JaTeX Source Code README
10-JAN-2015

Most of the source code for JaTeX is protected either by the General Public License (GPL) or by the Lesser General Public License (LGPL).  Copies of both licenses are provided along with the source code and the header of each source file indicates it's legal status (GPL, LGPL, public domain, or not written by me).

The JaTeX source code is 100% pure Java, but it does require that you have a native distribution of LaTeX installed on your computer.  This allows you to use whatever LaTeX distribution you want and leaves JaTeX as a lightweight, cross-platform tool.  The "TeX Live" distribution is a good general distribution of LaTeX that will work for most people on Windows, MacOS and Linux (https://www.tug.org/texlive/).  But other distributions are available as well.  The 1st time you run JaTeX, you may have to tell it where the "latex" and "diving" executables are located in your distribution by setting those in the application preferences.

A number of open source libraries are used by JaTeX.  They are all included in the source distribution.  Some of the JaTeX code is based on Laeqed by Jess Thrysoee (http://thrysoee.dk/laeqed/).  In particular, the code for working with meta-data stored in the PNG files is due to Jess.

JaTeX is set up to use the Apache ant build system (http://ant.apache.org/).  To build JaTeX from the DOS or Unix command line, cd into the JaTeX project directory, edit the "build.xml" file for your platform's needs (possibly to remove the MacOS X specific build if you are not interested in that), and execute the "ant" command.  This will compile the program, place a double-clickable JAR file in the "dist" directory, and create a MacOS X application bundle in the "dist" directory.

To execute the program, you would execute the following command under Windows (at the DOS prompt) or the Unix command line:

java -jar dist/JaTeX.jar

Or double-click on the JAR file found at that location.

On a Mac, you can double-click on the application icon found under "dist".

That's all I can think of right now.  If you have any other problems with the source code, don't be afraid to contact me.

Ad astra,

Joseph A. Huwaldt
jhuwaldt@mac.com
