制作Docbook文档.docVIP

/lyncn/archive/2006/05/11/725182.aspx /dollyn/archive/2009/11/14/4808308.aspx 制作Docbook文档 language=javascript type=text/javascriptdocument.title=制作Docbook文档 - +document.title 1. 制作Docbook文档需要了解的知识： 1) XML - 这是最基本的，如果这个都不懂的话，最好先找本入门级的书看看； 2) DTD - 有助于你理解Docbook的结构； 3) XSL - 有助于定制自己的Docbook； 4) XSL-FO - 最好了解一点，有助于更好的定制自己的PDF输出。 2. 制作Docbook文档的最简单的过程包括以下的步骤： 1) 编辑XML文件; 2) 对XML文件进行处理，生成HTML或者PDF文档。 2.1. 编辑XML文件 如果使用纯文本编辑器来完成这项工作，我敢打赌一天之后你就做不下去了，直接编辑XML可是一件苦差事。使用类似XMLSPY这样的工具，提供自动填充功能，并且随时可以进行有效性检查，不容易出错，可以让工作轻松不少。 Docbook文档分两类：书（book）和文章（article）。article就是一般的文章，不包含章（chapter），只有节（section）。book比较完整，可以包含前言（preface），部分（part），章（chapter），文章（article）等等。以上描述的都是Docbook DTD定义的元素，这里不可能给出详细的说明，具体每个元素的结构参见Docbook DTD。 让我们先来看一个book类型文档的典型定义： list 1. 典型的book类型文档 ?xml version=1.0 encoding=UTF-8? !DOCTYPE book PUBLIC -//OASIS//DTD DocBook XML V4.2//EN /docbook/xml/4.2/docbookx.dtd book bookinfo titleMy Book/title author firstnameMy First Name/firstname surnameMy Last Name/surname /author publisher publishernameCSDN/publishername /publisher isbnISBN#/isbn copyright year2005/year /copyright /bookinfo part titleMy Part/title chapter titleMy Chapter/title sect1 titleMy Section1/title paraThis is a demo of a book./para /sect1 /chapter /part /book 该文档声明使用的DTD为/docbook/xml/4.2/docbookx.dtd，所有的内容都包含在book元素中，bookinfo元素包含书名（title）、作者（author）、出版社（publisher）、书号（isbn）和版权（copyright）。接着part元素包含的内容是该书的一个部分，下面有一章，接着有一节（sect1），当然都有各自的标题。 怎么样，各个元素的含义是不是很显而易见，根据元素的名称，你就能知道自己的内容该包含在什么元素里面。 在上面的例子里面，有些元素不是必须的。譬如bookinfo，可以没有或者有一个，看Docbook DTD就可以知道。 下面我以article类型的文档为例子，说明Docbook文档的制作过程。 首先是XML声明，说明文档的一些基本信息： ?xml version=1.0 encoding=UTF-8? 紧接着是文档的DTD声明，说明文档使用的DTD还有根元素。典型的docbook文档的DTD声明如下： !DOCTYPE article PUBLIC -//OASIS//DTD DocBook XML V4.2//EN /docbook/xml/4.2/docbookx.dtd 这个声明表明，文档的根元素是article，使用外部DTD，该DTD用一个公共标识符-//OASIS//DTD DocBook XML V4.2//EN标识，该DTD位于网络的某处。标识符必须是全球唯一的，其形式为： prefix//owner-identifier/