path: root/docs-xml-tags-zh_CN.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Id: docs-xml-tags-zh_CN.xml,v 1.2 2005/12/17 13:28:38 bbbush Exp $ --><chapter id="ch-xml-tags">
  <title>DocBook XML 标记</title>
  <indexterm>
    <primary>XML</primary>
    <secondary>标记</secondary>
    <see>XML 标记</see>
  </indexterm>
  <para>请仔细阅读这一章。这一章描述了 Docs Project 使用的标记。一些规则是 Docs Project 特定的。</para>
  <para>如果这些标记运用合适，搜索文档时可以得到有意义的结果。这些标记帮助搜索引擎确认与搜索条件相关的信息。另一个好处是使 &PROJECT; 文档拥有相同的外观。(不过，由于输出格式不同，外观仍然会有一些区别。)</para>
  <indexterm>
    <primary>XML</primary>
    <secondary>标记概要</secondary>
  </indexterm>
  <para>XML 中所有标记必须有开标记和闭标记。另外，按照惯例，章、节、图象、表格等必须有唯一的标识符，这样可以被正确标识，需要的话也可以交叉引用。</para>
  <para>尽管 XML 可以处理很多文档形式，这里介绍的只是 article 一种。</para>
  <para>本章只介绍 &PROJECT; 文档使用的标记，并不是所有可用的 DocBook XML 标记。完整的列表请参考：</para>
  <screen>
    <computeroutput>
      <ulink url="http://www.docbook.org/tdg/en/html/docbook.html">http://www.docbook.org/tdg/en/html/docbook.html</ulink>
    </computeroutput>
  </screen>
  <sect1 id="s1-xml-tags-caveats">
    <title>标记和实体警告</title>
    <indexterm>
      <primary>xml 标记</primary>
      <secondary>警告</secondary>
    </indexterm>
    <para>应当牢记本节的警告。它们比有效的 DocBook XML 更加严格，这些规则的存在，是为了使 HTML 和 PDF 输出看起来更合适。</para>
    <variablelist>
      <varlistentry>
        <term>不要使用商标实体</term>
        <listitem>
          <para>不要使用商标实体 &amp;trade;, &amp;copy;, 或 &amp;reg; 因为它们无法为所有字符集产生 HTML 输出。这些实体产生的 HTML 输出定义在 DTD 中，无法通过样式表改变。</para>
          <para>应当使用 <command>trademark</command> 标记以及相关类别，如下所示：</para>
          <itemizedlist>
            <listitem>
              <para>&lt;trademark&gt;其后是商标符号&lt;/trademark&gt;</para>
            </listitem>
            <listitem>
              <para>&lt;trademark class="registered"&gt;其后是注册商标符号&lt;/trademark&gt;</para>
            </listitem>
            <listitem>
              <para>&lt;trademark class="copyright"&gt;其后是版权符号&lt;/trademark&gt;</para>
            </listitem>
          </itemizedlist>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <command>para</command> 标记中的内容</term>
        <listitem>
          <para>除非是文本段落，否则不要使用 <command>para</command>。这个标记在 PDF 中，会使其间的文本包含多余的空白。</para>
          <para>特别的，在下列标记之外不要使用 <command>para</command> (换句话说，不要把下列标记包含在 <command>para</command> 中)：</para>
          <itemizedlist>
            <listitem>
              <para>&lt;screen&gt;</para>
            </listitem>
            <listitem>
              <para>&lt;itemizedlist&gt;</para>
            </listitem>
            <listitem>
              <para>&lt;orderedlist&gt;</para>
            </listitem>
            <listitem>
              <para>&lt;variablelist&gt;</para>
            </listitem>
            <listitem>
              <para>&lt;table&gt;</para>
            </listitem>
          </itemizedlist>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>包含在 <command>para</command> 标记中的 <command>listitem</command></term>
        <listitem>
          <para>包含在 <command>para</command> 中的 <command>listitem</command> 标记 <emphasis>必须</emphasis> 紧挨 &lt;para&gt; 的开始标记，以避免 PDF 中的多余空白。</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>包含在 <command>screen</command> 标记中的内容</term>
        <listitem>
          <para>XML 文件中，<command>screen</command> 标记 (&lt;screen&gt; 和 &lt;/screen&gt;) <emphasis>必须</emphasis> 靠左对齐，<command>screen</command> 包含的内容必须同样靠左对齐，除非有意留出空白。否则，多余的空白将出现在 HTML 中。</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect1>
  <sect1 id="s1-xml-tags-application">
    <title>
      <command>application</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>application</secondary>
    </indexterm>
    <para>application 是图形界面应用程序的名字。command 是一个可执行的程序，或者运行应用程序的命令。</para>
    <para>
      <command>&lt;application&gt;</command> 和 <command>&lt;/application&gt;</command> 标记使您可以引用应用程序。例如，下面的 XML：</para>
    <screen>
      <computeroutput>
要在 Linux 中访问 Web，您可以使用
&lt;application&gt;Mozilla&lt;/application&gt; 或
&lt;application&gt;lynx&lt;/application&gt;，如果您只需要字符界面的话。
</computeroutput>
    </screen>
    <para>产生如下输出：</para>
    <para>要在 Linux 中访问 Web，您可以使用
<application>Mozilla</application> 或 
<application>lynx</application>，如果您只需要字符界面的话。</para>
  </sect1>
  <sect1 id="s1-xml-tags-chapter">
    <title>
      <command>chapter</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>chapter</secondary>
    </indexterm>
    <para>一篇 DocBook 文档可以划分为多章，类似：</para>
    <screen>
      <computeroutput>
  &lt;chapter id="ch-sample"&gt;
    &lt;title&gt;示例章&lt;/title&gt;

    &lt;para&gt;这是示例章，显示了用于创建章、节和小节的 XML 标记。&lt;/para&gt;
    
  &lt;/chapter&gt;
</computeroutput>
    </screen>
    <para>chapter 还可以进一步划分为节 (<command>sect1</command>, <command>sect2</command>, <command>sect3</command> 等等)。请参考 <xref linkend="s1-xml-tags-sections"/>。</para>
  </sect1>
  <sect1 id="s1-xml-tags-citetitle">
    <title>
      <command>citetitle</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>citetitle</secondary>
    </indexterm>
    <para>
      <command>&lt;citetitle&gt;</command>标记用来格式化一个特别的引用 (引用标题可以自行输入，也可以使用实体<footnote><para>实体是引用其他手册或教程的快捷方式。它可以在主控文档中定义，对于特定的文档集合，也可以在 DTD 引用的文件中定义。</para></footnote>，如果在文档中已经定义的话)。</para>
    <para>例如：</para>
    <screen>
      <computeroutput>
&lt;citetitle&gt;IG;&lt;/citetitle&gt;.
</computeroutput>
    </screen>
    <para>输出类似于 <citetitle>&IG;</citetitle>，因为 &amp;IG; 是已定义的实体。</para>
  </sect1>
  <sect1 id="s1-xml-tags-command">
    <title>
      <command>command</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>command</secondary>
    </indexterm>
    <para>application 是图形界面应用程序的名字。command 是一个可执行的程序，或者运行应用程序的命令。任何命令行程序，或是只有字符界面的工具都应以 <command>command</command> 标记。</para>
    <para>如果某些文本是一个命令，那就用 <command>&lt;command&gt;</command> 和 <command>&lt;/command&gt;</command> 标记：</para>
    <screen>
      <computeroutput>
要在安装后改变键盘设置，切换为 root 并使用 &lt;command&gt;redhat-config-keyboard&lt;/command&gt; 命令，或者在 root 提示符下输入 &lt;command&gt;setup&lt;/command&gt;。
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>要在安装后改变键盘设置，切换为 root 并使用 <command>redhat-config-keyboard</command> 命令，或者在 root 提示符下输入 <command>setup</command>。</para>
    <para>另一个例子：</para>
    <screen>
      <computeroutput>
&lt;command&gt;MAILNOVIOLATIONS&lt;/command&gt; &mdash; 如果设置为 &lt;command&gt;true&lt;/command&gt;，这个选项使得 Tripwire 定时发送邮件报告，无论是否出现了越权操作。默认值是 &lt;command&gt;true&lt;/command&gt;。
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>
      <command>MAILNOVIOLATIONS</command> &mdash; 如果设置为 <command>true</command>，这个选项使得 Tripwire 定时发送邮件报告，无论是否出现了越权操作。默认值是 <command>true</command>。</para>
    <note>
      <title>注意</title> <para>本例中，选项值 (true) 被标记为 &lt;command&gt;。由于选项是出现在配置文件中的，(命令行选项应当使用 &lt;option&gt; 标记，)并且由于没有为配置文件选项定义什么标记，我们约定使用 &lt;command&gt; 标记配置文件中的选项。</para></note>
    <para>名词也标记为 <command>command</command>，因为没有其他合适的标记：</para>
    <itemizedlist>
      <listitem>
        <para>配置文件中的选项，类似 Apache 指令</para>
      </listitem>
      <listitem>
        <para>守护进程名称</para>
      </listitem>
    </itemizedlist>
  </sect1>
  <sect1 id="s1-xml-tags-compoutput">
    <title>
      <command>computeroutput</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>computeroutput</secondary>
    </indexterm>
    <para>要显示屏幕输出，使用这个标记：</para>
    <screen>
      <computeroutput>
&lt;computeroutput&gt;您是否要删除文件? y n&lt;/computeroutput&gt;
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>
      <computeroutput>您是否要删除文件? y n</computeroutput>
    </para>
  </sect1>
  <sect1 id="s1-xml-tags-emphasis">
    <title>
      <command>emphasis</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>emphasis</secondary>
    </indexterm>
    <para>要强调的内容，使用 <command>&lt;emphasis&gt;</command> 和 <command>&lt;/emphasis&gt;</command> 标记。例如：</para>
    <screen>
      <computeroutput>
安装过程将 &lt;emphasis&gt;删除所有&lt;/emphasis&gt; 硬盘上的 &lt;emphasis&gt;所有&lt;/emphasis&gt; 已有 Linux 分区，非 Linux 分区不会被删除。
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>安装过程将 <emphasis>删除所有</emphasis> 硬盘上的 <emphasis>所有</emphasis> 已有 Linux 分区，非 Linux 分区不会被删除。</para>
  </sect1>
  <sect1 id="s1-xml-tags-example">
    <title>
      <command>example</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>example</secondary>
    </indexterm>
    <para>
      <command>&lt;example&gt;</command> 和 <command>&lt;/example&gt;</command> 标记用来格式化某个文档中的文本，适于显示代码示例等。</para>
    <para>
      <command>&lt;example&gt;</command> 标记应当有一个 ID 和标题：</para>
    <screen>
	&lt;example id="static-ip"&gt;
	  &lt;title&gt;使用 DHCP 的静态 IP 地址&lt;/title&gt;

&lt;screen width=60&gt;
&lt;computeroutput&gt;
host apex {
   option host-name "apex.example.com";
   hardware ethernet 00:A0:78:8E:9E:AA; 
   fixed-address 192.168.1.4;
}
&lt;computeroutput&gt;
&lt;/screen&gt;

	&lt;/example&gt;
</screen>
    <para>输出：</para>
    <example id="static-ip">
      <title>使用 DHCP 的静态 IP 地址</title>
      <screen>
        <computeroutput>
host apex {
   option host-name "apex.example.com";
   hardware ethernet 00:A0:78:8E:9E:AA; 
   fixed-address 192.168.1.4;
}
</computeroutput>
      </screen>
    </example>
  </sect1>
  <sect1 id="s1-xml-tags-filename">
    <title>
      <command>filename</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>filename</secondary>
    </indexterm>
    <para>
      <command>&lt;filename&gt;</command> 和 <command>&lt;/filename&gt;</command> 标记定义文件名和路径。由于目录是特殊的文件，因此也使用 <command>filename</command> 标记。例如：</para>
    <screen>
编辑 &lt;filename&gt;/home/smoore/sam.xml&lt;/filename&gt; 文件，修改它或加注释。
</screen>
    <para>输出：</para>
    <para>编辑 <filename>/home/smoore/sam.xml</filename> 文件，修改它或加注释。</para>
    <para>它们也用来标记 RPM 软件包名称。例如：</para>
    <screen>
要使用 &lt;application&gt;Keyboard Configuration Tool&lt;/application&gt;，必须安装 &lt;filename&gt;system-config-keyboard&lt;/filename&gt; 软件包。
</screen>
    <para>输出：</para>
    <para>要使用 <application>Keyboard Configuration Tool</application>，必须安装 <command>redhat-config-keyboard</command> 软件包。</para>
    <note>
      <title>注意</title>
      <para>目录名必须以斜线 (<computeroutput>/</computeroutput>) 结尾，以与文件名区分。</para>
    </note>
  </sect1>
  <sect1 id="s1-xml-tags-firstterm">
    <title>
      <command>firstterm</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>firstterm</secondary>
    </indexterm>
    <para>
      <command>&lt;firstterm&gt;</command> 和 <command>&lt;/firstterm&gt;</command> 标记用来定义一个用户不熟悉，但将频繁出现的词。例如：</para>
    <screen>
      <computeroutput>
几乎所有现代操作系统都使用 &lt;firstterm&gt;disk
partitions&lt;/firstterm&gt;(磁盘分区)，&FC; 也不例外。
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>几乎所有现代操作系统都使用 <firstterm>disk partitions</firstterm>(磁盘分区)，&FC; 也不例外。</para>
  </sect1>
  <sect1 id="s1-xml-tags-footnote">
    <title>
      <command>footnote</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>footnote</secondary>
    </indexterm>
    <para>如果您需要添加脚注，可以这样：</para>
    <screen>
      <computeroutput>
如果您想进行服务器级
&lt;footnote&gt;
&lt;para&gt;
服务器级安装用于安装典型的服务器环境。注意，服务器级安装不会安装图形界面。
&lt;/para&gt; 
&lt;/footnote&gt; 安装，请参考 &lt;citetitle&gt;Installation Guide&lt;/citetitle&gt;。
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>如果您想进行服务器级 <footnote><para>服务器级安装用于安装典型的服务器环境。注意，服务器级安装不会安装图形界面。</para></footnote> 安装，请参考 <citetitle>Installation Guide</citetitle>。</para>
  </sect1>
  <sect1 id="s1-xml-tags-figure">
    <title>
      <command>figure</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>figure</secondary>
    </indexterm>
    <important>
      <title>注意</title>
      <para>顺序很重要！EPS 文件 <emphasis>必须</emphasis> 首先声明。</para>
    </important>
    <para>示例图象声明：</para>
    <screen>
      <computeroutput>
&lt;figure id="fig-ksconfig-basic"&gt;
   &lt;title&gt;基本设置&lt;/title&gt;
       &lt;mediaobject&gt;
         &lt;imageobject&gt;
           &lt;imagedata fileref="./figs/ksconfig/ksconfig-basic.eps"
                       format="EPS"/&gt;
         &lt;/imageobject&gt;
         &lt;imageobject&gt;
           &lt;imagedata fileref="./figs/ksconfig/ksconfig-basic.png"
                      format="PNG"/&gt;
         &lt;/imageobject&gt;
         &lt;textobject&gt;
           &lt;phrase&gt;
              一些关于图象的文本描述
           &lt;/phrase&gt;
         &lt;/textobject&gt;
       &lt;/mediaobject&gt;
&lt;/figure&gt;
</computeroutput>
    </screen>
    <para>下面列出了需要修改的内容：</para>
    <screen>
&lt;figure id="fig-ksconfig-basic"&gt; <emphasis>==&gt; id="" 可以修改</emphasis>

&lt;title&gt;基本设置&lt;/title&gt; <emphasis>==&gt; 标题可以修改</emphasis>

fileref="./figs/ksconfig/ksconfig-basics.eps"&gt; <emphasis>==&gt; .eps 位置可以修改</emphasis>

fileref="./figs/ksconfig/ksconfig-basics.png"&gt; <emphasis>==&gt; .png 位置可以修改</emphasis>
                  
&lt;phrase&gt;一些关于图象的文本描述&lt;/phrase&gt; <emphasis>==&gt; "一些关于..." 可以修改</emphasis></screen>
    <para>关于获取屏幕截图，请参考 <xref linkend="s1-screenshots"/>。</para>
  </sect1>
  <sect1 id="s1-xml-tags-gui">
    <title>图形用户界面标记</title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>GUI 标记</secondary>
    </indexterm>
    <sect2 id="s2-xml-tags-guilabel">
      <title>
        <command>guilabel</command>
      </title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>GUI 标记</secondary>
        <tertiary>guilabel</tertiary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>guilabel</secondary>
      </indexterm>
      <para>使用 <command>&lt;guilabel&gt;</command> 和 <command>&lt;/guilabel&gt;</command> 作为描述 GUI 时的默认标记，类似窗体名称或窗体标题。例如：</para>
      <screen>
        <computeroutput>
&lt;guilabel&gt;Authentication Configuration&lt;/guilabel&gt; 屏幕指引您如何配置更安全的系统。
</computeroutput>
      </screen>
      <para>输出：</para>
      <para>
        <guilabel>Authentication Configuration</guilabel> 屏幕指引您如何配置更安全的系统。</para>
    </sect2>
    <sect2 id="s2-xml-tags-guibutton">
      <title>
        <command>guibutton</command>
      </title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>GUI 标记</secondary>
        <tertiary>guibutton</tertiary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>guibutton</secondary>
      </indexterm>
      <para>使用 <command>&lt;guibutton&gt;</command> 和 <command>&lt;/guibutton&gt;</command> 标记表示屏幕或菜单中的按钮。例如：</para>
      <screen>
        <computeroutput>
选择 &lt;guibutton&gt;Activate on boot&lt;/guibutton&gt; 按钮，配置 X 窗口系统自动启动。
</computeroutput>
      </screen>
      <para>输出：</para>
      <para>选择 <guibutton>Activate on boot</guibutton> 按钮，配置 X 窗口系统自动启动。</para>
    </sect2>
    <sect2 id="s2-xml-tags-guiicon">
      <title>
        <command>guiicon</command>
      </title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>GUI 标记</secondary>
        <tertiary>guiicon</tertiary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>guiicon</secondary>
      </indexterm>
      <para>
        <command>&lt;guiicon&gt;</command> 和 <command>&lt;/guiicon&gt;</command> 标记用来表示面板或桌面图标。例如：</para>
      <screen>
        <computeroutput>
双击桌面上的 &lt;guiicon&gt;Start Here&lt;/guiicon&gt; 图标。
</computeroutput>
      </screen>
      <para>输出：</para>
      <para>双击桌面上的 <guiicon>Start Here</guiicon> 图标。</para>
    </sect2>
    <sect2 id="s2-xml-tags-guimenu">
      <title>
        <command>guimenu</command> 和 <command>guimenuitem</command></title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>GUI 标记</secondary>
        <tertiary>guimenu</tertiary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>guimenu</secondary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>GUI 标记</secondary>
        <tertiary>guimenuitem</tertiary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>guimenuitem</secondary>
      </indexterm>
      <para>要表示一个菜单 (安装程序或控制面板中的菜单)，使用 <command>&lt;guimenu&gt;</command> 和 <command>&lt;/guimenu&gt;</command> 标记。</para>
      <para>要表示子菜单，使用 <command>&lt;guimenuitem&gt;</command> 和 <command>&lt;/guimenuitem&gt;</command> 标记。(请注意示例中为了输出需要，插入了一些换行。)例如：</para>
      <screen>
        <computeroutput>
选择 &lt;guimenu&gt;Main Menu&lt;/guimenu&gt; =&gt;
	    &lt;guimenuitem&gt;Programming&lt;/guimenuitem&gt; =&gt; &lt;guimenuitem&gt;Emacs&lt;/guimenuitem&gt; 来启动
&lt;application&gt;Emacs&lt;/application&gt; 编辑器。
</computeroutput>
      </screen>
      <para>输出：</para>
      <para>选择 <guimenu>Main Menu</guimenu> =&gt; <guimenuitem>Programming</guimenuitem> =&gt; <guimenuitem>Emacs</guimenuitem> 来启动 <application>Emacs</application> 编辑器。</para>
    </sect2>
  </sect1>
  <sect1 id="s1-xml-tags-keycap">
    <title>
      <command>keycap</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>keycap</secondary>
    </indexterm>
    <para>要表示某个按键，应当使用 <command>&lt;keycap&gt;</command> 和 <command>&lt;/keycap&gt;</command> 标记。按键会自动加上尖括号，因此不要在 XML 代码中再加一次。例如：</para>
    <screen>
      <computeroutput>
要作出选择，按下 &lt;keycap&gt;Enter&lt;/keycap&gt; 键。
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>要作出选择，按下 <keycap>Enter</keycap> 键。</para>
    <sect2 id="s2-xml-tags-menuchoice">
      <title>
        <command>menuchoice</command>
      </title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>menuchoice</secondary>
      </indexterm>
      <para>通常，使用鼠标对于频繁的操作过于繁琐。因此，程序员在程序中设置了快捷键来简化使用。应当使用 <command>shortcut</command> 标记包含 <command>keycap</command> 标记，然后再整个包含在 <command>menuchoice</command> 标记中，来表示快捷键。例如：</para>
      <screen>
        <computeroutput>
打开菜单并选择：
 &lt;menuchoice&gt;
   &lt;shortcut&gt;
     &lt;keycombo&gt;&lt;keycap&gt;Ctrl&lt;/keycap&gt;&lt;keycap&gt;s&lt;/keycap&gt;&lt;/keycombo&gt;
   &lt;/shortcut&gt;
   &lt;guimenu&gt;&lt;accel&gt;F&lt;/accel&gt;ile&lt;/guimenu&gt;
   &lt;guimenuitem&gt;&lt;accel&gt;S&lt;/accel&gt;ave&lt;/guimenuitem&gt;
 &lt;/menuchoice&gt;.
</computeroutput>
      </screen>
      <para>输出：</para>
      <para>打开菜单并选择：<menuchoice><shortcut><keycombo><keycap>Ctrl</keycap><keycap>s</keycap></keycombo></shortcut><guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>S</accel>ave</guimenuitem></menuchoice>.</para>
    </sect2>
    <sect2 id="s2-xml-tags-keycombo">
      <title>
        <command>keycombo</command>
      </title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>keycombo</secondary>
      </indexterm>
      <para>要描述按键组合，使用 <command>&lt;keycombo&gt;</command> 和 <command>&lt;/keycombo&gt;</command>, <command>&lt;keycap&gt;</command> 和 <command>&lt;/keycap&gt;</command> 标记。例如：</para>
      <screen>
        <computeroutput>
要重启系统，按下 &lt;keycombo&gt;
&lt;keycap&gt;Ctrl&lt;/keycap&gt;&lt;keycap&gt;Alt&lt;/keycap&gt;&lt;keycap&gt;Del&lt;/keycap&gt;
&lt;/keycombo&gt;.
</computeroutput>
      </screen>
      <para>输出：</para>
      <para>要重启系统，按下 <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Del</keycap></keycombo>.</para>
    </sect2>
  </sect1>
  <sect1 id="s1-xml-tags-lists">
    <title>列表</title>
    <indexterm>
      <primary>列表</primary>
      <secondary>创建</secondary>
    </indexterm>
    <para>您可以用 XML 创建多种列表。您可以创建无序的枚举，有序的编号列表，或是变量表 (先是一个词，然后是单独的一段话)。</para>
    <para>还有一种列表适于表格，最后一种是用于定义词汇解释的列表。</para>
    <para>下面各节描述了各种列表，以及如何创建。</para>
    <sect2 id="s2-xml-tags-itemizedlist">
      <title>
        <command>itemizedlist</command>
      </title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>
          <command>itemizedlist</command>
        </secondary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>列表</secondary>
        <tertiary>itemizedlist</tertiary>
      </indexterm>
      <indexterm>
        <primary>列表</primary>
        <secondary>
          <command>itemizedlist</command>
        </secondary>
      </indexterm>
      <para>
        <command>itemizedlist</command> 适于向读者呈现重要的信息，而信息是无序的。它比 <command>variablelist</command> 更短，也简单一点。</para>
      <para>要创建 <command>itemizedlist</command> (也称为枚举列表)，可以这样：</para>
      <note>
        <title>注意</title> <para>下面列表中的文本是直接包含在 <command>para</command> 标记中的。如果您使用列表，不要用这个标记，否则列表中会包含多余空白，无法对齐。如果多个列表项是多行文本，空白会更加明显。HTML 版本不会像 PDF 版本那样明显。</para></note>
      <screen>
        <computeroutput>
&lt;itemizedlist&gt; 
  &lt;listitem&gt;
    &lt;para&gt;熟悉安装程序的界面&lt;/para&gt;
  &lt;/listitem&gt;

  &lt;listitem&gt;
    &lt;para&gt;开始安装程序&lt;/para&gt; 
  &lt;/listitem&gt;

  &lt;listitem&gt;
    &lt;para&gt;选择安装方法&lt;/para&gt;
  &lt;/listitem&gt;
&lt;/itemizedlist&gt;
</computeroutput>
      </screen>
      <para>输出：</para>
      <itemizedlist>
        <listitem>
          <para>熟悉安装程序的界面</para>
        </listitem>
        <listitem>
          <para>开始安装程序</para>
        </listitem>
        <listitem>
          <para>选择安装方法</para>
        </listitem>
      </itemizedlist>
    </sect2>
    <sect2 id="s2-xml-tags-orderedlist">
      <title>
        <command>orderedlist</command>
      </title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>
          <command>orderedlist</command>
        </secondary>
      </indexterm>
      <indexterm>
        <primary>列表</primary>
        <secondary>
          <command>orderedlist</command>
        </secondary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>列表</secondary>
        <tertiary>orderedlist</tertiary>
      </indexterm>
      <para>
        <command>orderedlist</command> 适于向读者显示必须以一定顺序出现的信息。<command>orderedlist</command> 用来向读者描述一步一步的场景转换很不错。</para>
      <para>要创建 <command>orderedlist</command> (有序列表) 可以这样：</para>
      <note>
        <title>注意</title> <para>下面列表中的文本是直接包含在 <command>para</command> 标记中的。如果您使用列表，不要用这个标记，否则列表中会包含多余空白，无法对齐。如果多个列表项是多行文本，空白会更加明显。HTML 版本不会像 PDF 版本那样明显。</para></note>
      <screen>
        <computeroutput>
&lt;orderedlist&gt;
  &lt;listitem&gt;
    &lt;para&gt;在线 &amp;mdash; http://www.redhat.com/support/errata; 提供
    可以在线阅读的更正，您也可以下载光盘镜像。
    &lt;/para&gt;
  &lt;/listitem&gt;
	  
  &lt;listitem&gt;
    &lt;para&gt;电子邮件 &amp;mdash; 发送空白邮件到 errata@redhat.com, 
    您将收到完整的包含安装程序和相关软件 (如果有的话) 的更正说明。
    同时还包括软件更新以及光盘镜像的 URL。通过这些 URL 来下载
    镜像。请注意：下载时使用二进制模式。&lt;/para&gt; 
  &lt;/listitem&gt;
&lt;/orderedlist&gt;
</computeroutput>
      </screen>
      <para>输出：</para>
      <orderedlist>
        <listitem>
          <para>在线 &mdash; http://www.redhat.com/support/errata; 提供可以在线阅读的更正，您也可以下载光盘镜像。</para>
        </listitem>
        <listitem>
          <para>电子邮件 &mdash; 发送空白邮件到 errata@redhat.com, 您将收到完整的包含安装程序和相关软件 (如果有的话) 的更正说明。同时还包括软件更新以及的光盘镜像的 URL。通过这些 URL 来下载镜像。请注意：下载时使用二进制模式。</para>
        </listitem>
      </orderedlist>
    </sect2>
    <sect2 id="s2-xml-tags-varlist">
      <title>
        <command>variablelist</command>
      </title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>
          <command>variablelist</command>
        </secondary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>列表</secondary>
        <tertiary>variablelist</tertiary>
      </indexterm>
      <indexterm>
        <primary>列表</primary>
        <secondary>
          <command>variablelist</command>
        </secondary>
      </indexterm>
      <para>
        <command>variablelist</command> 适于表现一个词以及相关的解释和描述。</para>
      <para>要创建 <command>variablelist</command> 可以这样：</para>
      <note>
        <title>注意</title> <para>下面列表中的文本是直接包含在 <command>para</command> 标记中的。如果您使用列表，不要用这个标记，否则列表中会包含多余空白，无法对齐。如果多个列表项是多行文本，空白会更加明显。HTML 版本不会像 PDF 版本那样明显。</para></note>
      <screen>
        <computeroutput>
&lt;variablelist&gt;
  &lt;varlistentry&gt; 
    &lt;term&gt; 新的多介质安装过程 &lt;/term&gt;
    &lt;listitem&gt; 
      &lt;para&gt;由于安装程序越来越大，RedHat 开发了
      可以处理多张 CD-ROM 介质的安装程序。&lt;/para&gt;
    &lt;/listitem&gt;
  &lt;/varlistentry&gt;

 &lt;varlistentry&gt;
   &lt;term&gt;XFree 4.0 &lt;/term&gt;
   &lt;listitem&gt;
     &lt;para&gt;X 窗口系统的配置从来没有如此简单。
     从选择显示器及其设置，到显卡探测，以及测试您期望的 X 窗口设置，
     Xconfigurator 可以搞定一切。&lt;/para&gt;
   &lt;/listitem&gt;
 &lt;/varlistentry&gt;
&lt;/variablelist&gt;
</computeroutput>
      </screen>
      <para>输出：</para>
      <variablelist>
        <varlistentry>
          <term>新的多介质安装过程</term> <listitem> <para>由于安装程序越来越大，RedHat 开发了可以处理多张 CD-ROM 介质的安装程序。</para></listitem></varlistentry>
        <varlistentry>
          <term>XFree 4.0</term>
          <listitem>
            <para>X 窗口系统的配置从来没有如此简单。从选择显示器及其设置，到显卡探测，以及测试您期望的 X 窗口设置，Xconfigurator 可以搞定一切。</para>
          </listitem>
        </varlistentry>
      </variablelist>
      <warning>
        <title>警告</title>
        <para>
          <emphasis>不要</emphasis> 设置表格的 <computeroutput>frame</computeroutput> 属性，否则 PDF 生成会失败。</para>
      </warning>
    </sect2>
    <sect2 id="s2-xml-tags-simplelist">
      <title>在表格中创建列表，使用 <command>simplelist</command></title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>
          <command>simplelist</command>
        </secondary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>列表</secondary>
        <tertiary>simplelist</tertiary>
      </indexterm>
      <indexterm>
        <primary>列表</primary>
        <secondary>
          <command>simplelist</command>
        </secondary>
      </indexterm>
      <indexterm>
        <primary>表格</primary>
        <secondary>在表格中创建列表</secondary>
        <tertiary>
          <command>simplelist</command>
        </tertiary>
      </indexterm>
      <para>
        <command>simplelist</command> 是无修饰的列表。<command>simplelist</command> 可以内联或按列对齐。</para>
      <para>使用 <command>simplelist</command> 在表格内添加分离的文本段落。通常的列表，例如 <command>itemizedlist</command>，不能嵌入在表格内。</para>
      <para>XML 代码如下：</para>
      <screen>
        <computeroutput>
	  &lt;table id="tb-hwinfo-hostbus"&gt;
	    &lt;title&gt;主机总线适配器特性及配置要求&lt;/title&gt;
	    
	    &lt;tgroup cols="3"&gt;
	      &lt;colspec colnum="1" colname="HostBus" colwidth="33"/&gt;
	      &lt;colspec colnum="2" colname="Features" colwidth="34"/&gt;
	      &lt;colspec colnum="3" colname="Single" colwidth="33"/&gt;
	      
	      &lt;thead&gt;
		&lt;row&gt;
		  &lt;entry&gt;主机总线适配器&lt;/entry&gt;
		  &lt;entry&gt;特性&lt;/entry&gt;
		  &lt;entry&gt;Single-Initiator 配置&lt;/entry&gt;
		&lt;/row&gt;
	      &lt;/thead&gt;
	      
	      &lt;tbody&gt;
		
		&lt;row&gt;
		  &lt;entry&gt;Adaptec 2940U2W&lt;/entry&gt;
		  
		  &lt;entry&gt;&lt;simplelist&gt; 
		      &lt;member&gt;Ultra2, wide, LVD.&lt;/member&gt;
		      &lt;member&gt;HD68 external connector.&lt;/member&gt;
		      &lt;member&gt;One channel, with two bus segments.&lt;/member&gt;
		      &lt;member&gt;Set the onboard termination by using the BIOS
			utility.&lt;/member&gt;
		      &lt;member&gt;Onboard termination is disabled when the power is
			off.&lt;/member&gt;
		    &lt;/simplelist&gt;&lt;/entry&gt;
		  
		  &lt;entry&gt;&lt;simplelist&gt;
		      &lt;member&gt;Set the onboard termination to automatic (the
			default).&lt;/member&gt;
		      &lt;member&gt;Use the internal SCSI connector for private
			(non-cluster) storage.&lt;/member&gt;
		    &lt;/simplelist&gt;&lt;/entry&gt;
		&lt;/row&gt;
		
		&lt;row&gt;
		  &lt;entry&gt;Qlogic QLA1080&lt;/entry&gt;
		  
		  &lt;entry&gt;&lt;simplelist&gt; 
		      &lt;member&gt;Ultra2, wide, LVD&lt;/member&gt;
		      &lt;member&gt;VHDCI external connector&lt;/member&gt;
		      &lt;member&gt;One channel&lt;/member&gt;
		      &lt;member&gt;Set the onboard termination by using the BIOS
			utility.&lt;/member&gt;
		      &lt;member&gt;Onboard termination is disabled when the power is off,
			unless jumpers are used to enforce termination.&lt;/member&gt;
		    &lt;/simplelist&gt;&lt;/entry&gt;
		  
		  
		  &lt;entry&gt;&lt;simplelist&gt; 
		      &lt;member&gt;Set the onboard termination to
			automatic (the default).&lt;/member&gt;
		      &lt;member&gt;Use the internal SCSI connector for private
			(non-cluster) storage.&lt;/member&gt;
		    &lt;/simplelist&gt;&lt;/entry&gt;
		&lt;/row&gt;
		
	      &lt;/tbody&gt;
	    &lt;/tgroup&gt;
	  &lt;/table&gt;
</computeroutput>
      </screen>
      <para>输出：</para>
      <table id="tb-hwinfo-hostbus">
        <title>主机总线适配器特性及配置要求</title>
        <tgroup cols="3">
          <colspec colname="HostBus" colnum="1" colwidth="33"/>
          <colspec colname="Features" colnum="2" colwidth="34"/>
          <colspec colname="Single" colnum="3" colwidth="33"/>
          <thead>
            <row>
              <entry>主机总线适配器</entry>
              <entry>特性</entry>
              <entry>Single-Initiator 配置</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>Adaptec 2940U2W</entry>
              <entry>
                <simplelist>
                  <member>Ultra2, wide, LVD.</member>
                  <member>HD68 external connector.</member>
                  <member>One channel, with two bus segments.</member>
                  <member>Set the onboard termination by using the BIOS utility.</member>
                  <member>Onboard termination is disabled when the power is off.</member>
                </simplelist>
              </entry>
              <entry>
                <simplelist>
                  <member>Set the onboard termination to automatic (the default).</member>
                  <member>Use the internal SCSI connector for private (non-cluster) storage.</member>
                </simplelist>
              </entry>
            </row>
            <row>
              <entry>Qlogic QLA1080</entry>
              <entry>
                <simplelist>
                  <member>Ultra2, wide, LVD</member>
                  <member>VHDCI external connector</member>
                  <member>One channel</member>
                  <member>Set the onboard termination by using the BIOS utility.</member>
                  <member>Onboard termination is disabled when the power is off, unless jumpers are used to enforce termination.</member>
                </simplelist>
              </entry>
              <entry>
                <simplelist>
                  <member>Set the onboard termination to automatic (the default).</member>
                  <member>Use the internal SCSI connector for private (non-cluster) storage.</member>
                </simplelist>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <note>
        <title>注意</title>
        <para>注意 <command>simplelist</command> 标记的用法。&lt;entry&gt; 和 &lt;simplelist&gt; 标记必须靠紧，否则将产生解析错误。</para>
      </note>
      <para>每个要加入 <command>simplelist</command> 的段落或列表项应当包含在 &lt;member&gt; 标记中。</para>
    </sect2>
    <sect2 id="s2-xml-tags-glossary">
      <title>
        <command>glosslist</command>
      </title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>
          <command>glosslist</command>
        </secondary>
      </indexterm>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>列表</secondary>
        <tertiary>glosslist</tertiary>
      </indexterm>
      <indexterm>
        <primary>列表</primary>
        <secondary>
          <command>glosslist</command>
        </secondary>
      </indexterm>
      <para>使用 <command>glosslist</command> 来创建词汇表和解释。</para>
      <para>XML 代码如下：</para>
      <screen>
        <computeroutput>
	  &lt;glosslist&gt;
	    &lt;glossentry&gt;
	      &lt;glossterm&gt;applet&lt;/glossterm&gt;
	      &lt;glossdef&gt;
		&lt;para&gt;一个小程序，通常是实用工具或简单程序。&lt;/para&gt;
	      &lt;/glossdef&gt;
	    &lt;/glossentry&gt;

	    &lt;glossentry&gt;
	      &lt;glossterm&gt;architecture&lt;/glossterm&gt;
	      &lt;glossdef&gt;
		&lt;para&gt;计算机或计算机系统中，
                组件的组织和整合的设计。&lt;/para&gt;
	      &lt;/glossdef&gt;
	    &lt;/glossentry&gt;

	    &lt;glossentry&gt;
	      &lt;glossterm&gt;archive&lt;/glossterm&gt;
	      &lt;glossdef&gt;
		&lt;para&gt;将文件传送到存储设备，以节省空间和/或
                加以组织。&lt;/para&gt;
	      &lt;/glossdef&gt;
	    &lt;/glossentry&gt;
	  &lt;/glosslist&gt;
</computeroutput>
      </screen>
      <para>输出：</para>
      <glosslist>
        <glossentry>
          <glossterm>applet</glossterm>
          <glossdef>
            <para>一个小程序，通常是实用工具或简单程序。</para>
          </glossdef>
        </glossentry>
        <glossentry>
          <glossterm>architecture</glossterm>
          <glossdef>
            <para>计算机或计算机系统中，组件的组织和整合的设计。</para>
          </glossdef>
        </glossentry>
        <glossentry>
          <glossterm>archive</glossterm>
          <glossdef>
            <para>将文件传送到存储设备，以节省空间和/或加以组织。</para>
          </glossdef>
        </glossentry>
      </glosslist>
    </sect2>
  </sect1>
  <sect1 id="s1-xml-tags-option">
    <title>
      <command>option</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>option</secondary>
    </indexterm>
    <para>如果您的命令需要选项或设置标志，使用 <command>&lt;option&gt;</command> 和 <command>&lt;/option&gt;</command> 标记。</para>
    <note>
      <title>注意</title>
      <para>&lt;option&gt; 标记只用于命令行选项，不用于配置文件。</para>
    </note>
    <para>指定选项的 XML 代码如下：</para>
    <screen>
      <computeroutput>
例如，运行命令 &lt;command&gt;ls&lt;/command&gt; 时可以指定选项 &lt;option&gt;-la&lt;/option&gt;。
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>例如，运行命令 <command>ls</command> 时可以指定选项 <option>-la</option>。</para>
  </sect1>
  <sect1 id="s1-xml-tags-indexing">
    <title>索引节点</title>
    <indexterm>
      <primary>创建索引</primary>
    </indexterm>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>创建索引</secondary>
    </indexterm>
    <para>下面的命令序列展示了如何向文档中添加一个索引项的代码：</para>
    <screen>
      <computeroutput>
&lt;indexterm&gt; &lt;-- 这是要在索引中添加的词汇
&lt;primary&gt;foo&lt;/primary&gt; &lt;-- 表示 "foo" 是首要条目
&lt;secondary&gt;bar&lt;/secondary&gt; &lt;-- "bar" 将列在 "foo" 条目之下
&lt;/indexterm&gt; &lt;-- 关闭索引项
</computeroutput>
    </screen>
    <indexterm>
      <primary>foo</primary>
      <secondary>bar</secondary>
    </indexterm>
    <para>
      <command>&lt;seealso&gt;</command> 标记允许您引用另一个索引项或其他手册。应确保您指向的 <command>&lt;seealso&gt;</command> 引用有自己的节点。例如：</para>
    <indexterm>
      <primary>创建索引</primary>
      <secondary>seealso 标记</secondary>
    </indexterm>
    <screen>
      <computeroutput>
&lt;indexterm&gt; 
&lt;primary&gt;SWAK&lt;/primary&gt; 
&lt;seealso&gt;salutations&lt;/seealso&gt;
&lt;/indexterm&gt;


&lt;indexterm&gt; 
&lt;primary&gt;salutations&lt;/primary&gt; 
&lt;/indexterm&gt;
</computeroutput>
    </screen>
    <indexterm>
      <primary>SWAK</primary>
      <seealso>Salutations</seealso>
    </indexterm>
    <indexterm>
      <primary>Salutations</primary>
    </indexterm>
    <para>
      <command>&lt;see&gt;</command> 标记允许您引用一个完整的索引节点。例如：</para>
    <indexterm>
      <primary>创建索引</primary>
      <secondary>see 标记</secondary>
    </indexterm>
    <screen>
      <computeroutput>
&lt;indexterm&gt; 
&lt;primary&gt;Guinness&lt;/primary&gt; 
&lt;see&gt;beer&lt;/see&gt; &lt;-- "beer" 将被列在 "Guinness" 条目下，但是应确保所引用的 "beer" 有自己的索引节点。
&lt;/indexterm&gt;

&lt;indexterm&gt;
&lt;primary&gt;beer&lt;/primary&gt;
&lt;/indexterm&gt;
</computeroutput>
    </screen>
    <indexterm>
      <primary>Guinness</primary>
      <see>Beer</see>
    </indexterm>
    <indexterm>
      <primary>Beer</primary>
    </indexterm>
    <para>要查看这里的索引节点的 HTML 输出，请参考文档最后的 <filename>generated-index.html</filename> 文件。</para>
    <para>索引是如何生成的? 如果文档中包含 indexterm，并且开标记和闭标记出现在文档或文章的结束标记之前，就创建索引，因为样式表参数 <command>generate.index</command> 的默认值是真。</para>
  </sect1>
  <sect1 id="s1-xml-tags-para">
    <title>
      <command>para</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>para</secondary>
    </indexterm>
    <para>对于任意一段，<command>&lt;para&gt;</command> 和 <command>&lt;/para&gt;</command> 标记必须作为这一段的开始和结束。</para>
    <para>不要在除了简单段落之外使用 <command>para</command> 标记。否则，文本内部会产生多余的空白。</para>
    <para>在下列标记周围不要使用 <command>&lt;para&gt;</command> (换句话说，不要把下列标记放在 <command>&lt;para&gt;</command> 标记中)：</para>
    <itemizedlist>
      <listitem>
        <para>
          <command>&lt;screen&gt;</command>
        </para>
      </listitem>
      <listitem>
        <para>
          <command>&lt;itemizedlist&gt;</command>
        </para>
      </listitem>
      <listitem>
        <para>
          <command>&lt;orderedlist&gt;</command>
        </para>
      </listitem>
      <listitem>
        <para>
          <command>&lt;variablelist&gt;</command>
        </para>
      </listitem>
      <listitem>
        <para>
          <command>&lt;table&gt;</command>
        </para>
      </listitem>
    </itemizedlist>
  </sect1>
  <sect1 id="s1-xml-tags-part">
    <title>
      <command>part</command>
    </title>
    <indexterm>
      <primary>parts</primary>
    </indexterm>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>part</secondary>
    </indexterm>
    <para>在主控文件中，可以将章划分为部，以表示逻辑分组。例如，在主控文件中，以 <command>part</command> 标签包含章的实体：</para>
    <screen>
      <computeroutput>
&lt;part id="pt-foo"&gt;
  &lt;partintro&gt;
  &lt;para&gt;一些文本，对这一部分的介绍&lt;/para&gt;
     &amp;CHAPTER; 

     &amp;ANOTHER-CHAPTER;
&lt;/part&gt;
</computeroutput>
    </screen>
    <para>如果您创建了一个 part，应当对内容作一些介绍。例如：</para>
    <screen>
      <computeroutput>
  &lt;part id="pt-setup"&gt;
    &lt;title&gt;设置环境&lt;/title&gt;
    &lt;partintro&gt;
      &lt;para&gt;本节讲述当您刚加入 Docs Group 时需要的信息。
        您也许会再参考本节中，有关安装 &amp;FC; 的信息。&lt;/para&gt;
    &lt;/partintro&gt;
</computeroutput>
    </screen>
    <para>在 HTML 输出中，会生成单独的 HTML 页面，包含这一部的编号、标题、介绍和目录。在 PDF 输出中，这些信息会出现在单独的一页上。</para>
  </sect1>
  <sect1 id="s1-xml-tags-prompt">
    <title>
      <command>prompt</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>prompt</secondary>
    </indexterm>
    <para>要显示提示符，类似 root 提示符或 DOS 提示符，使用 <command>&lt;prompt&gt;</command> 和 <command>&lt;/prompt&gt;</command> 标记。例如：</para>
    <screen>
      <computeroutput>
在 &lt;prompt&gt;LILO:&lt;/prompt&gt; 启动提示符下，输入 linux 来启动到 Linux 分区。

在 &lt;prompt&gt;C:\&gt;&lt;/prompt&gt; 提示符下，输入...
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>在 <prompt>LILO:</prompt> 启动提示符下，输入 linux 来启动到 Linux 分区。</para>
    <para>在 <prompt>C:\&gt;</prompt> 提示符下，输入...</para>
    <note>
      <title>注意</title>
      <para>在显示计算机输出的范例时 (通常是在 <command>screen</command> 标记中)，不要包含提示符或命令 (除非命令或提示符是您意图显示的计算机输出)。</para>
    </note>
  </sect1>
  <sect1 id="s1-xml-tags-replaceable">
    <title>
      <command>replaceable</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>replaceable</secondary>
    </indexterm>
    <para>要创建可替换的文本，使用 <command>&lt;replaceable&gt;</command> 和 <command>&lt;/replaceable&gt;</command> 标记包围您用作可变值的文本。</para>
    <para>这个例子演示了在引用 RPM 文件时如何使用 <command>replaceable</command> 标记。</para>
    <screen>
foo-&lt;replaceable&gt;version-number&lt;/replaceable&gt;.&lt;replaceable&gt;arch&lt;/replaceable&gt;.rpm
</screen>
    <para>输出：</para>
    <screen>
foo-<replaceable>version-number</replaceable>.<replaceable>arch</replaceable>.rpm
</screen>
  </sect1>
  <sect1 id="s1-xml-tags-screen">
    <title>
      <command>screen</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>screen</secondary>
    </indexterm>
    <para>
      <command>&lt;screen&gt;</command> 标记用来格式化文档中的文本，适于用来添加代码示例，计算机输出等等。在 HTML 中，使用 Fedora CSS 文件，可以显示为灰色背景的方框。需要这种效果时，只要将开标记 <command>&lt;screen&gt;</command> 和闭标记 <command>&lt;/screen&gt;</command> 包围在需要强调的文本前后。</para>
    <important>
      <title>注意</title>
      <para>使用 <command>&lt;screen&gt;</command> 标记时，必须设置所包含的所有内容，包括 <command>&lt;screen&gt;</command> 标记本身为左对齐。这样，在转化为 HTML 时，在灰色背景内部文字之前不会出现多余的空白。</para>
    </important>
    <para>
      <command>&lt;screen&gt;</command> 标记可能包含其他内联标记，类似 <command>&lt;computeroutput&gt;</command>, <command>&lt;userinput&gt;</command>, 或 <command>&lt;replaceable&gt;</command> 等等。其他内联标记未作要求。<command>&lt;screen&gt;</command> 标记本身可以提供足够的上下文，尤其对于简单的范例或列举文件而言。考虑范例的上下文，如果内联标记有助于阅读，那么就使用它。</para>
    <para>如果您使用内联标记，牢记 <command>&lt;screen&gt;</command> 标记中的换行会在任何输出中生成换行。将标记与内容 <emphasis>放在同一行</emphasis>。不要在 <command>&lt;screen&gt;</command> 的内容中过分使用标记。</para>
    <para>
      <command>&lt;screen&gt;</command> 示例如下：</para>
    <screen>
      <computeroutput>&lt;screen&gt;
这是 screen 的示例。其中无须使用 &amp;lt;para&amp;gt; 标记。
&lt;/screen&gt;</computeroutput>
    </screen>
    <para>输出：</para>
    <screen>
这是 screen 的示例。其中无须使用 &lt;para&gt; 标记。
</screen>
    <sect2 id="s2-xml-tags-screen-inline-tags">
      <title>在 <command>screen</command> 中使用内联标记</title>
      <para>如果您在 <command>&lt;screen&gt;</command> 中使用内联标记，遵循下列准则以保持一致。如果 screen 的内容是配置文件的清单或程序的输出，使用 <command>&lt;computeroutput&gt;</command> 标记包含整个输出。如果用户应当在命令行照范例输入，或是配置文件，使用 <command>&lt;userinput&gt;</command> 标记。用简短的叙述性的话来区分输入和输出，如下所示：</para>
      <screen>
        <command>&lt;para&gt;</command>
	  输入下面的命令：
	<command>&lt;/para&gt;</command><command>&lt;screen&gt;</command><command>&lt;userinput&gt;</command>command -sw file1<command>&lt;/userinput&gt;</command><command>&lt;/screen&gt;</command><command>&lt;para&gt;</command>
	  可以看到下列输出：
	<command>&lt;/para&gt;</command><command>&lt;screen&gt;</command><command>&lt;computeroutput&gt;</command>Completed, time = 0.12 sec<command>&lt;/computeroutput&gt;</command><command>&lt;/screen&gt;</command></screen>
      <para>输出：</para>
      <para>输入下面的命令：</para>
      <screen>
        <userinput>command -sw file1</userinput>
      </screen>
      <para>可以看到下列输出：</para>
      <screen>
        <computeroutput>Completed, time = 0.12 sec</computeroutput>
      </screen>
      <note>
        <title>注意</title>
        <para>在 <command>screen</command> 标记中显示一条命令或命令序列时，不要显示提示符。</para>
      </note>
      <para>如果 <command>&lt;screen&gt;</command> 向读者显示如何修改文本的 <emphasis>一部分</emphasis>，可以将修改部分以内联的 <command>&lt;userinput&gt;</command> 标记。您可以在大块内联的 <command>&lt;computeroutput&gt;</command> 文本中使用 <command>&lt;userinput&gt;</command>。这时不要包含更多上下文，除非必须这么做。下面的示例演示了这些准则：</para>
      <screen>
        <command>&lt;para&gt;</command>
	  编辑 <command>&lt;filename&gt;</command>/etc/sysconfig/init<command>&lt;/filename&gt;</command> 文件，如下所示：
	<command>&lt;/para&gt;</command><command>&lt;screen&gt;</command>
GRAPHICAL=<command>&lt;userinput&gt;</command>yes<command>&lt;/userinput&gt;</command><command>&lt;/screen&gt;</command></screen>
      <para>输出：</para>
      <para>编辑 <filename>/etc/sysconfig/init</filename> 文件，如下所示：</para>
      <screen>
GRAPHICAL=<userinput>yes</userinput></screen>
      <para>对于如何在 <command>screen</command> 标记中使用 <command>replaceable</command> 标记，请参考 <xref linkend="s1-xml-tags-replaceable"/>。</para>
    </sect2>
  </sect1>
  <sect1 id="s1-xml-tags-sections">
    <title>section</title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>节</secondary>
    </indexterm>
    <indexterm>
      <primary>节</primary>
    </indexterm>
    <para>在文章中 (或者在 chapter 中，如果是 DocBook XML book 样式的话，类似 <citetitle>&IG;</citetitle>)，可以细分为节和小节。<command>&lt;sect1&gt;</command> 总是最顶层的节。如果两个 section 级别相同，那么一个不能包含另一个 (section 2 可以包含在 section 1 里面，但是如果再创建新的 section 1，必须先关闭当前的 section 1)。大致的布局如下：</para>
    <screen>
      <computeroutput>
&lt;sect1 id="s1-uniquename"&gt;
  &lt;title&gt;插入标题&lt;/title&gt;
  &lt;para&gt;
    内容文本。
  &lt;/para&gt;


  &lt;sect2 id="s2-uniquename"&gt;
    &lt;title&gt;插入标题&lt;/title&gt;
    &lt;para&gt;
      内容文本。
    &lt;/para&gt;

    &lt;sect3 id="s3-uniquename"&gt;
      &lt;title&gt;插入标题&lt;/title&gt;
      &lt;para&gt;
        内容文本。
      &lt;/para&gt;

    &lt;/sect3&gt;

  &lt;/sect2&gt;

&lt;/sect1&gt;
</computeroutput>
    </screen>
    <para>在 DocBook article 样式中，如果您只需要一级 section，可以使用 <command>section</command> 标记。例如：</para>
    <screen>
      <computeroutput>
&lt;section id="sn-uniquename"&gt;
  &lt;title&gt;插入标题&lt;/title&gt;
  &lt;para&gt;
    内容文本。
  &lt;/para&gt;
&lt;/section&gt;
&lt;section id="sn-anothername"&gt;
  &lt;title&gt;插入标题&lt;/title&gt;
  &lt;para&gt;
    内容文本。
  &lt;/para&gt;
&lt;/section&gt;
</computeroutput>
    </screen>
  </sect1>
  <sect1 id="s1-xml-tags-table">
    <title>
      <command>table</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>table</secondary>
    </indexterm>
    <para>下面是创建表格的范例。</para>
    <screen>
&lt;table id="tb-mockup-before-begin"&gt;
   <emphasis>这在 XML 中声明了一个表格，ID 是 <command>"tb-mockup-before-begin"</command>。</emphasis>

&lt;title&gt;Available Features of GNOME and KDE&lt;/title&gt;

&lt;tgroup cols="3"&gt;
    <emphasis>这在 XML 中声明了一个表格，包含三列。</emphasis>

&lt;colspec colnum="1" colname="Features" colwidth="3"/&gt;
    <emphasis><command>colspec</command> 表示您向 XML 声明的表格列信息。</emphasis> <emphasis><command>colnum="1"</command> 表示您对第一列的设定。</emphasis><emphasis><command>colname="Features"</command> 表示本列的标题是 "Features"。</emphasis><emphasis><command>colwidth="3"</command> 指定列宽。这里有些机关：如果两列的列宽分别是 1 和 2，那么 1 占据的页宽就是 2 的一半。但是，如果您需要让第一列比第二列的一半稍微宽一点，那么就用一个更大的数值，例如指定列宽分别为 10 和 20，然后把 10 增加到 11 或 12，这样就比第二列的 20 的一半大一点了。如果没有给定任何值，默认就是 1。</emphasis>

&lt;colspec colnum="2" colname="GNOME" colwidth="2"/&gt;
&lt;colspec colnum="3" colname="KDE" colwidth="2"/&gt;

&lt;thead&gt;
    <emphasis>包含一个或多个表格行。</emphasis>

&lt;row&gt; 
   <emphasis>包含一个或多个表格单元。</emphasis>

&lt;entry&gt;Features&lt;/entry&gt;
   <emphasis>表格单元元素，一列表格单元中的一个，定义了行内的列。</emphasis>

&lt;entry&gt;GNOME&lt;/entry&gt; 
&lt;entry&gt;KDE&lt;/entry&gt;
&lt;/row&gt; 
&lt;/thead&gt; 

&lt;tbody&gt; 
   <emphasis>包含一个或多个表格行，作为表格的主体。</emphasis>

&lt;row&gt; 
&lt;entry&gt;高度可定制&lt;/entry&gt; 
&lt;entry&gt;yes&lt;/entry&gt; 
&lt;entry&gt;yes&lt;/entry&gt; 
&lt;/row&gt; 
&lt;row&gt; 
&lt;entry&gt;多种窗口管理器&lt;/entry&gt;
&lt;entry&gt;yes&lt;/entry&gt; 
&lt;entry&gt;yes&lt;/entry&gt; 
&lt;/row&gt; 
&lt;row&gt; 
&lt;entry&gt;互联网程序&lt;/entry&gt; 
&lt;entry&gt;yes &lt;/entry&gt; 
&lt;entry&gt;yes &lt;/entry&gt; 
&lt;/row&gt; 
&lt;/tbody&gt; 
&lt;/tgroup&gt; 
&lt;/table&gt; 
</screen>
    <table id="tb-mockup-before-begin">
      <title>Available Features of GNOME and KDE</title>
      <tgroup cols="3">
        <colspec colname="Features" colnum="1" colwidth="3"/>
        <colspec colname="GNOME" colnum="2" colwidth="2"/>
        <colspec colname="KDE" colnum="3" colwidth="2"/>
        <thead>
          <row>
            <entry>特性</entry>
            <entry>GNOME</entry>
            <entry>KDE</entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry>高度可定制</entry>
            <entry>yes</entry>
            <entry>yes</entry>
          </row>
          <row>
            <entry>多种窗口管理器</entry>
            <entry>yes</entry>
            <entry>yes</entry>
          </row>
          <row>
            <entry>互联网程序</entry>
            <entry>yes</entry>
            <entry>yes</entry>
          </row>
        </tbody>
      </tgroup>
    </table>
    <sect2 id="s2-xml-tags-listintable">
      <title>在表格中创建列表</title>
      <indexterm>
        <primary>XML 标记</primary>
        <secondary>table</secondary>
        <tertiary>表格中的列表</tertiary>
      </indexterm>
      <para>在表格中创建列表比较困难，它要求严格的格式化以及一些 <application>Emacs</application> 无法完成的命令补全。</para>
      <para>需要使用的标记是 <command>&lt;simplelist&gt;</command> 和 <command>&lt;member&gt;</command>。</para>
      <para>下面是在表格中创建列表的例子。</para>
      <screen>
        <computeroutput>
&lt;table id="tb-hardware-powerswitch"&gt;
  &lt;title&gt;不间断电源硬件&lt;/title&gt;
    &lt;tgroup cols="4"&gt;
      &lt;colspec colnum="1" colname="Hardware" colwidth="2"/&gt;
      &lt;colspec colnum="2" colname="Quantity" colwidth="2"/&gt;
      &lt;colspec colnum="3" colname="Description" colwidth="6"/&gt; 
      &lt;colspec colnum="4" colname="Required" colwidth="2"/&gt;

       &lt;thead&gt;
	 &lt;row&gt;
           &lt;entry&gt;Hardware&lt;/entry&gt;
	   &lt;entry&gt;Quantity&lt;/entry&gt;
           &lt;entry&gt;Description&lt;/entry&gt;
	   &lt;entry&gt;Required&lt;/entry&gt;
	 &lt;/row&gt;
       &lt;/thead&gt;
	    
       &lt;tbody&gt;
	      
	&lt;row&gt;
          &lt;entry&gt;Serial power switches&lt;/entry&gt;

	  &lt;entry&gt;Two&lt;/entry&gt;

	  &lt;entry&gt;&lt;simplelist&gt; &lt;member&gt;Power switches enable each cluster system
	   to power-cycle the other cluster system. Note that clusters are
	   configured with either serial or network attached power switches and
	   not both.&lt;/member&gt;
		      
               &lt;member&gt;The following serial attached power switch has been
	       fully tested:&lt;/member&gt;

               &lt;member&gt;RPS-10 (model M/HD in the US, and model M/EC in
	       Europe) &lt;/member&gt;

               &lt;member&gt;Latent support is provided for the following serial
	       attached power switch.  This switch has not yet been fully
               tested:&lt;/member&gt;
		  
	       &lt;member&gt;APC Serial On/Off Switch (partAP9211), &lt;ulink
               url="http://www.apc.com/"&gt;http://www.apc.com/&lt;/ulink&gt;&lt;/member&gt;
               &lt;/simplelist&gt;&lt;/entry&gt;

           &lt;entry&gt;Strongly recommended for data integrity under all failure
	   conditions&lt;/entry&gt;

	 &lt;/row&gt;
     &lt;/tbody&gt;
  &lt;/tgroup&gt;
&lt;/table&gt;
</computeroutput>
      </screen>
      <para>
        <command>&lt;simplelist&gt;</command> 标记必须紧挨 <command>&lt;entry&gt;</command> 标记。如果不这样，就无法成功解析。</para>
      <para>上面的示例看起来象这样：</para>
      <table id="tb-hardware-powerswitch">
        <title>不间断电源硬件</title>
        <tgroup cols="4">
          <colspec colname="Hardware" colnum="1" colwidth="2"/>
          <colspec colname="Quantity" colnum="2" colwidth="2"/>
          <colspec colname="Description" colnum="3" colwidth="6"/>
          <colspec colname="Required" colnum="4" colwidth="2"/>
          <thead>
            <row>
              <entry>Hardware</entry>
              <entry>Quantity</entry>
              <entry>描述</entry>
              <entry>Required</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>Serial power switches</entry>
              <entry>Two</entry>
              <entry>
                <simplelist> <member>Power switches enable each cluster system to power-cycle the other cluster system. Note that clusters are configured with either serial or network attached power switches and not both.</member><member>The following serial attached power switch has been fully tested:</member><member>RPS-10 (model M/HD in the US, and model M/EC in Europe)</member><member>Latent support is provided for the following serial attached power switch. This switch has not yet been fully tested:</member><member>APC Serial On/Off Switch (partAP9211), <ulink url="http://www.apc.com/">http://www.apc.com/</ulink></member></simplelist>
              </entry>
              <entry>Strongly recommended for data integrity under all failure conditions</entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </sect2>
  </sect1>
  <sect1 id="s1-xml-tags-trademark">
    <title>
      <command>trademark</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>
        <command>trademark</command>
      </secondary>
    </indexterm>
    <para>不要使用商标实体 &amp;trade;, &amp;copy;, 或 &amp;reg; 因为它们无法为所有字符集产生 HTML 输出。这些实体产生的 HTML 输出定义在 DTD 中，无法通过样式表改变。</para>
    <para>应当使用 <command>trademark</command> 标记以及相关类别，如下所示：</para>
    <screen>
      <computeroutput>
&lt;trademark&gt;其后是商标符号&lt;/trademark&gt;
&lt;trademark class="registered"&gt;其后是注册商标符号&lt;/trademark&gt;
&lt;trademark class="copyright"&gt;其后是版权符号&lt;/trademark&gt;
</computeroutput>
    </screen>
  </sect1>
  <sect1 id="s1-xml-tags-userinput">
    <title>
      <command>userinput</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>
        <command>userinput</command>
      </secondary>
    </indexterm>
    <para>要显示用户将输入的内容，使用 <command>userinput</command> 标记。例如：</para>
    <screen>
      <computeroutput>
在提示符下，输入：

&lt;userinput&gt;dd if=boot.img of=/dev/fd0 bs=1440k&lt;/userinput&gt;
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>在提示符下，输入：</para>
    <para>
      <userinput>dd if=boot.img of=/dev/fd0 bs=1440k</userinput>
    </para>
  </sect1>
  <!--      <sect1 id="s1-xml-tags-mouse">
	<title><command>mousebutton</command></title>

	<indexterm>
	  <primary>XML tags</primary>
	  <secondary>mousebutton</secondary>
	</indexterm>
	<para>
Describe mouse actions with the mousebutton tag. Below is an example of its use.
</para>

<screen>
&lt;mousebutton&gt;Right click&lt;/mousebutton&gt; on the image and a new menu will appear.
</screen>

	<para>
<mousebutton>Right click</mousebutton> on the image and a new menu will appear.
 </para>

      </sect1> -->
  <sect1 id="s1-xml-tag-sulink">
    <title>
      <command>ulink</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>ulink</secondary>
    </indexterm>
    <para>要在文本中创建 URL，如下：</para>
    <screen>
      <computeroutput>
在线 &amp;mdash; &lt;ulink url="http://www.redhat.com/support/errata/"&gt;
http://www.redhat.com/support/errata/&lt;/ulink&gt;; 提供可以在线阅读的更正，您也可以下载光盘镜像。
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>在线 &mdash; <ulink url="http://www.redhat.com/support/errata/"> http://www.redhat.com/support/errata/</ulink>; 提供可以在线阅读的更正，您也可以下载光盘镜像。</para>
    <note>
      <title>注意</title>
      <para>如果 URL 不是以文件名结尾，必须以斜线结束 (<computeroutput>/</computeroutput>)，才是格式正确的 URL，例如 <ulink url="http://www.redhat.com/">http://www.redhat.com/</ulink>。</para>
    </note>
  </sect1>
  <sect1 id="s1-xml-tags-wordasword">
    <title>
      <command>wordasword</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>wordasword</secondary>
    </indexterm>
    <para>&lt;wordasword&gt; 标记用来定义一个词只作为语法单位，不代表其他含义。</para>
    <para>许多技术文档使用了有丰富意义的词汇。有时又需要用到不带技术意味的这个词。&lt;wordasword&gt; 标记这样的词，指示这个词应当简单地理解为一个词而不是其他东西。</para>
    <para>使用这个标记不会帮助读者理解其中的意义差别；好文档应当做到这一点。实际上 &lt;wordasword&gt; 的价值在于全文搜索和索引工具可以用它来减少虚假结果。</para>
    <para>例如：</para>
    <screen>
      <computeroutput>要使用 &lt;command&gt;grep&lt;/command&gt; 搜索单词
&lt;wordasword&gt;linux&lt;/wordasword&gt;，使用命令
&lt;command&gt;grep linux&lt;/command&gt;。</computeroutput>
    </screen>
    <para>输出：</para>
    <para>要使用 <command>grep</command> 搜索单词 <wordasword>linux</wordasword>，使用命令 <command>grep linux</command>。</para>
    <para>这个例子中，"linux" 仅仅是一个单词。文档不是以 Linux 为主题，这个词也不为内容添加任何相关含义，可以替换为其他任何词。</para>
  </sect1>
  <sect1 id="s1-xml-tags-xref">
    <title>
      <command>xref</command>
    </title>
    <indexterm>
      <primary>XML 标记</primary>
      <secondary>xref</secondary>
    </indexterm>
    <para>要引用手册中其他章节，使用 <command>&lt;xref&gt;</command> 标记。</para>
    <para>它的输出是您向读者指引的章节的标题。例如：</para>
    <screen>
      <computeroutput>
关于主控文件，请参考
&lt;xref linkend="ch-tutorial"&gt;&lt;/xref&gt; 和 &lt;xref linkend="s1-tutorial-parent"&gt;&lt;/xref&gt;
</computeroutput>
    </screen>
    <para>输出：</para>
    <para>关于主控文件，请参考 <xref linkend="ch-tutorial"/> 和 <xref linkend="s1-tutorial-parent"/>。</para>
  </sect1>
</chapter>