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

== Description ==

A plugin for rendering math in Trac using [http://www.mathjax.org MathJax]. Unlike the TracMathPlugin, this plugin performs all rendering on the client side using web fonts.

See also: TracMathPlugin, LatexFormulaMacro, Trac2LatexPlugin, LatexMacro

== Download and Source == 

Download the 0.3 release in [https://bitbucket.org/kisielk/tracmathjaxplugin/get/0.3.zip zip], [https://bitbucket.org/kisielk/tracmathjaxplugin/get/0.3.tar.gz gz], or [https://bitbucket.org/kisielk/tracmathjaxplugin/get/0.3.tar.bz2 bz2] format.

For the latest changes, check out the source [https://bitbucket.org/kisielk/tracmathjaxplugin using Hg], or [https://bitbucket.org/kisielk/tracmathjaxplugin/src browse it on Bitbucket].

== Installation ==

Unpack your download. Go to the top level directory of !TracMathJax and type:
{{{
#!sh
 $ python setup.py bdist_egg
}}}

This should create an egg file under the `dist` subdirectory of your current directory. Copy the egg to the `plugins` directory of your trac project. If you have any difficulties installing consult these [t:wiki:TracPlugins trac plugin installation steps].

As of version 0.3 of this plugin you no longer need to download !MathJax to your web server. The plugin will use version of !MathJax from their secure CDN URL: https://c328740.ssl.cf1.rackcdn.com/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML

=== Configuration ===
To activate the component, edit your project's `trac.ini` file to include:
{{{
#!ini
 [components] 
 tracmathjax.* = enabled
}}} 

For additional customization of the display output, see the [http://www.mathjax.org/resources/docs/ MathJax documentation].

== Bugs/Feature Requests == 

Existing bugs and feature requests for TracMathJaxPlugin are 
[report:9?COMPONENT=TracMathJaxPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TracMathJaxPlugin&owner=kisielk new ticket].

== Example ==

To display math inline, enter LaTeX equation in between a pair of `\(` and `\)` brackets:

{{{
Here is an inline equation: \( y = x^2 \)
}}}

To display a block of math, either enter it between a pair of `$$` characters:

{{{
Here is a block equation: $$ y = x^2 $$
}}}

or use the `latex` processor:

{{{
{{{
#!latex
y = x ^ 2
}}}
}}}

== Release Notes ==
=== 0.3 ===
 * Use the !MathJax CDN to serve !MathJax

=== 0.2 ===
 * Fixed bugs with inline macro syntax (#8500)

=== 0.1 ===
 * Initial release

== Alternative Implementation ==

There exist an alternative implementation which uses `math` keyword in wiki syntax so that it does conflicts with `TracMathPlugin` (which you could be using for real LaTeX rendering, including TikZ). Inline syntax is also different, simply using WikiMacros. Examples:

{{{
[[math(1+2=3)]]

{{{
#!math
x = \frac{1}{2}
}}}
}}}

Otherwise, implementations should be functionally equivalent. If it is not so, please inform us.

=== Bugs/Feature Requests ===

Please use [https://github.com/mitar/trac-mathjax/issues GitHub] for any issues you have with this implementation.

=== Download ===

Download the zipped source from [https://github.com/mitar/trac-mathjax/archive/master.zip here].

=== Source ===

You can clone this implementation from [https://github.com/mitar/trac-mathjax here] using git, or [https://github.com/mitar/trac-mathjax the source] on GitHub.

=== Installation ===

{{{
pip install MathJaxPlugin
}}}

For more information, please follow [http://trac.edgewall.org/wiki/TracPlugins#InstallingaTracPlugin documentation] on how to install Trac's plugins.

== Author/Contributors ==

'''Authors:''' [wiki:kisielk], [wiki:mitar] [[BR]]
'''Maintainer:''' [wiki:kisielk] [[BR]]
'''Contributors:'''