Math plugin is capable of rendering Mathematical Formulas in Wiki. An example of this:
This plugin displays latex formulas and uses a few external programs that must be installed on codeBeamer's host for this plugin. This guide describes the installation steps for making the plugin functional.
Windows requires manual installation and configuration of the following packages:
Installing MiKTeX (latex for windows)
For downloading MiKTeX download the Basic installation package from here. Choose the appropriate 32 bit or 64 bit installer depending whether your Windows is 32 or 64 bit.
Install the package (leaving the default settings for everything), and make a note of the installation directory (a typical example of installation directory is: "C:\Program Files (x86)\MiKTeX 2.9")
Currently supported version: ImageMagick-6.7.6-Q16
During the installation leave all settings on default, and make a note of the installation directory (for instance, "C:\Program Files (x86)\ImageMagick-6.7.6-Q16\").
After these installations are done, you'll have to "tell" codeBeamer where these programs are. Unfortunately, putting these on the system classpath is not enough, because Windows may pick up wrong executables from the path. Instead you will need to edit the "C:\CB\tomcat\webapps\cb\config\path.txt" file (use your codeBeamer location instead of "C:\CB"). Edit that file, and add the paths of the just installed packages this way:
If the Math plugin does not render the formulas correctly, check the following:
Did you restart codeBeamer after installation?
open the $CB_HOME/tomcat/logs/cb.txt log file and look for "MathPlugin" logs. If there is any error during the execution of the external programs above, there should be some kind of hint about that. Note: you may see some warnings during latext-processing, but that is typically not a problem.
If all 3 packages are installed properly, test their versions by executing these commands:
MiKTeX-pdfTeX 2.9.7029 (1.40.20)
Copyright (C) 1982 D. E. Knuth, (C) 1996-2006 Han The Thanh
TeX is a trademark of the American Mathematical Society.
This is dvips(k) 5.991 Copyright 2011 Radical Eye Software (www.radicaleye.com)
Check if all programs are adequately configured on the path.
On Windows the paths should be configured in the tomcat\webapps\cb\config\path.txt mentioned above, on Linux these commands should be on the system path. If everything looks fine, you can also try to put the applications' directories on Windows too.
In recent Ubuntu/Linux installations the ImageMagick library which is used to convert the Latex images to viewable images got a security fix which prevents the Latex/Math plugin from rendering the images properly.
This appears as either:
If the Math or Latex plugin is NOT rendering and it fails with an error message like this:
ImageMagick is not authorized to generate ps files
or the UI displays this error message:
or the cb.txt log file contains an error like the following then trying to render a Math or Latext plugin:
To fix this situation you need to enable the rendering of the PS (Postscipt) files by ImageMagick. That is typically done by editing the /etc/ImageMagick-6/policy.xml file and allow rendering the PS files here by editing this line: