2.7. 编号图形

你在本教程的例 1.1 “一个Book示例”中可以看到,在某些代码行前面有一个编号的小图形,同时在下面有对这些点的解释。如果在你的文档中想使用这种效果,要使用calloutlist环境。

例 2.8. 编号图形示例

1<programlisting>
2<co id="co.1.1.1"/>&lt;?xml version="1.0" encoding="gb2312"?>
<co id="co.1.1.2"/>&lt;!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<co id="co.1.1.3"/>&lt;book>
<co id="co.1.1.4"/>&lt;bookinfo>
&lt;title>DocBook 学习&lt;/title>
&lt;author>
&lt;othername>limodou&lt;/othername>
&lt;/author>
&lt;/bookinfo>
<co id="co.1.1.5"/>&lt;chapter>
<co id="co.1.1.6"/>&lt;title> ... &lt;/title>
<co id="co.1.1.7"/>&lt;sect1> ... &lt;/sect1>
&lt;/chapter>
&lt;chapter>
&lt;title> ... &lt;/title>
&lt;sect1> ... &lt;/sect1>
&lt;/chapter>
&lt;/book>
</programlisting>
3<calloutlist>
4<callout arearefs="co.1.1.1">
5<para>&xml;文档声明。<literal>encoding</literal>为xml文档所用编码。一个&xml;文档必须要有声明,而且这个声明必须是文档的开始。即声明前不能有任何内容,包括空白。</para>
</callout>
</calloutlist>
1

programlisting环境开始。

2

使用co元素来定义一个小图形的插入点。图形上的数字会依次递增。要定义id属性。

3

calloutlist环境开始。

4

定义一个解释。需要在arearefs属性中对前面定义的编号进行引用。

5

对此编号的解释。