[[PageOutline(2-5,Contents,pullout)]]

= Render mathematical expressions in Trac using ​MathJax

This [WikiProcessors WikiProcessor] uses the `math` keyword for LaTeX rendering, including [https://www.texample.net/tikz TikZ]. This plugin uses [wikipedia:MathJax] to display mathematical expressions. 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

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:'''