From XML to PDF: A Guide to Generating Documents with XSL-FO

XSL-FO is a powerful way to convert XML to PDF, suitable for printed documents that require precise layout. 1. Prepare structured XML data; 2. Use XSLT to convert XML into XSL-FO that describes the layout; 3. Render XSL-FO to PDF through a FO processor (such as Apache FOP). This method is suitable for scenarios such as requiring high-precision formats, compliance requirements, or generating invoices and reports from XML. Although the learning curve is steep and the flexibility is lower than that of CSS schemes, it still has advantages in structured document automation, ultimately achieving reliable and consistent output from XML to PDF.

Converting XML to PDF using XSL-FO is a powerful way to generate professional, print-ready documents from structured data. Unlike HTML-to-PDF methods, XSL-FO (Extensible Stylesheet Language Formatting Objects) gives you fine-grained control over layout, pagination, fonts, and styling—ideal for invoices, reports, and technical documentation.

Here's how it works in practice.

What Is XSL-FO and Why Use It?

XSL-FO is part of the XSL (Extensible Styleship Language) family, designed specifically for formatting XML data for output to PDF, print, or other paginated media. It sits between your raw XML and the final PDF:

XML → XSL-FO (via XSLT) → FO Processor → PDF

• XML holds your structured content (eg, product data, article text).
• XSLT transforms XML into XSL-FO, which describes layout (margins, blocks, tables, etc.).
• An FO processor (like Apache FOP, RenderX XEP, or Antenna House) renders the FO into PDF.

This pipeline is especially useful when:

• You need consistency, repeatable document formatting.
• Output must meet strict print or regulatory standards.
• Content comes from databases or CMS systems in XML format.

Step-by-Step: XML to PDF with Apache FOP

Apache FOP (Formatting Objects Processor) is a popular open-source tool for generating PDFs from XSL-FO. Here's a practical workflow.

1. Prepare Your XML

Start with clean, well-structured XML. For example:

 <report>
  <title>Monthly Sales Report</title>
  <date>2025-04-05</date>
  <section>
    <heading>Revenue Summary</heading>
    <paragraph>Total sales reached $120,000 this month.</paragraph>
  </section>
</report>

2. Write an XSLT to Generate XSL-FO

Transform the XML into formatting objects. Key elements include <fo:root> , <fo:layout-master-set> , and <fo:flow> .

 <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                xmlns:fo="http://www.w3.org/1999/XSL/Format">
  <xsl:output method="xml" indent="yes"/>

  <xsl:template match="/">
    <fo:root>
      <fo:layout-master-set>
        <fo:simple-page-master master-name="A4" page-height="29.7cm" page-width="21cm" margin="2cm">
          <fo:region-body/>
        </fo:simple-page-master>
      </fo:layout-master-set>

      <fo:page-sequence master-reference="A4">
        <fo:flow flow-name="xsl-region-body">
          <fo:block font-size="18pt" font-weight="bold" space-after="10pt">
            <xsl:value-of select="report/title"/>
          </fo:block>
          <fo:block font-size="10pt" space-after="5pt">
            <xsl:value-of select="report/date"/>
          </fo:block>
          <xsl:for-each select="report/section">
            <fo:block font-size="14pt" font-weight="bold" space-before="10pt" space-after="5pt">
              <xsl:value-of select="heading"/>
            </fo:block>
            <fo:block font-size="11pt" space-after="10pt">
              <xsl:value-of select="paragraph"/>
            </fo:block>
          </xsl:for-each>
        </fo:flow>
      </fo:page-sequence>
    </fo:root>
  </xsl:template>
</xsl:stylesheet>

3. Process with Apache FOP

Install Apache FOP (available at //m.sbmmt.com/link/c4d2cec38fa1da8b5d37758873c3678d ) and run the transformation:

 fop -xml input.xml -xsl stylesheet.xsl -pdf output.pdf

This command:

• Reads input.xml
• Applies stylesheet.xsl to generate FO in memory
• Uses FOP to render the result as output.pdf

You can also chain XSLT and FO processing in code (Java, Python, etc.) for automation.

Key XSL-FO Features for Professional Layouts

XSL-FO shines when you need precision control. Common use cases include:

• Page numbering : Use fo:page-number and running headers/footers.
• Tables : Define column widths, borders, and alignment with fo:table .
• Margins and breaks : Control page breaks with keep-together , break-before , etc.
• Fonts and embedding : Specify font families and embed TrueType fonts in PDFs.
• Lists and indentation : Use fo:list-block for ordered/unordered lists.

For example, adding a header:

 <fo:static-content flow-name="xsl-region-before">
  <fo:block text-align="center" font-size="10pt">
    Confidential Report
  </fo:block>
</fo:static-content>

Then reference it in your page master with margin-top and a region.

Limitations and Alternatives

While powerful, XSL-FO has some drawbacks:

• Steeper learning curve than CSS-based tools.
• Less flexible for web-style layouts.
• Limited support for modern PDF features (eg, forms, interaction).
• Apache FOP doesn't fully implement the entire XSL-FO spec (eg, some advanced table features).

Alternatives to consider:

• CSS Paged Media PrinceXML or AntennaHouse : More modern, web-friendly syntax.
• JasperReports or Docx4j : Better for mixed-format reporting.
• Pandoc : Simpler if you're converting from Markdown or HTML.

But if you're already working with XML and need predictable, high-quality print output, XSL-FO remains a solid choice.

Basically, XSL-FO isn't flashy, but it's reliable for structured document generation. With a clear pipeline—XML to XSLT to FO to PDF—you can automate complex reports, invoices, or manuals with pixel-perfect consistency. Not everything needs to be HTML-based; sometimes, old-school XML tooling does the job best.

The above is the detailed content of From XML to PDF: A Guide to Generating Documents with XSL-FO. For more information, please follow other related articles on the PHP Chinese website!