DocBook 是专为技术文档设计的 XML 标准,核心是内容与格式分离;它通过语义化标签描述文档结构,支持多格式输出、强中文支持及长期存档。

DocBook 是一种专为技术文档设计的 XML 标准,核心目标是把内容和格式彻底分开。它不是排版工具,也不是写作软件,而是一套结构化、语义明确的 XML 标签规范,用来准确描述文档“是什么”——比如哪部分是章节标题、哪段是代码块、哪个是参数说明、哪里该插入示意图等。
为什么用 DocBook 写技术文档
技术文档常需多渠道发布:网页帮助、PDF 手册、命令行 man 页、甚至 Kindle 或 ePub。DocBook 的优势正在于此:
- 一份源文件(XML)可生成 HTML、PDF、ePub、文本、手册页等多种格式,靠的是 XSLT 样式表驱动转换
- 标签语义强,比如
、、 直接表达技术含义,比通用 HTML 更精准 - 不依赖特定编辑器或平台,纯文本 XML 文件可长期存档、版本控制、协作审阅
- 中文支持成熟,配合 FOP 或 dblatex 等工具链,能稳定输出带中文字体、目录、页眉页脚的 PDF
DocBook 的实际组成
它不是一个单一文件,而是一整套协同工作的标准组件:
Unix in a Nutshell同时涵盖了许多重要的、业界标准的开放源码工具 本书还完整地讨论了常用的shell(bash、ksh及tcsh)和重要元素如正则表达式,乃至旧式工具如sed、awk与vi。 Unix不是一个庞大的物体:它是一个综合体,而《Unix技术手册》则是将这一切合并在一起的一本书。 到底unix是什么?原始的unix源码是由sco拥有,unix注册商标是由open group拥有,而领先的仿unix系统则是gnu/linux、mac os x及solaris。这些版本所附的命令与选
- 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 构建。它适合中大型技术文档项目,尤其当团队需要长期维护、多语言、多格式交付时,价值尤为明显。









