2.12. 链接

链接是表示一个连接到其它文档的一个点。它有几种形式。

ulink

一般要使用它的url属性。

例 2.18. ulink举例

1<ulink url="http://pyrecord.freezope.org/docbook/index.html"><citetitle>DocBook学习</citetitle></ulink>
2<ulink url="http://diveintopython.org"/>

结果如下:

引用文档:DocBook学习。链接站点: http://diveintopython.org

1

此处还使用了citetitle标记,它表示引用一个标题。一般产生的效果就是斜体。引用文档可以使用这种方式。

2

ulink中没有包括任何文字。因此会将url属性值作为包括的内容。

link

通用的链接元素。

例 2.19. link举例

1<link linkend="bookstru">引用第一章</link>
2<link linkend="bookstru" endterm="sect.1.1.title"/>

结果如下:

链接1:引用第一章 链接2:一个Book示例

1

linkend属性表示链接到哪个元素的id上去。因为id要求是唯一的,每个元素的id必须不同。link所包含的文字会显示为链接。本例为链到第一章的链接。

2

endterm表示链接文字用那个id的元素内容进行显示。这样做的效果就是把指定id的元素的内容显示为链接文本。本例为链到第一章的链接,但链接文字使用了第一章第一节的标题。

如果不想使用某个元素定义的id,而是想引用任意位置该怎么办呢?可以使用anchor元素,在其中设置它的id属性即可。

例 2.20. 设置锚点(链接点)

<para>这是一个测试用例。这里<anchor id="anchor.1"/>是一个anchor。</para>

这样就设置了一个anchor,在后面就可以使用link对其进行链接了。

xref

它与link类似,不同之处它是一个空元素[3]。它的链接文本是通过处理器根据指定id元素的内容生成的。

例 2.21. xref示例

<xref linkend="bookstru" endterm="sect.1.1.title"/>

运行结果为:一个Book示例



[3] 空元素不是成对的,它只有属性,不包含内容。形如:<anchor id="id.1"/>