DocBook 是专为技术文档设计的 XML 标准，核心是内容与格式分离；它通过语义化标签描述文档结构，支持多格式输出、强中文支持及长期存档。
DocBook 是一种专为技术文档设计的 XML 标准，核心目标是把内容和格式彻底分开。它不是排版工具，也不是写作软件，而是一套结构化、语义明确的 XML 标签规范，用来准确描述文档“是什么”——比如哪部分是章节标题、哪段是代码块、哪个是参数说明、哪里该插入示意图等。
为什么用 DocBook 写技术文档
技术文档常需多渠道发布：网页帮助、PDF 手册、命令行 man 页、甚至 Kindle 或 ePub。DocBook 的优势正在于此：
- 一份源文件（XML）可生成 HTML、PDF、ePub、文本、手册页等多种格式，靠的是 XSLT 样式表驱动转换
- 标签语义强，比如
、、 直接表达技术含义，比通用 HTML 更精准 - 不依赖特定编辑器或平台，纯文本 XML 文件可长期存档、版本控制、协作审阅
- 中文支持成熟，配合 FOP 或 dblatex 等工具链，能稳定输出带中文字体、目录、页眉页脚的 PDF
DocBook 的实际组成
它不是一个单一文件，而是一整套协同工作的标准组件：
- DTD 或 RELAX NG 模式：定义合法标签结构（如 DocBook 5.x 主要用 RELAX NG，4.x 多用 DTD）
- XSL 样式表：由 OASIS 官方维护，把 XML 内容映射成 HTML 或 FO（Formatting Objects）用于 PDF 渲染
- 转换工具链：常用组合包括 xsltproc + FOP（生成 PDF）、xsltproc + htmlhelp（生成 CHM）、或集成进 Ant/Maven/Eclipse 插件自动构建
和普通写作工具的区别
它不提供所见即所得界面，也不直接渲染美观样式。作者写的是结构，不是外观：
- 你写
安装步骤 请运行以下命令： make install - 样式表决定“section”是否加编号、标题用几号字、screen 是否带灰底和等宽字体、是否自动高亮命令关键词
- 同一份 XML，换一套 XSL，就能输出适配 Web 帮助系统的响应式 HTML，或打印友好的双栏 PDF
谁在用 DocBook
Linux 内核文档、GNOME 和 KDE 官方手册、PostgreSQL 用户指南、很多开源项目的 API 文档都基于 DocBook 构建。它适合中大型技术文档项目，尤其当团队需要长期维护、多语言、多格式交付时，价值尤为明显。
