企业官网建设流程全解析

• 文档
• 教程
• 知识库

在 tldr 社区速查手册中，像cuninst这样的命令往往并不是独立存在的工具，而是某个真实命令的别名（alias）。本文以仓库中的阿拉伯语别名页面 pages.ar/windows/cuninst.md 为主体，讲解 tldr 的别名页面（Alias Pages）设计机制、阿拉伯语翻译模板的写法，并延伸出choco uninstall的完整实战用法与仓库内自动化同步工具的工作原理。读完本文，你将理解 tldr 如何用「一行命令 + 一个跳转」的极简方式为别名命令建立文档入口，也能掌握如何在 Windows 环境下利用 Chocolatey 精确卸载软件包。

cuninst 到底是什么？别名页面的核心逻辑

打开 pages.ar/windows/cuninst.md，全文仅四行：

# cuninst > هذا الأمر هو اسم مستعار لـ `choco uninstall`. - إعرض التوثيقات للأمر الأصلي: `tldr choco uninstall`

逐行解读其含义：

• # cuninst：页面标题，即被记录的别名命令本身；
• 第二行（以>开头）：「这个命令是choco uninstall的别名」，阿拉伯语表述为هذا الأمر هو اسم مستعار لـ ...；
• 第三、四行：「查看原命令的文档」，并给出唯一一条可执行示例tldr choco uninstall。

这是 tldr 项目标准化的「别名页面」范式：别名页面本身不重复罗列参数与示例，而是把读者引导到被别名指向的原命令页面。原因很直接——cuninst与choco uninstall指向同一可执行行为，若在每个别名页里重复维护全部参数说明，会造成同一份信息在多处漂移、难以同步维护。别名页只承担「索引/跳转」职责，原命令页承担「完整文档」职责。

英文原版 pages/windows/cuninst.md 与阿拉伯语版结构完全一致：

# cuninst > This command is an alias of `choco uninstall`. - View documentation for the original command: `tldr choco uninstall`

这种「不同语言共享同一逻辑骨架」的做法，正是 tldr 多语言文档体系能够被脚本批量维护的前提。

别名页面的阿拉伯语模板：translation-templates 的规范

仓库在 contributing-guides/translation-templates/alias-pages.md 中为每种语言定义了别名页面的标准模板，cuninst页面正是阿拉伯语（ar）模板的实例化。模板原文：

# example > هذا الأمر هو اسم مستعار لـ `example`. - إعرض التوثيقات للأمر الأصلي: `tldr example`

模板以example为占位符，共出现三处，分别对应：

该模板文件同时收录了 zh（简体中文）、zh_TW、en、de、fr 等数十种语言的同一结构模板，例如中文模板为「> 此命令为example的别名。 / - 查看原命令的文档：」。这意味着：无论读者使用何种语言，在别名页上看到的都是「该命令是 X 的别名 + 一条 tldr X 命令」两个信息，全局体验高度一致。

仓库中还可见同类别名页面的横向对照，例如阿拉伯语的 pages.ar/windows/cinst.md 对应choco install，与cuninst形成「安装/卸载」的对称对。这说明别名页机制是整个仓库的通用约定，而非cuninst孤例。

从别名跳到本体：choco uninstall完整实战手册

当用户在终端执行tldr choco uninstall后，得到的是 pages/windows/choco-uninstall.md 中的完整用法。choco uninstall是 Chocolatey（Windows 包管理器）的卸载子命令，以下是其全部核心用法：

卸载一个或多个软件包（包名以空格分隔）：

`choco uninstall {{package1 package2 ...}}`

卸载指定版本的软件包：

`choco uninstall {{package}} --version {{version}}`

自动确认所有交互提示，避免卸载过程中的确认对话框打断脚本执行：

`choco uninstall {{package}} {{[-y|--yes]}}`

卸载时同时移除全部依赖：

`choco uninstall {{package}} {{[-x|--remove-dependencies]}}`

卸载所有已安装的包：

`choco uninstall all`

需要注意几点实战细节：

• 参数占位符{{package}}、{{version}}是 tldr 的约定记号，实际使用时替换为具体包名与版本号（如{{7zip}}、{{9.22.00}}）；
• {{[-y|--yes]}}表示-y与--yes两种写法等价，均可跳过确认提示；
• --version单独使用时精确指定版本，配合-y可在无人值守环境中稳定执行；
• choco uninstall all属于高破坏性操作，通常用于批量清理测试环境，需谨慎使用。

这些参数信息只存在于原命令页中，而别名页cuninst不重复承载，体现了两类页面清晰的分工。

别名页面是如何生成与同步的：set-alias-page.py 源码解读

别名页面的创建与多语言同步并非全靠人工手写，仓库提供了自动化脚本 scripts/set-alias-page.py。其核心流程如下：

1. 模板读取：脚本通过get_templates(root, "alias-pages.md")解析 contributing-guides/translation-templates/alias-pages.md，为每种语言建立「占位符模板」映射（见_common.py中LANGUAGE_ALIASES附近的模板解析逻辑）；
2. 交互式创建：使用-p platform/alias_command.md参数可启动向导，脚本会依次询问页面标题（默认取文件名）、原命令名（必填）与文档查询命令（默认同原命令），并预览即将生成的页面，经确认后才写入磁盘；
3. 批量同步：使用-S/--sync参数时，脚本扫描英文目录 pages/windows/cuninst.md 这类英文别名页，将其中解析出的original_command与documentation_command套入各语言模板，同步到所有翻译目录（如pages.ar/windows/cuninst.md）；配合-l pt_BR可仅同步指定语言，-n/--dry-run可预览改动而不落盘，-s/--stage则把改动文件暂存到 git 暂存区；
4. 占位符替换：核心函数generate_alias_page_content对模板中的example依次执行三次replace——第一次替换成标题，第二次替换成原命令，第三次替换成文档命令，从而生成与 alias-pages.md 完全对齐的页面内容。

脚本还内置了严格校验：get_alias_command_in_page会解析页面中的别名行与tldr行，只有结构完全符合模板的页面才被认定为别名页；解析出choco uninstall这一原命令后，才会将其纳入同步范围。这保证了脚本生成的pages.ar/windows/cuninst.md与模板逐字一致，也正是仓库中该文件结构规整、可被机器验证的原因。

小结：极简别名页背后的设计智慧

从cuninst这四行阿拉伯语文档，可以窥见 tldr 文档体系的一个核心工程决策：

• 单一事实来源：别名命令不重复维护参数，文档主体始终收敛在 pages/windows/choco-uninstall.md 这类原命令页中；
• 多语言一致骨架：借助 alias-pages.md 模板，40 余种语言共享同一语义结构，阿拉伯语用户与中文、英文用户获得的跳转体验完全对等；
• 脚本化维护：set-alias-page.py让「新增别名页」「全语言同步」「只同步某语言」都能一键完成，且支持 dry-run 预览与 git 暂存，降低了跨语言贡献者的维护成本。

对读者而言，实际收益非常直接：在 Windows 命令行中敲入tldr cuninst或tldr choco uninstall，即可在几十毫秒内获得一份可复制的卸载命令清单；而理解别名页机制后，遇到cinst、clist、cpush等任何 Chocolatey 缩写命令，都能沿着tldr <原命令>这条链路快速找到权威用法。

• 文档
• 教程
• 知识库