docbook初步使用指南

DocBook XML的使用

 

---

 

我们可以书写一个通用的SGML/XML文本，然后，等工具把这份文本转换为如txt，html,pdf...其他格式！这样我们只需要维护一份文档，同时可以生成多中其他格式的文档，这就是DOCBOOK工具的目的！概要地说：

• 写作-->SGML/XML
• 校对-->DTD
• 排版打印-->StyleShee

用一个具体的是实例来说明一切(本实例应该只合适Debian/ubuntu window下如何使用不要问我！我讨厌“微软”)：

• 系统环境：ubuntu 9.10
• 编辑工具：xmlcopyeditor 1.2
• 必要的软件软件包：docbook，xsltproc，docbook-xsl-html，fop等软件l

---

新建一个名字为new.xml的文本文件，字符集设置为UTF-8,输入如下内容：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML 4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<book>
  <title>深蓝的笔记</title>
  <chapter>
    <title>DocBook入门</title>
    <para>DocBook 是一种模式（在多种语言下可用，包括RELAX NG、SGML 和 XML DTDs ，以及 W3C XML 模式），它由OASIS 的DocBook 技术委员会维护。它非常适合于关于计算机硬件和软件的书籍和论文（虽然它绝不限于这些应用）。</para>
    <para>因为它是一个大而强壮的模式，因为它的主要结构符合一般概念所构成的"书"，DocBook 已被一个庞大而且还在成长中的作者群用于所有种类书籍的编写。DocBook 由一系列商业工具支持"out of box"，并且大量自由软件环境也在迅速扩大对它的支持。这些特性结合起来使得 DocBook 成为一种易于理解、广泛应用和非常受欢迎的模式。全世界有许多组织将 DocBook 用于数百万页的文档，这些文档有不同的打印和在线格式。</para>
  </chapter>
</book>

---

将其放在你的主目录下，执行命令：

 

转换为HTML

xsltproc --output ~/my.html /usr/share/sgml/docbook/stylesheet/xsl/docbook-xsl/html/docbook.xsl  new.xml

转换为PDF

xsltproc --output ~/my.fo /usr/share/sgml/docbook/stylesheet/xsl/docbook-xsl/html/docbook.xsl  new.xml

fop ~/my.fo my.pdf

 

---