docs: update Simplified Chinese translation for 0.16.0 (#2155)

Author: zhonger

docs/.vitepress/sidebars.ts

@@ -457,8 +457,13 @@ const zh_hans = [
  text: "指导",
  collapsed: false,
  items: [
- { text: "什么是asdf？", link: "/zh-hans/guide/introduction" },
+ { text: "什么是 asdf？", link: "/zh-hans/guide/introduction" },
  { text: "快速入门", link: "/zh-hans/guide/getting-started" },
+ {
+ text: "快速入门 (0.16.0 之前)",
+ link: "/zh-hans/guide/getting-started-legacy",
+ },
+ { text: "升级到 0.16.0", link: "/zh-hans/guide/upgrading-to-v0-16" },
  ],
  },
  {
@@ -476,6 +481,7 @@ const zh_hans = [
  items: [
  { text: "配置", link: "/zh-hans/manage/configuration" },
  { text: "所有命令", link: "/zh-hans/manage/commands" },
+ { text: "依赖", link: "/zh-hans/manage/dependencies" },
  {
  text: "插件缩写索引",
  link: "https://github.com/asdf-vm/asdf-plugins",

docs/zh-hans/contribute/core.md

@@ -41,13 +41,14 @@ asdf install
 
 ```shell
 # 脚本检查
-./scripts/shellcheck.bash
+./scripts/lint.bash --check
 
 # 格式化
-./scripts/shfmt.bash
+./scripts/lint.bash --fix
 
 # 测试：所有案例
-bats test/
+./scripts/test.bash
+
 # 测试：特定命令
 bats test/list_commands.bash
 ```
@@ -58,9 +59,54 @@ bats test/list_commands.bash
 
 :::
 
+### Gitignore
+
+以下是 `asdf-vm/asdf` 仓库中的 `.gitignore` 文件。我们忽略项目特定的文件。与操作系统、工具或工作流程相关的文件应在全 `.gitignore` 配置中忽略， [请查看此处](http://stratus3d.com/blog/2018/06/03/stop-excluding-editor-temp-files-in-gitignore/) 了解更多。
+
+<<< @/../.gitignore
+
+### `.git-blame-ignore-revs`
+
+`asdf` 使用 `.git-blame-ignore-revs` 文件来减少在运行 blame 命令时的噪音。请查看 [git blame documentation](https://git-scm.com/docs/git-blame) 了解更多。
+
+使用 `git blame` 时，可通过以下方式使用该文件：
+
+```sh
+git blame --ignore-revs-file .git-blame-ignore-revs ./test/install_command.bats
+```
+
+可选地，配置为在每次调用 `blame` 时自动使用该文件，无需手动提供：
+
+```sh
+git config blame.ignoreRevsFile .git-blame-ignore-revs
+```
+
+可以配置集成开发环境（IDEs）使用该文件。例如，在使用 VSCode (搭配 [GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens)) 时，将以下内容写入 `.vscode/settings.json`：
+
+```json
+{
+ "gitlens.advanced.blame.customArguments": [
+ "--ignore-revs-file",
+ ".git-blame-ignore-revs"
+ ]
+}
+```
+
 ## Bats 测试
 
-**强烈建议**在编写测试之前检查现有的测试套件和 [bats-core 文档](https://bats-core.readthedocs.io/en/stable/index.html)。
+在本地执行测试：
+
+```shell
+./scripts/test.bash
+```
+
+在编写测试之前，**请务必阅读**：
+
+- `test/` 目录中的现有测试
+- [bats-core 文档](https://bats-core.readthedocs.io/en/stable/index.html)
+- `scripts/test.bash` 中使用的现有 Bats 设置
+
+### Bats 提示
 
 Bats 调试有时可能很困难。使用带有 `-t` 标识的 TAP 输出将使你能够在测试执行期间打印带有特殊文件描述符 `>&3` 的输出，从而简化调试。例如：
 
@@ -71,7 +117,7 @@ printf "%s\n" "Will not be printed during bats test/some_tests.bats"
 printf "%s\n" "Will be printed during bats -t test/some_tests.bats" >&3
 ```
 
-进一步相关文档请查看 bats-core 的 [Printing to the Terminal](https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal) 部分.
+进一步相关文档请查看 bats-core 的 [终端打印](https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal) 部分.
 
 ## 拉取请求、发布以及约定式提交
 

docs/zh-hans/contribute/documentation.md

@@ -35,7 +35,7 @@ npm install
 
 ## 开发
 
-[Vuepress (v2)](https://v2.vuepress.vuejs.org/zh/) 是我们用来构建 asdf 文档网站的静态站点生成器（SSG）。它被选中来取代 [Docsify.js](https://docsify.js.org/#/zh-cn/)，因为我们希望在用户没有可用或未启用 JavaScript 时支持仅依靠 HTML。Docsify 无法做到这一点。除此之外，两者特性集合大致相同，重点是 Vuepress 可以用最少的配置编写 Markdown 文件。
+[Vitepress (v2)](https://vitepress.dev/zh/) 是我们用来构建 asdf 文档网站的静态站点生成器（SSG）。它被选中来取代 [Docsify.js](https://docsify.js.org/#/zh-cn/)，因为我们希望在用户没有可用或未启用 JavaScript 时支持仅依靠 HTML。Docsify 无法做到这一点。除此之外，两者特性集合大致相同，重点是 Vuepress 可以用最少的配置编写 Markdown 文件。
 
 `package.json` 包含了开发所需的脚本：
 
@@ -59,45 +59,58 @@ npm run format
 
 当为文档更改创建 PR 请求时，请确保 PR 标题使用了约定式提交类型 `docs` 以及 `docs: <description>` 的格式。
 
-## Vuepress
+## Vitepress
 
 网站的配置包含在几个 JavaScript 文件中，其中 JS 对象用于表示配置。它们是：
 
-- `docs/.vuepress/config.js`：网站的根配置文件。请查看 [Vuepress 文档](https://v2.vuepress.vuejs.org/zh/guide/configuration.html) 了解更多详情。
+- `docs/.vitepress/config.js`：网站的根配置文件。请查看 [Vitepress 文档](https://vitepress.dev/zh/reference/site-config) 了解更多详情。
 
 为了简化根配置文件，更大的 JS 对象表示 _导航栏和侧边栏_ 配置已经被提取并按照语言类型分隔开来。请参考以下文件：
 
-- `docs/.vuepress/navbar.js`
-- `docs/.vuepress/sidebar.js`
+- `docs/.vitepress/navbar.js`
+- `docs/.vitepress/sidebar.js`
 
-这些配置的官方文档位于 [默认主题参考](https://v2.vuepress.vuejs.org/zh/reference/default-theme/config.html)。
+这些配置的官方文档位于 [默认主题参考](https://vitepress.dev/zh/reference/default-theme-config)。
 
 ## I18n 国际化
 
-Vuepress 有一流的国际化支持。根配置文件 `docs/.vuepress/config.js` 定义了支持的语言类型及其 URL、在选择下拉菜单中的标题以及导航栏/侧边栏配置引用。
+Vitepress 有一流的国际化支持。根配置文件 `docs/.vitepress/config.js` 定义了支持的语言类型及其 URL、在选择下拉菜单中的标题以及导航栏/侧边栏配置引用。
 
 导航栏/侧边栏配置在上述配置文件中捕获，按语言类型分隔开并单独导出。
 
 每种语言的 markdown 内容必须位于与根配置文件中 `locale` 键同名的目录位置。也就是：
 
 ```js
-{
+// docs/.vitepress/config.js
+export default defineConfig({
  ...
- themeConfig: {
- locales: {
- "/": {
- selectLanguageName: "English (US)",
- sidebar: sidebar.en,
- navbar: navbar.en
+ locales: {
+ root: {
+ label: "English",
+ lang: "en-US",
+ themeConfig: {
+ nav: navbars.en,
+ sidebar: sidebars.en,
  },
- "/pt-BR/": {
- selectLanguageName: "Brazilian Portuguese",
- sidebar: sidebar.pt_br,
- navbar: navbar.pt_br
- }
- }
- }
-}
+ },
+ "pt-br": {
+ label: "Brazilian Portuguese",
+ lang: "pr-br",
+ themeConfig: {
+ nav: navbars.pt_br,
+ sidebar: sidebars.pt_br,
+ },
+ },
+ "zh-hans": {
+ label: "简体中文",
+ lang: "zh-hans",
+ themeConfig: {
+ nav: navbars.zh_hans,
+ sidebar: sidebars.zh_hans,
+ },
+ },
+ },
+})
 ```
 
 `/pt-BR/` 将要求 markdown 文件的同一集合位于 `docs/pt-BR/` 目录下，如下所示：
@@ -115,4 +128,4 @@ docs
  └─ README.md
 ```
 
-请查看 [Vuepress i18n 国际化官方文档](https://v2.vuepress.vuejs.org/zh/guide/i18n.html#%E7%AB%99%E7%82%B9%E5%A4%9A%E8%AF%AD%E8%A8%80%E9%85%8D%E7%BD%AE) 了解更多详情。
+请查看 [Vitepress i18n 国际化官方文档](https://vitepress.dev/zh/guide/i18n) 了解更多详情。