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

Question

我是否可以像这样在 docbook 中编写一个 orderlist，以便段落中的文本引用以前的 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>

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.