common/y*: add Chinese translation

pages.zh/common/ya.md

@@ -0,0 +1,28 @@
+# ya
+
+> 管理 Yazi 软件包和插件。
+> 更多信息：<https://github.com/sxyazi/yazi>.
+
+- 添加一个软件包：
+
+`ya pack -a {{软件包}}`
+
+- 升级所有软件包：
+
+`ya pack -u`
+
+- 订阅来自所有远程实例的消息：
+
+`ya sub {{种类}}`
+
+- 向当前实例发布一个字符串内容的消息：
+
+`ya pub --str {{字符串消息}}`
+
+- 向当前实例发布一个 JSON 内容的消息：
+
+`ya pub --json {{json消息}}`
+
+- 向指定实例发布一个字符串内容的消息：
+
+`ya pub-to --str {{消息}} {{接收者}} {{种类}}`

pages.zh/common/yacas.md

@@ -0,0 +1,28 @@
+# yacas
+
+> 另一个计算机代数系统。
+> 更多信息：<https://www.yacas.org>.
+
+- 启动交互式的 `yacas` 会话：
+
+`yacas`
+
+- 在 `yacas` 会话中，执行一个语句：
+
+`{{Integrate(x)Cos(x)}};`
+
+- 在 `yacas` 会话中，显示一个示例：
+
+`{{Example()}};`
+
+- 从 `yacas` 会话中退出：
+
+`{{quit}}`
+
+- 执行一个或多个 `yacas` 脚本（没有终端或提示符），然后退出：
+
+`yacas -p -c {{路径/到/脚本1}} {{路径/到/脚本2}}`
+
+- 执行并打印一个语句的结果，然后退出：
+
+`echo "{{Echo( Deriv(x)Cos(1/x) );}}" | yacas -p -c /dev/stdin`

pages.zh/common/yacc.md

@@ -0,0 +1,17 @@
+# yacc
+
+> 使用形式语法规范文件生成一个 LALR 解析器（使用 C 语言）。
+> 请参阅：`bison`。
+> 更多信息：<https://manned.org/yacc.1p>.
+
+- 创建一个包含 C 语言解析器代码的文件 `y.tab.c`，并编译语法文件以及所有值所需的常量声明。（只有在使用 `-d` 选项时，才会创建常量声明文件 `y.tab.h`）：
+
+`yacc -d {{路径/到/grammar_file.y}}`
+
+- 编译一个包含解析器描述的语法文件，以及报告由于语法中的歧义导致的冲突：
+
+`yacc -d {{路径/到/grammar_file.y}} -v`
+
+- 编译一个语法文件，并用 `prefix` 代替 `y` 作为输出文件名前缀：
+
+`yacc -d {{路径/到/grammar_file.y}} -v -b {{前缀}}`

pages.zh/common/yadm-alt.md

@@ -0,0 +1,9 @@
+# yadm-alt
+
+> 为任何被管理的文件创建符号链接并处理模板。
+> 了解更多关于模板的信息：<https://yadm.io/docs/templates>。
+> 更多信息：<https://yadm.io/docs/alternates>.
+
+- 手动在备用文件之间创建符号链接：
+
+`yadm alt`

pages.zh/common/yadm-bootstrap.md

@@ -0,0 +1,9 @@
+# yadm-bootstrap
+
+> 执行 Yadm 的 bootstrap 文件。
+> 这个文件应创建在 `$HOME/.config/yadm/bootstrap`。
+> 更多信息：<https://yadm.io/docs/bootstrap>.
+
+- 执行 bootstrap 可执行文件：
+
+`yadm bootstrap`

pages.zh/common/yadm-clone.md

@@ -0,0 +1,30 @@
+# yadm-clone
+
+> 功能就像 `git clone`。此外，你还可以传递额外的标志来配置你的仓库。
+> 如果仓库中有一个引导文件，将提示你执行它。
+> 请参阅：`git clone`。
+> 更多信息：<https://yadm.io/docs/common_commands>.
+
+- 克隆一个已有的仓库：
+
+`yadm clone {{远程_仓库_位置}}`
+
+- 克隆一个已有的仓库，然后执行引导文件：
+
+`yadm clone {{远程_仓库_位置}} --bootstrap`
+
+- 克隆一个已有的仓库，并在克隆后不执行引导文件：
+
+`yadm clone {{远程_仓库_位置}} --no-bootstrap`
+
+- 更改 `yadm` 在克隆时使用的工作树：
+
+`yadm clone {{远程_仓库_位置}} --w {{工作树_文件}}`
+
+- 更改 `yadm` 用于获取文件的分支：
+
+`yadm clone {{远程_仓库_位置}} -b {{分支}}`
+
+- 覆盖一个已有仓库的本地分支：
+
+`yadm clone {{远程_仓库_位置}} -f`

pages.zh/common/yadm-config.md

@@ -0,0 +1,20 @@
+# yadm-config
+
+> 传递选项给 `yadm` 的配置文件。更改由 `yadm` 管理的仓库的 `.config`。
+> 更多信息：<https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md#configuration>.
+
+- 设置或更新 `yadm` 的 Git 配置：
+
+`yadm config {{键.内键}} {{值}}`
+
+- 从 `yadm` 的 Git 配置中获取一个值：
+
+`yadm config --get {{键}}`
+
+- 在 `yadm` 的 Git 配置中取消设置一个值：
+
+`yadm config --unset {{键}}`
+
+- 列出 `yadm` 的 Git 配置中的所有值：
+
+`yadm config --list`

pages.zh/common/yadm-decrypt.md

@@ -0,0 +1,9 @@
+# yadm-decrypt
+
+> 解密由 `yadm` 加密的文件。
+> 激活此命令时，系统会提示你输入密码。
+> 更多信息：<https://yadm.io/docs/encryption>.
+
+- 解密文件：
+
+`yadm decrypt`

pages.zh/common/yadm-encrypt.md

@@ -0,0 +1,13 @@
+# yadm-encrypt
+
+> 加密在指定的加密文件中列出的文件。
+> 文件被加密后将会存储在指定的归档文件夹中。
+> 更多信息：<https://yadm.io/docs/encryption>.
+
+- 加密在指定的加密文件中列出的文件：
+
+`yadm encrypt`
+
+- 创建加密所需的文件和文件夹：
+
+`touch {{路径/到/encrypt_file}} && mkdir {{路径/到/archive_folder}}`

pages.zh/common/yadm-enter.md

@@ -0,0 +1,13 @@
+# yadm-enter
+
+> 使用所有 Git 变量设置运行一个子 Shell。这个子 Shell 可以用于使用 Git 命令方便地与本地 `yadm` 仓库交互。
+> 如果你正在使用一个直接使用 Git 的工具，这可能会很有用。
+> 更多信息：<https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md#commands>.
+
+- 使用所有 Git 变量设置运行一个子 Shell：
+
+`yadm enter`
+
+- 退出子 Shell：
+
+`exit`

pages.zh/common/yadm-git-crypt.md

@@ -0,0 +1,21 @@
+# yadm git-crypt
+
+> Git Crypt 能够实现 Git 仓库中文件的透明加密和解密。
+> 请参阅：`git-crypt`。
+> 更多信息：<https://github.com/AGWA/git-crypt>.
+
+- 初始化仓库以使用 Git Crypt：
+
+`yadm git-crypt init`
+
+- 使用 GPG 共享仓库：
+
+`yadm git-crypt add-gpg-user {{用户_id}}`
+
+- 克隆包含加密文件的仓库后，解锁它们：
+
+`yadm git-crypt unlock`
+
+- 导出对称密钥：
+
+`yadm git-crypt export-key {{路径/到/密钥文件}}`

pages.zh/common/yadm-gitconfig.md

@@ -0,0 +1,21 @@
+# yadm-gitconfig
+
+> 向 `git config` 传递选项。更改由 `yadm` 管理的仓库的 `.gitconfig`。
+> 请参阅：`git config`。
+> 更多信息：<https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md#commands>.
+
+- 更新或设置一个 Git 配置值：
+
+`yadm gitconfig {{键.内键}} {{值}}`
+
+- 从 `yadm` 的 Git 配置中获取一个值：
+
+`yadm gitconfig --get {{键}}`
+
+- 在 `yadm` 的 Git 配置中取消设置一个值：
+
+`yadm gitconfig --unset {{键}}`
+
+- 列出 `yadm` 的 Git 配置中的所有值：
+
+`yadm gitconfig --list`

pages.zh/common/yadm-init.md

@@ -0,0 +1,17 @@
+# yadm-init
+
+> 初始化一个新的空的代码仓库用于跟踪点文件。
+> 该代码仓库存储在 `$HOME/.local/share/yadm/repo.git` 中。
+> 更多信息：<https://yadm.io/docs/getting_started>.
+
+- 执行：
+
+`yadm init`
+
+- 覆盖工作树：
+
+`yadm init -w {{路径/到/工作树文件夹}}`
+
+- 覆盖已存在的代码仓库：
+
+`yadm init -f {{路径/到/本地代码仓库}}`

pages.zh/common/yadm-introspect.md

@@ -0,0 +1,21 @@
+# yadm-introspect
+
+> 查看由 `yadm` 管理的数据。
+> 内省的目的是支持命令行补全。
+> 更多信息：<https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md#commands>.
+
+- 输出命令：
+
+`yadm introspect commands`
+
+- 输出配置：
+
+`yadm introspect configs`
+
+- 为主 `yadm` 命令输出开关：
+
+`yadm introspect switches`
+
+- 输出仓库：
+
+`yadm introspect repo`

pages.zh/common/yadm-list.md

@@ -0,0 +1,12 @@
+# yadm-list
+
+> 打印由 `yadm` 管理的文件列表。
+> 更多信息：<https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md#commands>.
+
+- 打印当前目录中由 `yadm` 管理的文件列表：
+
+`yadm list`
+
+- 列出所有由 `yadm` 完全管理的文件：
+
+`yadm list -a`

pages.zh/common/yadm-perms.md

@@ -0,0 +1,9 @@
+# yadm-perms
+
+> 更新权限。
+> 通常不需要运行此命令，因为 `yadm` 默认会自动处理权限。这种自动行为可以通过将配置 `yadm.auto-perms` 设置为 `"false"` 来禁用。
+> 更多信息：<https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md#permissions>.
+
+- 修改文件权限：
+
+`yadm perms`

pages.zh/common/yadm-transcrypt.md

@@ -0,0 +1,26 @@
+# yadm-transcrypt
+
+> 如果已安装 `transcrypt`，此命令允许直接向 `transcrypt` 传递选项。
+> 环境配置为使用 yadm 仓库。
+> Transcrypt 使 Git 仓库中的文件能够透明地加密和解密。
+> 更多信息：<https://github.com/elasticdog/transcrypt>.
+
+- 设置用于加密的对称加密算法：
+
+`yadm transcrypt --cipher={{加密算法}}`
+
+- 提供用来派生密钥的密码：
+
+`yadm transcrypt --password={{密码}}`
+
+- 假设所有回答为“是”并接受未指定选项的默认值：
+
+`yadm transcrypt --yes`
+
+- 显示当前仓库的加密算法和密码：
+
+`yadm transcrypt --display`
+
+- 使用新的凭证重新加密所有已加密的文件：
+
+`yadm transcrypt --rekey`

pages.zh/common/yadm-upgrade.md

@@ -0,0 +1,13 @@
+# yadm-upgrade
+
+> 将 `yadm` 升级到最新版本。
+> 升级将尝试将你的子模块反初始化并重新初始化。
+> 更多信息：<https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md#commands>.
+
+- 将 `yadm` 升级到最新版本：
+
+`yadm upgrade`
+
+- 强制升级，无论有无更改：
+
+`yadm upgrade -f`

pages.zh/common/yadm.md

@@ -0,0 +1,33 @@
+# yadm
+
+> 一个通过使用 `git` 来管理 dotfiles 的工具。
+> 此命令也有关于其子命令的文件，例如：`init`、`clone`、`push` 和 `pull`。
+> 更多信息：<https://yadm.io/docs/overview>.
+
+- 覆盖 `yadm` 目录。`yadm` 会相对于此目录存储其配置：
+
+`yadm --yadm-dir`
+
+- 覆盖 `yadm` 数据目录：`yadm` 会相对于此目录存储其数据：
+
+`yadm --yadm-data`
+
+- 覆盖 `yadm` 仓库的位置：
+
+`yadm --yadm-repo`
+
+- 覆盖 `yadm` 配置文件的位置：
+
+`yadm --yadm-config`
+
+- 覆盖 `yadm` 加密配置的位置：
+
+`yadm --yadm-encrypt`
+
+- 覆盖 `yadm` 加密文件归档的位置：
+
+`yadm --yadm-archive`
+
+- 覆盖 `yadm` 引导程序的位置：
+
+`yadm --yadm-bootstrap`

pages.zh/common/yapf.md

@@ -0,0 +1,16 @@
+# yapf
+
+> Python 风格指南检查器。
+> 更多信息：<https://github.com/google/yapf>.
+
+- 显示将要进行的更改的差异，但不实际更改（试运行）：
+
+`yapf --diff {{路径/到/文件}}`
+
+- 就地格式化文件，并显示更改的差异：
+
+`yapf --diff --in-place {{路径/到/文件}}`
+
+- 递归格式化目录中的所有 Python 文件，并发执行：
+
+`yapf --recursive --in-place --style {{pep8}} --parallel {{路径/到/目录}}`