我的第一篇DOC BOOK

我的第一篇DOCBOOK文档

琴剑

<[email protected]>

早就对DocBook仰慕已久了，但是对我们这些受微软毒害很深的人来讲，想爱起来也不容易。且不说世面上没有可视化的编辑工具，而且将编译环境搭建起来也不容易。上网查找了DocBook资料,有大名鼎鼎的《DocBook助你完成传世之作》，还有《DocBook文件写作入门》，都是几年前写的。偏偏技术这个东西日新月异，按照网上的教程依葫芦画瓢，不是下载这个文件没找到，就是那个工具被新的给代替了。总之是折腾了两天，只留下几个半拉子文档，就没有一个成功的例子。其实我的要求很低，也不是准备写什么长篇大作，只要能写一个简单的"hello world",也可以给我一丝安慰呀。

偶然一次上网查资料，发现一篇讲在ubuntu下写作DocBook的文档，才发现在ubuntu设置DocBook编辑环境是如此的容易。现将设置步骤罗列出来，希望能够解脱和我同样还在迷雾中苦苦摸索的同仁。

1、安装转化工具和文档：

 $sudo apt-get install xsltproc
 $sudo apt-get install docbook-xsl
 $sudo apt-get install docbook-defguide 

那本大名鼎鼎的Docbook:The Definitive Guide，装完之后就可以直接在本机浏览器输入http://localhost/doc/docbook-defguide/html/docbook.html来阅读此书了。当然，你得装了apache，在ubuntu下一个命令即可轻松搞定:

$sudo apt-get install apache

2、新建文本文件，命名为test.xml，输入如下内容：

 <?xml version="1.0"?> 
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> 
 <article> 
 <title>Hello World</title>
 <para>Hello World!这是我的第一篇DocBook文档.</para> 
 </article>  

3、执行一下命令生成html文件

$xsltproc -o test.html /usr/share/xml/docbook/stylesheet/nwalsh/xhtml/docbook.xsl test.xml

执行完毕如无意外就可以在当前文件夹看到test.html，用浏览器打开看看！