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

Question

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

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

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

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

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

И как я могу написать ссылочную форму одной статьи в отдельный раздел в другой?

Answer 1

Если вы хотите использовать содержание 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.