Можно ли ссылаться на элемент DITA <topichead>? - PullRequest
0 голосов
/ 24 сентября 2018

Моя цель - предоставить ссылку на начало основного раздела документации, который начинается с элемента <topichead> только в качестве заголовка раздела.

Я не мог найти способ сделать это через conref.В основном файле карты sequence.ditamap элемент <topichead> записывается следующим образом:

<topichead id="th_adding_usrs">
    <topicmeta>
        <navtitle>Adding a new user to the team</navtitle>
    </topicmeta>
    <topicref href="tasks/requests.dita"/>
    <topicref href="tasks/db_sets.dita"/>
    <topicref href="tasks/user_support.dita"/>
</topichead>
<topicref href="concepts/integration.dita"/>

Ссылка на <topichead> th_adding_usrs встречается в теме integration.dita.

Начиная с integration.dita я пытался поместить conref="sequencing.ditamap#th_adding_usrs" внутри элемента <p>, а затем и элемента <ph>, но оба по-прежнему выдают ошибку (я использую редактор OxygenXML, v20.1) сообщая, что Conref не был расширен, потому что он не смог найти цель для conref="sequence.ditamap#th_adding_usrs".

Я также попробовал элемент <xref> внутри элемента <p> выше, сАтрибут conref также, как указано выше, но выдает ту же ошибку.

Возможно ли даже дать перекрестную ссылку (или иным образом предоставить интерактивную ссылку) на элемент <topichead>?

И, в более широком смысле, есть ли преимущество в использовании элемента <topichead> перед фактическим <topicref>, который имеет только заголовок и не имеет содержимого?Я придерживаюсь соглашения, используемого в моей компании, но я не обязан этого делать.Так что, если у <topichead> нет никаких преимуществ, я просто не буду использовать их в пользу только названия <topicref>.

1 Ответ

0 голосов
/ 24 сентября 2018

Добавление ключей к заголовку темы, а также topicrefs позволяет использовать атрибут keyref внутри элемента xref для ссылки на заголовок темы.

Итак, <topichead id="th_adding_usrs"> с добавленным ключом - <topichead keys=”adding_usrs” id="th_adding_usrs">, а тема integration.dita с ключом -.

В пределах integration.dita с использованием внешней ссылки, например: <p>Refer to <xref keyref=”adding_usrs”/></p> linksправильно.

...