24.08.2015 Views

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

Oxygen XML Author plugin 13.2.0

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Transforming Documents | 303XSL-FO ProcessorsThis section explains how to apply XSL-FO processors when transforming <strong>XML</strong> documents to various output formatsin <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> .The Built-in XSL-FO ProcessorThe <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> installation package is distributed with the Apache FOP that is a Formatting Objectsprocessor for rendering your <strong>XML</strong> documents to PDF. FOP is a print and output independent formatter driven by XSLFormatting Objects. FOP is implemented as a Java application that reads a formatting object tree and renders the resultingpages to a specified output.To include PNG images in the final PDF document you need the JIMI or JAI libraries. For TIFF images you need theJAI library. For PDF images you need the fop-pdf-images library. These libraries are not bundled with <strong>Oxygen</strong><strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> but using them is very easy. You need to download them and create an external FO processorbased on the built-in FOP libraries and the extension library. The external FO processor created in Preferences willhave a command line like:java -cp "${oxygenInstallDir}/lib/xercesImpl.jar:${oxygenInstallDir}/lib/fop.jar:${oxygenInstallDir}/lib/avalon-framework-4.2.0.jar:${oxygenInstallDir}/lib/batik-all-1.7.jar:${oxygenInstallDir}/lib/commons-io-1.3.1.jar:${oxygenInstallDir}/lib/xmlgraphics-commons-1.3.1.jar:${oxygenInstallDir}/lib/commons-logging-1.0.4.jar:${oxygenInstallDir}/lib/saxon9ee.jar:${oxygenInstallDir}/lib/saxon9-dom.jar:${oxygenInstallDir}/lib/xalan.jar:${oxygenInstallDir}/lib/serializer.jar:${oxygenInstallDir}/lib/resolver.jar:${oxygenInstallDir}/lib/fop-pdf-images-1.3.jar:${oxygenInstallDir}/lib/PDFBox-0.7.3.jar"org.apache.fop.cli.Main -fo ${fo} -${method} ${out}You need to add to the classpath JimiProClasses.zip for JIMI and jai_core.jar, jai_codec.jar andmlibwrapper_jai.jar for JAI. For the JAI package you can include the directory containing the native libraries(mlib_jai.dll and mlib_jai_mmx.dll on Windows) in the PATH system variable.The Mac OS X version of the JAI library can be downloaded fromhttp://www.apple.com/downloads/macosx/apple/java3dandjavaadvancedimagingupdate.html. In order to use it, installthe downloaded package.Other FO processors can be configured in the Preferences dialog.Add a Font to the Built-in FOP - The Simple VersionIf the font that must be set to Apache FOP is one of the fonts that are installed in the operating system you should followthe next steps for creating and setting a FOP configuration file that looks for the font that it needs in the system fonts.It is a simplified version of the procedure for setting a custom font in Apache FOP.1. Register the font in FOP configuration. (not necessary in case of DITA PDF transformations, see next step)a) Create a FOP configuration file that specifies that FOP should look for fonts in the installed fonts of the operatingsystem.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!