Obtaining JEuclid

You may download JEuclid from the sourceforge project site for JEuclid as a binary package or from source. Please note: There are 3 Binary packages:

jeuclid-distribution
Contains the full JEuclid distribution with all supported output formats (such as png, svg, pdf). This is what most people need.
jeuclid-minimal
Contains a minimal JEuclid distribution which supports only the standard Java output formats. Use this if you need only these formats (such as png), if you want to embedd JEuclid into a non-maven2 project, or if you're interested in viewing math only.
jeuclid-osx
Contains the MathViewer with all support functionality as an application bundle for Mac OS X.

If you just want the MathViewer you may also start it from our MathViewer WebStart page.

Additional Installs

For best results, we recommend installing either one of the following font sets:

  • DejaVu Fonts
    • Windows: Download the .zip distribution from the site mentioned above. Install these fonts into your system (instructions are available at Microsoft Typography)
    • OS X: Download the .zip distribution from the site mentioned above. Drag the .ttf files into your /Library/Fonts (or your personal Library/Fonts) directory
    • Debian + Ubuntu Linux: use apt-get install ttf-dejavu
  • OpenSymbol

    The DejaVu fonts are not yet complete. Full support for MathML symbols is on the roadmap for the near future (as or mar 07). In the mean time, the OpenSymbol font (from OO >= 2.2) has support for many mathematical symbols

    • Windows / OS X: This font is part of OpenOffice
    • Debian + Ubuntu Linux: use apt-get install ttf-opensymbol
  • Arial Unicode MS
    • Windows: This font is part of MS Office (2000/2003)
    • OS X: This font is part of MS Office (X,2004)
    • Unix / Linux: Please use the DejaVu fonts. Do not copy the Arial Unicode Font from a Windows system, as you may violate the license!

MathViewer

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 OS X package, the MathViewer is included as an application bundle.

Convert MathML to other Formats

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.

Within Ant

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. Please see the API documentation or the source code for usage.

In your own App

Please look at the API Documentation. You may be interested in net.sourceforge.jeuclid.awt.MathComponent and net.sourceforge.jeuclid.swing.JMathComponent.

Maven based projects

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.

As a cocoon component

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!