• View
• Edit
• History
• Attach
• Print
• Backlinks

MimeTeX

Questions answered by this recipe

• Can PmWiki be used to display mathematical formulas?

Solution

• mimetex-vc.phpΔ - PmWiki cookbook script (to rename mimetex.php)
  • URL gone 2022-08 http://www.forkosh.com/mimetex.html - mimeTeX package
  • try perhaps https://miktex.org/

See also

Discussion

The mimeTeX utility from John Forkosh Associates, Inc., along with the mimetex.php script above, makes it easy to embed mathematical formulas in wiki pages using the LaTeX math expression syntax. Once installed, the markup {$ and $} can be used to embed a formula in a wiki page. For example, the markup

produces

More complex formulas can be generated--for example:

becomes

See the full mimeTeX manual [mersenneforum.org] for more details.

Installation

To install MimeTeX, perform the following steps:

1. Download and install the mimeTeX package from http://www.forkosh.com/mimetex.html. You can use the installation instructions given in the README file included with the mimeTeX package; on pmichaud.com we simply unzipped the archive into a mimetex/ directory and executed the command

    cc -DAA mimetex.c gifsave.c -lm -o mimetex.cgi

(you can download the compiled version for linux directly on : http://www.forkosh.dreamhost.com/mimetex.exe/linux/mimetex.zip )

2. Place the mimetex-vc.phpΔ script in your cookbook/ subdirectory and rename it mimetex.php)

3. If you want to have PmWiki simply use MimeTeX as an external CGI script and do no caching of its own, you can place the following lines in your local/config.php (change the URL for mimetex.cgi as necessary):

   
$MimetexUrl = '/cgi-bin/mimetex.cgi';
include_once('cookbook/mimetex.php');

4. If you want PmWiki to call MimeTeX directly and cache the resulting images, then create a directory called pub/cache for the images and give the webserver write permissions to this subdirectory. (On Unix systems this is typically done via the command mkdir pub/cache; chmod 777 pub/cache;.) Then add the following to your local/config.php:

$MimetexCmd = '/filesystem/path/to/mimetex.cgi';
include_once('cookbook/mimetex.php');

That should do it! Whenever mimetex.php encounters the {$ ... $} markup, it automatically generates a call to mimetex.cgi and displays the resulting image. If PmWiki is being used to cache the images, then the images are kept in pub/cache/ to avoid regenerating them on future page accesses. A WikiAdministrator can delete the image files in pub/cache/ at any time and MimeTeX will automatically regenerate them as needed.

MimeTeX itself now has an optional built-in caching mechanism, which is enabled by compiling mimetex.cgi with the -DCACHEPATH=\"path/\" switch (where path/ is a directory relative to mimetex.cgi where images will be cached. This can be used in conjunction with #3 above and still provide caching.

5. If you have a wikifarm installed, you need an extra $FarmD in mimetex.php.

    --- mimetex.php.orig
    +++ mimetex.php
    -SDV($ImgCacheDir,"pub/cache");
    +SDV($ImgCacheDir,"$FarmD/pub/cache");

Also add $FarmD in config.php

Contributors

• Pm
• Christian Ridderström
• John Forkosh Associates, Inc. -- mimeTeX utility

MimeTeX Sandbox

{$$ f_X(x_1, \dots, x_N) = \frac

 {1}
 {(2\pi)^{N/2} \left|\Sigma\right|^{1/2}}

\exp \left(

 -\frac{1}{2}
 ( x - \mu)^\top \Sigma^{-1} (x - \mu)

\right)$$}

Feel free to use the space below to test various mimeTeX formula markups.

{$\array{CCC$\Large f=b_\0+\frac{a_\1}{b_\1+\frac{a_2}{b_2+\frac{a_3}{b_3+a_4}}} & \hspace{10} {\small\rm{Notes and\atop mimeTeX Sandbox}} \hspace{10} } \Large \scrJ^{ij}=\frac12\vareps_{ijk}\[\array{cc$\sig_k&0\\0&\sig_k}\] $

,

AB

}

This is some text wrapped around the formula to see how it behaves.

Some examples used from another Wiki:

Some weird examples... probably a bug. Only one of the formulas below should produce ...

* {$                    -\bar a_{c 3} \cos \Phi \sin \rho $}
* {$- \bar a $}
* {$ f(x)=x^3 $}
* {$- a $}
* {$\bar a $}

Ben: I found a similar bug. If you insert \. (which does nothing) at the beginning of each of these, then MimeTeX formats the image correctly. I would guess it is a bug with MimeTeX. Typing the following should work:

* {$\.                    -\bar a_{c 3} \cos \Phi \sin \rho $}
* {$\.- \bar a $}
* {$\. f(x)=x^2 $}
* {$\.- a $}
* {$\.\bar a $}

 return "<img class='mimetex' src='$ImgCacheUrl/$imgname' alt='".

to

  return "<img ALIGN='absMIDDLE' class='mimetex' src='$ImgCacheUrl/$imgname' alt='".

This causes the images to be centered with the center line of the text. It works in IE and Firefox. It still is not perfect at displaying all images, but I think it looks a lot better.

Other options for aligning are available (see http://www.w3.org/MarkUp/Test/Img/imgtest.html). I think the absmiddle does the best job.

* {$                     -\bar a_{c 3} \cos \Phi \sin \rho $}
* {$ - \bar a $}
* {$  f(x)=x^2 $}
* {$ - a $}
* {$ \bar a $}

I'm trying to make this work but I keep getting the error message: Warning: Cannot modify header information - headers already sent by (output started at /home6/jcarter/public_html/pmwiki/cookbook/mimetex.php:4) in /home6/jcarter/public_html/pmwiki/pmwiki.php on line 871.

any suggestions???

That worked! thanks!

I'm looking for markup that I can use for text that will allow me to place alternative strings directly above and below eachother (without using preformatted text). For example, with preformatted text, the result would be like this:

       (ago)
A: (e) ache moyuba

Using frac (and avoiding Q&A):

A: (e) moyuba

Using large and frac:

A: (e) moyuba

Using large and relstack:

Using \\:

A: (e) moyuba

 ------

i'm wondering if and how can this plugin works under windows iis..

Folks can't get it to work config.php has

 $MimetexUrl = '/cgi-bin/mimetex.cgi';
    include_once('cookbook/mimetex.php');

"cgi-bin" is a subdirectory in the "pmwiki-2.1.26" directory. mimetex.cgi is there, still it shows only the typed symbols, not the one I want to display.

Thanks for suggestion <<<<<<<

mw <math>\sqrt{1-e^2}</math> ltx =======

<math>\sqrt{1-e^2}</math> >>>>>>>

http://meta.wikimedia.org/wiki/Help:Formula

{$S_{new} = S_{old} - \frac{ \left( 5-T \right) ^2} {2}*}

abcd

27-Feb-2007 mimetex.phpΔ attachment seems to be corrupted. Can it be restored please ??

Attachement problem

24-Jul-2007
mimetex.phpΔ attachment seems to be corrupted. Can it be restored please ??

18-Nov-2007
try to copy content of mimetex-vc.phpΔ to your mimetex.php. It works