技巧

关于表格

在目录页中,会用每个表格的标题来生成表格清单。不希望被收录的可以使用 informaltable

可以通过在CSS中指定table和informaltable的样式来定义两种表格

交叉引用

可以放心的先引用,然后再定义被引用的部分。如果被引用的部分没有被定义,发布的时候xsltproc会给出提示

calloutlist自动编号问题

callout如果不是定义在screen、programlisting、synopsis等块元素中,则下一个calloutlist中编号并不会重新开始,而是继续上次的。

经测试,callout并不需要定义在screen等元素中,只要两个calloutlist中间有这些元素隔开就可以了。

可以定义一个不常用的元素,如果synopsis,来进行分隔。

只要在两个calloutlist之间的任何位置插入一个空标记<synopsis/>就可以了

当然了,生成的Html效果有一点怪异。在CSS中加入下面代码可以隐藏。

.synopsis {display:none;}    

尽量把这个标记放在不影响显示的地方,例如两个section之间;这样即便意外的显示,也只显示在目录中

断行符

在param.xsl文件中加入

<xsl:template match="processing-instruction('linebreak')">
<br/>
</xsl:template>

在源文件中加入

<?linebreak?>

生成Html时替换为<br>
这里是演示

内部链接

内部链接时,要给结构元素定义ID,而不要给title定义ID,不然跳转时会到达错误的位置