12. 以名称 meetingMinutes.dita 保存引用。 完成的―引用‖应当如下所示:
相关链接
术语表
DITA 术语表主题提供单个术语及其关联的定义,使用户可以获得对陌生术语的解释。该主题也提供有关术语的附加信息。如果某术语有多种定义,您应为每个定义都创建一个单独的 DITA 术语表主题。 ―术语表‖包含以下主要标记:
? ? ? ? ?
glossentry - 包含所有其它标记 glossterm - 术语 glossdef - 定义
prolog - 有关主题的各种元数据,如作者、版权、索引术语,等等。 glossBody - 提供有关术语的附加信息
glossBody 标记包含若干其它标记,用于提供有关术语的附加信息,如词性、用途、术语变型等。
?
related-links - 到相关术语的交叉引用链接
以上大多数标记是可选的,因此可以只使用创作主题所需的标记。 相关链接
创建术语表
按照以下步骤创建―术语表‖主题:
1. 选择文件 ? 新建。
新建对话框打开。
2. 在新建对话框中选择 DITA Glossary 并单击确定。
DITA Glossary 模板载入到 Arbortext Editor 窗口中:
3. 在 glossterm 标记中输入以下文本:
Meeting Agenda
4. 在 glossdef 标记中输入以下文本:
A list of meeting activities in the order in which they are to be taken up, beginning with the call to order and ending with adjournment.It usually includes one or more specific items of business to be considered.It may, but is not required to, include specific times for one or more activities. 5. 以名称 meetingAgenda.dita 保存术语表。 完成的―术语表‖应当如下所示:
相关链接
插入节
本练习中,将需要在创建概念主题练习中创建的 prodMeetings.dita 文档。 section 标记使您可以将分区包含到 DITA 主题的正文中。除―术语表‖主题外的所有主题类型都允许在主题正文中包含节。节应当包含与主题直接相关的信息子集。如果要包含在节中的信息可以独立出来,那么应当将其包含在另一主题中。
如果在主题中包含了多个节,各节间不会表示为层级形式。它们是同级分区。节可以有一个可选的标题。
按照以下步骤将节包含到 prodMeetings.dita 文档中。
1. 在 Arbortext Editor 中打开 prodMeetings.dita。
2. 将光标放在 ul 标记之后并按 ENTER 键,以显示―快速标记‖菜单。
3. 在菜单中单击分区以将节插入到文档中。 4. 在 title 标记中输入以下文本:
Remote Meeting Participants 5. 在 title 标记后面插入 p 标记。 6. 在 p 标记中输入以下文本:
If your meeting includes participants who will attend remotely, make sure that you make adequate preparations for those attendees.For example, set up telephone conferences ahead of time, send out the meeting agenda by electronic mail, and so forth. 7. 保存文档。
完成的文档应当如下所示:
相关链接
生成 ID
本练习中,将需要在前面的练习中修改的 prodMeetings.dita 文档。
DITA 标记包含一个用于保存标记 ID 的 id 属性。通过 ID 可唯一地标识 DITA 主题或主题中包含某个标记。必须为所有主题分配一个 ID。第一次保存新主题时,DITA 应用程序会自动为该主题分配一个 ID。对于所有其它 DITA 标记,ID 是可选的。
使用 ID 标识链接或交叉引用的目标。DITA 应用程序还提供一个功能,可为任何 DITA 标记生成 ID。
按照以下步骤为标记生成 ID:
1. 在 prodMeetings.dita 文档中,将光标置于起始 section 标记的右侧:
2. 选择插入 ? 生成 ID。
DITA 应用程序为 section 标记生成一个 ID:
也可以使用生成 ID 3. 保存文档。
有关详细信息,请参考 Arbortext Editor 帮助中的定制 DITA ID 生成主题。 相关链接
工具栏按钮生成 ID。
使用资源管理器
可将以下类型的引用添加到 DITA 主题中:
交叉引用 ? 链接 ? 图像 ? 内容引用
?
为帮助您将这些引用类型添加到文档中,DITA 应用程序提供了资源管理器。资源管理器是一个对话框,可通过其浏览文件系统、内容管理系统或 Internet 以查找要添加到文档中的引用。它包含几个选项卡,可添加上面的所有引用类型:
通过选择视图 ? 资源管理器或选择资源管理器
工具栏按钮来调用资源管理器。某些情况下,在执
行与在 DITA 主题中插入引用相关的编辑操作时会打开资源管理器。例如,在选择插入 ? 图形时资源管理器会出现,驻靠在 Arbortext Editor 窗口的左侧,并且图像选项卡处于活动状态。 有关详细信息,请参考 Arbortext Editor 帮助中的资源管理器概述主题。
添加交叉引用
本练习中,将需要在前面的练习中创建的 prodMeetings.dita 和 meetingAgenda.dita 文档。 使用 DITA 交叉引用可以链接到正在创作的主题内部的内容。交叉引用也可以链接到另一主题、主题内部的标记或外部文档。交叉引用使用 xref 标记。
按照以下步骤将交叉引用添加到 prodMeetings.dita 文档中:
1. 在 Arbortext Editor 中打开 prodMeetings.dita。 2. 选择视图 ? 资源管理器。
将打开资源管理器,并且链接/Xref 选项卡处于活动状态。
3. 选择无序列表 (ul) 中第一个 li 标记中的单词 \。
4. 使用资源管理器浏览器导航到保存先前练习中创建的 DITA Glossary 的文件夹。