docbook - DocBook 中的列表项编号可以交叉引用吗？

Question

我是否可以像这样在 docbook 中编写订单列表，以便段落中的文本引用以前的列表项标签？例如，我希望下面的第 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>

Answer 1

是的，这是可能的。使用 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 .