2.15. 附录

生成附录要使用appendix环境。一个附录包含title,还包含内容。内容可以有很多,如:一般性文字,术语表,参考书目等。

2.15.1. 术语表

术语表一般使用glossary环境,它需要单独的title。在附录中使用它并不需要定义它,只需直接使用glossentry元素即可。

例 2.23. 术语表例子

1<glossentry id="xml">
2	<glossterm>XML</glossterm>
3	<glossdef><para>可扩展标记语言。</para>
	</glossdef>
</glossentry>
1

一个术语项定义。属性id可以用来作为引用点。在文章中可以使用glossterm来定义一个术语引用项,如:<glossterm linkend="xml">xml</glossterm>。这样就生成一个指向xml定义的一个链接。

2

术语名称

3

术语的解释。

2.15.2. 参考书目

参考书目一般使用bibliography环境,它需要单独的title。在附录中使用时不需要定义它,只需直接使用biblioentry元素即可。

例 2.24. 参考书目例子

<biblioentry>
1	<title>DocBook:The Definitive Guide</title>
2	<publisher>
		<publishername>O'Reilly & Associates, Inc.</publishername>
	</publisher>
3	<authorgroup>
		<author><othername>Norman Walsh</othername>
		</author>
		<author><othername>Leonard Muellner</othername>
		</author>
	</authorgroup>
</biblioentry>
1

书名。

2

出版者信息。

3

作者

本例所举的环境中,还有许多元素,这里不过是简化了。

2.15.3. 修订历史

修订历史用来记录对信息修改的历史。它使用revhistory环境。

例 2.25. 修订历史例子

<revhistory>
1<revision>
2<revnumber>1.0</revnumber>
3<date>2004-03-17</date>
4<revdescription>
<itemizedlist>
<listitem><para>增加 <xref linkend="sect.2.10"/></para></listitem>
<listitem><para>增加 <xref linkend="sect.2.11"/></para></listitem>
</itemizedlist>
</revdescription>
</revision>
</revhistory>
1

一个修订记录。

2

修订版本号

3

修订日期

4

本修订的描述。这里使用了无序列表来列出每个修改点。