tldr 仓库中的 clhy 别名页:Clear-History 命令的阿拉伯语速查手册解析

原创2026-10-02 19:36:261,727 阅读
文章标签:文档知识库

tldr 仓库中的 clhy 别名页:Clear-History 命令的阿拉伯语速查手册解析

clhy 是 PowerShell 命令 Clear-History 的别名,本仓库在 pages/windows/clhy.md 和 pages.ar/windows/clhy.md 中分别以英文与阿拉伯语记录了该别名页。本文将以这两份别名页为骨架,完整解析其内容、别名页模板规范、阿拉伯语翻译要点,并结合 scripts/set-alias-page.py 的源码揭示别名页从模板生成到多语言同步的底层机制,同时补充 Clear-History 本身的完整用法,帮助你快速清除 PowerShell 会话命令历史。

clhy 是什么:一个指向 Clear-History 的速查别名

在 Windows 的 PowerShell 会话中,clhy 是 Clear-History 的短别名。tldr 仓库为这类"别名命令"维护的是别名页(alias page):页面本身不重复讲解参数,只告诉读者"这个命令是什么的别名"以及"去哪里查看原始命令的文档"。

pages.ar/windows/clhy.md 全文仅三部分,结构完全符合仓库的阿拉伯语别名页模板:

# clhy

> هذا الأمر هو اسم مستعار لـ `Clear-History`.

- إعرض التوثيقات للأمر الأصلي:

`tldr Clear-History`
  • 标题行 # clhy:以命令名本身作为页面标题;
  • 说明行 > هذا الأمر هو اسم مستعار لـ Clear-History.:阿拉伯语声明"此命令是 Clear-History 的别名";
  • 示例行 tldr Clear-History:提示用户通过 tldr 客户端查看原始命令的完整文档。

英文原文页 pages/windows/clhy.md 对应内容为:

# clhy

> This command is an alias of `Clear-History`.

- View documentation for the original command:

`tldr Clear-History`

这一"一句话说明 + 一个 tldr 跳转命令"的极简结构,是 tldr 项目处理别名命令的统一做法:避免为别名重复维护一套参数文档,把维护成本收敛到原始命令页面上。

别名页的模板规范:跨语言的统一契约

别名页并非随意编写,而是严格遵循 contributing-guides/translation-templates/alias-pages.md 中定义的多语言模板。该文件为每个翻译语言(en、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)分别定义了标准化的别名页骨架。

以英文模板为例:

# example

> This command is an alias of `example`.

- View documentation for the original command:

`tldr example`

阿拉伯语模板则对应为:

# example

> هذا الأمر هو اسم مستعار لـ `example`.

- إعرض التوثيقات للأمر الأصلي:

`tldr example`

将 pages.ar/windows/clhy.md 与阿拉伯语模板逐行对比可见:# example 被替换为 # clhy,说明行中的 example 被替换为 Clear-History,示例行中的 tldr example 被替换为 tldr Clear-History。clhy.md 正是该模板的一个精确实例化,这也解释了为什么两个语言版本的页面在结构上完全同构——它们源自同一套模板契约。

源码视角:set-alias-page.py 如何生成与同步别名页

别名页的创建、更新与多语言同步由 scripts/set-alias-page.py 驱动,其中 generate_alias_page_content 函数(见 scripts/set-alias-page.py)实现了模板占位符替换的核心逻辑:

template_command = "example"

# Replace placeholders in template with actual values
result = template_content.replace(template_command, page_content.title, 1)
result = result.replace(template_command, page_content.original_command, 1)
result = result.replace(template_command, page_content.documentation_command)

即对模板中的 example 依次执行三次替换:第一次替换成页面标题(如 clhy),第二次替换成原始命令(如 Clear-History),第三次替换成文档查看命令(如 tldr Clear-History 中的命令名)。AliasPageContent 数据结构(见 scripts/set-alias-page.py)恰好封装了 title、original_command、documentation_command 三个字段,与别名页的三段式结构一一对应。

而 get_alias_command_in_page(见 scripts/set-alias-page.py)则负责反向解析一个现有页面是否为别名页,并通过正则提取原始命令与 tldr 跳转命令——这正是 --sync 模式扫描英文页面、把 clhy 这类别名页同步到 pages.ar 等全部翻译目录的底层依据(见 scripts/set-alias-page.py)。

实际使用时,维护者可通过交互式向导创建或更新单个别名页,也可以将英文别名页批量同步到指定语言:

# 交互式创建/更新单个别名页
python3 scripts/set-alias-page.py -p windows/clhy

# 将英文别名页同步到所有翻译语言
python3 scripts/set-alias-page.py -S

# 仅同步巴西葡萄牙语并暂存改动
python3 scripts/set-alias-page.py -S -l pt_BR

-n/--dry-run 可预览将要产生的改动而不实际写入文件,-s/--stage 会调用 git 暂存被修改的页面;-i/--inexact 则允许忽略精确模板匹配,用于识别非标准的别名页。这些选项在脚本头部 docstring 中有完整说明(见 scripts/set-alias-page.py)。

跟随别名跳转:Clear-History 的完整速查

别名页的关键操作是 tldr Clear-History,它会跳转到原始命令页面 pages/windows/clear-history.md。该页面不仅再次确认"clhy 可作为 Clear-History 的别名",还给出了完整的清除历史用法:

  • 清空当前会话的全部命令历史:
Clear-History
  • 按命令名精确清除(删除包含指定文本的历史条目):
Clear-History -CommandLine "command"
  • 按多个命令名清除:
Clear-History -CommandLine "command1", "command2", ...
  • 按历史条目 ID 清除单条:
Clear-History -Id id_number
  • 按 ID 列表清除多条:
Clear-History -Id id1, id2, ...
  • 清除指定 ID 区间内的所有条目:
Clear-History -Id (start_id..end_id)
  • 演练模式(仅显示将被删除的内容,不实际删除):
Clear-History -WhatIf
  • 执行前要求确认:
Clear-History -Confirm

这些参数都作用于"当前 PowerShell 会话"的命令历史——Clear-History 只清理内存中的会话历史,不会影响持久化的历史记录文件。-WhatIf 与 -Confirm 是 PowerShell 标准的通用安全参数,适合在批量删除前先做安全检查。

小结

登录后查看全文
tldr