Apache™ FOP: Quick Start Guide

Everything you need to start using and appreciating Apache™ FOP quickly.

Apache™ FOP Essentials

The goal of this Quick Start Guide is to help novice users get Apache FOP up and running quickly. Typically, you'll need to:

1. Download FOP
2. Build FOP (you can skip this step if you download the binary distribution!)
3. Configure FOP
4. Run FOP

Here are some links to help you find out what FOP can do, as well as how and where to get help:

• Calling FOP from a Java Application
• Using FOP in Servlets
• Using FOP in an 'Ant' Build Script
• XSL-FO Compliance (what FOP supports and what it doesn't)
• FAQs
• Getting Help
• Mailing Lists

Once you've familiarized yourself with the basics, you can get more detailed information, in the detailed FOP product documentation.

Hello World with FOP

This section walks you through a "Hello World!" page with Apache FOP. We're assuming you download the binary distribution and that you have a Java Runtime Environment (version 1.8 or later) installed.

1. Unpack the downloaded binary distribution to a directory of your choice (for example, C:\FOP if you're on Windows). Let's call that directory .
2. Get a command prompt in the directory and write:

Windows: fop -fo examples/fo/basic/readme.fo -awt

Unix: ./fop -fo examples/fo/basic/readme.fo -awt

1. If all went well, this should open a window showing you a "readme"-style document. This is just to verify that FOP runs correctly.
2. Now, take your favorite XML editor and create a small XML file like the following. Replace "Frank" with your own first name to make it a bit more personal and save it as name.xml :

 Frank 

  version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fo="http://www.w3.org/1999/XSL/Format">  method="xml" indent="yes"/>  match="/">   master-name="A4-portrait" page-height="29.7cm" page-width="21.0cm" margin="2cm">     master-reference="A4-portrait">  flow-name="xsl-region-body"> Hello,  select="name"/>!      

Windows: fop -xml name.xml -xsl name2fo.xsl -pdf name.pdf

Unix: ./fop -xml name.xml -xsl name2fo.xsl -pdf name.pdf

1. You've produced your first PDF with Apache FOP! Please open name.pdf in your favorite PDF viewer.

Copyright © 2016 The Apache Software Foundation, Licensed under the Apache License, Version 2.0.
Apache, Apache XML Graphics, Apache FOP, Apache Batik, the Apache feather logo, and the Apache XML Graphics logos are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.