DITA:conkeyref、keydef 和有效的 URI
DITA: conkeyref, keydef and valid URIs
我的公司正试图在 DITA 中使用类似于下面的代码作为他们的 conkeyrefs,我认为它是无效的,但想验证一下。
在他们的 DITA 主题中:
<element conkeyref="keyName"/>
在他们的 DITA 映射中:
<keydef href="fileName#elementID"
keys="keyName"/>
我很确定的 href 无效:应该是 "fileName#topicID/elementID"
但我也不确定他们是如何结合使用 href 和 conkeyref 的。在我通过在线搜索的所有信息中,我找不到像上面这样的例子,所有的例子都像下面的例子(当引用地图或主题中的元素而不是主题或地图本身时)。
话题中:
<element conkeyref="keyName/elementID"/>
地图中:
<keydef href="fileName" keys="keyName"/>
我公司使用的组合是否有效 - 只是很少使用?
DITA 映射中的键定义必须始终使用 @href 属性指向主题 ID。
所以它可以是这样的:
<keydef href="fileName"/>
在这种情况下它指向文件中的第一个主题或像这样:
<keydef href="fileName#topicId"/>
在这种情况下,它指向文件中的特定主题。
但它永远不能指向文件中的特定元素 ID。
DITA 1.3 规范:
https://www.oxygenxml.com/dita/1.3/specs/langRef/base/keydef.html
表示对于@href 属性:
References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic.
此致,
拉杜
我的公司正试图在 DITA 中使用类似于下面的代码作为他们的 conkeyrefs,我认为它是无效的,但想验证一下。
在他们的 DITA 主题中:
<element conkeyref="keyName"/>
在他们的 DITA 映射中:
<keydef href="fileName#elementID"
keys="keyName"/>
我很确定的 href 无效:应该是 "fileName#topicID/elementID"
但我也不确定他们是如何结合使用 href 和 conkeyref 的。在我通过在线搜索的所有信息中,我找不到像上面这样的例子,所有的例子都像下面的例子(当引用地图或主题中的元素而不是主题或地图本身时)。 话题中:
<element conkeyref="keyName/elementID"/>
地图中:
<keydef href="fileName" keys="keyName"/>
我公司使用的组合是否有效 - 只是很少使用?
DITA 映射中的键定义必须始终使用 @href 属性指向主题 ID。 所以它可以是这样的:
<keydef href="fileName"/>
在这种情况下它指向文件中的第一个主题或像这样:
<keydef href="fileName#topicId"/>
在这种情况下,它指向文件中的特定主题。 但它永远不能指向文件中的特定元素 ID。
DITA 1.3 规范: https://www.oxygenxml.com/dita/1.3/specs/langRef/base/keydef.html
表示对于@href 属性:
References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic.
此致, 拉杜