Conref使用三条信息直接引用重用元素:
- 包含引用元素的topic文件的路径
- 包含引用元素的topic的id
- 引用元素的id
文件路径和topic id以#号隔开,topic id和元素id以斜杠(/)隔开。
注: 一个不常见的情况是:如果被引用元素和引用元素在同一个文件中,可以省略文件的路径,但是#号必须保留。
例如,储存在文件../warehouse/warnings.dita中的一个仓库式文件(warehouse topic)包含一个重用<note>元素。
<topic id="warehouseWarnings"> ... <note type="danger" id="hotWarning">Surface are hot.</note> ...
在另一个topic中重用这个<note>元素,在合适的位置创建一个空的<note>元素,然后使用conref属性来指定要重用的元素。
... <note conref="../warehouse/warnings.dita#warehouseWarnings/hotWarning"/> ...
Conref属性的内容可能有点令人生畏或者难以记住。大多数DITA编辑工具会帮你填写conref属性。
下表中的例子展示了conref属性值在不同情况下是如何呈现的。你可以替换以下示例中的占位符:
-
topicID :待重用topic的id
-
targetID:重用元素的id
-
folder:本地文件系统的目录
-
file.dita:DITA文件的名称
-
http://example.com:网络计算机的名字
目标位置 | Conref属性值 |
---|---|
同一个topic中 | #topicID/targetID |
本地文件系统的一个topic | folder/file.dita#topicID/targetID |
网络位置中的一个topic | http://example.com/file.dita#topicID/targetID |