[[PageOutline(2-5,Contents,pullout)]]
= Render mathematical expressions in Trac using MathJax
== Description
This plugin uses [wikipedia:MathJax] to display mathematical expressions on Trac wiki pages, tickets, milestones or blogs. MathJax is a cross-browser JavaScript library that displays mathematical notation in web browsers, using MathML, LaTeX and ASCIIMathML markup. MathJax is released as open-source software under the Apache License.
Usage of this plugin in your wiki is in the following ways:
* inline, also known as macro
* wiki-processor
This [WikiProcessors WikiProcessor] uses the `math` keyword for LaTeX rendering, including [https://www.texample.net/tikz TikZ].
Example of inline syntax:
{{{
[[math(f(z_{0})=\frac{1}{2\pi i}\int_{\left|z\right|=1}\frac{f(z)}{z-z_{0}}{\mathrm{d}z})]]
}}}
Example of wiki-processor:
{{{
{{{#!math
f(z_{0})=\frac{1}{2\pi i}\int_{\left|z\right|=1}\frac{f(z)}{z-z_{0}}{\mathrm{d}z}
}}}
}}}
Both of these examples produce the following result:
[[Image(cauchyintegral.png)]]
See also: [[ListTagged(realm:wiki LaTeX)]]
== Bugs/Feature Requests
Please use [https://github.com/trac-hacks/trac-mathjax/issues GitHub] for any issues you have.
== Download
Download the zipped source from [https://github.com/trac-hacks/trac-mathjax/archive/master.zip here].
The plugin is also available on [pypi:TracMathJax PyPI].
== Source
You can clone from [https://github.com/trac-hacks/trac-mathjax here] using git, or [https://github.com/trac-hacks/trac-mathjax browse the source] on GitHub.
== Installation
Enter the following on the command line:
{{{#!sh
pip install MathJaxPlugin
}}}
For more information, please follow [t:TracPlugins#InstallingaTracPlugin documentation] on how to install Trac plugins.
== Configuration
Depending on the version of MathJax you require you may have to update the `MATHJAX_URL` to the library, for example to https://cdnjs.com/libraries/mathjax.
== Author/Contributors
'''Authors:''' [wiki:kisielk], [wiki:mitar] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''