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.

Set a Font for PDF Output Generated with Apache FOPWhen a DITA map is transformed to PDF using the Apache FOP processor and it contains some Unicode charactersthat cannot be rendered by the default PDF fonts then a font that is capable to render these characters must be configuredand embedded in the PDF result.The settings that must be modified for configuring a font for the Apache FOP processor are detailed in this section.<strong>Author</strong> for DITA | 126DITA-OT CustomizationThis section explains how to customize specific parameters of a DITA transformation scenario like setting a customDITA Open Toolkit, a custom build file or a separate installation of the Ant tool.Support for Transformation CustomizationsYou can change all DITA transformation parameters to customize your needs. In addition, you can specify a custombuild file, parameters to the JVM and many more for the transformation.Using Your Custom Build FileYou can specify a custom build file to be used in DITA-OT transformations by editing the transformation scenario thatyou are using. In the Advanced tab you should change the Custom build file path to point to the custom build file.Customizing the <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> Ant ToolThe Ant 1.7 tool which comes with <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> is located in the[<strong>Oxygen</strong>-install-folder]/tools/ant directory. Any additional libraries for Ant must be copied to the<strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> Ant lib directory.If you are using Java 1.6 to run <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> the Ant tool should need no additional libraries to processJavaScript in build files.Upgrading to a New Version of DITA OTThe DITA OT framework bundled in <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> is located in the[<strong>Oxygen</strong>-install-folder]/frameworks/dita/DITA-OT folder.Important: There are a couple of modifications made to the DITA OT framework which will be overwrittenif you choose to copy the new DITA-OT version over the bundled one:• The DTD's in the framework have been enriched with documentation for each element. If you overwrite youwill lose the documentation which is usually shown when hovering an element or in the Model view.• Several build files from the IDIOM <strong>plugin</strong> have been modified to allow transformation using the <strong>Oxygen</strong><strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> Apache built-in FOP libraries and usage of the <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> classpathwhile transforming.• <strong>Oxygen</strong> <strong>XML</strong> <strong>Author</strong> <strong>plugin</strong> provides Java patches for some DITA OT problems. These patches are locatedin the [<strong>Oxygen</strong>-install-folder]/frameworks/dita/DITA-OT/lib/dost-patches.jarlibrary. If the patches library conflicts with the new DITA OT libraries it either has to be removed from diskor removed from the libraries list available in the DITA Map transformation scenario.Increasing the Memory for the Ant ProcessFor details about setting custom JVM arguments to the ANT process please see this section.Resolving Topic References Through an <strong>XML</strong> CatalogThere are situations where you want to resolve URIs with an <strong>XML</strong> catalog:• you customized your DITA map to refer topics using URI's instead of local paths

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

Saved successfully!

Ooh no, something went wrong!