With this Plugin for [JSPWiki|http://www.jspwiki.org] you can enter mathematical formulas in Latex syntax directly in the Wiki and display them as Gifs in a similar way like it is possible with the famous [Wikipedia|http://www.wikipedia.org]. Everything happens in Java - you do not need Latex or other non-java binaries.

The visualization of the formulas is most of the work. This is done by [HotEnq|http://www.atp.rub.de/VCLab/software/HotEqn/HotEqn.html], a Java Component of the Ruhr University Bochum, specialist area automatic control engineering and process computer science. Thank you at Professor Dr. Dr.-Ing. Christian Schmid for friendly permission.

For the generation of the GIF images the ACME.jar of the [ACME Laboratories|http://www.acme.com] is used (Freeware).

!Example

[{Math align='center' fontsize='16'

2\sum_{i=1}^n a_i \;\int_a^b f_i(x)g_i(x)\,dx
}]

is created by the following syntax:

{{{
[{Math align='center' fontsize='16'

2\sum_{i=1}^n a_i \;\int_a^b f_i(x)g_i(x)\,dx
}]
}}}

!Math-Plugin-Parameters

|| Name || Description || Necessity
| body or latex='..' | mathematical term in [latex syntax|http://www.atp.rub.de/VCLab/software/HotEqn/HotEqn.html#LaTeX] | required
| align | center, left, right | optional (none)
| fontsize | size of the base font | optional (16?)
| maxwidth | maximum size of the produced gif (if it is smaller, the size will be adjusted) | optional (600?)
| maxheight | maximum size of the produced gif (if it is smaller, the size will be adjusted) | optional (200?)
| bgcolor | color of the background | optional (white)
| color | color of the text | optional (black)


!Installation

1. The following jars must be copied to {JSPWiki}/WEB-INF/lib:

* [SBaltesPlugins.jar|SBaltesPlugins/SBaltesPlugins.jar]
* [HotEqn.jar|MathPlugin/HotEqn.jar]
* [Acme.jar|MathPlugin/Acme.jar]

2. The following must be added to {JSPWiki}/WEB-INF/web.xml:

{{{
<servlet>
<servlet-name>DownloadJobServlet</servlet-name>
<servlet-class>
com.ecyrd.jspwiki.plugin.DownloadJobServlet
</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>DownloadJobServlet</servlet-name>
<url-pattern>/downloadJob</url-pattern>
</servlet-mapping>
}}}
\\

3. Under Linux/Unix you may enable the awt headless mode (see [Headless-Mode in JDK 1.4|http://forum.java.sun.com/thread.jsp?forum=20&thread=132877]). You can do it in two ways:
* Edit Wiki.jsp and append {{System.setProperty("java.awt.headless", "true");}} in the init-method
* edit the catalina.sh and append {{CATALINA_OPTS='-Djava.awt.headless=true'}} at the head of the file

!Source Code

The source code is part of the SBaltesPlugins.jar.

!License

MathPlugin itself is under the LGPL and uses freeware libraries:

* [HotEnq|http://www.atp.rub.de/VCLab/software/HotEqn/HotEqn.html]
* [ACME|http://www.acme.com]

MathPlugin a JspWiki Plugin for visualising math.
Copyright (C) 2004 Sebastian Baltes

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

[GNU LESSER GENERAL PUBLIC LICENSE Version 2.1|http://www.gnu.org/copyleft/lesser.txt]


The EXAMPLE does not show up on my browser (Iceweasel)