序言

写作本文档时，遵循下列指导原则。

	警告
	阅读本文档，你需要通过自己的努力去查找本文档未提及的问题答案。本文档仅仅提供有效的起点。

你必须自己从以下原始材料查找解决方案。

本文通过如下使用 bash(1) shell 命令例子的简要方式来提供信息。

# command-in-root-account
$ command-in-user-account

这些 shell 提示符区分了所使用的帐户。为了可读性，在本手册中 shell 提示符相关的环境变量被设置为“PS1='\$'”和“PS2=' '。这与实际安装的系统所使用的 shell 提示符很有可能会不同。

所有的命令示例都是运行在英语语言环境“LANG=en_US.UTF8”下的。请不要期望命令示例中像 command-in-root-account 和 command-in-user-account 这样的占位符会被翻译。这么做是为了保持所有翻译示例都是最新的。

	注意
	参见在 bash(1) 中对环境变量 “$PS1” 和 “$PS2” 的解释。

要求系统管理员执行的操作，须用祈使句描述，如“在 shell 中输入命令字符串后，键入 Enter 键。”

这些描述列或类似信息在表格有一个名词短语，后面会紧跟软件包短描述，这些短语会省略掉前面的"a"和"the"。它们也可以包含一个不定式短语作名词短语，在联机帮助的短命令描述约定后面不带 "to"。有些人可能觉得这看起来有点可笑，这里故意保留这种风格是为了让文档看起来尽可能的简单。这些名词短语在短命令描述约定里并不会采用首字母大写的方式。

在文本段落中引用的命令片断由双引号括起来的打印机字体进行标记，就像"aptitude safe-upgrade"。

在文本段落中引用的来自配置文件的文本数据由双引号括起来的打印机字体进行标记，就像"deb-src"。

命令和置于其后的圆括号内的手册页章节数（可选），由打字机字体进行标记，就像 bash(1)。我们鼓励您这样通过输入以下命令来获得信息。

$ man 1 bash

manpage 会在打字机字体后面括号中显示 manpage 页章节号，如 sources.list(5)。建议你通过键入以下命令来获取帮助信息。

$ man 5 sources.list

info page 页是由双引号之间的打字机字体来标注，如 info make。建议你通过键入以下的命令来获取帮助信息。

$ info make

文件名将由双引号括起来的打印机字体进行标记，就像 "/etc/passwd"。对于配置文件，你可以输入下列的命令来获取它的信息。

$ sensible-pager "/etc/passwd"

目录名将由双引号括起来的打印机字体进行标记，就像 "/etc/apt"。你可以输入下列的命令来浏览目录的内容。

$ mc "/etc/apt/"

软件包名称将由打印机字体进行标记，就像 vim。你可以输入下列的命令来获取它的信息。

$ dpkg -L vim
$ apt-cache show vim
$ aptitude show vim

一个文档可能通过文件名来指示它的位置，文件名将由双引号括起来的打印机字体进行标记，就像"/usr/share/doc/base-passwd/users-and-groups.txt.gz"和" /usr/share/doc/base-passwd/users-and-groups.html "，或通过它的 URL，就像 https://www.debian.org。你可以通过输入下列命令来阅读文档。

$ zcat "/usr/share/doc/base-passwd/users-and-groups.txt.gz" | sensible-pager
$ sensible-browser "/usr/share/doc/base-passwd/users-and-groups.html"
$ sensible-browser "https://www.debian.org"

环境变量将由双引号括起来的打印机字体进行标记，并带有 "$" 前缀，就像 "$TERM"。你可以输入下列命令来获取它的当前值。

$ echo "$TERM"

popcon 数据被用来客观地衡量每个包的流行度。它的下载时间为 2024-01-25 09:08:50 UTC，包含了超过 196182 个二进制软件包和 27 个架构的全部 233460 份提交。

以“V:”开头表示“votes”的 popcon 数值计算方式为“1000 * （当前运行在 PC 上的包的 popcon 提交）/ （总的 popcon 提交）”。

以“I:”开头表示“安装数”的 popcon 数值计算方式为“1000 * （当前安装在 PC 上的包的 popcon 提交）/ （总的 popcon 提交）”。

软件包的大小数据同样表明了对每个包的客观衡量。它基于“apt-cache show”或“aptitude show”命令（目前在amd64 架构的不稳定版）报告的“安装大小”。报告的大小单位是 KiB（Kibibyte=表示 1024 Bytes 的单位）。

如果你发现本文档有任何问题，请使用 reportbug(1) 向 debian-reference 软件包报告 bug。对纯文件版本或源代码的改进建议，请使用 "diff -u" 包含在 bug 报告里面。