文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载本篇指南围绕 tldr 仓库的 common-descriptions.md 展开它是面向 39 种语言翻译者的通用描述术语表。tldr 页面中反复出现的Display help、Display version与[Interactive]三类描述在此统一登记各语言标准译法。读者读完可以掌握这些通用描述在页面中的规范用法、如何按语言查表取词、以及如何借助表格工具安全地维护这张多语言对照表。为什么 tldr 需要一张通用描述翻译表tldr 是一个协作式命令行速查表仓库每个命令页面都由「标题、描述行、若干示例」构成而--help、--version这类示例几乎出现在每一个命令页中。若各语言翻译者各自发挥同一句 Display help 可能在同一语言内出现多种译法破坏术语一致性也增加维护成本。为此style-guide.md 的 Help and version commands 一节明确规定我们通常按顺序将 help 与 version 命令放在页面最后两个示例中以将更实用的命令放在页面开头为保持一致性我们倾向于对这些命令使用通用措辞Display help和Display version。同时对于需要进入交互模式的命令style-guide.md 要求在进入该模式的示例描述中提及 interactive并且交互命令的描述行以[Interactive]开头例如[Interactive] Choose a server:。而 common-descriptions.md 正是为这些被反复使用的措辞提供逐语言的标准翻译让维护者不必逐页搜索比对。模板文件的结构一张按语言行组织的对照表common-descriptions.md 的核心是一张 Markdown 表格表头四列en英文原文、Display help、Display version、[Interactive]每一行一个语言代码及其对应译法空单元格表示该语言此条目的翻译尚未提供如bs、lo、ne、no、pt_PT、sr、uk多列为空文件共覆盖 39 种语言ar、bg、bn、bs、ca、cs、da、de、el、es、fa、fi、fr、hi、id、it、ja、ko、lo、ml、nb、ne、nl、no、pl、pt_BR、pt_PT、ro、ru、si、sr、sv、ta、th、tr、uk、uz、zh、zh_TW。这与仓库的页面目录结构一一对应仓库根目录下以pages.语言代码命名的目录如 pages.fr、pages.zh、pages.pt_BR共同构成了多语言页面体系scripts/_common.py 中的get_pages_dirs()正是通过扫描pages前缀目录来发现全部语言。完整对照表common-descriptions.md 原文下表完整继承自 common-descriptions.md翻译页面时可直接查表取词enDisplay helpDisplay version[Interactive]arعرض المساعدةعرض الإصدار[تفاعلية]bgПоказване на помощПоказване на версия[Интерактивен]bnসাহায্য প্রদর্শনভার্সন দেখুন[ইন্টার্যাকটিভ]bscaMostra ajudaMostra la versiócsZobrazit nápověduZobrazit verzi[Interaktivní]daVis hjælpVis versiondeZeige Hilfe anZeige Version anelΕμφάνιση ΒοήθειαςΕμφάνιση ΈκδοσηςesMuestra la ayudaMuestra la versión[Interactivo]faنمایش راهنماfiNäytä ohjeNäytä versio[Interaktiotila]frAffiche laideAffiche la version[Interactif]hiमदद प्रदर्शित करेंसंस्करण दिखाएंidTampilkan bantuanTampilkan versi[Interaktif]itMostra laiutoControlla la versione[Interattivo]jaヘルプを表示するバージョンを表示[対話的]ko도움말 표시버전 표시[대화형]lomlസഹായം കാണിക്കുകപതിപ്പ് കാണിക്കുക[ഇൻററാക്ടീവ്]nbVis hjelpVis versjon[Interaktivt]nenlToon de helpToon de versie[Interactief]noplWyświetl pomocWyświetl wersję[Interaktywne]pt_BRMostra ajudaMostra versão[Interativo]pt_PTroAfișare ajutorAfișare versiune[Interactiv]ruПоказать справкуПоказать версию[Интерактивно]siඋදව් දැක්වීමඅනුවාදය දැක්වීම[අන්තර් ක්රියාකාරී]srsvVisa hjälpenVisa versionen[Interaktiv]taஉதவியைக் காட்டுபதிப்பைக் காட்டு[ஊடாடும் கட்டளை]thแสดงวิธีใช้งานแสดงเวอร์ชัน[อินเทอร์แอคทีฟ]trYardımı görüntüleSürümü görüntüle[Etkileşimli]ukuzYordamni korsatishVersiyani korsatish[Interaktiv]zh显示帮助显示版本[交互式]zh_TW顯示說明顯示版本[互動式]三种通用描述的语义与页面用法Display help帮助示例的标准措辞按 style-guide.md 的约定帮助示例应放在页面倒数第二个位置且使用通用措辞。在中文页面zh中对应 显示帮助这在 pages.zh/common 下的页面中得到大量应用例如pages.zh/common/3d-ascii-viewer.md 第 26 行pages.zh/common/a2ping.md 第 30 行pages.zh/common/btop.md 第 32 行页面中对应片段形如- 显示帮助 command --helpDisplay version版本示例的标准措辞同样地版本示例应放在页面最后一个位置中文译作 显示版本zh_TW 为 顯示版本。与Display help不同部分语言至今尚未提供该条目译法如fa、pt_PT此时可在查表后自行补译并回填到模板中。[Interactive]交互模式的描述标记style-guide.md 对交互模式的定义是命令本身进入一个子环境运行命令、且提示符无法访问$PATH中的程序。进入该模式的示例需要在进入交互模式的示例描述中明确提及 interactive交互式命令的描述行以[Interactive]开头标记。例如英语写为[Interactive] Choose a server:中文对应 「[交互式] 选择服务器」zh_TW 为[互動式]。如何安全地维护这张多语言表格common-descriptions.md 自带官方建议的工作流——使用 tableconvert.com 进行可视化编辑导入将当前表格粘贴导入编辑在 WYSIWYG 编辑器中增删语言行、补全空单元格导出导出为 Markdown 表格并替换文件内容。同时文档特别提醒一个导出后遗症表头的左对齐会被丢失需要手动恢复即把|----改回|:---。这是 Markdown 表格语法的一部分|---与|:---分别表示默认对齐与左对齐客户端渲染时对齐方式会影响显示效果。通用描述模板在仓库脚本中的消费方式翻译模板并不是孤立文档仓库中的维护脚本会直接解析它们。scripts/_common.py 的get_templates()读取contributing-guides/translation-templates/文件名按###语言标题解析出每种语言的模板文本供各脚本复用template_file root / contributing-guides/translation-templates / filename with template_file.open(encodingutf-8) as f: lines f.readlines()例如 scripts/set-more-info-link.py 会加载more-info-link.md中的逐语言 More information 链接模板用真实链接替换https://example.com占位符后写回页面scripts/set-alias-page.py 则加载alias-pages.md模板生成别名页面。可见contributing-guides/translation-templates 目录下的每份模板含 common-arguments.md、alias-pages.md、more-info-link.md都是脚本自动化的数据源而 common-descriptions.md 主要面向人工翻译参考。配套的 common-arguments.md 则负责另一类通用元素——命令示例中的占位符如path/to/file、username、port、value的逐语言翻译两者配合可覆盖页面中几乎全部的高频文本。该文件还附有一条重要注意事项阿拉伯语ar和波斯语fa页面中的占位符不应翻译以避免从右到左文本渲染时产生倒置错乱。翻译与校验实践建议先查表后动手编写任何语言的帮助、版本、交互描述前先对照上表确认已有标准译法空白单元格则代表待翻译条目可在提交中一并补全。遵循各语言的独立规范style-guide.md 还针对具体语言规定了语法细节如法语描述需用第三人称直陈式现在时、葡萄牙语示例描述须以第三人称动词开头、中文需注意中英文混排空格与全角标点等通用描述应在此框架内使用。用 linter 校验页面格式由 linter 强制约束可通过tldr-lint本地校验详情见 style-guide.md 的 There is a linter 小节。不要机器批量改动style-guide.md 明确要求只翻译自己能够自信阅读与校对的语言避免对不熟悉的语言进行机器生成或批量编辑。通过这张统一术语表tldr 的数十种语言页面得以在帮助 / 版本 / 交互三个高频场景上保持措辞一致这也是 tldr 多语言协作体系能够低摩擦运转的关键细节之一。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐OpenMetadata 血缘Lineage标准实践指南从查询日志解析到精准血缘图的完整实现OpenMetadata 血缘Lineage标准实践指南从查询日志解析到精准血缘图的完整实现 导读 血缘Lineage是 OpenMetadata 数文档教程知识库QtScrcpy文档翻译指南多语言文档维护最佳实践QtScrcpy文档翻译指南多语言文档维护最佳实践 你是否曾因软件界面语言不通而放弃使用一款优秀工具作为Android实时投屏软件QtScrcpy的贡献者桌面应用音视频终极前端监控指南如何使用 Heimdallr-SDK 快速构建企业级监控系统终极前端监控指南如何使用 Heimdallr SDK 快速构建企业级监控系统 在前端开发中你是否经常遇到这样的问题用户反馈页面崩溃了但你却无法复现❓线上上一篇嵌入式Rust贡献完全指南如何为awesome-embedded-rust提交专业PR下一篇Obsidian Zotero集成插件5分钟打造高效学术写作工作流创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 tldr 翻译模板指南：common-descriptions.md 通用描述术语的多语言维护实践
文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载本篇指南围绕 tldr 仓库的 common-descriptions.md 展开它是面向 39 种语言翻译者的通用描述术语表。tldr 页面中反复出现的Display help、Display version与[Interactive]三类描述在此统一登记各语言标准译法。读者读完可以掌握这些通用描述在页面中的规范用法、如何按语言查表取词、以及如何借助表格工具安全地维护这张多语言对照表。为什么 tldr 需要一张通用描述翻译表tldr 是一个协作式命令行速查表仓库每个命令页面都由「标题、描述行、若干示例」构成而--help、--version这类示例几乎出现在每一个命令页中。若各语言翻译者各自发挥同一句 Display help 可能在同一语言内出现多种译法破坏术语一致性也增加维护成本。为此style-guide.md 的 Help and version commands 一节明确规定我们通常按顺序将 help 与 version 命令放在页面最后两个示例中以将更实用的命令放在页面开头为保持一致性我们倾向于对这些命令使用通用措辞Display help和Display version。同时对于需要进入交互模式的命令style-guide.md 要求在进入该模式的示例描述中提及 interactive并且交互命令的描述行以[Interactive]开头例如[Interactive] Choose a server:。而 common-descriptions.md 正是为这些被反复使用的措辞提供逐语言的标准翻译让维护者不必逐页搜索比对。模板文件的结构一张按语言行组织的对照表common-descriptions.md 的核心是一张 Markdown 表格表头四列en英文原文、Display help、Display version、[Interactive]每一行一个语言代码及其对应译法空单元格表示该语言此条目的翻译尚未提供如bs、lo、ne、no、pt_PT、sr、uk多列为空文件共覆盖 39 种语言ar、bg、bn、bs、ca、cs、da、de、el、es、fa、fi、fr、hi、id、it、ja、ko、lo、ml、nb、ne、nl、no、pl、pt_BR、pt_PT、ro、ru、si、sr、sv、ta、th、tr、uk、uz、zh、zh_TW。这与仓库的页面目录结构一一对应仓库根目录下以pages.语言代码命名的目录如 pages.fr、pages.zh、pages.pt_BR共同构成了多语言页面体系scripts/_common.py 中的get_pages_dirs()正是通过扫描pages前缀目录来发现全部语言。完整对照表common-descriptions.md 原文下表完整继承自 common-descriptions.md翻译页面时可直接查表取词enDisplay helpDisplay version[Interactive]arعرض المساعدةعرض الإصدار[تفاعلية]bgПоказване на помощПоказване на версия[Интерактивен]bnসাহায্য প্রদর্শনভার্সন দেখুন[ইন্টার্যাকটিভ]bscaMostra ajudaMostra la versiócsZobrazit nápověduZobrazit verzi[Interaktivní]daVis hjælpVis versiondeZeige Hilfe anZeige Version anelΕμφάνιση ΒοήθειαςΕμφάνιση ΈκδοσηςesMuestra la ayudaMuestra la versión[Interactivo]faنمایش راهنماfiNäytä ohjeNäytä versio[Interaktiotila]frAffiche laideAffiche la version[Interactif]hiमदद प्रदर्शित करेंसंस्करण दिखाएंidTampilkan bantuanTampilkan versi[Interaktif]itMostra laiutoControlla la versione[Interattivo]jaヘルプを表示するバージョンを表示[対話的]ko도움말 표시버전 표시[대화형]lomlസഹായം കാണിക്കുകപതിപ്പ് കാണിക്കുക[ഇൻററാക്ടീവ്]nbVis hjelpVis versjon[Interaktivt]nenlToon de helpToon de versie[Interactief]noplWyświetl pomocWyświetl wersję[Interaktywne]pt_BRMostra ajudaMostra versão[Interativo]pt_PTroAfișare ajutorAfișare versiune[Interactiv]ruПоказать справкуПоказать версию[Интерактивно]siඋදව් දැක්වීමඅනුවාදය දැක්වීම[අන්තර් ක්රියාකාරී]srsvVisa hjälpenVisa versionen[Interaktiv]taஉதவியைக் காட்டுபதிப்பைக் காட்டு[ஊடாடும் கட்டளை]thแสดงวิธีใช้งานแสดงเวอร์ชัน[อินเทอร์แอคทีฟ]trYardımı görüntüleSürümü görüntüle[Etkileşimli]ukuzYordamni korsatishVersiyani korsatish[Interaktiv]zh显示帮助显示版本[交互式]zh_TW顯示說明顯示版本[互動式]三种通用描述的语义与页面用法Display help帮助示例的标准措辞按 style-guide.md 的约定帮助示例应放在页面倒数第二个位置且使用通用措辞。在中文页面zh中对应 显示帮助这在 pages.zh/common 下的页面中得到大量应用例如pages.zh/common/3d-ascii-viewer.md 第 26 行pages.zh/common/a2ping.md 第 30 行pages.zh/common/btop.md 第 32 行页面中对应片段形如- 显示帮助 command --helpDisplay version版本示例的标准措辞同样地版本示例应放在页面最后一个位置中文译作 显示版本zh_TW 为 顯示版本。与Display help不同部分语言至今尚未提供该条目译法如fa、pt_PT此时可在查表后自行补译并回填到模板中。[Interactive]交互模式的描述标记style-guide.md 对交互模式的定义是命令本身进入一个子环境运行命令、且提示符无法访问$PATH中的程序。进入该模式的示例需要在进入交互模式的示例描述中明确提及 interactive交互式命令的描述行以[Interactive]开头标记。例如英语写为[Interactive] Choose a server:中文对应 「[交互式] 选择服务器」zh_TW 为[互動式]。如何安全地维护这张多语言表格common-descriptions.md 自带官方建议的工作流——使用 tableconvert.com 进行可视化编辑导入将当前表格粘贴导入编辑在 WYSIWYG 编辑器中增删语言行、补全空单元格导出导出为 Markdown 表格并替换文件内容。同时文档特别提醒一个导出后遗症表头的左对齐会被丢失需要手动恢复即把|----改回|:---。这是 Markdown 表格语法的一部分|---与|:---分别表示默认对齐与左对齐客户端渲染时对齐方式会影响显示效果。通用描述模板在仓库脚本中的消费方式翻译模板并不是孤立文档仓库中的维护脚本会直接解析它们。scripts/_common.py 的get_templates()读取contributing-guides/translation-templates/文件名按###语言标题解析出每种语言的模板文本供各脚本复用template_file root / contributing-guides/translation-templates / filename with template_file.open(encodingutf-8) as f: lines f.readlines()例如 scripts/set-more-info-link.py 会加载more-info-link.md中的逐语言 More information 链接模板用真实链接替换https://example.com占位符后写回页面scripts/set-alias-page.py 则加载alias-pages.md模板生成别名页面。可见contributing-guides/translation-templates 目录下的每份模板含 common-arguments.md、alias-pages.md、more-info-link.md都是脚本自动化的数据源而 common-descriptions.md 主要面向人工翻译参考。配套的 common-arguments.md 则负责另一类通用元素——命令示例中的占位符如path/to/file、username、port、value的逐语言翻译两者配合可覆盖页面中几乎全部的高频文本。该文件还附有一条重要注意事项阿拉伯语ar和波斯语fa页面中的占位符不应翻译以避免从右到左文本渲染时产生倒置错乱。翻译与校验实践建议先查表后动手编写任何语言的帮助、版本、交互描述前先对照上表确认已有标准译法空白单元格则代表待翻译条目可在提交中一并补全。遵循各语言的独立规范style-guide.md 还针对具体语言规定了语法细节如法语描述需用第三人称直陈式现在时、葡萄牙语示例描述须以第三人称动词开头、中文需注意中英文混排空格与全角标点等通用描述应在此框架内使用。用 linter 校验页面格式由 linter 强制约束可通过tldr-lint本地校验详情见 style-guide.md 的 There is a linter 小节。不要机器批量改动style-guide.md 明确要求只翻译自己能够自信阅读与校对的语言避免对不熟悉的语言进行机器生成或批量编辑。通过这张统一术语表tldr 的数十种语言页面得以在帮助 / 版本 / 交互三个高频场景上保持措辞一致这也是 tldr 多语言协作体系能够低摩擦运转的关键细节之一。赞分享文档教程知识库【免费下载链接】tldrCollaborative cheatsheets for console commands .项目地址https://gitcode.com/GitHub_Trending/tl/tldr点击查看免费下载相关推荐OpenMetadata 血缘Lineage标准实践指南从查询日志解析到精准血缘图的完整实现OpenMetadata 血缘Lineage标准实践指南从查询日志解析到精准血缘图的完整实现 导读 血缘Lineage是 OpenMetadata 数文档教程知识库QtScrcpy文档翻译指南多语言文档维护最佳实践QtScrcpy文档翻译指南多语言文档维护最佳实践 你是否曾因软件界面语言不通而放弃使用一款优秀工具作为Android实时投屏软件QtScrcpy的贡献者桌面应用音视频终极前端监控指南如何使用 Heimdallr-SDK 快速构建企业级监控系统终极前端监控指南如何使用 Heimdallr SDK 快速构建企业级监控系统 在前端开发中你是否经常遇到这样的问题用户反馈页面崩溃了但你却无法复现❓线上上一篇嵌入式Rust贡献完全指南如何为awesome-embedded-rust提交专业PR下一篇Obsidian Zotero集成插件5分钟打造高效学术写作工作流创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考