Внутренние ссылки в docbook 5

Я попытался написать внутреннюю ссылку на другой раздел в том же документе. Но ссылки не работают. Есть ссылка, которая находится в одном разделе в моей докбуке-статье

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

Часть другого раздела в этой статье:

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

Как правильно написать эту ссылку?

А как написать ссылку из одной статьи на отдельный раздел в другой?


docbook docbook-5
person VeLKerr    schedule 14.09.2014    source источник

Ответы (1)


arrow_upward
2
arrow_downward

Если вы хотите использовать содержимое titleabbrev в качестве текста перекрестной ссылки, используйте следующую разметку:

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

и

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

Перекрестная ссылка указывает на раздел с идентификатором id1. Значение endterm – это идентификатор (short) элемента, содержание которого обеспечивает текст перекрестной ссылки.

Обратите внимание, что в DocBook 5 вместо id используется xml:id.

О перекрестных ссылках между документами см. olink в "DocBook XSL: The Complete Guide": http://www.sagehill.net/docbookxsl/Olinking.html.

person mzjn    schedule 27.09.2015