DITA 内容引用概述
DITA 内容引用 (conref) 允许您将某一 DITA 文档中的元素内容包含在另一个 DITA 文档中。如果使用内容引用将来自另一个文档的内容包含在内,则所包含的内容会替换引用元素中的任何内容。合并来自引用元素和被引用元素的属性是个例外,在用于定义样式和文档发布的解析文档中支持此操作。
内容引用取决于元素,因此,您引用的元素必须与包含内容引用的元素相同。所引用的内容可以在文档中查看,但不能进行编辑。您必须修改引用的原始源文档才能进行更改。Arbortext Editor 可使用资源管理器来查找要在文档中引用的内容。如果您的文档中目前不存在有效的引用元素,资源管理器会自动将一个新的空元素插入到您的文档中,作为内容引用的目标。
内容引用由您的文档类型中的某属性来定义。此属性在文档类型配置文件 (.dcf 文件) 中定义。对于 DITA 文档,conref 属性在多数 DITA 元素上均可用,并且用作内容引用属性。
在内容引用属性中,在 DITA 主题中引用元素的字符串采用以下格式:
[[路径/]文件名][#主题 id[/元素 id]]
[[路径/]文件名] 是对包含引用的文件的可选引用。它可以是绝对文件名或相对文件名,并且可以包括路径组成部分。如果未指定文件名,则假定该引用是在当前文档中。如果未指定绝对文件名,则会使用 DITA 引用路径来解析该内容引用。
主题 id/元素 id 是文档内 ID 属性的导航路径。主题 id 是包含要引用的元素的 DITA 主题元素(或主题的专门化,例如概念、任务或引用)的标识符。元素 id 是该主题中要重复使用的元素(例如段落或列表项)的标识符。对于主题中的内容引用,这两项都是必需的。如果省略元素 id,则引用包括整个主题。如果同时省略主题 id 和元素 id,则引用对应的是该文件中的第一个主题。
在内容引用属性中,在 DITA 映射中引用元素的字符串采用以下格式:
[[路径/]文件名][#映射元素 id]
对于 DITA 映射中对元素的引用,只有元素 ID 是必需的。如果省略映射元素 id,则引用对应整个映射。如果省略文件名,则引用对应的是当前文档中的某元素。
例如,假定 DITA 段落元素包含以下内容引用:
<p conref=”C:\DITA content\releases.dita#product/version”></p>
conref 属性指明所包含的 p 元素内容应来自 ID 为 version 的 p 元素,该元素是 ID 为 product 的主题元素 (位于 releases.dita 文档中) 的子元素。所引用的 releases.dita 文档包含以下元素:
<topic id=”product">
...
<p id=”version”>...</p>
..
</topic>