Dokumen XSL-FO

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

Dokumen XSL-FO

XSL-FO 文档是带有输出信息的 XML 文件。它们包含着有关输出布局以及输出内容的信息。

XSL-FO 文档存储在以 .fo 或 .fob 为后缀的文件中。以 .xml 为后缀存储的 XSL-FO 文档也很常见,这样做的话可以使 XSL-FO 文档更易被 XML 编辑器存取。

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>

结构解释

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>

Elemen <fo:layout-master-set> mengandungi satu atau lebih template halaman:

<fo:layout-master-set
  <!-- Di tempat ini adalah semua template halaman -->
</fo:layout-master-set>

Elemen <fo:simple-page-master> mengandungi satu template halaman tunggal. Setiap template mesti mempunyai nama unik (master-name):

<fo:simple-page-master master-name="A4">
  <!-- Di tempat ini adalah template halaman yang satu ini -->
</fo:simple-page-master>

Satu atau lebih elemen <fo:page-sequence> boleh menggambarkan kandungan halaman. Atribut master-reference digunakan untuk merujuk kepada template simple-page-master dengan nama yang sama:

<fo:page-sequence master-reference="A4">
  <!-- Di tempat ini adalah kandungan halaman -->
</fo:page-sequence>

Komen:Komen: master-reference nilai "A4" sebenarnya tidak menggambarkan format halaman yang ditakrifkan. Ini hanya sebuah nama. Anda boleh menggunakan apa saja nama, seperti "MyPage", "MyTemplate", dan sebagainya.