1.2.1. 建立好文件夹

为了以后更好的使用和扩展Docbook环境，所以此处专门设计了一个简单的架构。

即，不是为了演示，就随便糊弄一下。

下面的架构搭好之后，真正想要使用docbook的人，就可以在此基础上，一点点的扩展功能了。

当然，此处搭建的环境，也尽量的保持简洁，此处暂时只支持生成我们所需要的HTML和PDF。

下面就是要搭建的docbook环境所对应的文件夹结构

请自行在某个文件夹，比如我的是E:\DevRoot\docbook,下面建立对应的文件夹。

books1
    |
    |-- docbook5_demo2
            |
            |-- output3
            |   |
            |   |-- fo4
            |   |-- html5
            |   |-- pdf5
            |
            |-- src6

config7
    |
    |-- docbook-xsl-ns-1.77.18
    |-- fop9

tools
    |
    |-- docbook-xsl-ns-1.77.110
    |   |
    |   |-- fo
    |   |-- html
    |   ...
    |
    |-- fop-1.011
    |   |
    |   |-- build
    |   |-- conf
    |   |-- ...
    |
    |-- xslt12
        |
        |-- bin
        |-- include
        |-- lib

1

用于存放多个Docbook的book（书籍）

后期扩展：可以建更多的book，比如我当前的关于docbook开发笔记，就可以对应新建一个docbook_dev_note的book了。

2

接下来所要写的docbook 5的demo的book

3

用于存放各种格式的输出。

当前暂时为了演示，只建了fo，html，pdf

后期扩展：可以建更多的文件夹，比如htmls，rtf，chm，txt等存放更多的输出格式

4

用于存放fo文件。其可以被fop等工具转换为PDF，RTF等格式

5

用于存放最终生成的html，pdf等格式的文件。这些，是我们所想要的最终的结果。

6

用与存放docbook的xml源码文件。

后期扩展：当单个xml内容太多，可以考虑用xinclude分出多个xml文件，此时多个xml文件，都可以都放在此src文件夹下了。

7

用于存放所有的和Docbook相关的配置文件，包括xsl格式stylesheet文件，以及其他如fop的配置文件等。

后期扩展：其他的，比如，实体定义entity，catalog等等一些内容，也可以放在此config下。

8

此处之所以文件夹叫做docbook-xsl-ns-1.77.1，是由于最新的stylesheet是1.77.1版本的。

其作用是，设置对应的参数，可以控制html，pdf等输出的效果，包括显示效果方面的一些控制参数和输出内容格式组织方面的。

9

此处存放fop的配置。

目前暂时只需要一个fop.xconf文件即可。

10

下载并解压docbook-xsl-ns-1.77.1，然后放到此处即可。

如何下载docbook-xsl-ns-1.77.1参见第 1.2.3 节 “下载docbook-xsl-ns-1.77.1”

11

下载fop 1.0并解压，放到此处即可。

如何下载fop 1.0参见第 1.2.4.1 节 “下载fop-1.0”

12

下载xsltproc及相关文件，并解压，放到此处即可。

如何下载xsltproc及相关文件，参见第 1.2.2 节 “下载windos版本的xsltproc”

顺便贴出后来建立好的docbook环境的文件夹结构的截图：

安装上述介绍，建立好对应的文件夹后，就可以参考下面的步骤，下载相关文件，添加相关配置，编译生成html和pdf，然后最终搭建好docbook环境。

上一页 上一级 下一页
1.2. 纯Windows环境下的Docbook开发环境的搭建 起始页 1.2.2. 下载windos版本的xsltproc