====== mathtran plugin ======

---- plugin ----
description: Display math expressions as images using MathTran Tex engine
author     : Olivier Delrieu
email      : olivier@delrieu.org
type       : Syntax
lastupdate : 2010-03-10
compatible : 
depends    : 
conflicts  : 
similar    : 
tags       : math, formulae, tex
downloadurl: http://www.delrieu.org/dokuwiki-plugin/mathtran.zip
----

===== What is it? =====

This very simple plug-in makes a connection to the [[http://www.mathtran.org/wiki/index.php/Main_Page|MathTran web service]], which provides translation of TeX encoded mathematics to bitmap images.

MathTran provides very good looking math formulae.

===== Download and Installation =====

Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the following URL. Refer to [[:Plugins]] on how to install plugins manually.

http://www.delrieu.org/dokuwiki-plugin/mathtran.zip

===== Syntax =====

<code><tex>my-math-formulae</tex></code>

Math syntax see:
   * http://refcards.com/docs/silvermanj/tex/tex-refcard-letter.pdf
   * http://en.wikipedia.org/wiki/Math_markup

===== Example =====

<code><tex>\displaystyle { BF_i = \prod_{j=1}^{N_{loci}}{ {\hat{\nu}_j^{S_{ij}} .  { (1-\hat{\nu}_j)^{(1-S_{ij}) }  } \over { {\hat{\theta}_j^{S_{ij}} .  { (1-\hat{\theta}_j)^{(1-S_{ij}) } } }    } </tex></code>

gives:

{{http://www.delrieu.org/dokuwiki-plugin/mathtran.png}}

===== What is the catch? =====

Images are re-built each time the page is accessed. This is no big deal since the MathTran web service is quite responsive.
===== Suggestion =====
It will be better if we can use some parameters to control the alignment of the image. For example, <tex mediacenter>1+2</tex>, which generate code like this <a alt="tex:1+2" class="mediacenter">.

And if the the image can be cached, the plugin can also be used in offline/personal wiki.