xsl-fo是w3c制定的xml页面布局语言，用于将xml精确渲染为pdf；其流程分三步：xml数据源→xslt转为.fo文件→fo处理器（如apache fop）生成pdf；需注意中文字体配置与utf-8编码。
XSL-FO（Extensible Stylesheet Language - Formatting Objects）是一种由W3C制定的、基于XML的页面布局描述语言，专门用于将结构化数据（如XML）精确渲染为可打印格式（尤其是PDF）。它不直接处理逻辑或交互，而是专注“怎么排版”——比如页边距、字体大小、分页控制、页眉页脚位置、表格对齐等。本质上，它是XML数据和最终PDF之间的一层“排版蓝图”。
XSL-FO的核心工作流程
从XML到PDF不是一步到位，而是三段式流水线：
- XML数据源：提供原始内容，例如订单信息、报告字段，结构清晰但无样式。
- XSLT转换器：用XSLT样式表把XML“翻译”成XSL-FO文档（.fo文件）。这个过程定义了“哪个字段放哪、用什么字体、是否加粗、是否分页”等规则。
-
FO处理器（渲染引擎）：读取.fo文件，按其中指令生成PDF。常用工具包括：
- Apache FOP（免费开源，Java实现，最常用）
- RenderX XEP（商业，排版质量高，适合复杂报表）
- Antenna House Formatter（商业，CSS+FO混合支持强）
快速上手：用FOP生成第一个PDF
以Apache FOP为例，只需三个动作：
魔法映像企业网站管理系统
下载
技术上面应用了三层结构，AJAX框架，URL重写等基础的开发。并用了动软的代码生成器及数据访问类，加进了一些自己用到的小功能，算是整理了一些自己的操作类。系统设计上面说不出用什么模式，大体设计是后台分两级分类，设置好一级之后，再设置二级并选择栏目类型，如内容，列表，上传文件，新窗口等。这样就可以生成无限多个二级分类，也就是网站栏目。对于扩展性来说，如果有新的需求可以直接加一个栏目类型并新加功能操作
-
准备环境：安装JDK（FOP依赖Java），下载解压FOP包，确认
fop -v能正常输出版本号。 -
写一个最小可行FO文件（如
hello.fo），包含<root></root>、页面模板（<layout-master-set></layout-master-set>）和正文流（<flow></flow>），里面用<block></block>写文字，指定font-family和font-size。 -
命令行渲染：
fop hello.fo hello.pdf，几秒后就生成PDF。
处理中文和乱码的关键点
中文PDF容易乱码，主因是字体缺失。必须同步做两件事：
-
FO文件中声明中文字体：例如
<block font-family="SimSun">你好</block>； -
FOP配置文件（fop.xconf）中注册该字体：指定TTF/OTF文件路径，并声明
name、style、weight三元组，确保与FO中写的完全一致。 - 所有XML、XSLT、FO文件保存为UTF-8编码，并在文件头明确声明
encoding="UTF-8"。
为什么选XSL-FO而不是其他方式？
它特别适合需要严格合规、批量生成、长期归档的场景：
- 分离关注点：XML管数据，XSLT管映射逻辑，FO管视觉呈现，修改样式不影响数据结构；
-
精准控制分页：支持
keep-together、break-before等属性，避免表格跨页断开、标题孤行等印刷问题； - 企业级稳定输出：不像HTML转PDF受浏览器渲染差异影响，FO是纯声明式，结果可复现、易审计。
