第 1 章 Windows下的Docbook的环境搭建

目录

1.1. 搭建Docbook之前需要知道的最基本的事情
1.1.1. 我们的目标
1.1.2. 关于格式转换方面的知识
1.2. 纯Windows环境下的Docbook开发环境的搭建
1.2.1. 建立好文件夹
1.2.2. 下载windos版本的xsltproc
1.2.3. 下载docbook-xsl-ns-1.77.1
1.2.4. 下载fop-1.0并添加fop配置文件
1.2.4.1. 下载fop-1.0
1.2.4.2. 配置FOP的环境变量FOP_HOME
1.2.4.3. 添加fop配置文件fop.xconf
1.2.5. 准备docbook的源码:xml文件
1.2.6. 从xml生成html
1.2.6.1. 为生成html准备配置文件
1.2.6.2. 将xml转换为html
1.2.7. 从xml生成pdf
1.2.7.1. 为生成pdf准备配置文件
1.2.7.2. 将xml转换为fo
1.2.7.3. 将fo转换为pdf
1.3. Windows环境下的,基于Cygwin的Docbook开发环境的搭建
1.3.1. 安装Cygwin
1.3.2. 下载cygwin下使用fop-1.0

摘要

1.1. 搭建Docbook之前需要知道的最基本的事情

1.1.1. 我们的目标

首先要清楚,我们想要得到什么。

我们想要得到的就是,写了符合Docbook规定的xml源文件之后,然后用工具可以生成多种格式的输出,此所谓”一种输入,多种输出“。

为了达到此目标,所以才要搭建一个docbook环境,配置一些东西,使用一些工具,将xml文件转换为HTML,PDF等多种格式。

简单的说,此时我们的目的就是,搭建一个最基本的Docbook环境,至少先支持这些基本的功能:

  1. 可以将Docbook的xml文件转换生成为HTML和PDF两种格式
  2. 支持中文字体
  3. 支持多个分割的(单独的)文件

    此种情况主要适用于,当你写了一本内容很多的书籍的话,肯定有必要将其分为多个章节

    而每个章节,希望放在一个单独的xml文件中,然后用一个总的xml,将每个章节包含进来。

    此时,这多个独立的章节所对应的各个xml文件,就称为多个分割的(xml)文件

1.1.2. 关于格式转换方面的知识

将docbook的xml源码,转换为HTML,PDF等格式的话,有多种方法,其中涉及多种工具。

此处暂时不需要理会太多,只需要知道这两点即可:

  1. 如何得到HTMl

    xsltproc可以将xml文件转换为HTML文件

  2. 如何获得PDF

    xsltproc将xml转换为FO文件

    然后用fop将FO文件转换为PDF文件

下面要介绍的docbook的环境,也都是关于xsltproc和fop这两方面。