vii. 排版约定

为了您能更容易地跟上进度,首先说明本书的排版惯例。 本节包含本书中若干排版格式的示例。

./configure --prefix=/usr

类似上面这样排版的文本应该被绝对准确地输入,除非上下文另有说明。 在解释命令的含义时,我们也用这种格式引用被解释的命令。

某些情况下,我们会将逻辑上的一行文本拆分成两行或多行, 此时行末会添加一个反斜线。

CC="gcc -B/usr/bin/" ../binutils-2.18/configure \
  --prefix=/tools --disable-nls --disable-werror

注意反斜线后面必须紧跟回车。反斜线后如果存在空格和制表符之类的空白字符, 将会得到不正确的结果。

install-info: unknown option '--dir-file=/mnt/lfs/usr/info/dir'

以上文本(等宽字体)展示屏幕输出,一般是某个命令运行的结果。 等宽字体也被用于显示文件名,例如 /etc/ld.so.conf

强调文本

这样的文本在书中有一些不同目的。主要目的是强调重点。

http://www.linuxfromscratch.org/

以上格式被用于超链接,无论是链接到 LFS 社区内还是社区外。 链接可能指向教程、下载链接或其他网站。

cat > $LFS/etc/group << "EOF"
root:x:0:
bin:x:1:
......
EOF

以上格式被用于创建配置文件。第一行指令告诉系统,创建文件 $LFS/etc/group 并把用户输入的所有东西写入文件内容, 直到用户输入文件结束符 (EOF) 。因此,这些文本一般按原状输入。

<需要替换的文本>

尖括号包含的文本不应该直接输入,而应该替换成合适内容。 在复制粘贴到命令行时要注意替换。

[可选的文本]

方括号包含的文本是可选的,根据您的需要决定是否输入。

passwd(5)

以上格式被用于引用特定的手册 (man) 页面。数字表明系统手册中的某一节。例如, passwd 有两个 man 页面。LFS 安装命令将会把它们安装在 /usr/share/man/man1/passwd.1/usr/share/man/man5/passwd.5。当本书使用 passwd(5) 时,我们特指 /usr/share/man/man5/passwd.5man passwd 会显示它找到的第一个匹配passwd 的 man 页面,即 /usr/share/man/man1/passwd.1。 对于本例,您需要执行 man 5 passwd 才能阅读指定的 man 页面。 多数 man 页面在各个章节中并不存在重名,因此 man <program name> 一般是足够的。

[注意]

译注

这是一个译注,就是原文中并不存在,由译者添加的额外说明。 注意原文有时也使用这种框, 只有标题是译注的框才是译注。