Skip to content
DITA-OT PDF Customization Plugin for oXygen User Manual
XSLT HTML Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.travis
Customization
fonts
gh-pages
lib
pdf2-customization-wiki-topics/images
.project
.travis.yml
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
Markdown File.md
README.md
build.xml
fop.xconf
index.html
integrator.xml
params.json
pdf2ExtensionParameters.xml
pdf2_oXy_ug.xpr
plugin.xml
ug-pdf2.xpr

README.md

DITA-OT PDF Customization Plugin for oXygen User Manual

This project represents a DITA-OT PFD customization plugin used to generate the user manual for oXygen XML Editor in the PDF format. It was tested with the DITA-OT 2.4 processor.

This project uses Travis CI for continuous integration, so a PDF sample is generated whenever the customization is modified. You can view the results of this customization by opening one of the following recently generated PDFs:

All the customizations that are allowed by this plugin are described in detail in its GitHub Wiki pages.

Project organization:

  • Customization - This folder contains the XSLT customization stylesheets, XML catalog, and font configuration.
  • fonts - This folder contains the resources for the Roboto font that we use for our customization.
  • lib - This folder contains some additional libraries needed to load SVG images.
  • plugin.xml - The plugin descriptor file.
  • build.xml, integrator.xml - The plugin build files.
  • fop.xconf - The configuration file for the Apache FOP.

To use this PDF customization plugin, use one of the following methods:

  • From the Oxygen interface - Follow these steps:
  1. Download the ZIP archive associated with this project by using the Clone or download button.
  2. To install the plugin and transform it, follow the procedure found here: https://www.oxygenxml.com/doc/versions/19.0/ug-editor/topics/dita-ot-install-plugin.html
  • From a command line - Follow these steps:
  1. Download DITA-OT 2.4
  2. Download the ZIP archive associated with this project by using the Clone or download button.
  3. Install the plugin by running the command dita-ot-dir/bin/dita --install=plug-in-zip. See more details in the Installing plug-ins topic from the DITA-OT documentation.
  4. Invoke the PDF transformation using the oxy-ug-pdf transtype in a command, as in the following example:
    dita.bat -i file:/D:/workspace/userguide-private/DITA/UserManual.ditamap -f oxy-ug-pdf -output=D:/workspace/userguide-private/DITA/out-pdf --filter=D:/workspace/userguide-private/DITA/author.ditaval -Doxy-ug-distribution=author

Copyright and License

Copyright 2018 Syncro Soft SRL.

This project is licensed under the Apache License 2.0. For details, see the LICENSE file at the top of this repository.

You can’t perform that action at this time.