MathJax Plugin for Confluence
The MathJax Plugin for Confluence makes MathJax available in your Confluence wiki. Must I say more? From within your Confluence editor you can access MathJax functions to display mathematical formulas on your Confluence page. The plugin was developed by David A.W. Barton (davebarton @ cityinthesky.co.uk).
However, his last release is not compatible anymore with Confluence 7.x+. Our new release 2.7 fixes that and also comes in a CHTML version.
What is Confluence
For quite some time I was involved in the administration and operation of Atlassian applications. Confluence is Atlassian's Enterprise Wiki. I you haven't heard of or used it yet, check it out. You can download a trial version right from their web site here: Atlassian Confluence.
What is Mathjax
MathJax is an open source JavaScript display engine for mathematics that works in all browsers. It renders mathematical formulas just beautifully right in your browser so there is no more need to install plugins or readers of any kind to visualize Albert Einstein's work on your website. Check out the MathJax website for details.
What is the MathJax Plugin for Confluence ?
The MathJax Plugin for Confluence makes MathJax available in your Confluence Wiki. Must I say more? From within your Confluence editor you can access MathJax functions to display mathematical formulas in your Confluence page. The plugin was developed by David A.W. Barton (davebarton @ cityinthesky.co.uk). All credits go to him for this awesome implementation.
His description of the plugin is this:
This plugin provides a thin wrapper around MathJax http://www.mathjax.org/ to enable equations to be entered in LaTeX notation. MathJax is an open source JavaScript display engine for mathematics that works in all modern browsers.
Two macros for Confluence are provided: mathinline and mathdisplay. They both accept mathematics in LaTeX notation and output either an inline equation (within the main text) or a displayed equation (separate from the main text, typically centered on the page). AMSmath extensions for LaTeX are also enabled.
You can download the original (built with MathJax 1.1) binaries from here:
https://github.com/db9052/confluence-mathjax/downloads
You will find the source code there too.
The Compatibility Thing
Like with most application plugins, their functionality stands and falls with their compatibility to the mother application. Once Atlassian updates Confluence, there is a chance that your plugins won’t work anymore. Exactly that happened with Confluence 5.3 that rendered the MathJax Plugin for Confluence incompatible with that version.
Fortunately, the MathJax Plugin for Confluence plugin is Open Source software and subject to adjustments by other developers. Since we are using the plugin we have just done that and would like to provide the updated version of this plugin for you here.
The Updated Plugin
The plugin you can download from here has the following small changes:
- MathJax javascript library was changed to the latest v2.4
- MathJax configuration slightly altered to enable equation numbering. autonumber: “AMS”
- Plugin pom.xml was changed to be compiled for Confluence (5.3 - 5.6)
- Inline equations now work with Confluence 5.5.6 and higher
You can read more on equation numbering here:
http://docs.mathjax.org/en/latest/tex.html#automatic-equation-numbering
http://docs.mathjax.org/en/latest/options/TeX.html
Installation Instructions
- Download the zip file (see link below)
- Extract the jar file
- Install into Confluence with the UPM (Universal Plugin Manager)
