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