You may download JEuclid from the sourceforge project site for JEuclid as a binary package or from source. Please note: There are several binary packages:
If you just want the MathViewer you may also start it from our MathViewer WebStart page.
For best results, we recommend installing either one of the following font sets:
Also, please ensure you have installed Asian font support. Some characters in MathML are part of the CJK character set.
To run the MathViewer application, you may use the mathviewer or mathviewer.bat script from the bin/ directory of the distribution.
If you use the one of the OS dependent packages, the MathViewer is included as an application.
You may use the included mml2xxx (unix) or mml2xx.bat (windows) script from the bin/ directory in the distribution.
Example:
mml2xxx a.mml a.png -backgroundColor white
To get a list of possible options, just mml2xxx without any parameters. Please see the JEuclid FAQ or run mml2xx without parameters for a list of supported output formats.
You will need to define the converter task:
<taskdef name="mmlconverter" classname="net.sourceforge.jeuclid.ant.MathMLConverter">
with the needed JAR files in the classpath.
The task can work with single input file or with a fileset. If you use a single input file, you must set an output file as well.
<mmlconverter in="input.odf" out="output.svg"/>
For using simple filesets, there are 2 methods: as attribute of task or nested element. Nested elements are universal, because they can repeat more than one element include/exclude. Examples are below:
<mmlconverter basedir="input_dir" destdir="output_dir" includes="*.odf" excludes="test*.odf"/>
<mmlconverter basedir="input_dir" destdir="output_dir"> <include name="*.odf"/> <include name="*.mml"/> <exclude name="test*.odf"/> <exclude name="test*.mml"/> </mmlconverter>
If you do not set basedir, the task will use the base directory of the called build file.
The next attribute is type, which specifies which converter class to use. Default type is image/png.
<mmlconverter in="input.odf" out="output.svg" type="image/svg+xml"/>
Sets basic font size and others font size as minimal for anti alias.
<mml converter in="input.odf" out="output.svg" type="image/svg+xml" fontsize="22.0" antialiasminsize="10.0" scriptminsize="8.0" scriptsizemult="0.71" />
Next parameters are lists of font families e.g. for Sun-Serif, Monospaced font family. List is seperated by comma.
<mml converter in="input.odf" out="output.svg" type="image/svg+xml" fontsmonospaced="Courier,Courier Mono,Courier New,Lucida Sans" fontssunserif="Helvetica,Arial,Arial Unicode MS,Lucida Sans" />
As others parameters can sets background/foreground color, enable anti alias or debugging and other. All supported parameters are same as in command line interface (see Link).
Documentation is available on the JEuclid FOP plug-in site.
You may use the included foprep application to convert MathML embedded in XSL-FO and XHTML files to SVG. This will allow you to render your documents with other xsl-fo renderers or on browsers with SVG support (newer versions of Opera, Firefox, Safari, ... ).
This information has moved to the Programming with JEuclid page.
JEuclid contains additional functionality available on Java ≥ 1.6. To use this functionality you need to add jeuclid-core16-xxx.jar to your project in addition to jeuclid-core-xxx.jar.
JEuclid is uploaded to ibiblio, and is therefore available in your project by adding
<depencency> <groupId>net.sourceforge.jeuclid</groupId> <artifactId>jeuclid-core</artifactId> </depencenty>
to your dependencies section.
If you wish to use the latest developer version, you need to declare the following repository
<repository> <id>jeuclid-snapshots</id> <url>http://jeuclid.sourceforge.net/m2-snap/</url> <releases> <enabled>false</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository>
To use the Cocoon component you have to download JEuclid 2. Please see the included INSTALL instructions. The Cocoon component is currently not under active development. Volunteers are welcome!