第 2 章 Docbook开发过程中的注意事项和心得

摘要

2.1. Docbook 4和Docbook 5的区别

其实对于普通的Docbook的使用者来说，其实不必关心如何从Docbook4转到Docbook5，但是对于像我之前借鉴别人的docbook的xml去写docbook的源码的话，就需要关注一下了。

因为之前的很多Docbook的元素（Element），其实都是Docbook5之前的，所以现在是在用Docbook5的框架，但是却使用了部分的之前的元素。因此，需要列出一些需要注意的事项。

此处列出几个在使用时候需要注意事情：

记得要给book，article等添加命名空间：


<?xml version="1.0"?>
<book xmlns="http://docbook.org/ns/docbook" version="5.0">
...

ulink被link取代了
关于交叉引用，link等方面的改变，去看Improved cross-referencing and linking
bookinfo，articleinfo等都被info取代了
关于更多的改变了名字的元素，去看Renamed elements

关于更多在docbook5中去除了的元素，去看Removed elements
支持了用alt和annotation给元素添加注释
新加了XSLT 2.0的支持

更多详细的内容，请参考：DocBook 5 differences


1.3. Windows环境下的，基于Cygwin的Docbook开发环境的搭建		2.2. 关于实体定义