文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载ug是 tldr 手册中一个典型的别名页alias page它本身只有三行信息明确告诉你ug等价于ugrep --config --pretty --sort并指引你通过tldr ugrep查看原始命令的完整用法。本文以仓库中的保加利亚语页面 pages.bg/common/ug.md 为骨架讲清别名页的书写规范、多语言模板机制、背后的自动化脚本以及被指向的原始命令ugrep的实战命令清单——读完即可在终端中直接使用ug/ugrep完成递归搜索、模糊匹配与压缩包检索。一、ug是什么一个指向ugrep的别名在 tldr 手册体系中别名页专门用于记录那些「本质上是另一个命令的快捷方式」的 shell 命令。保加利亚语页面 ug.md 的完整原文如下# ug Тази команда е псевдоним на ugrep --config --pretty --sort. - Виж документацията за оригиналната команда: tldr ugrep逐行解读标题行# ug页面命令名与文件名ug.md保持一致描述行以开头保加利亚语Тази команда е псевдоним на ...即「此命令是ugrep --config --pretty --sort的别名」——这给出了别名展开的完整等价形式是别名页的核心事实示例行以-开头保加利亚语Виж документацията за оригиналната команда:即「查看原始命令的文档」配套命令为反引号内的tldr ugrep。也就是说ug并非独立的搜索工具而是ugrep的快捷调用方式当你敲下ug时实际执行的是带--config、--pretty、--sort三个默认选项的ugrep。这一别名关系在英文主页面 pages/common/ug.md 中表述为# ug This command is an alias of ugrep --config --pretty --sort. - View documentation for the original command: tldr ugrep二、别名页的仓库级规范一页两字段多语言模板ug.md这类别名页并非随意书写仓库中维护着一套严格的结构化模板见 contributing-guides/translation-templates/alias-pages.md。该文件收录了从ar阿拉伯语到zh_TW繁体中文共 30 余种语言的统一模板每个别名页都必须且只能包含三部分# 命令名标题一行 此命令是 ... 的别名描述明确指出原始命令及其别名参数一行- 查看原始命令文档引导语配一条tldr 原始命令命令。保加利亚语bg模板在 alias-pages.md 中定义如下# example Тази команда е псевдоним на example. - Виж документацията за оригиналната команда: tldr example对照可见pages.bg/common/ug.md 正是该模板的实例化模板中的两个example占位符分别被替换为原始命令ugrep --config --pretty --sort描述行与文档命令ugreptldr行而标题替换为页面命令名ug。这种「同一结构、多语言翻译」的设计保证了任意语言的别名页都能被tldr客户端一致地解析与展示。三、别名页如何自动化生成set-alias-page.py脚本链路别名页的创建与同步由脚本 scripts/set-alias-page.py 驱动它恰好印证了ug.md的成文过程模板占位符替换函数generate_alias_page_content按顺序把模板中出现的example依次替换为标题、原始命令、文档命令set-alias-page.py这正是上文「一页两字段」落盘时的实际执行逻辑交互式创建运行python3 scripts/set-alias-page.py -p common/ug会启动向导依次询问页面标题、原始命令ugrep --config --pretty --sort与文档命令ugrep并预览最终页面后写入跨语言同步运行python3 scripts/set-alias-page.py -S会扫描英文别名页get_english_alias_pages然后调用sync_alias_page_to_locale把每个别名页同步到各语言目录可用-l bg限定只同步保加利亚语-n做预演-s自动git stage变更模板一致性校验函数get_alias_command_in_page用get_locale_alias_pattern(locale)从模板正则提取别名描述模式如bg的Тази команда е псевдоним на据此识别某个.md是否属于别名页并校验其结构是否偏离模板。也就是说pages.bg/common/ug.md 既是模板规范的产物也是这套脚本工作流的直接成果主仓库只需维护英文页 pages/common/ug.md各语言页由脚本按本地化模板生成与同步从而避免手工翻译的漂移。四、深入原始命令ugrep的典型实战用法别名页把ug指向 pages/common/ugrep.md后者是真正的内容主体——一个名为Ultra fast search tool with query TUI带查询 TUI 的极速搜索工具的命令文档。以下是该页提供的完整命令清单可直接复制使用启动交互式查询 TUI递归搜索当前目录按Ctrl z获取帮助ugrep -Q递归搜索当前目录中包含某正则模式的文件ugrep {{search_pattern}}在指定文件或目录中搜索并显示匹配行号ugrep -n {{search_pattern}} {{path/to/file_or_directory}}递归搜索当前目录只打印匹配文件的文件名ugrep -l {{search_pattern}}模糊搜索允许模式中最多 3 个字符的增、缺或错配ugrep -Z 3 {{search_pattern}}连压缩文件、Zip 与.tar归档一起递归搜索ugrep -z {{search_pattern}}只搜索文件名匹配特定 glob 模式的文件ugrep -g {{glob_pattern}} {{search_pattern}}只搜索 C 源文件可用ugrep --file-typelist列出所有支持的文件类型ugrep -t cpp {{search_pattern}}说明-Q/--query提供基于 TUI 的交互式搜索界面-n/--line-number输出行号-l/--files-with-matches只列文件名-Z/--fuzzyN开启容错为 N 的模糊匹配-z/--decompress穿透压缩归档-g/--glob按通配符过滤目标文件-t/--file-type按语言/文件类型过滤。上表中{{...}}为 tldr 的占位符约定实际使用时应替换为真实参数。五、把别名参数拆开看--config、--pretty、--sort各自承担什么回到别名本身ugrep --config --pretty --sort。从 ugrep 的命令行选项命名与常用约定可以推断这三个默认参数的含义--config启动时加载用户配置文件中的默认选项让ug带上个人化的搜索设置如默认高亮、忽略文件规则等--pretty以美化pretty-print方式输出匹配结果通常涉及终端彩色高亮与更易读的排版--sort对匹配结果按一定规则排序输出便于在多文件中快速定位。三者的组合效果是ug一条命令即可获得读取个人配置 美化输出 结果有序的开箱即用体验这正是它作为ugrep别名存在的意义——把最常用的默认行为封装进一个更短的名字。若要获得逐选项的完整权威说明直接执行tldr ugrep对应 pages/common/ugrep.md或在本机运行ugrep --help/ 阅读其 man 手册。六、在终端中的完整使用闭环结合以上全部信息一名使用 tldr 的终端用户面对ug时的完整闭环是键入tldr ugtldr 客户端展示保加利亚语或按LANG/TLDR_LANGUAGE选择的语言别名页页面告知ug等价于ugrep --config --pretty --sort键入tldr ugrep获取原始命令的完整示例递归搜索、行号、文件名、模糊匹配、压缩归档、glob、文件类型过滤等八类场景直接使用ug pattern享受带配置、美化且排序的搜索体验。这一闭环正是 tldr 设计别名页的初衷别名页本身轻量到只有一句话 一个跳转命令却通过模板规范、多语言覆盖与脚本同步contributing-guides/translation-templates/alias-pages.md、scripts/set-alias-page.py把用户精确引导到承载完整示例的原始命令页实现薄入口、厚内容的手册体验。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐tldr 仓库中的保加利亚语别名页 npm it从别名模板到 npm install-test 全链路解读tldr 仓库中的保加利亚语别名页 npm it 从别名模板到 npm install test 全链路解读 npm it 是 npm 官方提供的 npm i文档教程知识库tldr 仓库保加利亚语 todoman 别名页面解析别名文档机制与 todo 命令完整用法tldr 仓库保加利亚语 todoman 别名页面解析别名文档机制与 todo 命令完整用法 todoman 是一个基于命令行的待办事项管理器它在 tldr文档教程知识库tldr 仓库中的 ypchpass 别名页从保加利亚语页面到 FreeBSD chpass 命令全解析tldr 仓库中的 ypchpass 别名页从保加利亚语页面到 FreeBSD chpass 命令全解析 本文以 tldr 仓库中 pages.bg/free文档教程知识库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考