Math Plugin en

With this Plugin for JSPWiki 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. 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, 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 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:

<code>
[{Math align='center' fontsize='16'

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

Math-Plugin-Parameters

Name	Description	Necessity
body or latex='..'	mathematical term in latex syntax	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:

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

<code>
	<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> 
</code>

3. Under Linux/Unix you may enable the awt headless mode (see Headless-Mode in JDK 1.4). 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
ACME

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

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