DITA XML 是专为技术文档设计的结构化内容标准，强制按主题组织内容，主题分 Concept、Task、Reference 等类型，映射（Map）通过 topicref 串联主题并控制发布逻辑，实现“一次编写、多处发布”。
DITA XML 是一种基于 XML 的结构化内容标准，专为技术文档、帮助系统和多渠道出版设计。它不是通用的 XML 文档格式，而是有一套明确定义的语法规则（DTD 或 Schema），强制内容按“主题”组织，强调可重用性、可维护性和自动化处理能力。
DITA 主题（Topic）是内容的基本单元
它不是一篇完整的用户手册或 PDF，而是一个独立、自包含、语义明确的信息块。每个主题有固定类型，最常用的是三类：
- Concept（概念）：解释“是什么”，比如“什么是缓存策略”“OAuth 2.0 的工作原理”。不包含操作步骤，只讲定义、背景、原理。
- Task（任务）：说明“怎么做”，结构严格，含“前提条件→步骤→结果验证”。例如“如何在 AEM Guides 中发布 DITA 映射”。每一步都应可执行、无歧义。
- Reference（参考）：提供“查什么”，如参数列表、API 返回码、命令语法、错误代码表。强调准确性和完整性，通常以表格或清单呈现。
其他类型还包括 troubleshooting（故障处理）、glossentry（术语条目）等，可根据需要扩展。
DITA 映射（Map）是内容的组织蓝图
它本身不包含正文，而是一个 XML 文件（后缀常为 .ditamap），用 <topicref> 等元素把多个主题按逻辑关系串联起来。映射决定：
- 哪些主题被包含、哪些被排除（通过
@processing-role="resource-only"可标记为仅用于引用，不出现在最终输出中） - 主题的阅读顺序（线性流程）与层级结构（如章节→子节→附录）
- 输出形态线索：哪些主题生成 PDF 的某章，哪些只出现在 Web 帮助的侧边栏，哪些用于响应式 HTML 的折叠面板
- 多语言、多版本、多产品的条件化发布（结合 DITAVAL 过滤文件）
一个典型场景：同一组“安装”“配置”“排错”主题，可通过不同映射分别组装成《管理员指南》《快速入门卡》《API 集成文档》，无需复制粘贴内容。
主题与映射分离，正是 DITA 实现“一次编写、多处发布”的核心机制。
