是否可以引用 DITA <topichead> 元素？

Question

我的目标是在文档主要部分的开头提供一个 link，该部分仅以 <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"/>

在主题 integration.dita 中引用了 <topichead> th_adding_usrs。

从 integration.dita 开始，我尝试将 conref="sequencing.ditamap#th_adding_usrs" 放入 <p> 元素中，然后再放入 <ph> 元素，但两者仍然给我一个错误（我正在使用 OxygenXML 编辑器 v20.1) 报告 Conref 没有扩展，因为它无法找到 conref="sequence.ditamap#th_adding_usrs".

的目标

我也在上面的 <p> 元素中尝试了一个 <xref> 元素，conref 属性也和上面一样，但是得到了同样的错误。

甚至可以 cross-reference（或以其他方式提供可点击的 link）到 <topichead> 元素吗？

而且，更广泛地说，使用 <topichead> 元素与仅具有标题而没有内容的实际 <topicref> 元素相比是否有优势？我遵循我公司内部使用的惯例，但我不是必须这样做。所以，如果 <topichead> 没有优势，我将避免使用它们，而使用 title-only <topicref>.

Answer 1

将键添加到 topichead 以及 topicrefs 允许在外部参照元素内使用 keyref 属性 link totopichead。

所以 <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。

是否可以引用 DITA <topichead> 元素？

Is it possible to reference a DITA <topichead> element?

xml

dita

oxygenxml