3.8. 关于输出要注意的其它问题

3.8.1. images目录

如果你使用编号图形或设置警告信息输出为图形时要注意,在生成的HTML文件下并不带这些图形。那么从哪里可以得到它们呢?它们就在docbook-xsl目录下。它的下面有一个images目录,里面就是这些环境所要用到的图片。你要做的就是把images目录拷贝到输出HTML的目录下,作为一个子目录。

再用浏览器看一看你生成的结果文件,图形显示正常了。如果你还有自已的一些图片,把它们放也在HTML的输出目录下即可。

3.8.2. 常见的问题

  1. 格式不正确

    比如一个标记只有开始,没有结束,即不成对。对于空元素在 '>'前一定要有 '/'字符。对于正文中出现的 '<'一定要使用实体形式 &lt;

  2. 不符合DTD

    只要你使用了DTD声明,解释器就会对你的XML文档进行相应的内容验证,因此你写的XML文档的内容一定要符合相应的DTD的要求。比如说:footnote元素的内容不能直接为文本,要使用其它的元素,如para环境才可以。因此: <footnote>正文</footnote>就是错的,而 <footnote><para>正文</para></footnote>就是正确的。再如 sect1只能有一个title子元素,如果你写了两个就是错的。如果出现这样的问题,首先看错误信息是什么意思,然后再参考相应的文档看是如何规定的应该就可以了。

3.8.3. CSS文件

如果你自已生成了CSS,并且在参数中指定使用CSS(参见 第 3.5 节 “本教程所用样式表参数解释” ),那么需要将其拷贝到HTML的输出目录下。

3.8.4. UTF-8编码

如果输入了中文,又没有使用GB2312码,请注意保存时要使用utf-8编码。否则解释器会报错。