fix: 🐛 修复链接问题

uxiew · uxiew · commit 5ca46daf3bdd · 2024-06-14T22:05:33.000+08:00
diff --git a/.vitepress/config.mts b/.vitepress/config.mts
@@ -1,16 +1,20 @@
+import { resolve } from "node:path";
 import { defineConfig } from "vitepress";
 import { SearchPlugin } from "@ver5/vitepress-plugin-search";
 
 import markIt from "markdown-it-mark";
-import { REPO_URL, OUT_DIR, BASE_NAME, SRC_DOC } from "./const";
+import { REPO_URL, SRC_DOC, OUT_DIR, AUTHOR } from "./const";
+import { gHLink2JSON } from "./utils";
 import nav from "./nav";
 import { books, sidebar } from "./sidebar";
 import { linkPlugin } from "./plugins/linkPlugin";
 import { rustCodePlugin } from "./plugins/rustcode/runCodePlugin";
 import { imageSizePlugin } from "./plugins/imagePlugin";
 import { alignPlugin } from "./plugins/alignPlugin";
 
+const BASE_PATH = gHLink2JSON(REPO_URL).label.replace(AUTHOR, '');
 
+console.log(resolve(__dirname))
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
   lang: "zh-CN",
@@ -22,8 +26,13 @@ export default defineConfig({
   ],
   srcDir: SRC_DOC,
   outDir: OUT_DIR,
-  base: BASE_NAME,
+  base: BASE_PATH,
   vite: {
+    resolve: {
+      alias: {
+        "@vp": resolve(__dirname),
+      },
+    },
     plugins: [
       SearchPlugin({
         previewLength: 42,
@@ -66,7 +75,7 @@ export default defineConfig({
       copyright: "Copyright © 2023-present ChandlerVer5",
     },
     editLink: {
-      pattern: REPO_URL + "edit/main/docs/:path",
+      pattern: REPO_URL + "/edit/main/docs/:path",
       text: "Edit this page on GitHub",
     },
     // socialLinks: [
diff --git a/.vitepress/const.ts b/.vitepress/const.ts
@@ -1,7 +1,10 @@
 /** 定义常量 */
+export const SRC_DOC = "docs";
 
-export const BASE_NAME = "/rust_study";
 export const OUT_DIR = "dist";
-export const SRC_DOC = "docs";
 
-export const REPO_URL = 'https://github.com/ChandlerVer5/rust_study/'
+export const AUTHOR = 'uxiew'
+
+export const REPO_URL = 'https://github.com/uxiew/rust_study'
+
+export const RUST_REPO_URL = 'https://github.com/rust-lang/rust'
diff --git a/.vitepress/plugins/linkPlugin.ts b/.vitepress/plugins/linkPlugin.ts
@@ -1,6 +1,5 @@
 import type MarkdownIt from 'markdown-it'
 import { normalizeLink } from './utils'
-import { BASE_NAME } from '../const'
 
 export interface Options {
   books: any[]
@@ -18,7 +17,7 @@ const getRegRules = (text: string) => [
 ]
 
 function toLinkUrl(raw: string, rule: string, link: string) {
-  return raw.replace(new RegExp(rule, 'g'), (matchText) => `<a href=${normalizeLink(BASE_NAME + link)}>${matchText}</a>`)
+  return raw.replace(new RegExp(rule, 'g'), (matchText) => `<a href=${normalizeLink(link)} target="_blank">${matchText}</a>`)
 }
 
 /**
diff --git a/.vitepress/utils/index.ts b/.vitepress/utils/index.ts
@@ -0,0 +1,8 @@
+
+
+export function gHLink2JSON(GH_URL: string) {
+    return {
+        "label": GH_URL.replace('https://github.com/', ''),
+        "url": GH_URL,
+    }
+}
diff --git a/LICENSE b/LICENSE
@@ -1,5 +1,5 @@
 MIT License
-Copyright (c) 2023 ChandlerVer5
+Copyright (c) 2023 uxiew
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
diff --git a/docs/index.md b/docs/index.md
@@ -1,7 +1,15 @@
 # Dive Into Rust!
 
-> 项目地址：[ChandlerVer5/rust_study](https://github.com/ChandlerVer5/rust_study/)
+<script setup>
+import { ref } from 'vue'
+import { REPO_URL } from '@vp/const'
+import { gHLink2JSON } from '@vp/utils'
 
+const repo = ref(gHLink2JSON(REPO_URL))
+</script>
+
+> 项目地址：<a :href=repo.url target="_blank">{{repo.label}}</a>
+>
 > 随着作者的学习，持续更新、修正...
 
 **Rust 是一种低级静态类型的多范式编程语言，专注于安全性和性能**。
diff --git a/docs/第 1 章 步入Rust的世界（第一部分 基础知识）/1.1 版本和发布策略.md b/docs/第 1 章 步入Rust的世界（第一部分 基础知识）/1.1 版本和发布策略.md
@@ -1,26 +1,34 @@
 # 1.1 版本和发布策略
 
-Rust 编程语言是开源的，编译器的源码位于<https://github.com/rust-lang/rust> 项目中，语言设计和相关讨论位于<https://github.com/rust-lang/rfcs> 项目中。对于想深入研究这门语言的读者来说，这是一个非常好的消息，大家可以通过研读开放的源代码和技术文档了解到很多书本上没有讲解过的知识。任何一个开发者都可以直接给这个项目提 bug，或者直接贡献代码。Rust 项目是完全由开源社区管理和驱动的，社区的氛围非常友好。
+<script setup>
+import { ref } from 'vue'
+import { RUST_REPO_URL } from '@vp/const'
+import { gHLink2JSON } from '@vp/utils'
+
+const rustRepo= ref(gHLink2JSON(RUST_REPO_URL))
+</script>
+
+Rust 编程语言是开源的，编译器的源码位于 <a :href=rustRepo.url target="_blank">{{rustRepo.label}}</a>，语言设计和相关讨论位于 [rust-lang/rfcs](https://github.com/rust-lang/rfcs) 项目中。对于想深入研究这门语言的读者来说，这是一个非常好的消息，大家可以通过研读开放的源代码和技术文档了解到很多书本上没有讲解过的知识。任何一个开发者都可以直接给这个项目提 bug，或者直接贡献代码。Rust 项目是完全由开源社区管理和驱动的，社区的氛围非常友好。
 
 Rust 编译器的版本号采用了“语义化版本号”（Semantic Versioning）规划。在这个规则之下，版本格式为：主版本号。次版本号.修订号。版本号递增规则如下。
 
-* 主版本号：当你做了不兼容的 API 修改
-* 次版本号：当你做了向下兼容的功能性新增
-* 修订号：当你做了向下兼容的问题修正
+- 主版本号：当你做了不兼容的 API 修改
+- 次版本号：当你做了向下兼容的功能性新增
+- 修订号：当你做了向下兼容的问题修正
 
 Rust 的第一个正式版本号是 1.0，是 2015 年 5 月发布的。从那以后，只要版本没有出现大规模的不兼容的升级，大版本号就一直维持在“1”，而次版本号会逐步升级。Rust 一般以 6 个星期更新一个正式版本的速度进行迭代。
 
 为了兼顾更新速度以及稳定性，Rust 工具链分为三个发布渠道：
 
-* nightly 版本
-* beta 版本
-* stable 版本
+- nightly 版本
+- beta 版本
+- stable 版本
 
-| 版本类型 | 描述 |
-| --- | --- |
-| Nightly        | 每天从 develop 的主分支自动创建出来的版本，这个版本包含所有最新功能，但是某些功能存在问题的可能性也更大。因为新功能会首先在这个版本上开启，供用户试用。  |
-| Beta           | 每六周发布一次。将一些在 nightly 版本中验证过的功能开放给用户使用。它可以被看作 stable 版本的“预发布”版本。 |
-| Stable         | 正式版，每六周发布一个新版本，一些实验性质的新功能在此版本上无法使用。它也是最稳定、最可靠的版本。stable 版本是保证向前兼容的。  |
+| 版本类型 | 描述                                                                                                                                                    |
+| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Nightly  | 每天从 develop 的主分支自动创建出来的版本，这个版本包含所有最新功能，但是某些功能存在问题的可能性也更大。因为新功能会首先在这个版本上开启，供用户试用。 |
+| Beta     | 每六周发布一次。将一些在 nightly 版本中验证过的功能开放给用户使用。它可以被看作 stable 版本的“预发布”版本。                                             |
+| Stable   | 正式版，每六周发布一个新版本，一些实验性质的新功能在此版本上无法使用。它也是最稳定、最可靠的版本。stable 版本是保证向前兼容的。                         |
 
 鼓励开发人员使用稳定版本渠道。但是，Nightly 版本启用了前沿的不稳定功能，某些库和程序可能会需要此功能。您可以通过 rustup 轻松地更改为 Nightly 工具链。
 
diff --git a/docs/第 32 章 项目和模块（第五部分 实用设施）/32.2 项目配置.md b/docs/第 32 章 项目和模块（第五部分 实用设施）/32.2 项目配置.md
@@ -134,8 +134,8 @@ opt-level = 3
 ## 32.2.1 cargo 配置文件
 
 cargo 也支持配置文件。配置文件可以定制 cargo 的许多行为，就像我们给 git 设置配置文件一样。
-类似的，cargo 的配置文件可以存在多份，它们之间有优先级关系。你可以为某个文件夹单独提供一份配置文件， 例如在当前文件夹下的`.cargo/config.toml`文件，也可以提供一个全局的默认配置，为`$HOME/.cargo/config.toml`文件或者不带 `.toml`扩展名的文件。
-Cargo 对 `.toml` 扩展名的支持是在 1.39 版本中添加的，已经是首选形式了。如果这两种形式的配置文件都存在，Cargo 将优先使用不带扩展名的文件。
+类似的，cargo 的配置文件可以存在多份，它们之间有优先级关系。你可以为某个文件夹单独提供一份配置文件， 例如在当前文件夹下的 `.cargo/config.toml` 文件，也可以提供一个全局的默认配置，为 `$HOME/.cargo/config.toml` 文件或者不带 `.toml`扩展名的文件。
+Cargo 对 `.toml` 扩展名的支持是在 1.39 版本中添加的，已经是首选形式了。如果这两种形式的配置文件都存在，Cargo 将优先使用不带扩展名的文件，并打印 warning，所以推荐使用 `onfig.toml` 配置文件。
 
 下面是一份配置示例：
 ```toml
diff --git a/docs/第 6 章 数组和字符串/6.1 数组.md b/docs/第 6 章 数组和字符串/6.1 数组.md
@@ -259,7 +259,7 @@ fn main() {
 
 执行结果为：
 ```txt
-100     90      80      70      60      50      40      30      20      10
+100	90	80	70	60	50	40	30	20	10
 ```
 
 在 Rust 中，还有其他的几种 Range，包括
@@ -298,11 +298,11 @@ fn main() {
 
 ```txt
 Length: 5
-1       2       3       4       5
+1	2	3	4	5	
 Length: 3
-3       4       5
+3	4	5	
 Length: 2
-3       4
+3	4
 ```
 
 第一次打印，内容为整个`arr`的所有区间。第二次打印，是从`arr`的 index 为`2`的元素开始算起，一直到最后。注意数组是从 index 为`0`开始计算的。

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,5 @@`
`1`	`1`	`import type MarkdownIt from 'markdown-it'`
`2`	`2`	`import { normalizeLink } from './utils'`
`3`		`-import { BASE_NAME } from '../const'`
`4`	`3`
`5`	`4`	`export interface Options {`
`6`	`5`	`books: any[]`
`@@ -18,7 +17,7 @@ const getRegRules = (text: string) => [`
`18`	`17`	`]`
`19`	`18`
`20`	`19`	`function toLinkUrl(raw: string, rule: string, link: string) {`
`21`		- return raw.replace(new RegExp(rule, 'g'), (matchText) => `<a href=${normalizeLink(BASE_NAME + link)}>${matchText}</a>`)
	`20`	+ return raw.replace(new RegExp(rule, 'g'), (matchText) => `<a href=${normalizeLink(link)} target="_blank">${matchText}</a>`)
`22`	`21`	`}`
`23`	`22`
`24`	`23`	`/**`