实用XSLFO分页控制方法轻松提升文档打印质量与美观度完美满足各种复杂布局需求技术人员必备快速上手应用指南

威震华夏关云长

1. 引言

XSLFO（Extensible Stylesheet Language Formatting Objects）是一种强大的XML标记语言，专门用于文档格式化和布局控制。它特别适用于打印媒体和分页内容，能够精确控制文档的页面布局、分页行为和视觉呈现。在当今数字化时代，虽然电子文档占据主导地位，但高质量的打印文档仍然在许多领域具有不可替代的价值，如正式报告、技术手册、法律文档和出版材料等。

分页控制是文档打印中的关键环节，直接影响文档的专业性和可读性。不恰当的分页可能导致表格被截断、标题孤立在页面底部、段落分离等问题，严重影响文档质量。XSLFO提供了丰富的分页控制机制，使开发人员能够精确控制文档的分页行为，从而提升文档的打印质量和美观度。

本文将深入探讨XSLFO的分页控制方法，从基础概念到高级技巧，帮助技术人员快速掌握这一强大工具，满足各种复杂的文档布局需求。

2. XSLFO基础

在深入探讨分页控制之前，我们需要了解XSLFO的基本概念和结构。

2.1 XSLFO概述

XSLFO是W3C推荐的一种标准，用于定义XML文档的呈现方式。它将XML内容转换为适合打印或显示的格式，通常通过XSLT（Extensible Stylesheet Language Transformations）将XML文档转换为XSLFO格式，然后使用XSLFO处理器（如Apache FOP）将其转换为PDF或其他格式。

2.2 XSLFO文档结构

一个基本的XSLFO文档结构如下：

2. <?xml version="1.0" encoding="UTF-8"?>
3. <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
4.   <fo:layout-master-set>
5.     <!-- 定义页面布局 -->
6.   </fo:layout-master-set>
7.   
8.   <fo:page-sequence>
9.     <!-- 页面内容 -->
10.   </fo:page-sequence>
11. </fo:root>

复制代码

• fo:root：XSLFO文档的根元素
• fo:layout-master-set：定义页面布局的主集合
• fo:page-sequence：包含实际内容的页面序列

2.3 页面布局定义

在fo:layout-master-set中，我们定义页面的布局模板：

2. <fo:layout-master-set>
3.   <fo:simple-page-master master-name="A4" page-height="29.7cm" page-width="21cm">
4.     <fo:region-body margin="2cm"/>
5.     <fo:region-before extent="3cm"/>
6.     <fo:region-after extent="1.5cm"/>
7.   </fo:simple-page-master>
8. </fo:layout-master-set>

复制代码

• fo:simple-page-master：定义简单的页面布局
• page-height和page-width：定义页面尺寸
• fo:region-body：定义主体区域
• fo:region-before和fo:region-after：定义页眉和页脚区域

3. 分页控制基础

XSLFO提供了多种机制来控制分页行为，这些机制可以应用于不同的元素和场景。

3.1 分页的基本原理

在XSLFO中，分页是由处理器根据内容长度、页面大小和指定的分页属性自动进行的。开发人员可以通过设置各种属性来影响这一过程，实现更精确的分页控制。

3.2 基本分页属性

XSLFO提供了一系列基本分页属性，用于控制元素的分页行为：

• page-break-before：控制在元素之前是否分页
• page-break-after：控制在元素之后是否分页
• page-break-inside：控制元素内部是否允许分页

这些属性可以取以下值：

• auto：默认值，允许自动分页
• always：总是分页
• avoid：避免分页
• left：在左页分页
• right：在右页分页

3.3 基本分页示例

以下是一个使用基本分页属性的示例：

2. <fo:block page-break-before="always">
3.   <fo:block font-size="18pt" font-weight="bold" text-align="center">
4.     第一章 引言
5.   </fo:block>
6. </fo:block>
8. <fo:block page-break-inside="avoid">
9.   <fo:block font-size="12pt">
10.     这是一个重要的段落，我们不希望它在页面中间被分割。因此，我们设置了page-break-inside="avoid"属性，确保整个段落会保持在同一页中。
11.   </fo:block>
12. </fo:block>
14. <fo:block page-break-after="always">
15.   <fo:block font-size="12pt">
16.     这是第一章的最后一节内容。我们希望在新的一页开始第二章，因此设置了page-break-after="always"属性。
17.   </fo:block>
18. </fo:block>

复制代码

4. 常用分页属性详解

XSLFO提供了丰富的分页控制属性，让我们深入了解这些属性的用法和应用场景。

4.1 页面序列控制

fo:page-sequence元素用于定义文档中的页面序列，它本身也提供了一些分页相关的属性：

2. <fo:page-sequence master-reference="A4" initial-page-number="1" force-page-count="end-on-even">
3.   <!-- 页面内容 -->
4. </fo:page-sequence>

复制代码

• initial-page-number：指定页面序列的起始页码
• force-page-count：控制页面序列的页面数量，可取值为auto、even、odd、end-on-even、end-on-odd、no-force

4.2 块级元素分页控制

对于块级元素（如fo:block、fo:table等），可以使用以下分页属性：

2. <fo:block page-break-before="always" page-break-after="avoid" page-break-inside="avoid">
3.   <!-- 内容 -->
4. </fo:block>

复制代码

• page-break-before：控制元素前的分页行为
• page-break-after：控制元素后的分页行为
• page-break-inside：控制元素内部是否允许分页

4.3 表格分页控制

表格是文档中常见的元素，也是分页控制的难点。XSLFO提供了专门的表格分页属性：

2. <fo:table table-layout="fixed" width="100%" page-break-inside="avoid">
3.   <fo:table-column column-width="2cm"/>
4.   <fo:table-column column-width="6cm"/>
5.   <fo:table-column column-width="6cm"/>
6.   
7.   <fo:table-header>
8.     <fo:table-row>
9.       <fo:table-cell>
10.         <fo:block font-weight="bold">ID</fo:block>
11.       </fo:table-cell>
12.       <fo:table-cell>
13.         <fo:block font-weight="bold">名称</fo:block>
14.       </fo:table-cell>
15.       <fo:table-cell>
16.         <fo:block font-weight="bold">描述</fo:block>
17.       </fo:table-cell>
18.     </fo:table-row>
19.   </fo:table-header>
20.   
21.   <fo:table-body>
22.     <fo:table-row page-break-inside="avoid">
23.       <fo:table-cell>
24.         <fo:block>001</fo:block>
25.       </fo:table-cell>
26.       <fo:table-cell>
27.         <fo:block>产品A</fo:block>
28.       </fo:table-cell>
29.       <fo:table-cell>
30.         <fo:block>这是产品A的详细描述</fo:block>
31.       </fo:table-cell>
32.     </fo:table-row>
33.     <!-- 更多表格行 -->
34.   </fo:table-body>
35. </fo:table>

复制代码

• table-layout="fixed"：固定表格布局，有助于控制分页
• page-break-inside="avoid"：避免在表格内部或表格行内部分页

4.4 列表分页控制

列表元素（如fo:list-block）也有特定的分页控制属性：

2. <fo:list-block page-break-inside="avoid" provisional-distance-between-starts="1.2cm">
3.   <fo:list-item>
4.     <fo:list-item-label end-indent="label-end()">
5.       <fo:block>1.</fo:block>
6.     </fo:list-item-label>
7.     <fo:list-item-body start-indent="body-start()">
8.       <fo:block>第一个列表项</fo:block>
9.     </fo:list-item-body>
10.   </fo:list-item>
11.   <!-- 更多列表项 -->
12. </fo:list-block>

复制代码

• provisional-distance-between-starts：控制列表项标签和内容之间的距离
• page-break-inside="avoid"：避免在列表内部分页

5. 高级分页技巧

除了基本的分页控制外，XSLFO还提供了一些高级技巧，用于处理更复杂的分页需求。

5.1 条件分页

条件分页允许根据特定条件决定是否分页：

2. <fo:block>
3.   <xsl:if test="position() = last()">
4.     <xsl:attribute name="page-break-after">always</xsl:attribute>
5.   </xsl:if>
6.   <!-- 内容 -->
7. </fo:block>

复制代码

这个示例中，只有当元素是最后一个时，才在其后强制分页。

5.2 页面引用和备用页面

XSLFO允许定义多种页面布局，并根据需要引用它们：

2. <fo:layout-master-set>
3.   <fo:simple-page-master master-name="firstPage" page-height="29.7cm" page-width="21cm">
4.     <fo:region-body margin="2cm"/>
5.     <fo:region-before extent="3cm"/>
6.     <fo:region-after extent="1.5cm"/>
7.   </fo:simple-page-master>
8.   
9.   <fo:simple-page-master master-name="otherPages" page-height="29.7cm" page-width="21cm">
10.     <fo:region-body margin="2cm"/>
11.     <fo:region-before extent="2cm"/>
12.     <fo:region-after extent="1cm"/>
13.   </fo:simple-page-master>
14.   
15.   <fo:page-sequence-master master-name="document">
16.     <fo:repeatable-page-master-alternatives>
17.       <fo:conditional-page-master-reference master-reference="firstPage" page-position="first"/>
18.       <fo:conditional-page-master-reference master-reference="otherPages"/>
19.     </fo:repeatable-page-master-alternatives>
20.   </fo:page-sequence-master>
21. </fo:layout-master-set>

复制代码

在这个示例中，我们定义了两种页面布局：首页和其他页面。然后通过fo:page-sequence-master和fo:conditional-page-master-reference来控制何时使用哪种布局。

5.3 空间控制和保持

XSLFO提供了一些属性用于控制元素周围的空间，以及保持元素在一起：

2. <fo:block keep-with-next="always" keep-together="always">
3.   <fo:block font-size="16pt" font-weight="bold">
4.     重要标题
5.   </fo:block>
6. </fo:block>
8. <fo:block>
9.   这个段落会与前面的标题保持在同一页中，因为标题设置了keep-with-next="always"属性。
10. </fo:block>

复制代码

• keep-with-next：保持元素与下一个元素在同一页
• keep-with-previous：保持元素与前一个元素在同一页
• keep-together：保持元素内部不分页

5.4 孤行和寡行控制

孤行（orphan）指段落的第一行出现在页面底部，寡行（widow）指段落的最后一行出现在页面顶部。XSLFO提供了控制这些情况的属性：

2. <fo:block orphans="2" widows="2">
3.   这是一个较长的段落，我们希望避免第一行单独出现在页面底部（孤行）或最后一行单独出现在页面顶部（寡行）。通过设置orphans="2"和widows="2"，我们确保段落至少有两行留在页面底部或顶部。
4. </fo:block>

复制代码

• orphans：指定段落底部必须保留的最小行数
• widows：指定段落顶部必须保留的最小行数

6. 实际应用案例

让我们通过一些实际的应用案例，深入了解XSLFO分页控制的实际应用。

6.1 技术文档分页控制

技术文档通常包含章节、小节、表格、图像和代码片段，需要精细的分页控制：

2. <?xml version="1.0" encoding="UTF-8"?>
3. <xsl:stylesheet version="1.1" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fo="http://www.w3.org/1999/XSL/Format">
4.   <xsl:template match="/">
5.     <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
6.       <fo:layout-master-set>
7.         <fo:simple-page-master master-name="A4" page-height="29.7cm" page-width="21cm" margin="2cm">
8.           <fo:region-body margin="2cm"/>
9.           <fo:region-before extent="2cm"/>
10.           <fo:region-after extent="1.5cm"/>
11.           <fo:region-start extent="1.5cm"/>
12.           <fo:region-end extent="1.5cm"/>
13.         </fo:simple-page-master>
14.       </fo:layout-master-set>
15.       
16.       <fo:page-sequence master-reference="A4">
17.         <fo:flow flow-name="xsl-region-body">
18.           <!-- 章节标题 -->
19.           <xsl:apply-templates select="document/chapter"/>
20.         </fo:flow>
21.       </fo:page-sequence>
22.     </fo:root>
23.   </xsl:template>
24.   
25.   <xsl:template match="chapter">
26.     <fo:block page-break-before="always" keep-with-next="always">
27.       <fo:block font-size="20pt" font-weight="bold" text-align="center">
28.         <xsl:value-of select="title"/>
29.       </fo:block>
30.     </fo:block>
31.    
32.     <!-- 章节内容 -->
33.     <xsl:apply-templates select="section"/>
34.   </xsl:template>
35.   
36.   <xsl:template match="section">
37.     <fo:block page-break-before="always" keep-with-next="always">
38.       <fo:block font-size="16pt" font-weight="bold">
39.         <xsl:value-of select="title"/>
40.       </fo:block>
41.     </fo:block>
42.    
43.     <fo:block>
44.       <xsl:apply-templates select="para|table|code"/>
45.     </fo:block>
46.   </xsl:template>
47.   
48.   <xsl:template match="para">
49.     <fo:block text-align="justify" orphans="2" widows="2" space-after="0.5cm">
50.       <xsl:value-of select="."/>
51.     </fo:block>
52.   </xsl:template>
53.   
54.   <xsl:template match="table">
55.     <fo:table table-layout="fixed" width="100%" space-before="0.5cm" space-after="0.5cm" page-break-inside="avoid">
56.       <xsl:apply-templates select="column"/>
57.       <fo:table-header>
58.         <fo:table-row>
59.           <xsl:apply-templates select="header/entry"/>
60.         </fo:table-row>
61.       </fo:table-header>
62.       <fo:table-body>
63.         <xsl:apply-templates select="row"/>
64.       </fo:table-body>
65.     </fo:table>
66.   </xsl:template>
67.   
68.   <xsl:template match="column">
69.     <fo:table-column column-width="{@width}"/>
70.   </xsl:template>
71.   
72.   <xsl:template match="header/entry|row/entry">
73.     <fo:table-cell border="solid 1pt black" padding="0.2cm">
74.       <fo:block>
75.         <xsl:value-of select="."/>
76.       </fo:block>
77.     </fo:table-cell>
78.   </xsl:template>
79.   
80.   <xsl:template match="code">
81.     <fo:block background-color="#f0f0f0" font-family="monospace" white-space="pre"
82.              space-before="0.5cm" space-after="0.5cm" padding="0.5cm"
83.              keep-together.within-page="always">
84.       <xsl:value-of select="."/>
85.     </fo:block>
86.   </xsl:template>
87. </xsl:stylesheet>

复制代码

这个示例展示了如何为技术文档创建精细的分页控制，包括：

• 章节和小节标题前的强制分页
• 标题与其后续内容保持在同一页
• 段落的孤行和寡行控制
• 表格的整体保持（避免在表格内部分页）
• 代码块的整体保持

6.2 报表分页控制

报表通常包含大量数据和表格，需要特殊的分页控制：

2. <?xml version="1.0" encoding="UTF-8"?>
3. <xsl:stylesheet version="1.1" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fo="http://www.w3.org/1999/XSL/Format">
4.   <xsl:template match="/">
5.     <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
6.       <fo:layout-master-set>
7.         <fo:simple-page-master master-name="A4" page-height="29.7cm" page-width="21cm" margin="2cm">
8.           <fo:region-body margin="2cm"/>
9.           <fo:region-before extent="2cm"/>
10.           <fo:region-after extent="1.5cm"/>
11.         </fo:simple-page-master>
12.       </fo:layout-master-set>
13.       
14.       <fo:page-sequence master-reference="A4">
15.         <fo:flow flow-name="xsl-region-body">
16.           <!-- 报表标题 -->
17.           <fo:block font-size="18pt" font-weight="bold" text-align="center" space-after="1cm">
18.             <xsl:value-of select="report/title"/>
19.           </fo:block>
20.          
21.           <!-- 报表日期 -->
22.           <fo:block text-align="right" space-after="1cm">
23.             生成日期: <xsl:value-of select="report/date"/>
24.           </fo:block>
25.          
26.           <!-- 报表摘要 -->
27.           <fo:block space-after="1cm">
28.             <xsl:value-of select="report/summary"/>
29.           </fo:block>
30.          
31.           <!-- 数据表格 -->
32.           <fo:table table-layout="fixed" width="100%">
33.             <fo:table-column column-width="2cm"/>
34.             <fo:table-column column-width="4cm"/>
35.             <fo:table-column column-width="4cm"/>
36.             <fo:table-column column-width="3cm"/>
37.             <fo:table-column column-width="3cm"/>
38.             
39.             <!-- 表头 -->
40.             <fo:table-header>
41.               <fo:table-row background-color="#e0e0e0" font-weight="bold">
42.                 <fo:table-cell border="solid 1pt black" padding="0.2cm">
43.                   <fo:block>ID</fo:block>
44.                 </fo:table-cell>
45.                 <fo:table-cell border="solid 1pt black" padding="0.2cm">
46.                   <fo:block>产品名称</fo:block>
47.                 </fo:table-cell>
48.                 <fo:table-cell border="solid 1pt black" padding="0.2cm">
49.                   <fo:block>类别</fo:block>
50.                 </fo:table-cell>
51.                 <fo:table-cell border="solid 1pt black" padding="0.2cm">
52.                   <fo:block text-align="right">单价</fo:block>
53.                 </fo:table-cell>
54.                 <fo:table-cell border="solid 1pt black" padding="0.2cm">
55.                   <fo:block text-align="right">库存</fo:block>
56.                 </fo:table-cell>
57.               </fo:table-row>
58.             </fo:table-header>
59.             
60.             <!-- 表体 -->
61.             <fo:table-body>
62.               <xsl:for-each select="report/products/product">
63.                 <fo:table-row>
64.                   <fo:table-cell border="solid 1pt black" padding="0.2cm">
65.                     <fo:block>
66.                       <xsl:value-of select="id"/>
67.                     </fo:block>
68.                   </fo:table-cell>
69.                   <fo:table-cell border="solid 1pt black" padding="0.2cm">
70.                     <fo:block>
71.                       <xsl:value-of select="name"/>
72.                     </fo:block>
73.                   </fo:table-cell>
74.                   <fo:table-cell border="solid 1pt black" padding="0.2cm">
75.                     <fo:block>
76.                       <xsl:value-of select="category"/>
77.                     </fo:block>
78.                   </fo:table-cell>
79.                   <fo:table-cell border="solid 1pt black" padding="0.2cm">
80.                     <fo:block text-align="right">
81.                       <xsl:value-of select="price"/>
82.                     </fo:block>
83.                   </fo:table-cell>
84.                   <fo:table-cell border="solid 1pt black" padding="0.2cm">
85.                     <fo:block text-align="right">
86.                       <xsl:value-of select="stock"/>
87.                     </fo:block>
88.                   </fo:table-cell>
89.                 </fo:table-row>
90.                
91.                 <!-- 每10行添加一个分页提示 -->
92.                 <xsl:if test="position() mod 10 = 0">
93.                   <fo:table-row>
94.                     <fo:table-cell number-columns-spanned="5" padding="0.2cm">
95.                       <fo:block page-break-inside="avoid" keep-with-next="always">
96.                         <fo:block font-style="italic" text-align="center">
97.                           继续下一页...
98.                         </fo:block>
99.                       </fo:block>
100.                     </fo:table-cell>
101.                   </fo:table-row>
102.                 </xsl:if>
103.               </xsl:for-each>
104.             </fo:table-body>
105.           </fo:table>
106.          
107.           <!-- 报表总结 -->
108.           <fo:block page-break-before="always" space-before="1cm">
109.             <fo:block font-size="14pt" font-weight="bold" space-after="0.5cm">
110.               报表总结
111.             </fo:block>
112.             <fo:block>
113.               <xsl:value-of select="report/conclusion"/>
114.             </fo:block>
115.           </fo:block>
116.         </fo:flow>
117.       </fo:page-sequence>
118.     </fo:root>
119.   </xsl:template>
120. </xsl:stylesheet>

复制代码

这个报表示例展示了：

• 表格的自动分页
• 每10行添加一个分页提示
• 报表总结在新页开始
• 表头在每页重复显示

6.3 多语言文档分页控制

多语言文档需要考虑不同语言的排版规则和分页习惯：

2. <?xml version="1.0" encoding="UTF-8"?>
3. <xsl:stylesheet version="1.1" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fo="http://www.w3.org/1999/XSL/Format">
4.   <xsl:template match="/">
5.     <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
6.       <fo:layout-master-set>
7.         <fo:simple-page-master master-name="A4" page-height="29.7cm" page-width="21cm" margin="2cm">
8.           <fo:region-body margin="2cm"/>
9.           <fo:region-before extent="2cm"/>
10.           <fo:region-after extent="1.5cm"/>
11.         </fo:simple-page-master>
12.       </fo:layout-master-set>
13.       
14.       <fo:page-sequence master-reference="A4">
15.         <fo:flow flow-name="xsl-region-body">
16.           <xsl:apply-templates select="document/content"/>
17.         </fo:flow>
18.       </fo:page-sequence>
19.     </fo:root>
20.   </xsl:template>
21.   
22.   <xsl:template match="content">
23.     <xsl:choose>
24.       <!-- 英语内容 -->
25.       <xsl:when test="@lang='en'">
26.         <fo:block language="en" country="US" text-align="left" hyphenate="true">
27.           <xsl:apply-templates/>
28.         </fo:block>
29.       </xsl:when>
30.       
31.       <!-- 阿拉伯语内容 -->
32.       <xsl:when test="@lang='ar'">
33.         <fo:block language="ar" country="SA" writing-mode="rl-tb" text-align="right">
34.           <xsl:apply-templates/>
35.         </fo:block>
36.       </xsl:when>
37.       
38.       <!-- 中文内容 -->
39.       <xsl:when test="@lang='zh'">
40.         <fo:block language="zh" country="CN" text-align="justify" linefeed-treatment="preserve">
41.           <xsl:apply-templates/>
42.         </fo:block>
43.       </xsl:when>
44.       
45.       <!-- 默认处理 -->
46.       <xsl:otherwise>
47.         <fo:block>
48.           <xsl:apply-templates/>
49.         </fo:block>
50.       </xsl:otherwise>
51.     </xsl:choose>
52.   </xsl:template>
53.   
54.   <xsl:template match="p">
55.     <fo:block space-after="0.5cm" orphans="2" widows="2">
56.       <xsl:apply-templates/>
57.     </fo:block>
58.   </xsl:template>
59.   
60.   <xsl:template match="h1">
61.     <fo:block page-break-before="always" keep-with-next="always" space-after="0.5cm">
62.       <fo:block font-size="18pt" font-weight="bold">
63.         <xsl:apply-templates/>
64.       </fo:block>
65.     </fo:block>
66.   </xsl:template>
67.   
68.   <xsl:template match="h2">
69.     <fo:block page-break-before="avoid" keep-with-next="always" space-after="0.5cm">
70.       <fo:block font-size="16pt" font-weight="bold">
71.         <xsl:apply-templates/>
72.       </fo:block>
73.     </fo:block>
74.   </xsl:template>
75. </xsl:stylesheet>

复制代码

这个多语言文档示例展示了：

• 根据语言属性应用不同的排版规则
• 阿拉伯语的从右到左（RTL）排版
• 中文的对齐和换行处理
• 英语的连字符处理
• 所有语言都适用的孤行和寡行控制

7. 最佳实践

在使用XSLFO进行分页控制时，遵循一些最佳实践可以帮助您创建更专业、更美观的文档。

7.1 分页策略规划

在开始编写XSLFO代码之前，先规划文档的分页策略：

1. 识别关键分页点：确定哪些元素需要在新页开始（如章节标题）
2. 定义保持区域：确定哪些元素应该保持在一起（如标题和其后的第一段）
3. 规划特殊布局：确定是否有需要特殊布局的页面（如首页、目录页等）

7.2 合理使用分页属性

避免过度使用分页属性，只在必要时使用：

2. <!-- 好的做法：只在必要时使用分页属性 -->
3. <fo:block page-break-before="always">
4.   <fo:block font-size="18pt" font-weight="bold">
5.     第一章
6.   </fo:block>
7. </fo:block>
9. <!-- 避免的做法：不必要的分页属性 -->
10. <fo:block page-break-before="auto" page-break-after="auto" page-break-inside="auto">
11.   <fo:block>
12.     普通段落
13.   </fo:block>
14. </fo:block>

复制代码

7.3 平衡自动分页和手动分页

XSLFO的自动分页功能非常强大，但在某些情况下需要手动干预：

2. <!-- 自动分页适合大多数情况 -->
3. <fo:block>
4.   这是一个普通段落，让XSLFO处理器自动决定分页位置。
5. </fo:block>
7. <!-- 手动分页适用于特殊情况 -->
8. <fo:block page-break-before="always">
9.   这是一个新章节的开始，需要在新页显示。
10. </fo:block>

复制代码

7.4 表格分页的最佳实践

表格分页是文档格式化中的难点，以下是一些最佳实践：

2. <fo:table table-layout="fixed" width="100%">
3.   <!-- 定义固定宽度的列 -->
4.   <fo:table-column column-width="proportional-column-width(1)"/>
5.   <fo:table-column column-width="proportional-column-width(3)"/>
6.   
7.   <!-- 表头保持在一页 -->
8.   <fo:table-header>
9.     <fo:table-row keep-with-next="always">
10.       <!-- 表头单元格 -->
11.     </fo:table-row>
12.   </fo:table-header>
13.   
14.   <!-- 表体 -->
15.   <fo:table-body>
16.     <xsl:for-each select="data/row">
17.       <!-- 避免行内分页 -->
18.       <fo:table-row page-break-inside="avoid">
19.         <!-- 行单元格 -->
20.       </fo:table-row>
21.     </xsl:for-each>
22.   </fo:table-body>
23. </fo:table>

复制代码

7.5 测试和验证

分页控制通常需要多次测试和调整才能达到理想效果：

1. 使用不同内容长度测试：测试短内容和长内容场景
2. 检查边界情况：测试几乎填满页面的内容
3. 验证特殊元素：确保表格、图像等特殊元素正确分页

7.6 性能考虑

复杂的分页控制可能会影响处理性能，特别是在处理大型文档时：

1. 避免过度嵌套：深度嵌套的元素会增加处理复杂度
2. 合理使用条件分页：复杂的条件判断会降低处理速度
3. 优化表格结构：大型表格应考虑分页优化

8. 常见问题与解决方案

在使用XSLFO进行分页控制时，可能会遇到一些常见问题。以下是一些常见问题及其解决方案。

8.1 问题：表格被截断

现象：表格在页面中间被截断，部分内容显示在下一页，但没有表头。

解决方案：

2. <fo:table table-layout="fixed" width="100%">
3.   <!-- 表头 -->
4.   <fo:table-header>
5.     <fo:table-row>
6.       <!-- 表头单元格 -->
7.     </fo:table-row>
8.   </fo:table-header>
9.   
10.   <!-- 表体 -->
11.   <fo:table-body>
12.     <!-- 使用keep-together避免行被截断 -->
13.     <xsl:for-each select="data/row">
14.       <fo:table-row keep-together.within-page="always">
15.         <!-- 行单元格 -->
16.       </fo:table-row>
17.     </xsl:for-each>
18.   </fo:table-body>
19. </fo:table>

复制代码

8.2 问题：标题孤立在页面底部

现象：章节标题出现在页面底部，其后的内容从下一页开始。

解决方案：

2. <!-- 使用keep-with-next确保标题与后续内容在同一页 -->
3. <fo:block keep-with-next="always">
4.   <fo:block font-size="18pt" font-weight="bold">
5.     第一章 引言
6.   </fo:block>
7. </fo:block>
9. <fo:block>
10.   这是第一章的第一段内容，它会与标题保持在同一页。
11. </fo:block>

复制代码

8.3 问题：段落被不当分页

现象：段落被不当分页，导致孤行或寡行。

解决方案：

2. <!-- 使用orphans和widows属性控制段落分页 -->
3. <fo:block orphans="3" widows="3">
4.   这是一个较长的段落，通过设置orphans和widows属性为3，确保段落底部至少保留3行，顶部也至少保留3行，避免出现孤行或寡行。
5. </fo:block>

复制代码

8.4 问题：图像与说明文字分离

现象：图像出现在一页末尾，而其说明文字出现在下一页开头。

解决方案：

2. <!-- 使用keep-together确保图像和说明文字在一起 -->
3. <fo:block keep-together.within-page="always">
4.   <fo:block text-align="center">
5.     <fo:external-graphic src="url('image.jpg')" width="80%"/>
6.   </fo:block>
7.   <fo:block text-align="center" font-style="italic">
8.     图1: 示例图像
9.   </fo:block>
10. </fo:block>

复制代码

8.5 问题：列表项被不当分页

现象：列表项被不当分页，导致项目符号与其内容分离。

解决方案：

2. <!-- 使用keep-together确保列表项完整 -->
3. <fo:list-block>
4.   <fo:list-item keep-together.within-page="always">
5.     <fo:list-item-label end-indent="label-end()">
6.       <fo:block>•</fo:block>
7.     </fo:list-item-label>
8.     <fo:list-item-body start-indent="body-start()">
9.       <fo:block>
10.         这是一个列表项，通过设置keep-together属性，确保项目符号和内容保持在同一页。
11.       </fo:block>
12.     </fo:list-item-body>
13.   </fo:list-item>
14. </fo:list-block>

复制代码

8.6 问题：页眉页脚不正确显示

现象：页眉或页脚在某些页面上不显示或显示不正确。

解决方案：

2. <fo:layout-master-set>
3.   <fo:simple-page-master master-name="A4" page-height="29.7cm" page-width="21cm">
4.     <!-- 确保region-before和region-after有足够的空间 -->
5.     <fo:region-before extent="2cm"/>
6.     <fo:region-after extent="1.5cm"/>
7.     <fo:region-body margin-top="2cm" margin-bottom="1.5cm" margin-left="2cm" margin-right="2cm"/>
8.   </fo:simple-page-master>
9. </fo:layout-master-set>
11. <fo:page-sequence master-reference="A4">
12.   <!-- 定义页眉 -->
13.   <fo:static-content flow-name="xsl-region-before">
14.     <fo:block text-align="center" font-weight="bold">
15.       文档标题
16.     </fo:block>
17.   </fo:static-content>
18.   
19.   <!-- 定义页脚 -->
20.   <fo:static-content flow-name="xsl-region-after">
21.     <fo:block text-align="center">
22.       第 <fo:page-number/> 页
23.     </fo:block>
24.   </fo:static-content>
25.   
26.   <!-- 页面内容 -->
27.   <fo:flow flow-name="xsl-region-body">
28.     <!-- 内容 -->
29.   </fo:flow>
30. </fo:page-sequence>

复制代码

9. 结论

XSLFO提供了强大而灵活的分页控制机制，使开发人员能够创建高质量的打印文档。通过合理使用分页属性、保持属性和空间控制属性，可以精确控制文档的分页行为，避免常见的分页问题，如孤行、寡行、表格截断等。

在实际应用中，应根据文档类型和内容特点选择合适的分页策略。技术文档、报表和多语言文档各有其特殊的分页需求，需要采用不同的方法和技术。

通过本文介绍的方法和技巧，技术人员可以快速掌握XSLFO分页控制，提升文档打印质量和美观度，满足各种复杂的布局需求。无论是创建简单的报告还是复杂的技术手册，XSLFO都能提供专业级的文档格式化解决方案。

随着文档处理需求的不断增长，掌握XSLFO分页控制技术将成为技术人员的宝贵技能，帮助他们在各种文档处理项目中脱颖而出。通过不断实践和探索，您将能够充分利用XSLFO的强大功能，创建出令人印象深刻的打印文档。