XSL-FO
Posted A_山水子农
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了XSL-FO相关的知识,希望对你有一定的参考价值。
一、XSL-FO简介
XSL-FO 用于格式化供输出的 XML 数据。XSL-FO 是一种基于 XML 的标记语言,用于描述向屏幕、纸或者其他媒介输出 XML 数据的格式化(信息)。样式化(Styling)是关于转换信息和格式化信息两方面的信息。在万维网联盟编写他们的首个 XSL 工作草案的时候,这个草案包括了有关转换和格式化 XML 文档的语言语法。
后来,XSL 工作组把这个原始的草案分为独立的标准:
XSLT,用于转换 XML 文档的语言
XSL 和 XSL-FO,用于格式化 XML 文档的语言
XPath,是通过元素和属性在 XML 文档中进行导航的语言
本教程的其余内容均与文档的格式化有关:XSL-FO,也被称为 XSL。
二、XSL-FO 文档
XSL-FO 文档是带有输出信息的 XML 文件。它们包含着有关输出布局以及输出内容的信息。XSL-FO 文档存储在以 .fo 或 .fob 为后缀的文件中。以 .xml 为后缀存储的 XSL-FO 文档也很常见,这样做的话可以使 XSL-FO 文档更易被 XML 编辑器存取。
1、XSL-FO 文档的结构
XSL-FO 的文档结构类似这样:
<?xml version="1.0" encoding="ISO-8859-1"?>
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
<fo:layout-master-set>
<fo:simple-page-master master-name="A4">
<!-- Page template goes here -->
</fo:simple-page-master>
</fo:layout-master-set>
<fo:page-sequence master-reference="A4">
<!-- Page content goes here -->
</fo:page-sequence>
</fo:root>
2、结构解释
XSL-FO 文档属于 XML 文档,因为也需要以 XML 声明来起始:
<?xml version="1.0" encoding="ISO-8859-1"?>
<fo:root> 元素是 XSL-FO 文档的根元素。这个根元素也要声明 XSL-FO 的命名空间:
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
<!-- 此处是 XSL-FO 文档的内容 -->
</fo:root>
<fo:layout-master-set> 元素含有一个或多个页面模板:
<fo:layout-master-set>
<!-- 此处是所有的页面模板 -->
</fo:layout-master-set>
<fo:simple-page-master> 元素包含一个单一的页面模板。每个模板须有一个唯一的名称(master-name):
<fo:simple-page-master master-name="A4">
<!-- 此处是某一个页面模板 -->
</fo:simple-page-master>
一个或多个 <fo:page-sequence> 元素可描述页面的内容。master-reference 属性使用相同的名称来引用 simple-page-master 模板:
<fo:page-sequence master-reference="A4">
<!-- 此处是页面内容 -->
</fo:page-sequence>
注释:master-reference 的值 "A4" 实际上并没有描述某个预定义的页面格式。它仅仅是一个名称。您可以使用任何名称,比如 "MyPage"、"MyTemplate" 等等。
三、XSL-FO 区域
XSL-FO 使用矩形框(区域)来显示输出。
1、XSL-FO 区域
XSL 格式化模型定义了一系列的矩形(区域)框来显示输出。所有的输出都会被格式化到这些框中,然后会被显示或打印到某个目标媒介。让我们研究一下下面这些区域:
Pages(页面)
Regions(区)
Block areas(块区域)
Line areas(行区域)
Inline areas(行内区域)
2、XSL-FO Pages(页面)
XSL-FO 输出会被格式化到页面中。打印输出通常会进入分为许多分割的页面。浏览器输出经常会成为一个长的页面。
3、XSL-FO 页面包含区域(Region)。
XSL-FO Regions(区),每个 XSL-FO 页面均包含一系列的 Regions(区):
region-body (页面的主体)
region-before (页面的页眉)
region-after (页面的页脚)
region-start (左侧栏)
region-end (右侧栏)
4、XSL-FO Regions 包含块区域(Block Area)。
XSL-FO Block Areas(块区域),XSL-FO 块区域可定义小的块元素(通常由一个新行开始),比如段落、表格以及列表。
5、XSL-FO 块区域可包含其他的块区域,不过大多数时候它们包含的是行区域(Line Area)。
XSL-FO Line Areas(行区域)
XSL-FO 行区域定义了块区域内部的文本行。
6、XSL-FO 行区域包含行内区域(Inline Area)。
XSL-FO Inline Areas(行内区域)
XSL-FO 行内区域定了行内部的文本(着重号、单字符以及图像等等)。
四、XSL-FO 输出
XSL-FO 在 <fo:flow> 元素内部定义输出。XSL-FO 页面(Page)、流(Flow)以及块(Block),内容“块”会“流”入“页面”中,然后输出到媒介。XSL-FO 输出通常被嵌套在 <fo:block> 元素中,<fo:block> 嵌套于 <fo:flow> 元素中,<fo:flow> 嵌套于 <fo:page-sequence> 元素中:
<fo:page-sequence>
<fo:flow flow-name="xsl-region-body">
<fo:block>
<!-- Output goes here -->
</fo:block>
</fo:flow>
</fo:page-sequence>
五、XSL-FO 流
XSL-FO 页面使用来自 <fo:flow> 元素的数据进行填充。
1、XSL-FO 页面顺序
XSL-FO 使用 <fo:page-sequence> 元素来定义输出页面。
每个输出页面都会引用一个定义布局的 page master。
每个输出页面均有一个定义输出的 <fo:flow>元素。
每个输出页面均会按顺序(序列)被打印或显示。
2、XSL-FO Flow(流)
XSL-FO 页面使用来自 <fo:flow> 元素的数据进行填充。<fo:flow> 包含所有被打印到页面的元素。当页面被印满以后,相同的 page master 会被一遍又一遍地被使用,直到所有页面的页面被打印为止。
3、流动到何处?
<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" 的页面模板来定义页面的布局。
1、XSL-FO 页面模板
XSL-FO 使用名为 "Page Masters" 的页面模板来定义页面的布局。每个模板必须拥有一个唯一的名称:
<fo:simple-page-master master-name="intro">
<fo:region-body margin="5in" />
</fo:simple-page-master>
<fo:simple-page-master master-name="left">
<fo:region-body margin-left="2in" margin-right="3in" />
</fo:simple-page-master>
<fo:simple-page-master master-name="right">
<fo:region-body margin-left="3in" margin-right="2in" />
</fo:simple-page-master>
在上面的例子中,三个 <fo:simple-page-master> 元素,定义了三个不同的模板。每个模板(page-master)都有不同的名称。
第一个模板名为 "intro"。它可作为介绍页面的模板使用。
第二个和第三个模板名为 "left" 和 "right"。它们可被用于偶数和奇数页码的页面。
2、XSL-FO 页面尺寸
XSL-FO 使用下面的属性来定义页面尺寸:
page-width定义页面的宽度
page-height定义页面的高度
3、XSL-FO 页面边距
XSL-FO 使用下面的属性定义页面边距:
margin-top定义上边距
margin-bottom定义下边距
margin-left定义左边距
margin-right定义右边距
margin定义所有边的边距
4、XSL-FO 页面区(Page Regions)
XSL-FO 使用下面的元素来定义页面的区:
region-body定义主体区
region-before定义顶部区 (页眉)
region-after定义底部区 (页脚)
region-start定义左侧区 (左侧栏)
region-end定义右侧区 (右侧栏)
注释:region-before、region-after、region-start 以及 region-end 是主体区的一部分。为了避免主体区的文本覆盖到这些区域,主题区的边距至少要等于其他区的尺寸。
图示:
5、XSL-FO 实例
这是从某个 XSL-FO 文档中提取的一个片断:
<fo:simple-page-master master-name="A4" page-width="297mm" page-height="210mm"
margin-top="1cm" margin-bottom="1cm" margin-left="1cm" margin-right="1cm">
<fo:region-body margin="3cm"/>
<fo:region-before extent="2cm"/>
<fo:region-after extent="2cm"/>
<fo:region-start extent="2cm"/>
<fo:region-end extent="2cm"/>
</fo:simple-page-master>
上面的代码定义了名称为 "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 Blocks(块)
XSL-FO 的输出位于块区域中。
1、XSL-FO 页面、流以及块
内容“块”会“流”入“页面”中,然后输出到媒介。XSL-FO 输出通常被嵌套在 <fo:block> 元素中,<fo:block> 嵌套于 <fo:flow> 元素中,<fo:flow> 嵌套于 <fo:page-sequence> 元素中:
<fo:page-sequence>
<fo:flow flow-name="xsl-region-body">
<fo:block>
<!-- Output goes here -->
</fo:block>
</fo:flow>
</fo:page-sequence>
2、块区域的属性
块是位于矩形框中的输出序列:
<fo:block border-width="1mm">
这个输出块周围有一条一毫米的边框。
</fo:block>
由于块区域是矩形框,所以可共享许多公共的区域属性:
space before 和 space after、Margin、border、padding、space before
space before 和 space after 是块与块之间起分割作用的空白。
margin 是块外侧的空白区域。
border 的区域外部边缘的矩形。其四个边均可有不同的宽度。它也可被填充为不同的颜色和背景图像。
padding 是位于内容区域与边框之间的区域。
内容区域可包含实际的内容,比如文本、图片、图形等等。
3、块边距
margin、margin-top、margin-bottom、margin-left、margin-right
4、块边框
边框样式属性:
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)
5、块填充
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)
6、块背景
background-color、background-image、background-repeat、background-attachment (scroll 或者 fixed)
7、块样式属性:
块是可被单独样式化的输出序列:
<fo:block font-size="12pt" font-family="sans-serif">
This block of output will be written in a 12pt sans-serif font.
</fo:block>
字体属性:
font-family、font-weight、font-style、font-size、font-variant
文本属性:
text-align、text-align-last、text-indent、start-indent、end-indent
wrap-option (定义自动换行,word wrap)
break-before (定义分页符,page breaks)
break-after (定义分页符,page breaks)
reference-orientation (定义 90" 内的文字旋转)
实例
<fo:block font-size="14pt" font-family="verdana" color="red"
space-before="5mm" space-after="5mm">
W3School
</fo:block>
<fo:block text-indent="5mm" font-family="verdana" font-size="12pt"
space-before="5mm" space-after="5mm">
At W3School you will find all the Web-building tutorials you need, from basic html and XHTML to advanced XML, XSL, Multimedia and WAP.
</fo:block>
八、XSL-FO 列表
XSL-FO 使用列表块(List Block)来定义列表。
1、有四种 XSL-FO 对象可用来创建列表:
fo:list-block包含整个列表。
fo:list-item包含列表中的每个项目。
fo:list-item-label包含用于 list-item 的标记 - 典型地,包含一个数字或者字符的
<fo:block> 。
fo:list-item-body包含 list-item 的主体或内容 - 典型地,一个或多个 <fo:block> 对象。
2、一个 XSL-FO 列表实例:
<fo:list-block>
<fo:list-item>
<fo:list-item-label>
<fo:block>*</fo:block>
</fo:list-item-label>
<fo:list-item-body>
<fo:block>Volvo</fo:block>
</fo:list-item-body>
</fo:list-item>
<fo:list-item>
<fo:list-item-label>
<fo:block>*</fo:block>
</fo:list-item-label>
<fo:list-item-body>
<fo:block>Saab</fo:block>
</fo:list-item-body>
</fo:list-item>
</fo:list-block>
九、XSL-FO 表格
XSL-FO 使用 <fo:table-and-caption> 元素来定义表格。
1、XSL-FO 表格
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> 元素。
2、<fo:table> 元素包含:
可选的 <fo:table-column> 元素
可选的 <fo:table-header> 元素
<fo:table-body> 元素
可选的 <fo:table-footer> 元素
这些元素中的每一个都可能拥有一个或多个 <fo:table-row> 元素,而 <fo:table-row> 同时会带有一个或多个 <fo:table-cell> 元素:
<fo:table-and-caption>
<fo:table>
<fo:table-column column-width="25mm"/>
<fo:table-column column-width="25mm"/>
<fo:table-header>
<fo:table-row>
<fo:table-cell>
<fo:block font-weight="bold">Car</fo:block>
</fo:table-cell>
<fo:table-cell>
<fo:block font-weight="bold">Price</fo:block>
</fo:table-cell>
</fo:table-row>
</fo:table-header>
<fo:table-body>
<fo:table-row>
<fo:table-cell>
<fo:block>Volvo</fo:block>
</fo:table-cell>
<fo:table-cell>
<fo:block>$50000</fo:block>
</fo:table-cell>
</fo:table-row>
<fo:table-row>
<fo:table-cell>
<fo:block>SAAB</fo:block>
</fo:table-cell>
<fo:table-cell>
<fo:block>$48000</fo:block>
</fo:table-cell>
</fo:table-row>
</fo:table-body>
</fo:table>
</fo:table-and-caption>
十、XSL-FO 与 XSLT
XSL-FO 与 XSLT 可彼此互助。
来自 XSLT 的帮助
从文档移除 XSL-FO 信息:
<header>
W3School
</header>
<paragraph>
At W3School you will find all the Web-building tutorials you need, from basic HTML and XHTML to advanced XML, XSL, Multimedia
and WAP.
</paragraph>
添加 XSLT 转换:
<xsl:template match="header">
<fo:block
font-size="14pt" font-family="verdana" color="red"
space-before="5mm" space-after="5mm">
<xsl:apply-templates/>
</fo:block>
</xsl:template>
<xsl:template match="paragraph">
<fo:block
text-indent="5mm"
font-family="verdana" font-size="12pt"
space-before="5mm" space-after="5mm">
<xsl:apply-templates/>
</fo:block>
</xsl:template>
产生的结果是相同的:
以上是关于XSL-FO的主要内容,如果未能解决你的问题,请参考以下文章