Можно ли ссылаться на элемент DITA <topichead>?

Question

Моя цель - предоставить ссылку на начало основного раздела документации, который начинается с <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>,

Answer 1

Добавление ключей к заголовку темы, а также 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> ссылки правильно.