• 文档
• 教程
• 知识库

本篇文章以 pages.bg/common/gdm-binary.md 这一保加利亚语别名页为切入点，系统讲解 tldr 社区文档仓库中「别名页（alias page）」的设计思想、标准格式与自动化维护手段，同时顺带梳理其指向的原命令gdm（GNOME Display Manager）的常用用法。读完本文，你将理解：为什么一个仅 4 行的gdm-binary页面会被视为完整合规的文档条目，tldr gdm为什么能作为「查看原命令文档」的标准动作，以及贡献者如何借助仓库脚本 scripts/set-alias-page.py 快速创建、同步并校验几十种语言的别名页。

一、gdm-binary到底是什么

gdm-binary是 GNOME 显示管理器（GDM）的可执行程序文件名，而在 tldr 仓库中，pages/common/gdm-binary.md 与 pages.bg/common/gdm-binary.md 并不重复描述该程序的全部功能，而是采用一种刻意精简的「别名页」形态：

# gdm-binary > This command is an alias of `gdm`. - View documentation for the original command: `tldr gdm`

保加利亚语版本与之逐行对应：

# gdm-binary > Тази команда е псевдоним на `gdm`. - Виж документацията за оригиналната команда: `tldr gdm`

这并非文档残缺，而是 tldr 项目对「同一命令存在多个可调用名称」场景的官方约定：当gdm-binary只是gdm的别名（alias）时，重复罗列参数反而会造成信息冗余与维护负担，正确做法是用一个极简页面告诉用户「请去查原命令」。从目录结构看，仓库为gdm还维护了gdm-safe-restart、gdm-stop、gdmsetup、gdm-restart等关联页面（见 pages/common），共同构成 GDM 命令家族。

二、原命令gdm：别名背后完整的功能文档

gdm-binary指向的原命令页面 pages/common/gdm.md 给出了 GDM 的真实定位与可复制的用法：

The GNOME Display Manager (GDM) is a replacement for the X Display Manager (XDM).

该页面列出了 6 条可执行示例，实际使用时可把gdm替换为gdm-binary，效果相同：

页面中同时给出gdm-binary、gdmsetup、gdm-stop、gdm-restart、gdm-safe-restart作为 see-also 关联命令，并把更多信息指向 man 手册（https://manned.org/gdm）。

三、tldr 别名页的标准格式：来自 style-guide 的硬性约定

为什么别名页必须是上面那种形态？contributing-guides/style-guide.md 的「Aliases」小节给出了明确规范：当命令可以用别名调用（例如vim可写作vi）时，应创建别名页，把用户引导到原命令名。标准模板为：

# command_name > This command is an alias of `original-command-name`. - View documentation for the original command: `tldr original_command_name`

并附有vi→vim的完整示例：

# vi > This command is an alias of `vim`. - View documentation for the original command: `tldr vim`

gdm-binary页正是对这一模板的忠实落地：标题行# gdm-binary、第二行「alias of」描述、一条tldr gdm命令。注意别名页不包含任何参数示例——这是有意为之，参数细节统一由原命令页维护，避免了同一命令族在两个页面间出现内容漂移。

四、多语言模板：保加利亚语别名页的由来

别名页不是各语言随意翻译的产物。仓库在 contributing-guides/translation-templates/alias-pages.md 中固化了全部官方语言的别名页模板，每份模板都只替换「命令名」占位符，不允许改动结构。其中保加利亚语（bg）模板为：

# example > Тази команда е псевдоним на `example`. - Виж документацията за оригиналната команда: `tldr example`

把三处example分别替换为gdm-binary、gdm、gdm，就得到了仓库中现存的 pages.bg/common/gdm-binary.md。这正是别名页可以几十种语言同步存在的原因——gdm-binary的别名页同时存在于 pages.ar、pages.de、pages.es、pages.zh 等目录中，均遵循同一份逐语言模板。

五、自动化工具链：set-alias-page.py 如何生成与同步别名页

别名页的维护有专门的脚本支撑。scripts/set-alias-page.py 是一个 Python 工具，负责生成、更新与同步别名页，其核心调用方式如下：

# 交互式创建/更新单个别名页（格式为 platform/alias_command.md） python3 scripts/set-alias-page.py -p common/gdm-binary # 将英文别名页同步到所有翻译目录 python3 scripts/set-alias-page.py -S # 只同步巴西葡萄牙语 python3 scripts/set-alias-page.py -S -l pt_BR # 同步并 git stage 变更文件 python3 scripts/set-alias-page.py -Ss # 干跑：只预览将要发生的变更 python3 scripts/set-alias-page.py -Sn

从源码结构看，脚本的工作流程清晰地对应了上述机制：

• generate_alias_page_content()（scripts/set-alias-page.py）读取指定语言的模板，依次把example替换为页面标题、原命令、文档命令；
• get_alias_command_in_page()解析已有页面，校验它是否严格符合别名模板结构（标题、alias 描述行、tldr命令行缺一不可）；
• get_english_alias_pages()扫描pages/下各平台目录，自动识别全部英文别名页；
• sync_alias_page_to_locale()与set_alias_page()负责把内容写入各翻译目录，并报告page added/page updated等状态。

脚本还会把tldr.md与aria2.md加入忽略列表（见IGNORE_FILES的扩展），因为这些特殊页面不应被当作别名页处理。此外，scripts/test.sh 等测试脚本配合 scripts/check-errors.sh 会在 PR 阶段对别名页的格式做自动化校验，确保每一份翻译都与模板严格一致。

六、实操：如何在终端中消费这份文档

对普通用户而言，gdm-binary别名页的价值在于极低的认知成本：

1. 在任意 tldr 客户端中查询tldr gdm-binary，立刻得到「This command is an alias ofgdm」的提示；
2. 看到tldr gdm一行后，再执行tldr gdm即可获得完整的 GDM 参数速查（--nodaemon、--no-console、--preserve-ld-vars、--help、--version）；
3. 在无法确定某命令是否为别名时，别名页正是消除歧义的第一道关卡，配合 see-also 关联命令（如gdm-stop、gdm-safe-restart）形成完整的命令导航网络。

对于希望参与贡献的开发者，则可以在本地克隆仓库后，直接对照 contributing-guides/style-guide.md 与 contributing-guides/translation-templates/alias-pages.md 阅读、校验现有别名页，或借助set-alias-page.py以规范流程新增条目。

七、小结

gdm-binary别名页虽只有 4 行，却浓缩了 tldr 仓库三层设计：内容层（用别名页消除命令名冗余）、规范层（style-guide 与多语言模板统一定义结构）、工具层（set-alias-page.py 自动化生成与同步）。理解这三层，就理解了整个 tldr 项目数千条命令页赖以高效协作的文档工程哲学——这也是gdm-binary这一条小小的保加利亚语页面真正的技术价值所在。

• 文档
• 教程
• 知识库