引用
“DITA 引用”主题描述某主题或产品的常规功能,例如编程语言或应用程序编程接口 (application programming interface,简称 API) 中的命令。DITA 引用主题可以提供具有常规内容(包括技巧、目录、书目和类似的结构化说明性信息)的任何主题的相关信息。
“引用”包含以下主要标记:
• reference - 包含所有其他标记
• title - 主题的标题
• shortdesc - 主题的简短说明或概述
• prolog - 有关主题的各种元数据,如作者、版权、索引术语,等等
• refbody - 包含主题的实际内容
“引用”通常组织为可以任意顺序排列的一个或多个节、表格和列表。以下是“引用”正文中的主要标记:
◦ section - 要在引用中分组的内容的容器
◦ refsyn - 语法或类似信息
◦ properties - 与引用主题关联的属性列表,通常以表格形式显示
◦ example – 用于说明或支持引用信息的示例
refbody 标记也能包含标准 DITA 表。
• related-links - 包含指向相关信息的交叉引用链接
以上大多数标记是可选的,因此可以只使用创作主题所需的标记。