Part I, Chapter 1, Section 1. Contents of the installation directory

1. Contents of the installation directory

bin/ditac, ditac.bat

Scripts used to run XMLmind DITA Converter (ditac for short). Use ditac on any Unix system. Use ditac.bat on Windows.

JAXP limits

This directory also contains file jaxp.properties which is referenced by the ditac scripts. As of Java™ version 24, the standard Java XML processing limits (JAXP limits

) are very restrictive and no longer allow to load documents conforming to the DITA DTD. Therefore this file is needed to increase Java XML processing limits.

doc/index.html

Contains the documentation of ditac. XMLmind DITA Converter Manual is available in all the output formats supported by ditac. You'll also find there the reference manual of the API of ditac (generated by javadoc).

docsrc/manual/

Contains the DITA source of XMLmind DITA Converter Manual.

LEGAL/, LEGAL.txt

Contains legal information about ditac and about third-party components used in ditac.

lib/

All the (non-system) Java™ class libraries needed to run ditac:

ditac.jar: contains the code of XMLmind DITA Converter.
xmlresolver.jar: is XMLResolver , an enhanced XML resolver with XML Catalog support.
relaxng.jar: is Jing version 20030619, James Clark's RELAX NG validator, slightly modified for use in XMLmind XML Editor and XMLmind DITA Converter. The details of the modifications are found in LEGAL/relaxng.README.
saxon12.jar: is Michael Kay's XSLT 3.0 engine. See https://www.saxonica.com/ .
whcmin.jar
snowball.jar: contains the code needed to run XMLmind Web Help Compiler .
xslthl.jar: contains the code of the XSLT syntax highlighting open source software component.
flexmark.jar: flexmark-java is the software component used by ditac to parse Markdown and convert it to HTML.

plugin/

This directory is initially empty. It's the default location where user plug-ins are to be installed.

plus/

This directory is present only in the case of the ditac-N_N_N-plus-fop.zip distribution has been installed.

fop-N.M/: Contains most recent Apache FOP , including hyphenation and JEuclid -based MathML support. This XSL-FO processor is automatically registered with ditac and thus, ready to be used to generate PDF or PostScript.
converters/: Contains a number of image converters based on Batik , JEuclid , JLaTeXMath , etc. These image converters are automatically registered with ditac and thus, ready to be used to convert SVG to PNG, MathML to SVG or PNG, TeX/LaTeX math to SVG or PNG, etc.

schema/

Contains the DTD, RELAX NG and W3C XML schemas of DITA 1.3 1.2, 1.1, 1.0.1. File schema/catalog.xml contains an XML catalog which points to these local copies.

src/

Contains the Java source code of ditac. src/build.xml is an ant

build file which allows to rebuild lib/ditac.jar.

whc_template/

Contains the template directory of XMLmind Web Help Compiler

xsl/

Contains the XSLT 2.0

stylesheets used to convert DITA documents to a variety of formats.

fo/fo.xsl: Used to generate an intermediate XSL-FO file. After that, the XSL-FO file is converted to PDF , PostScript , RTF , WordprocessingML , Office Open XML (.docx) or OpenOffice/LibreOffice (.odt) by the means of an XSL-FO processor.
xhtml/xhtml.xsl: Used to generate XHTML 1.0 pages.
xhtml/xhtml1_1.xsl: Used to generate XHTML 1.1 pages.
xhtml/html.xsl: Used to generate HTML 4.01 pages.
xhtml/xhtml5.xsl: Used to generate XHTML 5 pages.
webhelp/webhelp.xsl: Used to generate Web Help containing XHTML 1 pages, which are then compiled using XMLmind Web Help Compiler .
webhelp/webhelp5.xsl: Used to generate Web Help containing XHTML 5 pages, which are then compiled using XMLmind Web Help Compiler .
htmlhelp/htmlhelp.xsl: Used to generate HTML Help files, which are then compiled using hhc.exe.
eclipsehelp/eclipsehelp.xsl: Used to generate Eclipse Help files.
epub/epub.xsl: Used to generate EPUB 2 files, which are then archived in a .epub file (Zip archive having a .epub extension).
epub/epub3.xsl: Used to generate EPUB 3 files, which are then archived in a .epub file (Zip archive having a .epub extension).
hdita/hdita.xsl: Translates XHTML5 to DITA according to the HDITA specification.