docbook初步使用指南

最新推荐文章于 2024-08-26 08:55:39 发布

原创最新推荐文章于 2024-08-26 08:55:39 发布 · 1.4k 阅读

本内容遵循CC 4.0 BY-SA版权协议

本文介绍了如何在Ubuntu环境下使用DocBook XML编写文档，并通过XMLCopyEditor编辑，利用xsltproc和fop转换为HTML和PDF格式。通过一个具体的实例展示了DocBook工具的便捷之处，适合Ubuntu和Windows用户。

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