Download XML Editor 11.2 User Manual

Transcript
Author for DITA
You can configure another DITA-OT toolkit directory for use in <oXygen/> To do this you must edit the transformation
scenario that you are using and in the Parameters tab change the "dita.dir" parameter to your custom DITA-OT installation directory. Also in the Advanced tab (the Libraries button) you have to add:
• the dost.jar and resolver.jar libraries as file paths that point to the libraries from your custom DITA-OT
installation directory
• the installation directory of your custom DITA-OT and the lib subdirectory of that installation directory as directory
paths
Using your custom build file
You can specify a custom build file to be used in DITA-OT ANT transformations by editing the transformation scenario
that you are using and in the Advanced tab change the Custom build file path to point to the custom build file.
Customizing the <oXygen/> Ant tool
The ANT 1.7 tool which comes with <oXygen/> is located in the {INSTALLATION_DIRECTORY}/tools/ant
directory. Any additional libraries for ANT must be copied to the <oXygen/> ANT lib directory.
Example 6.3. Enabling JavaScript in ANT build files
If you are using Java 1.6 to run <oXygen/> the ANT tool should need to additional libraries to process JavaScript in
build files.
If you are using Java 1.5 you have to copy the bsf.jar [http://jakarta.apache.org/bsf/] and js.jar
[http://www.mozilla.org/rhino/download.html] libraries in the <oXygen/> ANT lib directory.
Upgrading to a new version of DITA OT
The DITA OT framework bundled in <oXygen/> is located in the {INSTALLATION_DIRECTORY}/frameworks/dita/DITA-OT directory.
Important
There are a couple of modifications made to the DITA OT framework which will be overwritten if 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 you
will lose the documentation which is usually shown when hovering an element or in the Model View
The IDIOM FO Plugin comes pre-installed in the bundled DITA-OT framework
Several build files from the IDIOM plugin have been modified to allow transformation using the <oXygen/>
Apache Built-in FOP libraries and usage of the <oXygen/> classpath while transforming.
Increasing the memory for the Ant process
You can give custom JVM Arguments to the ANT process. See here for more details.
Resolving topic references through an XML catalog
If you customized your map to refer topics using URI's instead of local paths or you have URI content references in
your DITA topic files and you want to resolve the URIs with an XML catalog when the DITA map is transformed then
you have to add the catalog to <oXygen/>. The DITA Maps Manager view will solve the displayed topic refs through
238