<external href="../index.html" label="Home"/>
<separator/>
<document id="index" label="Readme" source="fop/readme.xml"/>
+ <document id="todo" label="TODO" source="fop/todo.xml" />
<document id="download" label="Download" source="fop/download.xml" />
<document id="running" label="Running FOP" source="fop/running.xml" />
<document id="implemented" label="Features" source="fop/implemented.xml" />
<source>Driver driver = new Driver();<br/>
driver.setRenderer("org.apache.fop.render.pdf.PDFRenderer", version);<br/>
-driver.addElementMapping("org.apache.fop.fo.StandardElementMapping");<br/>
-driver.addElementMapping("org.apache.fop.svg.SVGElementMapping");<br/>
-driver.addPropertyList("org.apache.fop.fo.StandardPropertyListMapping");<br/>
-driver.addPropertyList("org.apache.fop.svg.SVGPropertyListMapping");<br/>
driver.setOutputStream(new FileOutputStream(args[1]));<br/>
-driver.buildFOTree(parser, fileInputSource(args[0]));<br/>
-driver.format();<br/>
-driver.render();</source>
+driver.render(parser, inputHandler.getInputSource());</source>
</s2>
<s2 title="Formatting Object Tree">
can start one of these scripts, you have to setup your classpath and the environment variable JAVA_HOME (see below).</p>
<p> The compilation uses Ant,
a replacement of make (you can find more information about Ant at
- <jump href="http://jakarta.apache.org/ant/">jakarte.apache.org</jump>).
+ <jump href="http://jakarta.apache.org/ant/">jakarta.apache.org</jump>).
build.xml is the replacement of makefile. Look there for detailed information on the build
process and different targets. </p>
<p>A help screen is shown by calling "build usage".</p>
<?xml version="1.0" standalone="no"?>
-
<!-- Embedding FOP -->
<s1 title="Embedding FOP ">
<s2 title="Overview">
<p>Instantiate org.apache.fop.apps.Driver. Once this class is
instantiated, methods are called to set the
- Renderer to use, the (possibly multiple) ElementMapping(s) to
- use and the OutputStream to use to output the results of the
+ Renderer to use
+ and the OutputStream to use to output the results of the
rendering (where applicable). In the case of the Renderer and
ElementMapping(s), the Driver may be supplied either with the
object itself, or the name of the class, in which case Driver will
]]></source>
- <p>Once the Driver is set up, the buildFOTree method
+ <p>Once the Driver is set up, the render method
is called. Depending on whether DOM or SAX is being used, the
- invocation of the method is either buildFOTree(Document) or
- buildFOTree(Parser, InputSource) respectively.
+ invocation of the method is either render(Document) or
+ render(Parser, InputSource) respectively.
</p>
<p>A third possibility may be used to build the FO Tree, namely
calling getContentHandler() and firing the SAX events yourself.
<source><![CDATA[
Driver driver = new Driver();
driver.setRenderer(Driver.RENDER_PDF);
- driver.buildFOTree(parser, fileInputSource(args[0]));
- driver.format();
+ driver.setInputSource(new FileInputSource(args[0]));
driver.setOutputStream(new FileOutputStream(args[1]));
- driver.render();
+ driver.run();
]]></source>
<p>You can also specify an xml and xsl file for the input.
</p>
driver.setRenderer(Driver.RENDER_PDF);
InputHandler inputHandler = new XSLTInputHandler(xmlFile, xslFile);
XMLReader parser = inputHandler.getParser();
- driver.buildFOTree(parser, inputHandler);
- driver.format();
driver.setOutputStream(new FileOutputStream(outFile));
- driver.render();
+ driver.render(parser, inputHandler.getInputSource());
]]></source>
<p>Have a look at the classes CommandLineStarter or FopServlet for complete examples.</p>
</s2>
<?xml version="1.0" standalone="no"?>
-<s1 title="FOP extensions to xsl:fo">
+<s1 title="Extensions to FOP">
<p>Sometimes it is desirable to have extensions to xsl:fo in order to support some feature of the
output format which isn't covered by the xsl:fo specification.
- To use the Fop extensions, you need to add a namespace entry for
+ </p>
+ <s2 title="Default Extensions">
+<p>
+These extension are available by default. They are automatically loaded
+and you only need to provide the correct namespace for your embedded
+xml markup.
+</p>
+ <s3 title="SVG">
+Please see the <jump href="svg.html">SVG page</jump> for more details.
+ </s3>
+ <s3 title="Bookmarks">
+ <p>To use this standard Fop extension, you need to add a namespace entry for
http://xml.apache.org/fop/extensions on the root element. </p>
- <s2 title="Bookmarks">
- <p>You can provide outlines inside the root object (but outside any page-sequences or
+
+ <p>You can provide outlines inside the root object (but outside
+ any page-sequences or
other formatting objects). Here's an example of an outline entry:</p>
<source>
<
projects / xmlgraphics-fop.git / commitdiff