Tools

• Ant (Windows download) (install instructions & rest of manual if you need it) (command window here (see right sidebar)) (supplementary instructions)
  
• DocBook (stylesheets) (supplementary instructions)
  
• Firefox (MathML fonts)
  
• Ghostscript (AFPL or GPL is fine) (supplementary instructions)
• Java (supplementary instructions)
  
• Mathematica
• SVGMath (download) (Python (download)) (sample Windows svgmath.xml config file) (supplementary instructions)
  
• XEP (download trial version (puts XEP ad on page bottom but isn't time limited)) (sample Windows xep.xml config file) (supplementary instructions)
• xsltproc (Windows download) (install instructions) (supplementary instructions)

Supplementary Instructions for Some Tools

Ant

Unzip it to wherever you want it installed, because it doesn't have an installer for Windows. On Windows, you will likely want to add the folder containing ant.exe to the PATH environment variable (the system path, not the user path). On my system, the extra path is C:\Program Files\ant\apache-ant-1.6.5\bin. Because ant is typically run from the command line in a project's documentation directory, Windows users may want the Microsoft "power toy" called "open command window here" to avoid needing to change directories.

DocBook

Many XML editors come with default support for DocBook, because it is such a useful format. You may need to make sure your editor is using the schema for DocBook version 5 instead of version 4. You do not need to download the schema if your editor comes with a copy of the DocBook 5 schema.

If you need any help with DocBook editing or transformation to other formats, you can try searching the official documentation or the user archives.

Ghostscript

Windows users should note the location of gswin32c.exe (on my system this is C:\Program Files\gs\gs8.54\bin\gswin32c.exe), while Linux users should note the location of gs (on my system this is /usr/bin/gs). The XML`DocBook` package that is part of MMADE will ask for you to set the location of this executable if automatic location fails.

Java

Windows users may want to set the JAVA_HOME environment variable to that of Mathematica's Java install. On my Windows system, this is C:\Program Files\Wolfram Research\Mathematica\5.2\SystemFiles\Java\Windows. This helps get rid of Ant's complaint about not being able to find tools.jar.

SVGMath

Note the location of math2svg.py and adjustbase.xsl inside the fo subdirectory. Windows users, note the location of python.exe from the Python install. These locations will be needed when setting up MMADE. Note that my sample svgmath.xml file makes use of the Firefox MathML fonts listed above and will not run without them

XEP

Download XEP, unzip it, and follow the installation directions in the readme. Note the location of the XEP directory, XEPTask.jar and xep.jar in its lib subdirectory. You will need to know these locations when setting up MMADE.

If you don't like the small advertisement in XEP, you could try Apache FOP. It's free (and advertisement free), but it doesn't format PDFs quite as well as XEP, yet.

xsltproc

xsltproc needs an environment variable called XML_CATALOG_FILES that should point to the location of catalog.xml from the DocBook stylesheets (unless a more complicated setup is desired). On my Windows system, the value of the variable is file:///C%3A/Program%20Files/docbook-xsl/docbook-xsl-1.71.0/catalog.xml, where the file path has been written like an internet address. DocBook XSL: The Complete Guide has more information about XML catalogs and xsltproc. When setting up MMADE, you will need the location of xsltproc. On my Windows system, it is at C:\Program Files\libxslt\libxslt-1.1.17.win32\bin\xsltproc.exe.