Docbook 5中的内部参考 [英] Internal references in docbook 5

问题描述

我试图在同一文档中编写对另一部分的内部引用.但是引用不起作用. 有一个参考，位于我的docbook文章的一个部分中

I tried to write an internal reference to another section in the same document. But references are not working. There is a reference, which is located in one section in my docbook-article

<xref linkend="id1</b>" endterm="Управление Роботом из программы short"/>

本文另一部分的一部分:

The part of another section in this article:

<section id="id1">
        <title>Управление Роботом из программы
        </title>
        <titleabbrev id="id1 short"> Управление Роботом из программы
        </titleabbrev>
        <para>
...
</para>
</section>

如何正确编写此参考?

我如何才能将一篇文章的参考文献写到另一篇文章的单独章节中?

And how can I write a reference form one article to the separate section in another?

推荐答案

如果要将titleabbrev内容用作交叉引用文本，请使用以下标记:

If you want to use the titleabbrev content as the cross-reference text, use the following markup:

<xref linkend="id1" endterm="short"/>

和

<section xml:id="id1">
    <title>Управление Роботом из программы
    </title>
    <titleabbrev xml:id="short"> Управление Роботом из программы
    </titleabbrev>
    <para>
...
</para>
</section>

交叉引用指向ID为id1的部分. endterm 值是其内容提供交叉引用文本的元素.

The cross-reference points to the section with an ID of id1. The endterm value is the ID (short) of the element whose content provides the cross-reference text.

请注意，在DocBook 5中，使用xml:id代替了id.

Note that in DocBook 5, xml:id is used instead of id.

关于文档之间的交叉引用，请阅读"DocBook XSL:完整指南"中的olink: http://www.sagehill.net/docbookxsl/Olinking.html .

Regarding cross references between documents, read about olink in "DocBook XSL: The Complete Guide": http://www.sagehill.net/docbookxsl/Olinking.html.

这篇关于Docbook 5中的内部参考的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！