recursion recursion RTFM read the f*'ing manual humor humor RTFM 请仔细阅读本章。本章描述了必须遵循的约定，例如命名约定。 XML 标记 命名约定 命名约定 后面您将看到这样的 ID 命名。它们有助于理解这些命名的含义。例如： <chapter id="ch-uniquename"> <sect3="s3-install-make-disks"> <figure id="fig-redhat-config-kickstart-basic"> ID 是独一无二的标识符，使得 DocBook XML 得知如何交叉参考章、节等等。 定义 ID 的一般规则如下： XML 标记 定义 ID 的规则 命名约定 定义 ID 的规则 至多使用 32 个字母 (这里指的是引号中所有内容) 尽量短小而简单 确保命名与内容相关 (使它可辨识) 例如，"ch-uniquename" (有 13 个字母) 以及 "s3-install-make-disks" (有 21 个字母)。 特定一章中的小节应当在 ID 中包含这一章的名称 (这一章的 ID 去掉 "ch-")。例如，您在撰写 "ch-intro" 一章，需要将有关磁盘分区的内容作为第一节时，小节 ID 将类似于 "s1-intro-partition"，它包含了小节编号，这一章的 ID 以及这一节的独一无二的 ID。 标记 前缀 前言 pr- chapter ch- 节 sn- 第一节 s1- 第二节 s2- 第三节 s3- 第四节 s4- figure fig- table tb- 附录 ap- part pt- example ex- 所有文件必须包含 CVS Id 头部。 如果您创建了一个新文件，第一行必须是： <!-- $Id: --> 它被提交到 CVS 中时 (在每次提交时)，这一行都会自动更新，以包含关于文件的信息。例如： <!-- $Id: --> 提示 XML 标记 警告 XML 标记 技巧 XML 标记 注意 XML 标记 小心 XML 标记 重要 XML 标记 提示 警告 XML 标记 提示 技巧 XML 标记 提示 注意 XML 标记 提示 小心 XML 标记 提示 重要 DocBook 中有五种提示类型：小心，重要，注意，技巧和警告。 所有提示都有类似的结构：可选的标题，随后是段落级的元素。DocBook DTD 没有定义每种提示的特殊语义。例如，DocBook 并未规定警告必须用于可能造成重大损失的情况。 XML 标记 注意 XML 标记 技巧 XML 标记 小心 XML 标记 重要 XML 标记 警告 有很多方法来使文档中的文本引人注意。Note 用于显示附加信息。Tip 用于显示完成任务的其他方法。Caution 用于告诫用户在尝试某一步时必须小心。Important 用于提醒用户不可忽视的信息，尽管用户动作不受影响，但是必须提醒用户信息的重要性。Warning 用于提醒读者，他们的设置将被修改或变动，例如文件将被删除，如果他们在意这一后果，就不应继续动作。 下列代码将展示上面每种情况的写法，同时也展示了 HTML 显示效果。 <note> <title>注意</title> <para>文本内容</para> </note> 文本内容 <tip> <title>技巧</title> <para>文本内容</para> </tip> 文本内容 <caution> <title>小心</title> <para>文本内容</para> </caution> 文本内容 <important> <title>重要</title> <para>文本内容</para> </important> 文本内容 <warning> <title>警告</title> <para>文本内容</para> </warning> 文本内容 屏幕截图 如何截取 屏幕快照 屏幕截图 屏幕抓图 屏幕截图 有两种类型的屏幕截图：图象和文本。选择它们的原则是 尽量使用文本截图。这意味着，如果您可以用文本而不是图象来表达，那么就用文本。GUI 的图象截图可以首先引入一些对象，然后用文字加以描述，但是您不会总是为每一步都创建一副截图。 这样选择的主要目的是文本块通常比占据相同空间的图象包含更多信息。这和具体图象有关，某个场景的准确的截图也许抵得上一千字的效果。GUI 的截图通常有很大空白，只包含很少元素，这样便于描述或列举。 截取图象的步骤本身表明了，使用文字来描述一个过程比起一系列的屏幕截图要精确许多。 图象截图 设置主题为默认主题。这样读者会熟悉这一外观，也使得 &FDP; 文档显得一致。从菜单中，选择 Preferences, Theme 然后选 Bluecurve (&FC; 4 不再使用 Bluecurve)。 设置字体为默认值。从菜单中，选择 Preferences, Fonts. 然后设置 Application font 和 Desktop font 为 Sans Regular 10。设置 Window Title font 为 Sans Bold 10。设置 Terminal font 为 Monospace Regular 10。 在截图之前，试着将目标 GUI 元素调整到尽可能小。您的目标应当是 500 像素或更小。如果您需要截取超过一个 GUI 元素，可以按照下面的步骤来缩放图象。 要截取图象，使用鼠标选择 GUI 元素，将它放到最前，或者调整元素排列。按下 AltPrint Screen 来截取单个 GUI 窗口。要抓去整个桌面，按下 Print Screen。如果您要截取包含很多元素的图象，并已将它们靠近，那么还可以在 The GIMP 中裁减结果图象到适当大小。截取的图象将是 PNG 格式。 如果需要，您可以使用 The GIMP 缩放图象。打开图象，在图象上点击右键，选择 Image -> Scale Image...。保持长宽比不变，设置 New Width 为 500 px，然后点击 OK。记住在转换为 EPS 之前按下 Ctrls 保存图象。 仍使用 The GIMP 编辑图象，在图象上点击右键，选择 File -> Save As...。在 Determine File Type: 列表中，选择 PostScript，然后点击 OK。点击 Export，允许平整图象。 在 Save as PostScript 窗口，选择 Encapsulated PostScript，然后点击 OK。 关于如何在 XML 中调用图象，请参考 。 文本截图 文本的屏幕信息对读者也很有用。如果您可以同时用图象和文本截图描述某个功能，就不要同时包含它们，除非忽略任何一个都将使描述不清楚。您应当使得信息更加通用。忽略用户名和主机名信息，区分用户的输入与示例的输出。在 screen 标记中，用户输入应当包含在 userinput 标记内，而用户看到的输出应当包含在 computeroutput 标记内。例如， 的用法应该改为这样 ps ax | grep ssh 2564 ? S 0:23 /usr/sbin/sshd 3092 ? S 0:00 /usr/bin/ssh-agent /etc/X11/xinit/Xclients 8235 ? S 0:00 ssh -Nf rocky@philadelphia.net -L 6667:localhost 17223 pts/0 S 0:00 ssh rbalboa@core-router7 17227 pts/2 S 0:10 ssh rbalboa@smbshare2 21113 pts/7 S 1:19 ssh rocky@xxx.private 要显示所有当前活动的 ssh 会话，执行下列命令： ps ax | grep ssh 输出将类似于： 2564 ? S 0:23 /usr/sbin/sshd 3092 ? S 0:00 /usr/bin/ssh-agent /etc/X11/xinit/Xclients 8032 pts/0 S 0:00 ssh user@host.example.com 8032 pts/1 S 0:00 ssh root@backup.example.com 关于 screen 标记，请参考 。 images 图表 创建 待编辑