更新源代码

源代码？难道要编程么？请不要误会，更不要害怕。用DocBook技术写成的文档，是纯文本格式，可以使用配置管理软件进行版本控制。而把这类文件称作源代码，并不过分。在准备撰写文档之前，先和版本控制系统进行同步，防止多人协同工作时可能造成的版本冲突。如图1-4。

图1-4. 使用 WinCVS 更新源代码

文件编辑

如图1-5，使用用 UltraEdit 编辑该文件。UltraEdit? 难道没有像Word那样的所见即所得的工具么？我的回答是，学用DocBook，这的确是最难过的一关，要改变写作方式，把精力放在文章的撰写和结构的设计上，而不在字体、格式上修修补补。从多人的协作工作和个人的知识积累的便利上，这一切非常值得。

也不要为文档中出现的标签（尖括号括起来的关键字形成了标签）感到困惑，我们将在本书的稍后作以介绍。

图1-5. UltraEdit编辑和DocBook关键字补齐功能

提交前比较源代码

将修改后的文档提交到配置管理系统。提交前，先比较一下（如图1-6），这也是程序开发人员的一种“惯性”吧。而WinCVS调用的外部Differ程序：Araxis Merge（如图1-7），是我用过得最好用的Differ工具之一。

当然也可以和该文件的任何一个版本进行比较。当一个文档由版本控制系统维护之后，再也不必担心你的文档会被覆盖、会丢掉什么，版本控制系统，忠实记录了文档的每一次Checkin。

图1-6. 文件提交前，先Differ一下

图1-7. Araxis Merge是我见过的最好的Differ工具

提交源代码

既然添加的内容没有问题，就提交吧。如图1-8

图1-8. 将改动提交到CVS服务器

编译

编译？又是一个软件开发的专业词汇。DocBook源文件并不能直接用来浏览和打印，需要将结构化文档转换为其他格式。下面是一段转换实例：将DocBook格式转换为超文本和纯文本格式。加黑的部分为输入的命令，其他部分为屏幕输出。

Administrator@JOHNSON ~/work/johnson_homepage
$ sh make docbook_howto
/cygdrive/d/HOME/WORK/johnson_homepage/docbook/docbook_howto/index.sgml is newer

make -html docbook_howto
openjade -E 0 -t sgml -i html -V nochunks -d /share/sgml/docbook-dsssl/ldp.dsl\#
html /cygdrive/d/HOME/WORK/johnson_homepage/docbook/docbook_howto/index.sgml >  
docbook_howto.htm

done

/cygdrive/d/HOME/WORK/johnson_homepage/docbook/docbook_howto/index.sgml is newer

make -htmls docbook_howto
openjade -E 0 -t sgml -i html -d /share/sgml/docbook-dsssl/ldp.dsl\#html /cygdri
ve/d/HOME/WORK/johnson_homepage/docbook/docbook_howto/index.sgml

done

lynx -dump -base -dont_wrap_pre -nolist -display_charset=gb2312 -assume_charset=
gb2312 -assume_local_charset=gb2312 -assume_unrec_charset=gb2312 /cygdrive/d/HOM
E/WORK/johnson_homepage/doc/docbook_howto/docbook_howto.htm > /cygdrive/d/HOME/W
ORK/johnson_homepage/doc/docbook_howto/docbook_howto.txt

done