DocBook学习
修订版本 <chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">1.6.7(<a href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/">http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/</a><a href="http://www.xiaowang.net/doc/docbook/"></a>)</chsdate>
版权 © 2005 limodou
本文档还在不停地写作、完善中，如果你有什么建议请与limodou联系。
本教程提供源码下载，大家可以下载源码在你的机器上进行测试。关于下载及转换见附录A, 关于本教程。
本文档版权所有者为limodou。你可以自由发布，引用，拷贝，但要保留此版权声明。
感谢 leasun 指出2.5节和2.16的错误。
特别感谢 <chsdate year="1899" month="12" day="30" islunardate="False" isrocdate="False" w:st="on">1.6.6</chsdate>版是在老康的帮助下完成的，不仅有好的建议，还帮助我改进了许多地方。
感谢 xuejm 指出2.5节的错误。
感谢 jxb 指出2.5节的错误。
感谢 Alex Dong 指出3.1节的错误。
目录
从这里开始学习DocBook
1. DocBook Book 结构
1.1. 一个Book示例
1.2. 多个物理文档
1.3. 块元素 vs. 环境
2. 常见环境介绍
2.1. 章、节、段
2.2. 使用entity做为宏替换
2.3. 例子
2.4. 图形
2.4.1. 使用figure环境
2.5. 代码片段
2.6. 屏幕输出
2.7. 编号图形
2.8. 脚注
2.9. 列表
2.9.1. 无序列表
2.9.2. 有序列表
2.9.3. 定义列表
2.10. 表格
2.10.1. 表格基础
2.10.2. 横向融合
2.10.3. 纵向融合
2.11. 处理过程
2.12. 链接
2.13. 块引用
2.14. 常见inline元素
2.15. 附录
2.15.1. 术语表
2.15.2. 参考书目
2.15.3. 修订历史
2.16. 警告信息
3. 输出HTML
3.1. 环境准备
3.2. xslt参数的使用
3.2.1. 在命令行中指定参数
3.2.2. 在驱动样式表中使用参数
3.3. 使用Saxon进行转换
3.4. docbook.xsl 还是 chunk.xsl
3.5. 本教程所用样式表参数解释
3.6. 中文处理
3.6.1. 编码
3.6.2. 调整相关xslt参数
3.7. 编辑DocBook文档
3.8. 关于输出要注意的其它问题
3.8.1. images目录
3.8.2. 常见的问题
3.8.3. CSS文件
3.8.4. UTF-8编码
A. 关于本教程
B. 文档修订历史
C. 常用术语
D. 参考书目
从这里开始学习DocBook
DocBook是什么？有什么用？我不想在这方面过多地叙述了。从现在开始，我只是想和大家一起来学习如何使用DocBook来进行写作。我会通过如何写一个Book来和大家一起学习。我会一点点地增加使用的element(元素)，从而使这个Book丰富起来。因此这篇文档是在不停的写作中，如果想要了解最新的内容，请访问我的Blog：limodou的学习记录。
这里所讨论的DocBook都是以XML为前提的，关于SGML的内容在这里不涉及。同时有关XML的知识如果可能我会加以说明，一些基础知识还请大家看一下有关资料。因此学习本教程希望你有一些XML的知识。
对于DocBook我经验也不丰富，之所以写这个教程主要是想把我所学过的东西拿出来与大家分享。因此这个教程一定有不足和错误的地方，希望大家指出来，以便我进行改正，从而使本教程变得实用。
第1章DocBook Book 结构
目录
1.1. 一个Book示例
1.2. 多个物理文档
1.3. 块元素 vs. 环境
1.1.一个Book示例
例1.1.一个Book示例
<shapetype id="_x0000_t75" coordsize="21600,21600" o:spt="75" o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f"><font face="宋体" size="3"> <stroke joinstyle="miter"></stroke></font><formulas><font face="宋体" size="3"> <f eqn="if lineDrawn pixelLineWidth 0"></f><f eqn="sum @0 1 0"></f><f eqn="sum 0 0 @1"></f><f eqn="prod @2 1 2"></f><f eqn="prod @3 21600 pixelWidth"></f><f eqn="prod @3 21600 pixelHeight"></f><f eqn="sum @0 0 1"></f><f eqn="prod @6 1 2"></f><f eqn="prod @7 21600 pixelWidth"></f><f eqn="sum @8 21600 0"></f><f eqn="prod @7 21600 pixelHeight"></f><f eqn="sum @10 21600 0"></f></font></formulas><font face="宋体" size="3"> <path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"></path><lock v:ext="edit" aspectratio="t"></lock></font></shapetype><shape id="_x0000_i1028" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="1"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/1.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image001.gif"></imagedata></font></shape><?xml version="1.0" encoding="gb2312"?>
<shape id="_x0000_i1029" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="2"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/2.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image002.gif"></imagedata></font></shape><!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<shape id="_x0000_i1030" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="3"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/3.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image003.gif"></imagedata></font></shape><book>
<shape id="_x0000_i1031" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="4"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/4.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image004.gif"></imagedata></font></shape><bookinfo>
<title>DocBook 学习</title>
<author>
<othername>limodou</othername>
</author>
</bookinfo>
<shape id="_x0000_i1032" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="5"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/5.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image005.gif"></imagedata></font></shape><chapter>
<shape id="_x0000_i1033" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="6"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/6.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image006.gif"></imagedata></font></shape><title> ... </title>
<shape id="_x0000_i1034" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="7"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/7.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image007.gif"></imagedata></font></shape><sect1> ... </sect1>
</chapter>
<chapter>
<title> ... </title>
<sect1> ... </sect1>
</chapter>
</book>
上面就是一个Book的简单样子，我会逐步改造它，使它变得越来越丰富。
1.2.多个物理文档
XML文档允许你将一个大文档拆分成多个文档。你看到的本教程就是一个例子。下面给出一个分成两个文件的例子。
例1.2.多文件示例
这是主文件，起名为main.xml
<?xml version="1.0" encoding="gb2312"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<shape id="_x0000_i1044" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="1"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/1.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image001.gif"></imagedata></font></shape> <!ENTITY chapter1 SYSTEM "chapter1.xml">
]>
<book>
<bookinfo>
<title>DocBook 学习</title>
<author>
<othername>limodou</othername>
</author>
<shape id="_x0000_i1045" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="2"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/2.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image002.gif"></imagedata></font></shape><para>这是一个演示多文档的示例。</para>
</bookinfo>
<shape id="_x0000_i1046" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="3"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/3.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image003.gif"></imagedata></font></shape>&chapter1;
<shape id="_x0000_i1047" style="WIDTH: 9pt; HEIGHT: 9pt" type="#_x0000_t75" alt="4"><font face="宋体" size="3"> <imagedata o:href="http://www.woodpecker.org.cn:9081/doc/XML/docbook_step_1.6.6/src/html/images/callouts/4.png" src="file:///C:%5CDOCUME~1%5CSnaill%5CLOCALS~1%5CTemp%5Cmsohtml1%5C01%5Cclip_image004.gif"></imagedata></font></shape><chapter id="chapter.2">
<title>标题</title>
<sect1> ... </sect1>
</chapter>
</book>
下面是次文件，文件名为chapter1.xml
<?xml version="1.0" encoding="gb2312"?>
<chapter id="bookstru">
<title>标题</title>
<sect1> ... </sect1>
</chapter>
chapter1.xml文件不需要也不可以包含DTD声明。
以上就是一个多文档的例子，你可以将内容安排在不同的文档中，然后通过一个主文档将它们组织起来。
1.3.块元素 vs. 环境
块元素(Block element)是一个容器，它可以包含其它的子元素和块元素(当然有些是有限制的)。关于块元素可以包含哪些子元素和块元素，这些都在DTD中有介绍。
<font
分享到：
相关推荐
### DocBook知识点详解 #### 一、DocBook概述 **DocBook**是一种强大的文档标记语言标准，主要用于技术文档的编写，尤其是与计算机硬件和软件相关的书籍及论文。它支持多种语言，包括RELAX NG、SGML (Standard ...
### Docbook开发手记 v1.2 知识点概览 #### 一、Docbook简介 - **1.1 Docbook出现的背景** - Docbook 的出现是为了满足技术文档编写的需求，尤其是在软件开发领域。传统的文档撰写方式通常依赖于特定的排版系统...
关于的DocBook的资料, 本人看过,觉得很不错,讲解很详细,应该对想学习DocBook的人有些帮助
本书全面介绍了DocBook V5.0的相关知识和技术细节，为用户提供了一套详尽且实用的手册。 #### 二、作者与出版信息 - **作者**：诺曼·沃尔什是一位资深的技术文档专家，拥有多年的技术写作经验。 - **编辑**：...
在《DocBook 5.0中文版》中，读者可以学习到创建DocBook文档的基本步骤，包括XML声明、文档类型声明、内部子集、文档（或根）元素等内容。其中，XML声明用于指示解析器文档采用的字符编码；文档类型声明则用于指定...
1 docbook-xsl-ns-1.75.2.zip解压到D:\docbook 2 另外四个压缩包解压出来，把里面的bin，include和lib三个文件夹拷贝到D:\docbook\xsltproc目录下 2 环境变量Path中增加 D:\docbook\xsltproc\bin 3 新建一个bat，...
### Windows 下配置 Docbook #### 一、Docbook 概述 **1.1 Docbook 出现的背景** 随着互联网技术的发展与信息量的急剧增加，文档的编写与管理面临着越来越大的...希望本文能帮助您在 Docbook 的学习道路上更进一步。
对于想要深入学习或使用DocBook的IT专业人员来说，DocBook 5.0的最终指南是一份非常有价值的参考资料。它不仅覆盖了理论知识，还可能涉及实践操作，帮助技术写作人员制作出结构化、标准化的高质量技术文档。
DocBook是一种XML（可扩展标记语言）文档格式，专门用于...通过深入学习这两份文档，你将能够熟练掌握DocBook的使用，从而编写出专业且结构清晰的技术文档。无论是个人项目还是团队合作，DocBook都能成为你的得力助手。
标题“docbook-style-xsl.zip”表明这是一个包含DocBook风格XSL转换文件的压缩包。DocBook是一种XML架构，常用于编写技术文档，如手册、教程和参考指南。它允许内容作者专注于文档的内容，而不是排版，然后通过XSL...
在实际应用中，学习并熟练使用DocBook需要理解XML的基本原理，熟悉DocBook的元素结构，并掌握至少一种转换工具。对于大型项目，可能还需要了解版本控制、自动化构建流程等。通过不断的实践和调试，可以创建出专业且...
1. **学习曲线**：由于 DocBook 是基于 XML 的，初学者可能会觉得学习曲线较陡峭。不过，一旦掌握了基本的 XML 和 DocBook 元素，就能快速上手。 2. **工具支持**：DocBook 提供了一系列工具，如 `db2html`、`db2...
通过以上知识点的学习，读者不仅可以掌握DocBook的基础知识，还能了解到如何利用DocBook进行文档定制化设置，进一步提升文档的质量和阅读体验。无论是技术文档作者还是对文档编写感兴趣的读者，都能从本指南中获得有...
《DocBook XML 4.2：构建技术文档的利器》 DocBook，作为一个标准化的XML词汇表，是用于编写技术文档的强大工具。DocBook XML 4.2版本是这一系列中的一个重要里程碑，它提供了丰富的元素和属性，使得作者能够详细地...
docbook2asciidoc, 将DocBook转换为AsciiDoc的XSL 这是将 DocBook 4.5转换为 AsciiDoc插件的样式表，最初由 bjepson 启动。依赖项这个项目有一个模块 ( https://github.com/oreillymedia/docbook2htmlbook ) 。
DocBook DTD的官方文档。 设计为对DocBook DTD的清晰，简洁，规范的参考。
DocBook 是一个流行的XML文档格式，它用于编写技术文档，如手册、教程、参考指南等。这个"docbook-xsl-1.73.2.zip"压缩包包含的是DocBook XSL样式表的1.73.2版本，这是一个关键组件在将DocBook XML文档转换成各种...
7. **文档支持**：提供了详尽的用户手册和在线帮助，方便用户学习和解决问题。 在使用XMLMind DocBook工具时，你需要了解一些基本的DocBook标签和结构，例如`<book>`、`<chapter>`、`<section>`、`<para>`等，这些...
英文名称：Writing Documentation Using DocBook 中文名称：Docbook写作指南 DocBook提供了一个使用SGML/XML撰写结构化文档的系统。这个系统非常适合于计算机类的文章、书籍、论文等的出版，当然并不仅仅限于计算机...