发布

使用xsltproc将它发布为 Html


xsltproc  /usr/share/xml/docbook/xsl-stylesheets-1.73.2/1html/2html.xsl3 docbook.xml 

1

xsl-stylesheets目录,里面包含可以发布的格式。该路径可能会因系统的不同而改变

2

发布为 Html 格式所需要的 xsl 文件

3

发布为单独的 html 页面。如果需要分页,使用chunk.xsl

这是最简单的发布。有的时候,我们需要进行一些控制,例如使用 CSS、设定输出目录等,可以在命令中加入参数:


xsltproc --output ../html/1                \

--stringparam html.stylesheet docbook.css 2\

/usr/share/xml/docbook/xsl-stylesheets-1.73.2/html/html.xsl 3 \

docbook.xml  

1

设定输出目录

2

使用 CSS 样式表

3

使用 XSL 样式表

这个命令有点长,我们可以把相关参数写入参数样式表param.xsl,使用命令xsltproc param.xsl docbook.xml发布

下面是一个参数样式表的例子,复制保存:

例 27.1. DocBook 参数样式表


<?xml version='1.0'?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

                version="1.0">



<!--调用样式表-->

<xsl:import href="/usr/share/xml/docbook/xsl-stylesheets-1.73.2/html/chunk.xsl"/>



<xsl:param name="chunker.output.encoding" select="'utf-8'"/> 

<!--标准信息所使用的语言-->

<xsl:param name="l10n.gentext.language" select="'zh_cn'"/>

<!--指定样式表-->

<xsl:param name="html.stylesheet" select="'docbook.css'"/>

<!--对于警告类信息是否使用图形 0 1-->

<xsl:param name="admon.graphics" select="1"/>



<!--生成的 HTML 文件存放的起始目录-->

<!--如果没有在 Makefile 或命令中指定,取消这里的注释

<xsl:param name="base.dir" select="'../html/'"/>

-->



<!--生成的 HTML 文件内容是否进行缩排 yes no-->

<xsl:param name="chunker.output.indent" select="'yes'"/>

<!--给节编号 0 1-->

<xsl:param name="section.autolabel" select="0"/>

<!--节的编号是否包含章的编号 0 1-->

<xsl:param name="section.label.includes.component.label" select="1"/>

<!--表格边框的属性是否使用预设 CSS 来指定-->

<xsl:param name="table.borders.with.css" select="0"/>

<!--参考书目是否进行编号-->

<xsl:param name="bibliography.numbered" select="1"></xsl:param>





<!--目录深度-->

<xsl:param name="toc.max.depth" select="2"/>

<!--sect#页面上显示目录-->

<xsl:param name="generate.section.toc.level" select="0"/>

<!--sect#可以生成目录条目-->

<xsl:param name="toc.section.depth" select="2"/>

<!--目录中收录哪些内容-->

<!--包括 toc,title,figure,table,example,equation -->

<!-- nop 为空 -->

<xsl:param name="generate.toc">

appendix  toc

article/appendix  nop

article   toc,title

book      toc,title,example

chapter   toc,title

part      toc,title

preface   toc,title

qandadiv  toc

qandaset  toc

reference toc,title

sect1     toc

sect2     toc

sect3     toc

sect4     toc

sect5     toc

section   toc

set       toc,title

</xsl:param>



<!--在源码中插入 <?linebreak?> 标记,生成 Html 时替换为<br> -->

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

<br/>

</xsl:template>



</xsl:stylesheet>  

将偷懒进行到底,使用下面 Makefile,在工作目录下键入make就可以了[57]


OBJECT = all

SOURCE =  docbook.xml

PARAM = param.xsl

ARG = --output html/

COMPILER = xsltproc



$(OBJECT):$(SOURCE) $(PARAM)

1	$(COMPILER) $(ARG) $(PARAM) $(SOURCE)



clean:

2	rm -rf ../html/*.html

1

这里一定要用 TAB,而不能用空格字符

2

同上


[57] 在 Emacs 中 M-x compile 效果更好,如果有错误还能够直接定位


Host by Alair