XSL-FO 教程

内容列表

XSLFO 简介
XSL-FO 的简介。包括其概念和作用。

XSLFO 文档
本章将解 XSL-FO 文档的结构。

XSLFO 区域
本章讲解 XSL-FO 的区域模型（area model）。

XSLFO 输出
本章讲解 XSL-FO 文档的输出元素（Output Elements）。

XSLFO 流
本章讲解 XSL-FO 文档的输出流（Output Flow）。

XSLFO 页面
本章讲解 XSL-FO 如何定义页面的布局。

XSLFO 块
本章讲解 XSL-FO 输出块（output blocks）。

XSLFO 列表
本章讲解 XSL-FO 如何定义列表。

XSLFO 表格
本章讲解 XSL-FO 如何定义表格。

XSLFO & XSLT
本章讲解 XSL-FO 如何使用 XSLT。

XSLFO 软件
本章介绍了我们最喜欢的XSL-FO软件。

XSL-FO 对象参考手册
完整的 XSL-FO 对象列表，以及它们的属性。

XSL-FO 简介

XSL-FO 用于格式化供输出的 XML 数据。

学习之前应当具备的基础知识

在您学习 XSL-FO 之前，应当对 XML 和 XML 命名空间有基本的了解。

如果您希望首先学习这些项目，请阅读我们的 XML 教程。

什么是 XSL-FO？

• XSL-FO 是用于格式化 XML 数据的语言
• XSL-FO 指可扩展样式表语言格式化对象（Extensible Stylesheet Language Formatting Objects）
• XSL-FO 是基于 XML
• XSL-FO 是一个 W3C 推荐标准
• XSL-FO 目前通常被称为 XSL

XSL-FO 与格式化有关

XSL-FO 是一种基于 XML 的标记语言，用于描述向屏幕、纸或者其他媒介输出 XML 数据的格式化（信息）。

XSL-FO 通常被称为 XSL

为什么会存在这样的混淆呢？XSL-FO 和 XSL 是一回事吗？

可以这么说，不过我们需要向您作一个解释：

样式化（Styling）是关于转换信息和格式化信息两方面。在万维网联盟（W3C）编写他们的首个 XSL 工作草案的时候，这个草案包括了有关转换和格式化 XML 文档的语言语法。

后来，W3C 工作组把这个原始的草案分为独立的标准：

• XSLT，用于转换 XML 文档的语言
• XSL 或 XSL-FO，用于格式化 XML 文档的语言
• XPath，是通过元素和属性在 XML 文档中进行导航的语言

本教程的其余内容均与格式化 XML 文档有关：XSL-FO，也被称为 XSL。

XSL-FO 是一个 Web 标准

XSL-FO 在 2001 年 10 月 15 日 被确立为 W3C 推荐标准。通常被称为 XSL。

如需阅读更多有关 W3C 的 XSL 活动的内容，请阅读我们的 W3C 教程。

XSL-FO 文档

XSL-FO 文档

XSL-FO 文档是带有输出信息的 XML 文件。

XSL-FO 文档存储在以 .fo 或 .fob 为文件扩展名的文件中。您也可以把 XSL-FO 文档存储为以 .xml 为扩展名的文件，这样做的话可以使 XSL-FO 文档更易被 XML 编辑器存取。

XSL-FO 文档结构

XSL-FO 的文档结构如下所示：

结构解释

XSL-FO 文档属于 XML 文档，因此也需要以 XML 声明来起始：

<fo:root> 元素是 XSL-FO 文档的根元素。这个根元素也要声明 XSL-FO 的命名空间：

<fo:layout-master-set> 元素包含一个或多个页面模板：

每个 <fo:simple-page-master> 元素包含一个单一的页面模板。每个模板必须有一个唯一的名称（master-name）：

一个或多个 <fo:page-sequence> 元素可描述页面内容。master-reference 属性使用相同的名称来引用 simple-page-master 模板：

注释：master-reference 的值 "A4" 实际上并没有描述某个预定义的页面格式。它仅仅是一个名称。您可以使用任何名称，比如 "MyPage"、"MyTemplate" 等等。

XSL-FO 区域

XSL-FO 使用矩形框（区域）来显示输出。

XSL-FO 区域

XSL 格式化模型定义了一系列的矩形区域（框）来显示输出。

所有的输出（文本、图片，等等）都会被格式化到这些框中，然后会被显示或打印到某个目标媒介。

让我们研究一下下面这些区域：

• Pages（页面）
• Regions（区）
• Block areas（块区域）
• Line areas（行区域）
• Inline areas（行内区域）

XSL-FO Pages（页面）

XSL-FO 输出会被格式化到页面中。打印输出通常会分为许多分割的页面。浏览器输出经常会成为一个长的页面。

XSL-FO Pages（页面）包含区（Region）。

XSL-FO Regions（区）

每个 XSL-FO 页面均包含一系列的 Regions（区）：

• region-body（页面的主体）
• region-before（页面的页眉）
• region-after（页面的页脚）
• region-start（左侧栏）
• region-end（右侧栏）

XSL-FO Regions（区）包含块区域（Block Area）。

XSL-FO Block Areas（块区域）

XSL-FO Block Areas（块区域）定义了小的块元素（通常由一个新行开始），比如段落、表格以及列表。

XSL-FO Block Areas（块区域）包含其他的块区域，不过大多数时候它们包含的是行区域（Line Area）。

XSL-FO Line Areas（行区域）

XSL-FO Line Areas（行区域）定义了块区域内部的文本行。

XSL-FO Line Areas（行区域）包含行内区域（Inline Area）。

XSL-FO Inline Areas（行内区域）

XSL-FO Inline Areas（行内区域）定义了行内部的文本（着重号、单字符、图像，等等）。

XSL-FO 输出

XSL-FO 在 <fo:flow> 元素内部定义输出。

XSL-FO 页面（Page）、流（Flow）以及块（Block）

内容"块"会"流"入"页面"中，然后输出到媒介。

XSL-FO 输出通常被嵌套在 <fo:block> 元素内，<fo:block> 嵌套于 <fo:flow> 元素内，<fo:flow> 嵌套于 <fo:page-sequence> 元素内：

XSL-FO 实例

现在让我们看一个真实的 XSL-FO 实例：

以上代码的输出如下所示：

XSL-FO 流

XSL-FO 页面使用来自 <fo:flow> 元素的数据进行填充。

XSL-FO 页面序列（Page Sequences）

XSL-FO 使用 <fo:page-sequence> 元素来定义输出页面。

每个输出页面都会引用一个定义布局的 page master。

每个输出页面都有一个定义输出的 <fo:flow> 元素。

每个输出页面均会按序列（顺序）被打印或显示。

XSL-FO 流（Flow）

XSL-FO 页面使用来自 <fo:flow> 元素的内容进行填充。

<fo:flow> 元素包含所有被打印到页面的元素。

当页面被印满以后，相同的 page master 会被一遍又一遍地被使用，直到所有文本被打印为止。

流动到何处？

<fo:flow> 元素有一个 "flow-name" 属性。

flow-name 属性的值定义 <fo:flow> 元素的内容会去往何处。

合法的值：

• xsl-region-body（进入 region-body）
• xsl-region-before（进入 region-before）
• xsl-region-after（进入 region-after）
• xsl-region-start（进入 region-start）
• xsl-region-end（进入 region-end）

XSL-FO 页面

XSL-FO 使用名为 "Page Masters" 的页面模板来定义页面的布局。

XSL-FO 页面模板（Page Templates）

XSL-FO 使用名为 "Page Masters" 的页面模板来定义页面的布局。每个模板必须拥有一个唯一的名称：

在上面的实例中，三个 <fo:simple-page-master> 元素，定义了三个不同的模板。每个模板（page-master）都有不同的名称。

第一个模板名为 "intro"。它可作为介绍页面的模板使用。

第二个和第三个模板名为 "left" 和 "right"。它们可作为偶数和奇数页码的页面模板使用。

XSL-FO 页面尺寸（Page Size）

XSL-FO 使用下面的属性定义页面的尺寸：

• page-width 定义页面的宽度
• page-height 定义页面的高度

XSL-FO 页面边距（Page Margins）

XSL-FO 使用下面的属性定义页面的边距：

• margin-top 定义上边距
• margin-bottom 定义下边距
• margin-left 定义左边距
• margin-right 定义右边距
• margin 定义所有边的边距

XSL-FO 页面区（Page Regions）

XSL-FO 使用下面的元素定义页面的区：

• region-body 定义主体区
• region-before 定义顶部区（页眉）
• region-after 定义底部区（页脚）
• region-start 定义左侧区（左侧栏）
• region-end 定义右侧区（右侧栏）

请注意，region-before、region-after、region-start 以及 region-end 是主体区的一部分。为了避免主体区的文本覆盖到这些区域的文本，主体区的边距至少要等于其他区的尺寸。

XSL-FO 实例

这是从某个 XSL-FO 文档中提取的一个片断：

上面的代码定义了一个名称为 "A4" 的 "Simple Page Master Template"。

页面的宽度是 297 毫米，高度是 210 毫米。

页面的四个边距（上边距、下边距、左边距、右边距）均为 1 厘米。

主体的边距是 3 厘米（四个边都是）。

主体的 before、after、start 以及 end 区均为 2 厘米。

上面的实例中的主体的宽度可通过页面宽度减去左右边距以及 region-body 的边距来计算得出：

297mm - (2 x 1cm) - (2 x 3cm) = 297mm - 20mm - 60mm = 217mm

请注意，region（region-start 和 region-end）没有被计算进来。正如之前讲解过的，这些区（region）是主体的组成部分。

XSL-FO 块

XSL-FO 的输出位于块区域中。

XSL-FO 页面（Page）、流（Flow）以及块（Block）

内容"块"会"流"入"页面"中，然后输出到媒介。

XSL-FO 输出通常被嵌套在 <fo:block> 元素内，<fo:block> 嵌套于 <fo:flow> 元素内，<fo:flow> 嵌套于 <fo:page-sequence> 元素内：

块区域的属性

块是位于矩形框中的输出序列：

由于块区域是矩形框，所以可共享许多公共的区域属性：

• space before 和 space after
• margin
• border
• padding

space before 和 space after 是块与块之间起分割作用的空白。

margin 是块外侧的空白区域。

border 是区域外部边缘的矩形。其四个边均可有不同的宽度。它也可被填充为不同的颜色和背景图像。

padding 是位于 border 与 content 区域之间的区域。

content 区域可包含实际的内容，比如文本、图片、图形等等。

块边距（Block Margin）

• margin
• margin-top
• margin-bottom
• margin-left
• margin-right

块边框（Block Border）

边框样式属性：

• border-style
• border-before-style
• border-after-style
• border-start-style
• border-end-style
• border-top-style（等同于 border-before）
• border-bottom-style（等同于 border-after）
• border-left-style（等同于 border-start）
• border-right-style（等同于 border-end）

边框颜色属性：

• border-color
• border-before-color
• border-after-color
• border-start-color
• border-end-color
• border-top-color（等同于 border-before）
• border-bottom-color（等同于 border-after）
• border-left-color（等同于 border-start）
• border-right-color（等同于 border-end）

边框宽度属性：

• border-width
• border-before-width
• border-after-width
• border-start-width
• border-end-width
• border-top-width（等同于 border-before）
• border-bottom-width（等同于 border-after）
• border-left-width（等同于 border-start）
• border-right-width（等同于 border-end）

块填充（Block Padding）

• padding
• padding-before
• padding-after
• padding-start
• padding-end
• padding-top（等同于 padding-before）
• padding-bottom（等同于 padding-after）
• padding-left（等同于 padding-start）
• padding-right（等同于 padding-end）

块背景（Block Background）

• background-color
• background-image
• background-repeat
• background-attachment（scroll 或 fixed）

块样式属性（Block Styling Attributes）

块是可被单独样式化的输出序列：

字体属性：

• font-family
• font-weight
• font-style
• font-size
• font-variant

文本属性：

• text-align
• text-align-last
• text-indent
• start-indent
• end-indent
• wrap-option（定义自动换行）
• break-before（定义分页符）
• break-after（定义分页符）
• reference-orientation（定义 90" 增量的文字旋转）

实例

结果：

请看上面的实例，如果要生成一个拥有许多标题和段落的文档，那么将会需要非常多的代码。

通常，XSL-FO 文档不会像我们刚才所做的那样对格式化信息和内容进行组合。

通过 XSLT 的些许帮助，我们就可以把格式化信息置入模板，然后编写出更纯净的内容。

您会在本教程后面的章节学习到如何使用 XSLT 模板来组合 XSL-FO。

XSL-FO 列表

XSL-FO 使用 <fo:list-block> 元素来定义列表。

XSL-FO 列表块（List Blocks）

有四种 XSL-FO 对象可用来创建列表：

• fo:list-block（包含整个列表） (contains the whole list)
• fo:list-item（包含列表中的每个项目） (contains each item in the list)
• fo:list-item-label（包含用于 list-item 的标签 - 典型地，包含一个数字或者字符的 <fo:block> ）
• fo:list-item-body（包含 list-item 的内容/主体 - 典型地，一个或多个 <fo:block> 对象）

一个 XSL-FO 列表实例:

上面代码的输出如下所示：

XSL-FO 表格

XSL-FO 使用 <fo:table-and-caption> 元素来定义表格。

XSL-FO 表格（Tables）

XSL-FO 表格模型与 HTML 表格模型不是完全不同的。

有九种 XSL-FO 对象可用来创建表格：

• fo:table-and-caption
• fo:table
• fo:table-caption
• fo:table-column
• fo:table-header
• fo:table-footer
• fo:table-body
• fo:table-row
• fo:table-cell

XSL-FO 使用 <fo:table-and-caption> 元素来定义表格。它包含一个 <fo:table> 以及一个可选的 <fo:caption> 元素。

<fo:table> 元素包含可选的 <fo:table-column> 元素，一个可选的 <fo:table-header> 元素，一个 <fo:table-body> 元素，一个可选的 <fo:table-footer> 元素。这些元素中的每一个都可能拥有一个或多个 <fo:table-row> 元素，而 <fo:table-row> 同时会带有一个或多个 <fo:table-cell> 元素：

以上代码的输出如下所示：

XSL-FO 与 XSLT

XSL-FO 与 XSLT 可彼此互助。

还记得这个实例吗？

结果：

上面的实例来自于有关 XSL-FO 块区域的那一章节。

来自 XSLT 的帮助

从文档移除 XSL-FO 信息：

添加 XSLT 转换：

产生的结果是相同的：

XSL-FO 软件

XSL-FO 需要格式化软件来产生输出。

XSL-FO 处理器

一个 XSL-FO 处理器是一个用于格式化输出 XSL 文档的软件程序。

大多数的 XSL-FO 处理器可以输出 HTML、PDF 文档和质量打印。

下面介绍一些知名的 XSL-FO 处理器。

Antenna House Formatter V5

Antenna House Formatter V5 是为 PDF 或打印格式化 XML 文档的软件程序。

访问 Antenna House

Altova 的 StyleVision

StyleVision 基于您的设计自动生成一致性标准的 XSLT 和 XSL:FO 样式表，以及相应的 HTML、RTF、PDF、 Word 2007 输出，等等。

访问 Altova

Ecrion 的 XF 产品

XSL-FO 格式化的一些产品！

访问 Ecrion

XSL-FO 参考手册

XSL 格式化对象参考手册

将描述转换为呈现的过程被称为格式化（formatting）。