DocBook
来自 Whodo Wiki (混沌初开)
|
浏览所有 DocBook 格式文档，请参见: DocBook 分类文档。 |
《DocBook Howto》
- 作者: Jiangxin,
- 提交时间: 2006/04/17
- 文档链接:
目录 |
[编辑] 1 DocBook: Whodo 之母
如果没有 DocBook，就不会有 2002 年底，WorldHello.net 建站的动机。《DocBook Howto》从那时起，断断续续在写，总是由于这样或者那样的借口，写写停停。2005 年从公司辞职，想干一些真正喜欢的事情，WorldHello.net 更是无暇顾及，这时一些热心的朋友的来信，对 DocBook 的殷切关注，使我产生了一个想法：就是既然自己没有精力，为什么不把它共享出来，提供一个平台，让关心它的网友们共同来完成？于是 Whodo 诞生了。
基于上述原因，我称 DocBook 为 Whodo 之母。
[编辑] 2 什么是 DocBook？
我称 DocBook 为文档的再一次革命，是即 WYSIWYG (所见即所得) 方式文档撰写之后的又一次革命。纯文本文件格式，到各种 WYSIWYG 编辑器的二进制文本格式，再到纯文本(XML)格式的 DocBook，看似又回到了起点，实则一次升华。
二进制的 WYSIWYG 文档是商业软件对垄断追求的产物，当编辑软件寿终正寝之时，用该软件撰写的文档，将成为其陪葬。后人再发掘到这些“古董文档”时，就像现在的文字学家对契丹文字一样的茫茫然。从这一点看来，用 DocBook 撰写的文档，才具备流传万代的可能。
更多 DocBook 内容，请看这篇 《DocBook Howto》。
[编辑] 3 DocBook 编译
DocBook 优势之一是所谓 Single Source，即只需要维护一份 DocBook 格式的文档，可以编译（render, transform）为其他格式的文档： html(chunk), html(no-chunk)，chm，pdf，rtf，txt，...
但是这个编译过程，却恰恰是 DocBook 入门的最大的拦路虎。首先要从不同的来源将 DTD, XSLT（或DSSSL）, ISO Entities 等汇总到一起。 然后要在多个 XML/SGML 转换方案中选择一个，并掌握长长的命令行。而 XSLT/DSSSL 的定制，即使你有编程基础而对 XML/SGML 不了解，也异常困难。
Whodo 已经将定制好的 XSLT 和编译工具集成在一起，之前可以从 Whodo SVN 中下载。
现已经从SVN中删除，还可以从历史版本中获取。
$ svn ls -r 39 http://svn.worldhello.net/svn/whodo/trunk/tools@39
SVN中的相关删除记录：
r40 | jiangxin | 2007-05-14 16:35:08 +0800 (一, 2007-05-14) | 1 line 改变的路径: D /trunk/tools Docbook tools chain in ossxp-docbook package
删除原因是：
- 相关内容太占用带宽；
- 重新整理的 DocBook tools chain 使用绝对路径 /opt/docbook/tools/...，以便多项目共享；
- 使用绝对路径后，相关内容作为独立的软件包发布，不适合和文档目录混杂在一起；
以 Debian 发布包形式组织的 DocBook 相关组件，可以从 “群英汇” 的升级网站下载：
参考 DocBook 网站: http://wiki.docbook.org/topic/DocBook
[编辑] 4 DocBook 编辑软件
[编辑] 4.1 记事本
在使用 Eclipse 之前，一直使用记事本，或者稍好些的 UltraEdit 作为 DocBook 的编辑器。Unix 平台有 vi 和 Emacs，Windows 平台下也有 NTEmacs 和 VIM。
[编辑] 4.2 Eclipse
Eclipse 是 IBM 贡献的伟大的软件，它早已不再是 Java 开发者的专利。琳琅满目的插件，可以把 Eclipse 变成 C 语言的 IDE， Python 的 IDE，PHP 的 IDE，Perl 的 IDE。并且已经有相当多的插件支持 XML 文档的编辑，可以把 Eclipse 变成 DocBook 的编辑器。
