可以交叉引用DocBook中的listitem数字吗?

时间:2013-11-14 12:46:00

标签: docbook

我是否可以在docbook中编写一份订单列表,以便段落中的文字引用之前的listitem标签?例如,我希望下面的第3段自动解析为“重复步骤1到2”。

<orderedlist numeration="arabic">
  <listitem>
    <para>Do foo</para>
  </listitem>
  <listitem>
    <para>Do bar</para>
  </listitem>
  <listitem>
    <para>Repeat steps # to #</para>
  </listitem>
  <listitem>
    <para>Do baz</para>
  </listitem>
</orderedlist>

1 个答案:

答案 0 :(得分:3)

是的,这是可能的。使用xml:id<xref linkend="..."/>

<orderedlist numeration="arabic">
  <listitem xml:id="foo">
    <para>Do foo</para>
  </listitem>
  <listitem xml:id="bar">
    <para>Do bar</para>
  </listitem>
  <listitem>
    <para>Repeat steps <xref linkend="foo"/> to <xref linkend="bar"/>.</para>
  </listitem>
  <listitem>
    <para>Do baz</para>
  </listitem>
</orderedlist>

使用DocBook-XSL处理包含上述标记的DocBook源文件时,您将在生成的HTML(或PDF)中获得“重复步骤1到2”。

如果您未使用DocBook 5,请将xml:id更改为id