文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载本篇以 tldr 开源仓库中的保加利亚语别名页 pages.bg/common/copr.md 为样本剖析 tldrCollaborative cheatsheets for console commands这一协作式命令速查手册项目的核心文档机制别名页alias pages。你将了解到copr命令与copr-cliFedora COPR 在线 RPM 构建服务的命令行客户端之间的真实对应关系、别名页从风格规范到多语言模板再到自动化同步脚本的完整实现链路并掌握在终端中查看来别名的原命令文档的实战方法。页面本体一条 7 行的保加利亚语别名页先看被指定的文档 pages.bg/common/copr.md 的完整内容它只有 7 行# copr Тази команда е псевдоним на copr-cli. - Виж документацията за оригиналната команда: tldr copr-cli对照英文原页 pages/common/copr.md# copr This command is an alias of copr-cli. - View documentation for the original command: tldr copr-cli两页结构完全一致仅文案语言不同。逐行拆解这份页面的组成行结构英文含义说明第 1 行# copr页面标题与命令名同名copr即被调用的命令第 3 行 ... псевдоним на \copr-cli.| 命令描述 | 说明这是一个指向copr-cli 的别名第 5 行- Виж документацията...操作说明提示查看原命令的文档第 7 行tldr copr-cli推荐命令引导用户通过 tldr 查看原命令可以看出别名页本身并不重复撰写原命令的用法它的全部职责是一条指路牌告诉用户你敲的这个命令其实是另一个命令的别名去查那个命令吧。从别名页到原命令copr 与 copr-cli 的真实关系copr之所以是别名是因为 Fedora 生态中真正提供命令行工具的是copr-cli——与 Fedora-Projects 的 COPR 实例交互、用于构建 RPM 包并将其发布的客户端程序。tldr 仓库中的原命令页 pages/common/copr-cli.md 给出了它的完整速查# copr-cli Interface with Fedora-Projects copr instance for building RPMs and publishing them. More information: https://manned.org/copr-cli. - Show user logged in to copr: copr-cli whoami - Build a local spec file on copr: copr-cli build {{repository}} {{path/to/spec_file}} - Check status of builds: copr-cli list-builds {{repository}} - Trigger a copr build of a spec-file from public (Git) repository: copr-cli buildscm {{repository}} --clone-url {{https://git.example.org/repo}} --spec {{spec_file_name}}它覆盖了 COPR 工作流中最常用的四类操作身份确认copr-cli whoami—— 查看当前登录 COPR 的用户本地构建copr-cli build {{repository}} {{path/to/spec_file}}—— 将本地的.spec文件提交到指定仓库构建{{repository}}、{{path/to/spec_file}}为 tldr 惯例的占位符使用时替换为真实值状态查询copr-cli list-builds {{repository}}—— 检查某仓库中构建任务的状态远程构建copr-cli buildscm {{repository}} --clone-url {{...}} --spec {{spec_file_name}}—— 从公开 Git 仓库克隆源码并触发构建。因此在 tldr 中用户输入tldr copr会先看到别名页再根据指引tldr copr-cli获取上述完整速查——这就是别名页 原命令页的组合分工。别名页机制tldr 的文档设计规范别名页不是随意写的它受仓库的风格指南约束。在 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为例演示了成品效果。copr.md正是这一模板的直接落实现例替换后即为This command is an alias of \copr-cli.与 tldr copr-cli 。此外style-guide.mdcontributing-guides/style-guide.md#L504-L543还针对PowerShell命令给出了三类特殊别名场景替换既有 cmd 命令的别名如cd别名到Set-Location在原命令页第二行追加说明而非新建别名页仅存在于 PowerShell 的新别名如ni别名到New-Item使用标准别名模板但需加上In PowerShell,字样与其他程序冲突的别名如 PowerShell 内置curl/wget别名需附加如何判定当前指向的说明。这说明别名页机制在普通 Unix/Linux 命令与 Windows PowerShell 语境下有着精细的差异化处理规则。多语言模板pages.bg 的别名页翻译tldr 仓库收录了 40 余种语言的翻译版本pages.bg/、pages.de/、pages.zh/等别名页的每一种语言都有统一维护的翻译模板集中在 contributing-guides/translation-templates/alias-pages.md。该文件按语言列出模板其中bg保加利亚语模板位于该文件的 L80-L90# example Тази команда е псевдоним на example. - Виж документацията за оригиналната команда: tldr example对照 pages.bg/common/copr.md保加利亚语页正是将模板中的三个example占位符分别替换为标题copr、原命令copr-cli与文档命令copr-cli后生成的产物。模板解析逻辑在 scripts/_common.py 的get_templates()函数中实现脚本逐行扫描alias-pages.md遇到###行识别语言标签读取紧跟其后的markdown代码块内容作为该语言的模板并跳过标注了 Not translated yet. 的未翻译语言。get_locale()scripts/_common.py则负责从页面路径反推语言若上级目录名含.如pages.bg取其后缀bg否则默认为en。自动化set-alias-page.py 如何生成与同步别名页别名页数量庞大英文pages/common目录下就有数千页仓库提供了 scripts/set-alias-page.py 来自动化创建与同步。它支持两种工作模式交互式创建-p, --pagepython3 scripts/set-alias-page.py -p common/copr脚本会启动向导依次询问页面标题、原命令名、文档命令名并在落盘前打印预览、请求确认。该脚本还体贴地处理了含短横线的命令名如pacman -S——采用交互式输入而非位置参数正是为了避免此类参数解析歧义见脚本头部的设计说明。批量同步-S, --syncpython3 scripts/set-alias-page.py -S -l bg该模式以英文别名页为基准将同一命令的别名页同步到所有或指定-l语言的翻译目录。核心流程是get_english_alias_pages()扫描英文pages目录下所有平台子目录通过 get_alias_command_in_page() 解析出每页的标题、原命令与文档命令对每个翻译目录调用set_alias_page()用该语言模板重新生成页面内容若内容与现有一致则跳过否则写入并输出page added/page updated状态。模板替换的核心是 generate_alias_page_content() 中的三次str.replace(example, ...)先替换标题占位符再替换描述中的原命令占位符最后替换tldr文档命令占位符从而用一份模板生成任意别名页。配套参数还包括参数作用-s, --stage用git add暂存被修改的页面要求仓库为 Git 仓库-n, --dry-run仅预览将发生的变更不实际写盘-i, --inexact忽略与模板的直接匹配用于识别非标准别名页脚本头部还特别提醒--sync会产生较多误报建议配合-l LANGUAGE只同步特定语言并仅暂存、提交人工核对过的变更。实战在终端中从别名查到原命令掌握上述机制后实际使用非常简单# 1. 输入你记忆中的短命令tldr 会给出别名页 tldr copr # 输出copr 是 copr-cli 的别名请查看原命令文档 # 2. 按提示查看原命令完整速查 tldr copr-cli # 输出whoami / build / list-builds / buildscm 等示例 # 3. 直接在本地构建 RPM 包 copr-cli build my-repo ~/rpmbuild/SPECS/hello.spec # 4. 查看构建状态 copr-cli list-builds my-repo别名页的设计让 tldr 在命令名很多、但本质工具很少的现实世界中保持克制每个工具只有一份权威速查其他名字统一由轻量的别名页指向它。而 contributing-guides/translation-templates/alias-pages.md 的多语言模板与 scripts/set-alias-page.py 的同步脚本则保证了pages.bg/、pages.zh/等数十种语言目录下别名页的措辞、结构与英文版始终保持一致——pages.bg/common/copr.md 正是这套机制在保加利亚语下的一个标准产物。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐tldr 仓库中的 zegrep 别名页从 zgrep --extended-regexp 到多语言别名页维护机制tldr 仓库中的 zegrep 别名页从 zgrep extended regexp 到多语言别名页维护机制 本文以 pages.ar/common/zeg文档教程知识库tldr 仓库中的 dnf deplist 别名页从阿拉伯语文档看 tldr 别名页面机制tldr 仓库中的 dnf deplist 别名页从阿拉伯语文档看 tldr 别名页面机制 本篇技术指南以 tldr 仓库中的 dnf deplist.md文档教程知识库tldr 仓库中的 fdfind 别名页命令别名文档机制与 fd 命令速查tldr 仓库中的 fdfind 别名页命令别名文档机制与 fd 命令速查 导读 本文围绕 fdfind.md https://link.gitcode.co文档教程知识库上一篇AndroidUtilCode之ImageUtils实战裁剪、水印、模糊、压缩等12个图片处理技巧下一篇MCP Python SDK 文档多语言翻译体系架构、生成工具与协作方式创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考