使用 DITA 文档的链接
DITA 主题具有两种不同类型的链接。在主题的正文中,可以使用 xref 元素插入交叉引用或行内链接。在主题的 related-links 部分,可以使用 link 元素插入链接。发布 DITA 映射时还可以从关系表格生成相关链接。xref 可以链接到主题、主题内的元素以及外部文档。link 只能引用主题和外部文档,而不能引用主题内的元素。
资源管理器包含链接/Xref 选项卡,该选项卡可用于在文件系统、CMS 或 Internet 中浏览要用作链接目标的文档。该选项卡还可用于在文档中进行浏览,以查找要链接的特定元素。修改属性对话框、文档结构图和“列”视图 (可用于修改现有链接) 中提供了链接/Xref 选项卡的浮动版本。
在 DITA 主题中插入交叉引用或链接时,
Arbortext Editor 将检索目标的标题和简短说明 (如果可用),并在“编辑”视图中显示该信息。这使您能够确定生成的文本对于链接是否足够,或者是否需要手动编写链接的文本。显示的链接文本前面加有一个棕色的菱形,并且背景为灰色 (
)。如果链接目标没有可用标题,消息
在目标中无标题;需要创作链接文本将作为预览文本显示。
如果要创作交叉引用或链接文本而不使用生成的文本,则可轻松地删除预览文本。在预览文本上单击鼠标指针或将光标移到预览文本中时,将选择所有预览文本。选择预览文本后,可将其删除,或者只开始键入创作的链接或说明文本。也可以使用“编辑”窗口快捷菜单选项使用创作链接文本和使用生成的链接文本在这两种文本类型之间切换。可以使用更新引用功能以重新显示删除的预览文本或更新预览文本。
预览文本只适用于 DITA 文档的本地引用。Arbortext Editor 将尝试依次从以下元素检索标题信息:navtitle 元素、title 元素、DITA 主题中的 searchtitle 元素。说明文本从 shortdesc 元素进行检索。
请注意,在发布文档时,不会使用“编辑”视图中显示的链接预览文本。发布过程在发布时要么使用创作的链接文本,要么从链接目标获取标题和说明信息。