Support for LaTeX Math Formulas in Wiki Pages

Description

Allow embedded equations in wiki pages. Basically a port of mt-math to trac.

Installation

Download the source. Go to the top level directory of TracMath and type:

   $ 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 trac plugin installation steps.

To activate the component, edit your project's trac.ini file to include:

    [components] 
    tracmath.* = enabled

The settings default to a linux environment where latex_cmd is /usr/bin/latex and dvipng_cmd is /usr/bin/dvipng, and cache_dir is /tmp/tracmath. You can override these settings by including in your trac.ini file settings such as:

[tracmath]
latex_cmd = <location of your latex binary>
dvipng_cmd = <location of dvipng>
cache_dir = <cache directory>
max_png = <max number of pngs in cache - defaults to 500>
use_dollars = enabled

Additional Requirements

Install python-genshi, dvipng and latex.

Bugs/Feature Requests

Existing bugs and feature requests for TracMathPlugin are here. If you have any issues, create a new ticket.

Download and Source

Download the zipped source, check out using Subversion, or browse the source with Trac.

Example

{{{
#!latex
$\mbox{Var}[\tau(X_p,X_d)] = \mbox{Var}[E(\tau(X_p,X_d)|X_p)] E[\mbox{Var}(\tau(X_p,X_d)|X_p)]$
}}}

would produce something akin to:

Other features:

  • links for any \label{} that appears, i.e., \label{eq1} will allow you link to the output image via SomeWikiPage#eq1.
  • can use '$' latex syntax instead (if use_dollars is enabled in config)

Similar Plugins

Trac2LatexPlugin

LatexFormulaMacro

Recent Changes

[3463] by rlotun on 04/04/08 10:58:46

Applied patch by guyer@nist.gov

[3462] by rlotun on 04/04/08 10:43:37

Applied patch by Immanuel Scholz <immanuel.scholz@tu-dresden.de> to allow Latex style '$$' syntax in wiki pages.

[2945] by rlotun on 12/27/07 02:39:39

small info update

[2316] by rlotun on 06/18/07 18:00:26

TracMathPlugin:

Contributed some changes and suggestions by ofv@wanadoo.es. Includes: - parsing of trac.ini for [tracmath]

including options for cache_dir, latex_cmd, dvipng_cmd, max_png

- a simple cache manager - unicode won't cause a traceback now

closes #1676

Author/Contributors

Author: rlotun
Contributors:

Attachments