文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载本文以 tldr 仓库中pages.bg/linux/dir.md保加利亚语别名页为切入点讲解 GNU coreutils 的dir命令为何等价于ls -C --escape并深入 tldr 的别名页alias page机制从多语言模板、tldr ls的跳转阅读方式到scripts/set-alias-page.py的自动生成与同步实现帮助读者理解如何在 tldr 中为别名命令建立独立但轻量的文档页面。一、dir是什么GNU coreutils 中的ls别名在 GNU coreutils 工具集中dir是一个与ls功能几乎完全相同的命令。tldr 的 英文版dir页面 只用一句话就点明了它的本质This command is an alias ofls -C --escape.也就是说调用dir等价于以两个特定选项运行ls-C以多列columnar方式排列条目每行显示多个文件名--escape短选项-b用反斜杠转义序列显示非图形字符如换行、制表符等不可打印字符避免终端输出被看不见的字符破坏。因此dir的默认输出风格是紧凑多列 转义特殊字符适合在脚本或终端中对文件名做快速、安全的列表展示。它并非独立的实现而是ls的一种固定参数组合的别名这也是 tldr 为它建立别名页而非完整页面的根本原因。二、tldr 中的保加利亚语dir别名页本次关联文档 pages.bg/linux/dir.md 是 tldr 保加利亚语bg分支下的对应页面全文如下# dir Тази команда е псевдоним на ls -C --escape. - Виж документацията за оригиналната команда: tldr ls逐行解读# dir页面标题即命令名本身 Тази команда е псевдоним на ...描述行保加利亚语意为此命令是ls -C --escape的别名- Виж документацията за оригиналната команда:操作说明意为查看原始命令的文档tldr ls告诉使用者通过tldr ls即可阅读原始命令ls的完整文档。别名页的精髓在于只描述别名关系不重复原始命令的用法既然dir只是ls的参数组合那么详细的选项与示例都交给 ls 页面 维护别名页只提供一个指路牌。这与英文页 pages/linux/dir.md 的结构完全一一对应只是描述语言不同。三、别名页的多语言模板体系为了让 30 多种语言社区都能产出格式统一的别名页tldr 在 contributing-guides/translation-templates/alias-pages.md 中维护了每种语言的标准模板。以本次涉及的保加利亚语bg为例模板为# example Тази команда е псевдоним на example. - Виж документацията за оригиналната команда: tldr example模板中的占位符example会被实际命令名替换第一次替换为别名页标题如dir第二次替换为被别名的原始命令如ls -C --escape最后一次替换为tldr命令行的目标命令如ls。同仓库中还有中文zh等模板例如# example 此命令为 example 的别名。 - 查看原命令的文档 tldr example这套模板体系保证了无论哪种语言别名页的标题 别名说明 跳转命令三段式结构都保持一致机器可解析、人也易阅读。四、如何阅读原始命令文档tldr ls别名页给出的核心操作是tldr ls。运行这条命令后用户会看到 pages/common/ls.md 中整理的ls常用示例例如每行只列出一个文件ls -1列出所有文件含隐藏文件ls {{[-a|--all]}}按文件类型附加符号目录/、符号链接、可执行文件*ls {{[-F|--classify]}}长格式列出权限、属主、大小、修改时间ls {{[-la|-l --all]}}长格式并以人类可读单位显示大小KiB、MiB、GiBls {{[-lh|-l --human-readable]}}长格式按文件大小降序递归排序ls {{[-lSR|-lS --recursive]}}长格式按修改时间倒序最旧在前ls {{[-ltr|-lt --reverse]}}只列出目录ls {{[-d|--directory]}} */当用户需要比多列 转义更丰富的列表方式时从别名页跳转到ls页面就能立即获得这些经过社区验证的实用组合。五、源码级实现set-alias-page.py如何生成与同步别名页别名页并非手工逐语言维护而是由仓库中的 scripts/set-alias-page.py 统一生成与同步的。该脚本的核心逻辑如下1. 模板占位符替换——generate_alias_page_content()函数读取对应语言的模板按顺序把example依次替换为标题、原始命令、文档命令从而得到完整的别名页内容见 scripts/set-alias-page.py。2. 交互式创建—— 通过-p/--page参数可以交互式创建新别名页脚本会引导输入页面标题、原始命令、文档命令并预览将生成的页面内容见 scripts/set-alias-page.py。例如创建dir这类别名页时标题填dir原始命令填ls -C --escape文档命令填ls。3. 批量同步——-S/--sync选项会扫描英文 pages 目录下所有别名页再把它们同步到各个语言的pages.*目录可用-l/--language限定只同步某一种语言如-l bg用-n/--dry-run预览变更、-s/--stage自动暂存修改见 scripts/set-alias-page.py。从源码结构可以推断脚本还通过get_locale_alias_pattern()从模板中提取各语言别名的措辞并用正则去识别一个既有页面是否已经是标准别名页从而避免重复创建或误判见 scripts/set-alias-page.py。这也是pages.bg/linux/dir.md能与英文页保持措辞一一对应的自动化保障。六、与dir相关的其他别名页在仓库中还能找到与dir直接相关的其他别名页反映了 GNU coreutils 在各种平台上的别名生态pages/linux/gnudir.mdgnudir是 GNUdir的别名用于在其他 Unix 平台上明确调用 GNU 版本文档同样跳转到tldr dirpages/osx/gdir.mdmacOS 上gdir也是 GNUdir的别名其文档命令写为tldr {{[-p|--platform]}} linux dir即通过-p linux明确指定读取 Linux 平台下的dir页面pages/common/vdir.mdvdir是 GNU coreutils 中dir的兄弟命令等价于ls -l --escape长格式 转义同样是别名页模式。这些页面共同演示了 tldr 别名页的两种跳转写法tldr 原始命令同平台与tldr -p 平台 命令跨平台指定。对使用者而言只要记住别名页只负责指路这一原则就能在任何语言、任何平台上快速定位到真正想读的命令文档。七、总结别名页的价值与使用方式pages.bg/linux/dir.md虽只有短短数行却是 tldr 设计理念的浓缩体现知识不重复dir的全部行为已由ls -C --escape定义别名页不做重复劳动多语言低成本维护借助 alias-pages.md 模板与 set-alias-page.py 脚本一次修改可同步到所有语言快速跳转用户在任何场景遇到dir一条tldr ls就能进入完整的ls文档查询效率最高。如果你在终端里恰好碰到dir或gnudir、gdir、vdir这类别名命令只需运行tldr dir或直接tldr ls即可用最短时间掌握它背后的真实能力。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐tldr 别名页机制解析以 pages.ar/linux/dir.md 为例解读 dir 与 ls -C --escape 的协作关系tldr 别名页机制解析以 pages.ar/linux/dir.md 为例解读 dir 与 ls C escape 的协作关系 在 tldr 这个控制台命文档教程知识库tldr 中的 vdir 别名页ls -l --escape 的阿拉伯语文档与别名页工作机制解析tldr 中的 vdir 别名页 ls l escape 的阿拉伯语文档与别名页工作机制解析 vdir 是 GNU coreutils 中 ls l esca文档教程知识库tldr 别名页文档解析以保加利亚语 file-rename 页面为例tldr 别名页文档解析以保加利亚语 file rename 页面为例 本文以 tldr 仓库中的保加利亚语别名页 pages.bg/common/file文档教程知识库上一篇awesome4girls开源指南如何借Debian Women、OPW等项目迈出开源第一步下一篇Cloudflare Docs 的 MDX 组件体系.agents/references/components.md 组件参考深度解读创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考