企业官网建设流程全解析

• 文档
• 教程
• 知识库

本文围绕 tldr 仓库中阿拉伯语版who命令页（pages.ar/common/who.md）展开，系统讲解 GNU coreutilswho命令的三种核心用法（基础会话列表、全量信息、带表头的全量信息），并剖析 tldr 页面格式规范、阿拉伯语翻译约定（RTL 文本、占位符保留策略）、相关命令引用机制，以及如何用 tldr-lint 校验此类页面。读完本文，你将既能熟练使用who排查登录会话，也能理解 tldr 多语言页面从编写到校验的完整工程链路。

关联文档速览：阿拉伯语 who 页的完整内容

who是 GNU coreutils 套件中的经典命令，用于显示当前登录用户及相关数据（进程、启动时间）。tldr 为它在common平台层级下维护了英文原版（pages/common/who.md）以及包括阿拉伯语在内的多语言译本。

pages.ar/common/who.md全文仅由以下要素组成（这也是所有 tldr 页面的标准骨架）：

该页面结构严格遵循 contributing-guides/style-guide.md 的通用模板：# 命令名+>引用块（描述/参见/更多信息）+-示例描述 + 反引号包裹的示例命令，且示例数控制在 8 条以内。

who 命令三种实战用法深度讲解

基础用法：查看当前登录会话

最简单的形式不带任何参数：

who

输出示例如下（用户名、终端线路、登录时间与来源地址）：

alice pts/0 2026-10-01 09:15 (192.168.1.20) bob pts/1 2026-10-01 10:02 (localhost)

对应描述是「显示用户名，终端线路，和所有当前登录会话的时间」。注意 GNU coreutils 的who不带参数时默认显示当前活跃会话，而带-a/--all时则会包含更多历史与系统信息。

全量信息：-a/--all

who {{[-a|--all]}}

-a（--all）等价于组合启用-b（启动时间）、-d（死进程）、-l（登录进程）、-p（活动进程）、-r（运行级别）、-t（系统时钟变更）、-T（终端状态）等一系列开关，输出所有可用信息。tldr 页面中{{[-a|--all]}}这种花括号写法表示占位符/可选参数：短选项-a与长选项--all语义等价，用户可任选其一，随--all还可搭配--heading。

带表头的全量输出：-aH/--all --heading

who {{[-aH|--all --heading]}}

-H（--heading）为输出增加列标题行，便于阅读表格化信息。tldr 刻意写成-aH合并形式与--all --heading展开形式并用|分隔，正是为了同时展示短选项连写与长选项两种风格。实际输出会先出现：

NAME LINE TIME COMMENT

随后才是各登录会话明细，其中COMMENT列通常显示登录来源或退出时间等备注。

这三个示例正好覆盖了 pages/common/who.md 英文原版的全部内容，阿拉伯语译本与其逐条对应，无任何删减。

参见机制：users、w 与 whoami 的定位差异

who页头部通过> انظر أيضًا: \users`, `w`, `whoami`.` 提示三个相关命令，这是 tldr「参见」机制（contributing-guides/translation-templates/see-also-mentions.md）的典型应用——用一行引文通知用户存在相似或配套命令，便于横向跳转：

• users：只打印当前登录用户的用户名列表，比who更精简；其页面（pages/common/users.md）还演示了按指定文件读取的用法users {{/var/log/wtmp}}。注意users在阿拉伯语目录中暂无对应译本，此时客户端会自动回退到英文原页。
• w：显示谁已登录及其正在运行的进程，并附带负载、CPU 时间等系统信息，是比who信息密度更高的运维利器；其阿拉伯语页（pages.ar/common/w.md）包含 4 个示例（默认输出、指定用户、-h/--no-header去表头、-s/--short精简列）。
• whoami：显示当前有效用户 ID，属于别名页——pages.ar/common/whoami.md 明示「هذا الأمر هو اسم مستعار لـ `id --user --name`」（此命令是id --user --name的别名），并通过tldr id引导用户查看原始命令文档，符合 style-guide.md 的别名页模板。

从源码结构看，这三个页面与who形成了完整的「会话排查工具链」：who看会话、w看进程负载、users看用户名、whoami确认当前身份，彼此通过 See also 交叉引用构成导航闭环。

阿拉伯语翻译的工程约定

pages.ar/common/who.md并非简单直译，其措辞与格式遵循了 tldr 的阿拉伯语翻译规范：

• 描述句式对齐翻译模板：tldr 维护了一份跨语言的常用描述与参数翻译表。例如「عرض …」（显示…）对应 contributing-guides/translation-templates/common-descriptions.md 中 ar 行عرض المساعدة（显示帮助）等固定译法；「انظر أيضًا:」正是 ar 行统一的 See also 模板。
• 占位符保留原样：contributing-guides/translation-templates/common-arguments.md 顶部有一条重要提示：阿拉伯语（ar）与波斯语（fa）页面中的占位符不应翻译，以免造成 RTL（从右到左）文本下花括号内字母顺序颠倒、产生难以阅读的乱序文本。这正是who.md中{{[-a|--all]}}等参数写法与英文版完全一致的原因。
• 「更多信息」链接模板：> لمزيد من التفاصيل:与 contributing-guides/translation-templates/more-info-link.md 中 ar 段落的模板完全吻合，且链接指向 GNU coreutils 官方手册的 who 章节。

这些约定由 scripts/set-more-info-link.py 等脚本工具统一维护，便于批量批量更新多语言页面的链接与模板文本。

页面组织结构与多平台回退机制

who归类在common目录（pages/common、pages.ar/common）而非linux、osx等平台专属目录，意味着该命令在各主流平台行为一致，可被所有平台的 tldr 客户端直接使用。根据 style-guide.md 的「平台差异」说明：若命令在 Windows 与 macOS 等平台存在差异，客户端会优先展示pages/windows、pages/osx等平台版本，否则回退到common通用版本。

仓库中who页面的完整谱系包括：

• 英文原版：pages/common/who.md
• 阿拉伯语版（本文主角）：pages.ar/common/who.md
• 简体中文版：pages.zh/common/who.md（「显示当前登录用户和相关信息（进程，启动时间）」，三示例与阿拉伯语版一一对应）

由于翻译语言众多，tldr 会在部分语言缺少某命令页时自动回退到英文页，保证tldr who在任意客户端都有可用输出。

如何校验与预览此类页面

如果你要修改或新增who这类命令页，tldr 提供了官方校验工具。根据 style-guide.md 与 style-guide.zh.md：

npm install --global tldr-lint tldr-lint path/to/tldr_page.md

该 linter 会在每次 pull request 时自动运行，检查格式（标题与文件名一致性、示例数量、占位符写法、引用块结构等）。本地预览则可用：

tldr --render path/to/tldr_page.md

仓库还配套了 scripts/test.sh、scripts/check-pr.sh 等自动化测试脚本，确保大规模多语言页面在 CI 中持续通过校验——这正是pages.ar/common/who.md这类看似简单的文件背后完整的质量保障体系。

小结

pages.ar/common/who.md以三条示例浓缩了who命令的核心能力（会话列表、全量信息、带表头输出），同时是 tldr 多语言协作模式的微型样本：RTL 语言下的占位符保留策略、标准化的描述/参见/链接模板、common平台的跨平台复用，以及 linter + CI 的格式约束。掌握了它，你就同时掌握了 GNU coreutilswho的日常用法与 tldr 页面贡献的最佳实践。

• 文档
• 教程
• 知识库