1. 制作Docbook文档需要了(ji¨£n)解的知识åQ?/p>

1) XML - ˜q™æ˜¯æœ€åŸºæœ¬çš„，如果˜q™ä¸ªéƒ½ä¸æ‡‚的话，最好先找本入门¾U§çš„书看看；
2) DTD - 有助于你理解Docbook的结构；
3) XSL - 有助于定制自å·Þqš„DocbookåQ?br />4) XSL-FO - 最好了(ji¨£n)解一点，有助于更好的定制自己的PDF输出ã€?/p>

2. 制作Docbook文档的最½Ž€å•çš„˜q‡ç¨‹åŒ…括以下的步骤：(x¨¬)

1) ¾~–辑XMLæ–‡äšg;
2) 对XMLæ–‡äšg˜q›è¡Œå¤„理åQŒç”ŸæˆHTML或者PDF文档ã€?/p>

2.1. ¾~–辑XMLæ–‡äšg

如果使用¾U¯æ–‡æœ¬ç¼–辑器来完成这™å¹å·¥ä½œï¼Œæˆ‘敢打赌一天之后你ž®±åšä¸ä¸‹åŽÖMº†(ji¨£n)åQŒç›´æŽ¥ç¼–辑XML可是一件苦差事。ä‹É用类似XMLSPY˜q™æ ·çš„å·¥å…øP¼Œæä¾›è‡ªåŠ¨å¡«å……功能åQŒåƈ且随时可以进行有效性检查，不容易出错，可以让工作轻松不ž®‘ã€?/p>

Docbook文档分两¾c»ï¼š(x¨¬)书（bookåQ‰å’Œæ–‡ç« åQˆarticleåQ‰ã€‚articlež®±æ˜¯ä¸€èˆ¬çš„文章åQŒä¸åŒ…含章（chapteråQ‰ï¼Œåªæœ‰èŠ? åQˆsectionåQ‰ã€‚book比较完整åQŒå¯ä»¥åŒ…含前­a€åQˆprefaceåQ‰ï¼Œéƒ¨åˆ†åQˆpartåQ‰ï¼Œç« ï¼ˆchapteråQ‰ï¼Œæ–‡ç« åQˆarticleåQ‰ç­‰½{‰ã€‚以上描 ˜q°çš„都是Docbook DTD定义的元素，˜q™é‡Œä¸å¯èƒ½ç»™å‡?gu¨®)™¯¦¾l†çš„说明åQŒå…·ä½“每个元素的¾l“构参见Docbook DTDã€?/p>

让我们先来看一个book¾cÕdž‹æ–‡æ¡£çš„典型定义：(x¨¬)

 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) list 1. 典型的book¾cÕdž‹æ–‡æ¡£
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<book>
 (t¨©ng)<bookinfo>
 (t¨©ng) <title>My Book</title>
 (t¨©ng) <author>
 (t¨©ng) (t¨©ng) <firstname>My First Name</firstname>
 (t¨©ng) (t¨©ng) <surname>My Last Name</surname>
 (t¨©ng) </author>
 (t¨©ng) <publisher>
 (t¨©ng) (t¨©ng) <publishername>CSDN</publishername>
 (t¨©ng) </publisher>
 (t¨©ng) <isbn>ISBN#</isbn>
 (t¨©ng) <copyright>
 (t¨©ng) (t¨©ng) <year>2005</year>
 (t¨©ng) </copyright>
 (t¨©ng)</bookinfo>
 (t¨©ng)<part>
 (t¨©ng) <title>My Part</title>
 (t¨©ng) <chapter>
 (t¨©ng) (t¨©ng) <title>My Chapter</title>
 (t¨©ng) (t¨©ng) <sect1>
 (t¨©ng) (t¨©ng) (t¨©ng) <title>My Section1</title>
 (t¨©ng) (t¨©ng) (t¨©ng) <para>This (t¨©ng) is a demo of a book.</para>
 (t¨©ng) (t¨©ng) </sect1>
 (t¨©ng) </chapter>
 (t¨©ng)</part>
</book>

该文档声明ä‹É用的DTDä¸?a >http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtdåQ? 所有的内容都包含在book元素中，bookinfo元素包含书名åQˆtitleåQ‰ã€ä½œè€…（authoråQ‰ã€å‡ºç‰ˆç¤¾åQˆpublisheråQ‰ã€ä¹¦å? åQˆisbnåQ‰å’Œç‰ˆæƒåQˆcopyrightåQ‰ã€‚接着part元素包含的内å®ÒŽ(gu¨©)˜¯è¯¥ä¹¦çš„一个部分，下面有一章，接着有一节（sect1åQ‰ï¼Œå½“然都有各自的标题ã€?/p>

怎么æ øP¼Œå„个元素的含义是不是很显而易见，æ ÒŽ(gu¨©)®å…ƒç´ çš„名¿UŽÍ¼Œä½ å°±èƒ½çŸ¥é“自å·Þqš„内容该包含在什么元素里面ã€?/p>

在上面的例子里面åQŒæœ‰äº›å…ƒç´ ä¸æ˜¯å¿…™åȝš„。譬如bookinfoåQŒå¯ä»¥æ²¡æœ‰æˆ–者有一个，看Docbook DTDž®±å¯ä»¥çŸ¥é“ã€?/p>

下面我以article¾cÕdž‹çš„文档äØ“(f¨´)例子åQŒè¯´æ˜ŽDocbook文档的制作过½E‹ã€?/p>

首先是XML声明åQŒè¯´æ˜Žæ–‡æ¡£çš„一些基本信息：(x¨¬)

<?xml version="1.0" encoding="UTF-8"?>

紧接着是文档的DTD声明åQŒè¯´æ˜Žæ–‡æ¡£ä‹É用的DTD˜q˜æœ‰æ ¹å…ƒç´ ã€‚典型的docbook文档的DTD声明如下åQ?/p>

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

˜q™ä¸ªå£°æ˜Žè¡¨æ˜ŽåQŒæ–‡æ¡£çš„根元素是<article>åQŒä‹É用外部DTDåQŒè¯¥DTD用一个公共标识符"-//OASIS//DTD DocBook XML V4.2//EN"标识åQŒè¯¥DTD位于¾|‘络的某处。标识符必须是全球唯一的，其åŞ式äØ“(f¨´)åQ?/p>

prefix//owner-identifier//text-class text-description//language//display-version

½W¬ä¸€ä¸ªprefix为â€?/-”，â€?”表½Cºæ˜¯å·²æ³¨å†Œçš„标识åQŒâ€?”则相反。其他各部分的含义自己对照ã€?/p>

接着ž®±å¯ä»¥æ·»åŠ å†…容了(ji¨£n)。首先是根元素：(x¨¬)

<article>

</article>

article必须有一个标题：(x¨¬)

<article>
 (t¨©ng) (t¨©ng) (t¨©ng) <title>My Article</title>
</article>

标题?sh¨´)¹‹åŽå¿…须有内容，不可能有无内容的文章åQ?/p>

<article>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <title>My Article</title>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <sect1>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </sect1>
</article>

˜q™é‡Œæˆ‘们æ·ÕdŠ ä¸€ä¸ªå°èŠ‚，“sect1”是ž®èŠ‚的最™å¶å±‚元素åQŒå…¶¾~–排方式与MS Word的“heading 1”类伹{€?/p>

与article相同åQŒsect1也必™åÀLœ‰æ ‡é¢˜åQ?/p>

<article>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <title>My Article</title>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <sect1>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <title>My Section</title>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </sect1>
</article>

sect1也不允许无内容：(x¨¬)

<article>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <title>My Article</title>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <sect1>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <title>My Section</title>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <para>This is my first article.</para>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </sect1>
</article>

正文的内容一般用<para>元素ž®è£…åQŒparaåÏx(ch¨®ng)®µè½ï¼ˆparagraphåQ‰çš„意思ã€?/p>

现在ž®±æœ‰äº?ji¨£n)一个最½Ž€å•çš„Docbook文档。list 2是完整的代码ã€?/p>

 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) list 2. 一个简单的article文档
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<article>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <title>My Article</title>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <sect1>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <title>My Section</title>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <para>This is my first article.</para>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </sect1>
</article>

¾~–辑完成之后åQŒä¿å­˜ä(sh¨´)Ø“(f¨´)myarticle.xmlåQŒæŽ¥ç€ž®±å¯ä»¥ç”ŸæˆHTML或者PDFäº?ji¨£n)ã€?/p>

2.2 生成HTML

关于如何安装配置工具åQŒå‚见“安装配¾|®Docbook”ã€?/p>

我ä‹É用cygwin下的xsltproc来生成HTMLåQŒåœ¨cygwinçš„shell中输入命令：(x¨¬)

xsltproc --nonet --output myarticle.html c:/docbook-xsl-1.67.2/html/docbook.xsl myarticle.xml

--nonet表示我不希望从网¾lœèŽ·å–DTDåQŒè¿™æ ·å¯ä»¥èŠ‚省时间ã€?/p>

--output指定我希望输出的文äšg名，˜q™é‡ŒæŒ‡å®šçš„是myarticle.htmlã€?/p>

紧接着是用来è{换XMLæ–‡äšgçš„XSL样式单，需要注意，使用的是html目录下的XSL样式单ã€?/p>

最后是要处理的Docbook文档�/p>

没有意外的话åQŒçŽ°åœ¨ä½ ž®±å¯ä»¥ç”¨‹¹è§ˆå™¨æ‰“å¼€myarticle.html看看效果äº?ji¨£n)ã€?/p>

2.3 生成PDFæ–‡äšg

下面使用FOP生成PDFæ–‡äšg。关于如何安装配¾|®FOPåQŒå‚è§?a >http://blog.csdn.net/mickeyrat/archive/2005/02/06/283471.aspxã€?/p>

在控制台输入命ä×o(h¨´)åQ?/p>

fop -xml myarticle.xml -xsl C:\docbook-xsl-1.67.2\fo\docbook.xsl myarticle.pdf

Linux的命令类ä¼û|¼Œæ³¨æ„docbook.xslçš„èµ\径ã€?/p>

-xml指定需要è{换的docbook文档ã€?/p>

-xsl指定使用的样式单åQŒæ³¨æ„ï¼Œ˜q™é‡Œä½¿ç”¨çš„fo目录下的样式单，˜q™æ˜¯ä¸“äØ“(f¨´)转换XSL-FO开发的ã€?/p>

最后是输出文档的文件名�/p>

在FOP处理˜q‡ç¨‹ä¸­ï¼Œä¼?x¨¬)输å‡ø(gu¨®)™®¸å¤šè¯¸å?/p>

property - "background-position-horizontal" is not implemented yet.

的信息。不用理ä¼?x¨¬)，˜q™æ˜¯å› äØ“(f¨´)FOP˜q˜åœ¨å¼€å‘中åQŒè®¸å¤šXSL-FO的特性都不支持。这æ ïL(f¨¥ng)š„问题òq¶ä¸å½±å“æœ€¾lˆæ–‡æ¡£çš„生成ã€?/p>

快打开myarticle.pdf看看效果吧，是不是很专业的PDF文档åQ?/p>

是不是觉得制作docbook文档很简单呢åQŸè¿™ä¹ˆæƒ³å¯å°±é”™äº†(ji¨£n)åQŒæœ¬æ–‡å‰©ä½™çš„部分介绍制作Docbook文档的高¾U§æŠ€å·§ã€?/p>

3. 定制自己的XSL样式�/p>

当你开始正式制作自å·Þqš„docbook文档之后åQŒä½ ä¼?x¨¬)发现生成的文档òq¶ä¸èƒ½å®Œå…¨æ»¡­‘³ä½ å¯ÒŽ(gu¨©) ¼å¼çš„要求åQŒè­¬å¦‚章节号、页码、字体等½{‰ã€‚这一节就告诉你如何定制自å·Þqš„XSL样式单，生成满èƒö特定需求的文档。下面的内容ä¼?x¨¬)涉及(qi¨¢ng)XSLå’ŒXSL-FOã€?/p>

有äh可能ä¼?x¨¬)想通过修改Docbook DTD辑ֈ°å®šåˆ¶ç›®çš„åQŒä½†æ˜¯è¿™¿Uæ–¹å¼æ˜¯ä¸å¾è®®é‡‡ç”¨çš„åQŒå› ä¸ÞZ¿®æ”¹Docbook DTD之后åQŒä½ çš„文档就不再是Docbook文档ã€?/p>

å› äØ“(f¨´)Docbook把内容与样式完全分开åQŒæ‰€ä»¥ä¿®æ”¹XSL样式单，ž®Þpƒ½å¤Ÿæ”¹å˜è¾“出结果ã€?/p>

ä¸ÞZº†(ji¨£n)修改样式单，你需要有自己的定制层åQŒä¹Ÿž®±æ˜¯åŸÞZºŽDocbook XSL样式单之上开发自å·Þqš„样式单。千万不要直接修改Docbook XSL样式单，˜q™æ ·åšæœ‰ä¸¤ä¸ª¾~ºç‚¹åQ?/p>

1) 不易¾l´æŠ¤åQšä½ çš„修改可能会(x¨¬)分散在几十个文äšg中，˜q‡å‡ å¤©ï¼Œä½ å°±ä¼?x¨¬)忘记自å·×ƒ¿®æ”¹è¿‡çš„地斏V€?/p>

2) 不易升çñ”åQšå¦‚果你惛_‡¾U§æ ·å¼åˆ°æ–°çš„版本åQŒä½ ä¸å¾—不把你所做的所有修改合òq¶åˆ°æ–°çš„版本中，合åƈ的过½E‹ä¸­è‚¯å®šè¦å¤„理大量的冲突åQŒåƈ且容易出错ã€?/p>

我想你应该知é?lt;xsl:include>ä¸?lt;xsl:import>的区别：(x¨¬)使用<xsl: include>引入的元素，如果有重复定义的åQŒç¬¬ä¸€‹Æ¡å‡ºçŽ°çš„有效åQ›ä‹Éç”?lt;xsl:import>引入的元素，最后一个有效。定制层å…? 实是依赖于XSL˜q™æ ·çš„一个特性，使用<xsl:import>引入Docbook XSL样式单的èµïL(f¨¥ng)‚¹æ–‡äšgåQŒç„¶åŽæ·»åŠ è‡ªå·Þqš„修改。list 3¾l™å‡ºä¸€ä¸ªå®šåˆ¶å±‚æ–‡äšg的框架ã€?/p>

 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) list 3 customization.xsl
<?xml version='1.0'?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
 (t¨©ng) (t¨©ng) (t¨©ng) <xsl:import href="html/docbook.xsl"/>
 (t¨©ng) (t¨©ng) (t¨©ng) ...
 (t¨©ng) (t¨©ng) (t¨©ng) modifications
 (t¨©ng) (t¨©ng) (t¨©ng) ...
</xsl:stylesheet>

定制层是XSLæ–‡äšgåQŒå› æ­¤éœ€è¦å¼•å…¥xsl的名字空间。在½W¬ä¸‰è¡Œï¼Œå¼•å…¥è½¬æ¢HTMLçš„XSL样式单的èµïL(f¨¥ng)‚¹æ–‡äšgdocbook.xslåQŒå¦‚果是XSL-FO的定制层åQŒè“vç‚ÒŽ(gu¨©)–‡ä»¶åœ¨fo目录下。然后就可以æ·ÕdŠ è‡ªå·±çš„修改了(ji¨£n)ã€?/p>

定制分äØ“(f¨´)两类åQŒä¸€¾cÀL˜¯ä¿®æ”¹æ ·å¼å•å‚敎ͼŒä¸€¾cÀL˜¯ä¿®æ”¹æ¨¡æ¿ã€?/p>

3.1 修改样式单参�/p>

打开html/param.xsl或者f(xi¨¦)o/param.xslåQŒå¯ä»¥æ‰¾åˆ°æ‰€æœ‰çš„样式单参数。看下面˜q™ä¸ªä¾‹å­

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

参数的名字是“section.autolabel”，å€égØ“(f¨´)â€?”。这个参数的作用是控制生成文档的时候是否对ž®èŠ‚自动¾~–号åQŒè­¬å¦‚â€?”，â€?.1”等½{‰ã€‚â€?”表½Cºå…³é—­è‡ªåŠ¨ç¼–受÷€‚你可以看一下前面生成的文档åQŒæ˜¯ä¸æ˜¯æ²¡æœ‰ç« èŠ‚åøP¼Ÿ

要打开自动¾~–号åQŒåªéœ€è¦è¿™æ ·ä¿®æ”¹ï¼š(x¨¬)

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

你不是直接在param.xsl里面改的吧？如果是的话，赶紧改回来！千万记得åQŒæ‰€æœ‰çš„修改都写在前面生成的customization.xsl。现在重新生成HTMLåQ?/p>

xsltproc --nonet --output myarticle.html c:/docbook-xsl-1.67.2/customization.xsl myarticle.xml

或生成PDF
fop -xml myarticle.xml -xsl C:\docbook-xsl-1.67.2\customization.xsl myarticle.pdf

注意åQŒè¿™ä¸ªå‚数对HTMLå’ŒXSL-FO都有效，但是你必™åÕdœ¨customization.xsl中用<xsl:import>引入对应的è“vç‚ÒŽ(gu¨©)–‡ä»Óž¼Œå¦åˆ™ä¼?x¨¬)报错。现在新的文档是不是出现章节号了(ji¨£n)åQ?/p>

再来一个。看你的PDF文档åQŒè‚¯å®šæ²¡æœ‰bookmarkåQŒå› ä¸ºåœ¨fo/param.xsl中，bookmark的功能被关闭äº?ji¨£n)。在customization.xsl里添加：(x¨¬)

<xsl:param name="fop.extensions" select="1"/>

˜q™æ ·FOP在处理的时候就ä¼?x¨¬)生成bookmark。注意这个参数的名字åQŒâ€œfop.extensions”，表示˜q™ä¸ªå‚数属于FOP的扩展，只对FOP有效。如果你使用PassiveTeXåQŒé‚£ä¹ˆéœ€è¦è®¾¾|®â€œpassivetex.extensions”ã€?/p>

再来一个复杂点的：(x¨¬)

<xsl:param name="formal.title.placement">
 (t¨©ng) figure after
 (t¨©ng) example before
 (t¨©ng) equation before
 (t¨©ng) table before
 (t¨©ng) procedure before
 (t¨©ng) task before
 (t¨©ng)</xsl:param>

˜q™ä¸ªå‚数作用于文章中的图、表½{‰ç­‰å…ƒç´ çš„标题，控制标题的位¾|®åœ¨å‰é¢åQˆbeforeåQ‰è¿˜æ˜¯åŽé¢ï¼ˆafteråQ‰ï¼Œparam.xsl预定义的都是 “before”，˜q™é‡ŒæŠŠfigure的标题放在图的后面。这个参数对HTMLå’ŒXSL-FO都有效。在你的文档中添åŠ?lt;figure>å…? 素，重新生成文档åQŒå°±å¯ä»¥çœ‹åˆ°æ•ˆæžœã€?/p>

3.2 修改模板

Docbook XSL提供很多的参数控制输出的效果。但是有时候，仅仅修改参数òq¶ä¸èƒ½æ»¡­‘Ïx(ch¨®ng)‰€æœ‰çš„要求åQŒè¿™æ—Óž¼Œä½ å°±éœ€è¦ä¿®æ”ÒŽ(gu¨©)¨¡æÑ€?/p>

我们来看一个很现实的例子。XSL-FO定义äº?ji¨£n)一¾cÖM»¥â€œkeep-”开头的属性，譬如“keep-with-next”，表示前面的内容与后面的内容必™åÕdœ¨åŒä¸€™åµï¼Œä¸èƒ½æ–­å¼€åœ¨ä¸¤™åµä¸Šã€‚但是除äº?ji¨£n)tableåQ?br />FOP目前不支持这æ ïL(f¨¥ng)š„属性。所以当文档比较长的时候，在FOP生成的PDF文档中，你会(x¨¬)发现有某些小节的标题在一™å늚„底部åQŒè€Œå†…容却在下一™åµï¼Œå…¶ä»–有标题的内容åQŒè­¬å¦‚图åQŒéƒ½ä¼?x¨¬)出现这æ ïL(f¨¥ng)š„情况。这当然是不合理的，可是无论你怎么æ·ÕdŠ â€œkeep-”类的参敎ͼŒéƒ½æ— ‹¹ŽäºŽäº‹ã€?/p>

对于˜q™æ ·çš„情况，FOPçš„FAQ告诉你的ž®±æ˜¯åQŒâ€œå¯¹ä¸è“våQŒæˆ‘们还没有实现”，至于什么时候实玎ͼŒâ€œä½ åˆ«é—®åQŒæˆ‘也不知道”ã€?/p>

所以只能采取一个变通的方式。前面我说过åQŒFOP对于table支持˜q™æ ·çš„属性，那么是否可以考虑把这æ ïL(f¨¥ng)š„内容攑֜¨table里面呢？当然可以åQ? FOP有一个“blind table”的概念åQŒè¿™æ ïL(f¨¥ng)š„表除äº?ji¨£n)其中的内容是不可见的，正符合我们的要求。现在的问题ž®±æ˜¯åQŒDocbook XSL样式单生成的是通用的XSL-FOæ–‡äšgåQŒä¸ä¼?x¨¬)把å?lt;sect2>˜q™ç§å…ƒç´ çš„内å®ÒŽ(gu¨©)”¾åˆ°â€œblind table”里面。那ž®±åªå‰©ä¸€æ¡èµ\äº?ji¨£n)（其实˜q˜æœ‰ä¸€æ¡ï¼Œç”¨å•†ä¸šäñ”品^_^åQŒRenderXçš„XEP支持“keep-”类属性）(j¨ª)åQŒä¿®æ”ÒŽ(gu¨©) ·å¼å•æ¨¡æ¿ã€‚list 4的代码把<sect2>的内å®ÒŽ(gu¨©)”¾åˆîC¸€ä¸ªâ€œblind table”里面ã€?br /> (t¨©ng)
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) list 4. blindtable.xsl
<?xml version='1.0'?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) xmlns:fo="http://www.w3.org/1999/XSL/Format"
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) version="1.0">
 (t¨©ng) (t¨©ng) (t¨©ng) <xsl:import href="docbook.xsl"/>

 (t¨©ng) (t¨©ng) (t¨©ng) <xsl:template match="sect2">
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:variable name="id">
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:call-template name="object.id"/>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </xsl:variable>
 (t¨©ng) (t¨©ng)
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <fo:table table-layout="fixed" width="100%">
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <fo:table-column column-number="1"/>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <fo:table-body>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <fo:table-row keep-with-next="always">
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <fo:table-cell id="{$id}" xsl:use-attribute-sets="section.level2.properties">
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:call-template name="sect2.titlepage"/>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </fo:table-cell>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </fo:table-row>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:variable name="toc.params">
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:call-template name="find.path.params">
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:with-param name="table" select="normalize-space($generate.toc)"/>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </xsl:call-template>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:if test="contains($toc.params, 'toc') and $generate.section.toc.level &gt;= 2">
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:call-template name="section.toc"/>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:call-template name="section.toc.separator"/>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </xsl:if>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </xsl:variable> (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng)
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <fo:table-row>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <fo:table-cell>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:apply-templates select="*[2]"/>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </fo:table-cell>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </fo:table-row>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </fo:table-body>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) </fo:table>
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <xsl:apply-templates select="*[position() > 2]"/>
 (t¨©ng) (t¨©ng) (t¨©ng) </xsl:template>
</xsl:stylesheet>

对于˜q™æ®µä»£ç ž®×ƒ¸å¤šåšè§£é‡Šäº?ji¨£n)，æ€Èš„来说其作用就是覆盖了(ji¨£n)sections.xsl中定义的名äØ“(f¨´)“sect2”的模板åQŒåœ¨ç”ŸæˆXSL-FOæ–‡äšgçš„æ—¶ 候，æŠ?lt;sect2>的标题和内容分别攑ֈ°ä¸€ä¸ªå•åˆ—表的两行。因ä¸ø™¿™é‡Œç”¨åˆîCº†(ji¨£n)fo名字½Iºé—´åQŒæ‰€ä»¥åœ¨å¼€å§‹è¦å¼•å…¥fo名字½Iºé—´ã€?/p>

重新生成PDFæ–‡äšgåQ?/p>

fop -xml yourarticle.xml -xsl C:\docbook-xsl-1.67.2\blindtable.xsl yourarticle.pdf

你会(x¨¬)发现所æœ?lt;sect2>的内å®ÒŽ(gu¨©)²¡æœ‰æ ‡é¢˜ä(sh¨´)¸Žå†…容断开在两™åµä¸Šçš„情况了(ji¨£n)ã€?/p>

4. æ€È»“

到此为止åQŒä½ å·²ç»äº?ji¨£n)解制作Docbook的完整过½E‹ï¼š(x¨¬)

1) ¾~–辑XML文档åQ?br />2) 生成HTML/PDFåQ?br />3) 定制XSL样式单ã€?/p>

定制XSL样式单不能直接修改Docbook XSL样式单，需要创å»ÞZ¸€ä¸ªæ–°çš„XSLæ–‡äšg作äØ“(f¨´)定制层ã€?/p>

XSL样式单定制有两类åQ?/p>

1) 修改XSL参数åQ?br />2) 修改XSL模板ã€?/p>

æ€ÖM¹‹Docbook是十分强大的工具åQŒå¯ä»¥ç”¨æ¥åˆ¶ä½œéžå¸æ€¸“业漂亮的技术文档，甚至是其他文档ã€?/p>

参考文章：(x¨¬)

Docbook½Ž€ä»?/a>

安装配置Docbook

DocBook XSL: The Complete Guide

使用Docbook发布文档åQŒéœ€è¦å®‰è£…以下的工具åQ?br /> (t¨©ng) (t¨©ng) (t¨©ng) *DocBook DTD
 (t¨©ng) (t¨©ng) (t¨©ng) *DocBook XSL 样式å?br /> (t¨©ng) (t¨©ng) (t¨©ng) *XSLT处理½E‹åº
 (t¨©ng) (t¨©ng) (t¨©ng) *XSL-FO处理½E‹åº

下面详细介绍各个工具的安装�/p>

1.安装DocBook DTD

Docbook DTD可以到OASIS的网站上下蝲åQŒåœ¨˜q™é‡Œä½ å¯ä»¥æ‰¾åˆ°zip格式的压¾~©åŒ…。目前的最新版本是4.2ã€?/p>

事实上可以不下蝲Docbook DTD。如果你的文档DTD声明˜q™æ ·å†™ï¼š(x¨¬)

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" (t¨©ng) "

æ ÒŽ(gu¨©)®˜q™æ ·çš„定义，大部分XML处理器能够从¾|‘络上获取DTD。这样做的好处是¾~–辑的Docbook文档¿UÀL¤æ€§å¥½åQŒå¯ä»¥åœ¨æ²¡æœ‰å®‰è£…Docbook DTD的机器上使用。不˜q‡ç”±äºŽDocbook DTD比较庞大åQŒé€šè¿‡¾|‘络获取DTDä¼?x¨¬)åª?ji¨£ng)响处理速度åQŒåœ¨ä½Žé€Ÿç½‘¾lœæˆ–者网¾lœæ¯”较糟¾p•çš„情况下，影响ž®¤äØ“(f¨´)显著ã€?/p>

如果选择使用本地DTDåQŒæ–‡æ¡£çš„DTD引用应该˜q™æ ·å†™ï¼š(x¨¬)

Linux:
<!DOCTYPE book SYSTEM "/usr/share/docbook-4.2/docbookx.dtd">

Windows:
<!DOCTYPE book SYSTEM "file:///C:/xml/docbook42/docbookx.dtd">

Docbook提供äº?ji¨£n)一¿Uæ–¹å¼ï¼Œè®©ç”¨æˆ·å¯ä»¥ä‹É用相同的DTD声明åQŒä½†å¯ä»¥åœ¨ä‹É用网¾lœèŽ·å–DTDå’Œä‹É用本地DTD之间切换åQŒåŒæ—¶æ‹¥æœ‰ä¸¤è€…的优势。这ž®±æ˜¯catalogæ–‡äšg的作用。典型的catalog的声明如下：(x¨¬)

<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
 (t¨©ng) <group id="DocbookDTD" prefer="public">
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) <system (t¨©ng)
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) systemId="http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
 (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) uri="file:///usr/share/xml/docbook42/docbookx.dtd"/>
 (t¨©ng) </group>
</catalog>

˜q™ä¸ªå£°æ˜ŽæŠŠç½‘¾lœDTD映射到本地DTD。如果ä‹É用支持Catalogçš„XSLT ProcessoråQŒå®ƒé¦–å…ˆä¼?x¨¬)查找本地文ä»Óž¼Œå¦‚果本地文äšg不存在，再查扄¡½‘¾lœã€?/p>

2.安装Docbook XSL样式�/p>

�a >http://docbook.sourceforge.net上可以下载到Docbook XSL样式单，目前最新的版本�.67.2�/p>

解压之后åQŒæœ‰å‡ ä¸ªæ¯”较主要的目录：(x¨¬)
 (t¨©ng)*common (t¨©ng) (t¨©ng) - 包含的是公用的模块，诸如语言之类的文仉™ƒ½åœ¨è¿™é‡Œã€?br /> (t¨©ng)*extensions - 针对特定的XSLT Processor¾~–写的扩展代码ã€?br /> (t¨©ng)*fo (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) - 生成XSL-FOæ–‡äšg所需的XSL样式单ã€?br /> (t¨©ng)*html (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) - 生成HTMLæ–‡äšg所需的XSL样式单ã€?br /> (t¨©ng)*images (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) - 生成文档时所需要的囄¡‰‡ã€?br /> (t¨©ng)*doc (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) - 有关XSL样式单的文档åQŒåŒæ äh˜¯Docbook文档ã€?/p>

其他˜q˜æœ‰åƒhtmlhelp之类的目录，但不是生成HTML或XSL-FO所必须的ã€?/p>

3.安装XSLT Processor

目前有许多免费的XSLT ProcessoråQŒæœ€å¸¸ç”¨çš„是
 (t¨©ng)*Saxon (t¨©ng) (t¨©ng) (t¨©ng) - 使用Java实现åQ?a >http://saxon.sourceforge.net/ã€?br /> (t¨©ng)*Xalan (t¨©ng) (t¨©ng) (t¨©ng) (t¨©ng) - 有Javaå’ŒC++版本åQ?a >http://xml.apache.org/xalan-j/index.htmlã€?br /> (t¨©ng)*xsltproc - 使用C实现åQŒæ˜¯æœ€å¿«çš„处理½E‹åºåQ?a >http://xmlsoft.org/XSLT/
 (t¨©ng)
å› äØ“(f¨´)Saxonå’ŒXalan都有Java版本åQŒæ‰€ä»¥æŒ‰ç…§ä¸€èˆ¬çš„Java½E‹åºçš„安装方式安装即可。下面介¾lxsltproc的安装，因äØ“(f¨´)它速度快，是我比较喜欢的处理程序ã€?/p>

如果你ä‹É用windowsòq›_°åQŒé‚£ä¹ˆä½ æœ‰ä¸¤ä¸ªæ–¹æ³•å¯é€‰ï¼š(x¨¬)

 (t¨©ng)1) 直接下蝲为windowsòq›_°é¢„编译的版本。你需要下载libxml, libxslt, å’ŒiconvåQŒå®ƒä»¬éƒ½æ˜¯zip格式åQŒè§£åŽ‹ä¹‹åŽï¼Œåœ¨çŽ¯å¢ƒå˜é‡PATH中添加xsltproc.exeå’?dllæ–‡äšgçš„èµ\径ã€?br /> (t¨©ng)
 (t¨©ng)如果你不想编辑环境变量，一个简单的办法是把下面˜q™äº›æ–‡äšg复制到C:\Windows\System32åQ?br />
 (t¨©ng) libxslt.dll
 (t¨©ng) libxml2.dll
 (t¨©ng) libexslt.dll
 (t¨©ng) iconv.dll
 (t¨©ng) xsltproc.exe

 (t¨©ng)˜q™æ ·åœ¨å‘½ä»¤è¡Œž®±å¯ä»¥ç›´æŽ¥æ‰¾åˆ°è¿™äº›æ–‡ä»¶äº†(ji¨£n)。完成之后，˜qè¡Œ

 (t¨©ng)xsltproc -version

 (t¨©ng)打印出版本号则表明完成安装ã€?br /> (t¨©ng)
 (t¨©ng)2) 在Cygwin下安装，˜q™æ˜¯æˆ‘选择使用的方式。Cygwin是一个在Windows下模拟Linux Shell的应用程序。如果你喜欢以Linux命ä×o(h¨´)的方式来使用xsltprocåQ?a >下蝲Cygwin安装½E‹åºã€‚Cygwin的是通过¾|‘络安装的，首先你从它提供的包列表中选择libxsltåQŒç„¶åŽå®‰è£…程序会(x¨¬)æ ÒŽ(gu¨©)®ä¾èµ–关系自动选择libxml2åQŒç¡®å®šä¹‹åŽï¼Œå®‰è£…½E‹åºä¸‹è²òq¶å®‰è£…xsltproc。完成安装之后，你就可以˜qè¡Œ

 (t¨©ng)xsltproc -version

来检查是否安装成功ã€?br /> (t¨©ng)
3) 如果使用LinuxåQŒå¾ˆæœ‰å¯èƒ½ç³»¾lŸå·²¾lå®‰è£…了(ji¨£n)xsltproc。运è¡?br />
xsltproc -version

‹‚€(g¨¨)查一下是否已¾lå®‰è£…。如果运行命令失败，或者版本太老，那么讉K—®ä¸‹é¢ä¸¤ä¸ªURL获取最新的RPM包：(x¨¬)

http://rpmfind.net/linux/rpm2html/search.php?query=libxml2
http://rpmfind.net/linux/rpm2html/search.php?query=libxslt

然后切换到root权限åQŒå®‰è£…新的包åQ?br />
rpm -Uv libxml2-2.6.17-2.i386.rpm
rpm -Uv libxslt-1.1.12-4.i386.rpm

完成之后åQŒå°±å¯ä»¥˜qè¡Œ

xsltproc -version

‹‚€(g¨¨)查安装是否完成ã€?/p>

安装之后åQŒå°±å¯ä»¥ä½¿ç”¨xsltproc来生成HTML或者XSL-FOæ–‡äšgã€?/p>

譬如åQŒç”ŸæˆHTMLåQ?br />
xsltproc (t¨©ng) --output myfile.html (t¨©ng) docbook-xsl/html/docbook.xsl myfile.xml

或者生成XSL-FO文档åQ?br />
xsltproc --output myfile.fo docbook-xsl/fo/docbook.xsl myfile.xml

åœ?a >http://xmlsoft.org/XSLT/xsltproc2.html上列å‡ÞZº†(ji¨£n)所有xsltproc的命令行参数åQŒç›´æŽ¥è¿è¡?br />xsltproc也会(x¨¬)打印出参数列表ã€?/p>

如果你只要发布HTML文档åQŒé‚£ä¹ˆåˆ°æ­¤äØ“(f¨´)止。如果你˜q˜æƒ³å‘布PDF或是PS文档åQŒé‚£ä¹ˆéœ€è¦å®‰è£…XSL-FO处理½E‹åºã€?/p>

4. 安装XSL-FO处理½E‹åº

XSL-FO处理½E‹åºæ ÒŽ(gu¨©)®XSLT处理½E‹åºç”Ÿæˆçš„XSL-FOæ–‡äšg生成PDF或者PSæ–‡äšg。目前可供选择的XSL-FO处理½E‹åº˜qœä¸å¦‚XSLT处理½E‹åºé‚£ä¹ˆå¤šï¼Œ˜q™æ˜¯å› äØ“(f¨´)åQ?br />
 (t¨©ng) (t¨©ng) (t¨©ng) a. XSL-FO标准比XSLT标准的制订晚两年åQ?br />
 (t¨©ng) (t¨©ng) (t¨©ng) b.XSL-FO标准å?qi¨¢ng)其庞大而复杂，该标准的作者也发现其实çŽîC¸Šçš„难度，从而将该标准分为基本、扩展和完整三个¾U§åˆ«ã€?/p>

现在可用的免费的XSL-FO处理½E‹åºæœ‰ï¼š(x¨¬)

 (t¨©ng) (t¨©ng) (t¨©ng) *FOP - 来自Apache XML™å¹ç›®ã€‚目前最新的版本æ˜?.20.5åQŒè¿˜åœ¨å¼€å‘当中，˜q˜æœ‰å¾ˆå¤šç‰ÒŽ(gu¨©)€§ä¸æ”¯æŒåQŒä¸˜q‡å·²¾lå¯ä»¥æ»¡­‘³ä¸€èˆ¬çš„使用ã€?br /> (t¨©ng) (t¨©ng) (t¨©ng)
 (t¨©ng) (t¨©ng) (t¨©ng) *PassiveTeX - 来自Sebastian Rahtz (http://www.tei-c.org.uk/Software/passivetex/)一‹Æ‘ÖŸºäºŽTeXçš„XSL-FO处理½E‹åºã€‚同样也在开发中åQŒè¾ƒFOP要复杂的多ã€?/p>

另外有一些商业äñ”品可供选择åQŒå¯èƒ½ç”Ÿæˆçš„文档质量要比开源代码好åQŒè­¬å¦‚：(x¨¬)

 (t¨©ng) (t¨©ng) (t¨©ng) *XEP

 (t¨©ng) (t¨©ng) (t¨©ng) *XSL Formatter

下面介绍如何安装FOP�/p>

4.1.首先需要安装JDKåQŒè¿™ä¸ªä¸ç”¨å¤šè¯´ã€?/p>

4.2. 下蝲FOPåQŒå¯ä»¥é€‰æ‹©tar或者zip压羃包。下载之后解压到本地ã€?/p>

4.3. 下蝲囑ÖŞ代码库。FOP自己不支持PNG之类的图片，如果在你的文档里ä¼?x¨¬)涉及(qi¨¢ng)到囄¡‰‡åQŒé‚£ä¹ˆéœ€è¦ä¸‹è½½é¢å¤–的代码库。可以选择JAIåQŒæˆ–è€?a >Jimiã€?.20.5之前的版本只能ä‹É用Jimi。下载之后，ž®†jai_core.jarå’Œjai_codec.jaråQˆJAI)åQŒæˆ–者JimiProClasses.jaråQˆJimiåQ‰å¤åˆ¶åˆ°FOP安装目录的lib目录下，然后在fop.batåQˆWindowsòq›_°åQ‰ä¸­æ·ÕdŠ 

set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\jai_core.jar
set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\jai_codec.jar

或是
set LOCALCLASSPATH=%LOCALCLASSPATH%;%LIBDIR%\JimiProClasses.zip

如果使用fop.shåQˆLinuxòq›_°åQ‰ï¼Œä¼?x¨¬)自动搜索ã€?/p>

4.4. æ·ÕdŠ æ‰©å±•ä»£ç ã€‚如果Docbook XSL样式单有针对FOP的扩展代码（目前没有åQ‰ï¼Œåƒä¸Šé¢ä¸€æ ähŠŠå®ƒä»¬æ·ÕdŠ åˆ°FOP安装目录下lib目录ã€?/p>

现在ž®±å¯ä»¥ä‹É用FOP来生成PDF文档äº?ji¨£n)。FOP提供两个脚本fop.batåQˆWindowsòq›_°åQ‰å’Œfop.shåQˆUnixå’ŒLinuxòq›_°åQ‰ä»¥æ–¹ä¾¿ä½¿ç”¨ã€‚生成PDF的命令行如下åQ?br />
 (t¨©ng) (t¨©ng) (t¨©ng) Linux或UnixåQ?br /> (t¨©ng) (t¨©ng) (t¨©ng) fop.sh -xsl /docbook-xsl/fo/docbook.xsl -xml myfile.xml -pdf myfile.pdf
 (t¨©ng) (t¨©ng) (t¨©ng)
 (t¨©ng) (t¨©ng) (t¨©ng) WindowsåQ?br /> (t¨©ng) (t¨©ng) (t¨©ng) fop.bat -xsl /docbook-xsl/fo/docbook.xsl -xml myfile.xml -pdf myfile.pdf

在处理过½E‹ä¸­åQŒå¯èƒ½ä¼š(x¨¬)提示某些属性不支持或尚未实玎ͼŒä¸ç”¨ç†ä¼š(x¨¬)˜q™äº›æç¤ºåQŒå› ä¸ºFOP仍处于开发中åQŒè¿™òq¶ä¸å½±å“ç”ŸæˆPDF文档ã€?/p>

到此åQŒä¸€ä¸ªDocbook发布¾pȝ»Ÿé…ç½®å®ŒæˆåQŒåƈ可以用来发布文档äº?ji¨£n)。你完全可以在Linux上编写ä“Q务，通过该系¾lŸè‡ªåŠ¨å‘布技术文档ã€?/p>

参考文章：(x¨¬)
Docbook½Ž€ä»?/a>

制作Docbook文档

DocBook XSL: The Complete Guide