2

我的目标是提供一个指向文档主要部分开头的链接，该<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>我遵循公司内部使用的惯例，但我不需要这样做。因此，如果 a 没有优势<topichead>，我将避免使用它们来支持仅标题<topicref>。

4

1 回答 1

1

向 topichead 和 topicrefs 添加键允许使用外部参照元素内的 keyref 属性链接到 topichead。

所以<topichead id="th_adding_usrs">加了键的是 is <topichead keys=”adding_usrs” id="th_adding_usrs">，加了键的主题integration.dita是 。

在 内integration.dita，使用外部参照，如：<p>Refer to <xref keyref=”adding_usrs”/></p>正确链接。

于 2018-09-24T18:53:40.857 回答