Fop What is FOP? FOP is the world's first print formatter driven by XSL formatting objects. It is a Java application that reads a formatting object tree and then turns it into a PDF document. The formatting object tree, can be in the form of an XML document (output by an XSLT engine like XT or Xalan) or can be passed in memory as a DOM Document or (in the case of XT) SAX events. The latest version of Fop is 0.18 and it supports the xsl:fo candidate release. You can download Fop including a precompiled version, the source code and many example files to get you started. Pointers to introductions into xsl:fo can be found in the section specifications . Please be aware, that Fop is at the moment not a full implementation of the basic conformance level of the xsl:fo standard. You can find a list of supported flow objects and properties in the section Features and in section Limitations in what way this support is limited. FOP is part of Apache's XML project. The homepage of FOP is http://xml.apache.org/fop . A list of known bugs, the committers to this project and the tasks they are working on can be found in the file Status in the root of your Fop distribution. A history of the latest changes to the project can be found in CHANGES. FOP Objectives The goals of the Apache XML FOP Project are to deliver an XSL FO->PDF formatter that is compliant to at least the Basic conformance level described in the W3C Candidate Recommendation 21 November 2000, and that complies with the 11 March 1999 Portable Document Format Specification (Version 1.3) from Adobe Systems. Conformance to the XML 1.0 Recommendation, XSLT 1.0 Recommendation and the XML Namespaces Recommendation is understood. Other relevant documents, such as the XPath and XLink Working Drafts, are referenced as necessary. The FOP Project will attempt to use the latest version of evolving specifications. Secondary goals of the FOP Project (also, "FOP") are desirable requirements that also have a high priority. One secondary goal of the FOP Project is to deliver a follow-on version of the formatter that is compliant to the Extended conformance level described in the XSL FO. Any formatting objects that cannot be translated into PDF will be explicitly identified as such. Another secondary goal is to improve the conversion of SVG into PDF. This includes the use of FOP to work as a transcoder for Batik to convert an SVG document into a PDF document and the fully support embedding SVG inside fo documents in an fo:instream-foreign-object. A final secondary goal is the continued refinement of the FOP design and implementation. In particular, maintaining the separation between formatting and rendering, continuing to support the AWT Viewer renderer (backend), and providing new renderers, are all desirable objectives. 1999-2001 The Apache Software Foundation 1999-2001 The Apache Software Foundation TODO List for FOP FOP TODO Core Features - these are the areas that are important to getting fop to be useable for general use. Processing improvements - these are mainly things that can be improved in the way fop works, eg. resources usage, pdf output etc. Enhancements - these are added functionality that might be useful, no comment is made about the suitability of these suggestions. Core Features Layout This is the crucial part to getting FOP to make it to the next step. Webstart Demo a demo using Java Webstart that runs the awt viewer and supports linking from an index Website Need to improve the website to better demonstrate what fop is and can do. Examples, screenshots, pdf documents. Property Support Currently all properties are in the xml file. We need to handle all default values properly (including ones that change depending on the element) and all possible values. Property Resolution This is support for the functions in property values that evaluate some expression. Better support for resolution including support for "inherit" and values with lists. Validity Checking Check the validity of children for a particular element to ensure there are no invalid children. Should help process the layout better. Processing Improvements 1999-2001 The Apache Software Foundation Logging Support for proper logging with logKit. Image Handling Needs to be a bit more solid and allow for direct insertion of images (jpeg) into the pdf. Configuration Support for avalon. Better multithread handling. More PDF Outputs Support for streaming and linearized pdf to help with different deployement of pdf documents. i18n in awt viewer Use proper i18n handling for awt viewer. better abstraction of rendering classes put all common rendering processes into an abstract class that has no dependancies on any specific renderers. Enhancements linking support in svg support the a link rendering for the svg output. input from url be able to specify a url as the input fo (or xml, xsl) documents. improve text handling in svg support (better) the direct rendering of text into pdf graphics and other similair outputs svg renderer (output to svg doc for slide presentation) Create an SVGRenderer that will render all pages onto a single svg document suitable for slide show presentations (with batik) suggested by Vincent Hardy. stream encoding support for different encoding on different types of streams in pdf document. 1999-2001 The Apache Software Foundation svg features currently patterns and gradients are not generated properly 1999-2001 The Apache Software Foundation Downloading FOP You can download the latest release version from the distribution directory . The file contains also the documentation (including some example fo files) and the source. If you want to work with the latest and nicest code, you can use the cvs version. See the section on AnonCVS in the xml.apache.org documentation for details. Sometimes people have difficulties to access the cvs server; in this case you can download a snapshot from the cvs files here . In both cases you have to build Fop yourself - see Compiling Fop for details. To run FOP from the command line, see Running FOP . If you are interested in embedding FOP in a Java application of your own, see Embedding FOP . 1999-2001 The Apache Software Foundation Running FOP Prerequisites Following software must be installed: a) Java 1.1.x or later (If you want to use the previewer (option -awt), you need Swing or Java 2) b) All libraries you need are part of the Fop distribution and can be found in the xml-fop/lib directory. Look at the batch/shell script fop.bat/fop.sh to see, how Fop can be invoked easily. These libraries are included: l An XML parser which supports SAX and DOM like Xerces-J . (Xerces is the default xml parser) l An XSLT processor l The SVG library batik.jar is the library from the batik project at xml.apache.org. l The imaging library Jimi from Sun Starting FOP as an standalone application Fop [options] [-fo|-xml] infile [-xsl file] [-awt|-pdf|-mif|-pcl|-txt|-print] <outfile> [OPTIONS] -d debug mode -x dump configuration settings -q quiet mode -c cfg.xml use additional configuration file cfg.xml -l lang the language to use for user information [INPUT] infile xsl:fo input file (the same as the next) -fo infile xsl:fo input file -xml infile xml input file, must be used together with -xsl -xsl stylesheet xslt stylesheet [OUTPUT] outfile input will be rendered as pdf file into outfile -pdf outfile input will be rendered as pdf file (outfile req'd) -awt input will be displayed on screen -mif outfile input will be rendered as mif file (outfile req'd) -pcl outfile input will be rendered as pcl file (outfile req'd) -txt outfile input will be rendered as text file (outfile req'd) -print input file will be rendered and sent to the printer see options with "-print help" [Examples] Fop foo.fo foo.pdf Fop -fo foo.fo -pdf foo.pdf (does the same as the previous line) Fop -xsl foo.xsl -xml foo.xml -pdf foo.pdf Fop foo.fo -mif foo.mif Fop foo.fo -print or Fop -print foo.fo Fop foo.fo -awt Problems 1999-2001 The Apache Software Foundation If you have problems running FOP, please have a look at the FOP FAQ . If you don't find a solution there, you can ask for help on the list fop-dev@xml.apache.org. Maybe it is a bug and maybe somebody is already working on it. 1999-2001 The Apache Software Foundation Features What's Implemented? The following formatting objects and properties of the xsl-fo candidate recommendation are implemented.Please have also a look at the section on limitations 1) Formatting Objects This section follows the table "B Formatting Object Summary" in the xsl:fo specification. At the end of each sub-section you find listed what is not implemented. B.1 Declaration and Pagination and Layout Formatting Objects l root l page-sequence l page-sequence-master l single-page-master-reference l repeatable-page-master-reference l repeatable-page-master-alternatives l conditional-page-master-reference l layout-master-set l simple-page-master l region-body l region-before l region-after l region-start l region-end l flow l static-content Not implemented: declarations, color-profile, title B.2 Block Formatting Objects l block Not implemented: block-container B.3 Inline Formatting Objects l character l external-graphic l inline l instream-foreign-object 1999-2001 The Apache Software Foundation l leader l page-number l page-number-citation, see limitations Not implemented: bidi-override, initial-property-set, inline-container B.4 Table Formatting Objects l table l table-body l table-cell l table-column l table-footer l table-header l table-row Not implemented: table-and-caption, table-caption B.5 List Formatting Objects l list-block l list-item l list-item-body l list-item-label B.6 Link and Multi Formatting Objects l basic-link (internal and external) Not implemented: multi-switch, multi-case, multi-toggle, multi-properties, multi-property-set B.7 Out-of-line Formatting Objects l footnote l footnote-body Not implemented: float B.8 Other Formatting Objects l wrapper Not implemented: marker, retrieve-marker border and padding shorthand properties 2) Properties Property values can be computed. Compound properties are also understood by Fop. 1999-2001 The Apache Software Foundation l background-color l blank-or-not-blank l border-after-color l border-after-style l border-after-width l border-before-color l border-before-style l border-before-width l border-bottom l border-bottom-color l border-bottom-style l border-bottom-width l border-color (only one value allowed) l border-end-color l border-end-style l border-end-width l border-left l border-left-color l border-left-style l border-left-width l border-right l border-right-color l border-right-style l border-right-width l border-start-color l border-start-style l border-start-width l border-style l border-top l border-top-color l border-top-style l border-top-width l border-width l bottom l break-after l break-before l character l color l column-count l column-gap l column-width l country l end-indent 1999-2001 The Apache Software Foundation l extent l external-destination l flow-name l font-family l font-size l font-style l font-weight l height l hyphenate l hyphenation-character l hyphenation-push-character-count l hyphenation-remain-character-count l id l initial-page-number l internal-destination l keep-with-next (broken) l language l leader-alignment (not value "page") l