Latex Block Parser

...a remake of the old latexrender mod. It is based on the great graphviz plugin by Carl-Christian Salvesen.

It consists of amine


Alternatively, see the installation notes by Frisco Rose under


  • Of course you need this DokuWiki installed and running
  • LatexRender needs a working installation of Graph, ImageMagick and Ghostscript
  • If you are on a Debian box, $apt-get install tetex-base texlive-latex-recommended texlive-fonts-recommended imagemagick gs-common should be sufficient to install the required packages
    • Recommended: install also tetex-extra
    • Note: Make sure texlive-latex-recommended (used to be latex-ucs) is installed. It's not really a standard package. We need it because DokuWiki uses UTF-8 to store its data, so you also have to enable Graph to handle UTF-8.
  • If you are on a Fedora Core 3 box, $yum install tetex-latex ImageMagick should be sufficient to install the required packages ($yum install tetex-unicode for including latex-ucs ??)
  • Gentoo users use this: emerge -av tetex latex-unicode imagemagick ghostscript

Installation with plugin manager

  • within a web browser, load dokuwiki, follow the links admin > manage plugins, then download from URL:
  • at present, it may be necessary to make a little modification to the syntax file which requires command-line access to the dokuwiki server. See below.

Installation from command line, with darcs

$> cd dokuwiki/lib/plugins
$> darcs get


$> darcs pull

Installation from command line, without darcs

$>  cd dokuwiki
$>  mkdir lib/plugins/latex
$> mkdir latexrender
$> cd latexrender
$> wget
$> unzip
$> cp otherPHP/latexrender/class.latexrender.php ../lib/plugins/latex
$> cd ..
$> rm -rd latexrender
  • modify the paths in lib/plugins/latex/class.latexrender.php


Test Latex installation

If you can not latex the following lines, your latexrender won't work (since this is the kind of file generated by the latexrender script):

\Latex2e\ ist nett!

Some installations may work better (i.e., work, period) with utf8xlatin1, though this is not the preferred method.

Step by Step

    \frac{3}{4 \pi}   \sqrt{4 \cdot x^2   12}\\
    \lim_{n \to \infty}
    \sum_{k=1}^n \frac{1}{k^2} = \frac{\pi^2}{6}\\
    \it{f}(x) = \frac{1}{\sqrt{x} x^2}\\
    e^{i \pi} + 1 = 0\;

...that'd be a good way to debug your install. These are the exact commands the plugin uses.

  1. Copy&Paste these lines into test.tex
    1. cat > test.tex
    2. press Return
    3. paste the file
    4. press Ctrl+C
  2. create a dvi file: test.dvi
    /usr/bin/latex --interaction=nonstopmode test.tex
  3. convert that dvi to a ps:
    /usr/bin/dvips -E test.dvi -o
  4. convert that ps to our final png file: test.png
    /usr/bin/convert -density 120 -trim -transparent "#FFFFFF" test.png
  5. see your image
    xv test.png

Under MS Windows

I had some problems with installation. Clearly, the instructions at the page are obsolete and misleading. Here is what I did.

  • Skip steps 2-5.
  • Download latex.tar.gz (see the URL above)
  • Unzip the files class.latexrender.php and syntax.php from this zip into the directory dokuwiki/lib/plugins/latex/ (create it if you don't have it).
  • Modify the paths in those files. In my case, on a Windows machine, those modifications include the following variables in class.latexrender.php:
  var $_tmp_dir = "c:/temp";
  var $_latex_path = "c:/texmf/miktex/bin/latex.exe";
  var $_dvips_path = "c:/texmf/miktex/bin/dvips.exe";
  var $_convert_path = "c:/soft/imagemagick/convert.exe";
  var $_identify_path="c:/soft/imagemagick/identify.exe";


    var $_tmp_dir='c:/temp';

in line 22 of syntax.php.

  • Run the example given above and make sure that everything works.

(inserted by Facundo) I had problems with the double quotes. I enclosed the paths in single quotes and it worked fine, e.g. 'c:\textmf\...'

If you have problems, check that the plugin creates a tex file in your temporary directory (in my case, the file had a temporary name d1b4924d687d27239d896aaf8b9a6444.tex) and run manually latex on this file. I found out that my miktex stuck initially because it required packages eurosym and utf8x which I did not have. After I downloaded them manually, everything works now.

Adding align=absmiddle on line 91 of syntax.php makes much better alignment of inline formulas.


Example dokuwiki contents

  • <latex>öäüß</latex>


  • <latex>
        \frac{3}{4 \pi}   \sqrt{4 \cdot x^2   12}\\
        \lim_{n \to \infty}
        \sum_{k=1}^n \frac{1}{k^2} = \frac{\pi^2}{6}\\
        \it{f}(x) = \frac{1}{\sqrt{x} x^2}\\
        e^{i \pi} + 1 = 0}\;


  • For those who want a “displayed” equation instead of “inline”, or those with a piece of long proof, try this trick:

Note: [space] = ' '

[space]$ \begin{align*}
\int x^2 dx & = \frac{1}{3}x^3
\therefore\quad\int_0^1 x^2 dx &= \frac{1}{3}

The space right after and before the latex tag is compulsory because the latexrender will encode all your stuff with a pair of dollar sign. The idea of my trick is to make the two dollar signs out of effect! I learn this from SQL-injection.

Alternatively, as noted at the bottom of this page, This version of the plugin allows for simple markup, like $\alpha$ directly in the wikitext.
Should work with the latest darcs version too, but you've to use $$ latex $$ ;-) Graph
I tried the today darcs version and the $$ trick does not work :-(

You could also replace line 190 in class.latexrenderer.php with $string .= $latex_formula.”\n”; (then enclose inline equations in $s and displayed equations in $$s).


darcs changes


  • darcs repository created


  • getInfo() added


  • global settings added
    • $_tmp_dir
    • $_image_format
  • no changes in class.latexrender.php needed


  • plugin-path changed
  • fetch.php path changed
  • FIXME add a umask call for the mkdir


  • change the path to fetch.php: lib/exe/fetch.php


I'm having problem to generate a *png* file from the *ps* file. However, I do have ImageMagick installed, and the command *convert* works fine. The problem is really strange. At the line 249 of class.latexrender.php :

        // imagemagick convert ps to image and trim picture
        $command = $this->_convert_path." -density ".$this->_formula_density." -trim -transparent white ".$this->_tmp_filename.".ps ".$this->_tmp_filename.".".$this->_image_format;

        $status_code = exec($command);

The returned value of $status_code is zero, which presumptively means that the command did not execute correctly. However, when I type exactly the same command on terminal, everything works great, and I get the png file.

Any idea what would be the problem?


Nice work! Just started to work on a plugin for LatexRender and then found this! Greets, Jan Tammen.
Yeah! I couldn't wait for your release ;-)
Also 0777-$conf['dmask'] didn't work for me – I had to do a chmod x data/media/latex
But now it runs perfectly - thanks for your work!

I'm having trouble getting this to work. I've traced it to execution of latex, which stops immediately with “can't find 'latex.fmt'”. Nonetheless, when I stop the file from being deleted and go into the /tmp directory, I can run latex properly on the .tex file. Permissions are set liberally. Is there something with PHP that I'm not understanding? A safe mode problem, maybe?

The following code doesn't work for me, e.g. transparency for generated images is broken:

class.latexrender.php(line 253):

        // imagemagick convert ps to image and trim picture
        $command = $this->_convert_path." -density ".$this->_formula_density.
                   " -trim -transparent \"#FFFFFF\" ".$this->_tmp_filename.".ps ".

but it works fine if I remove escaped double quotes that surround #FFFFFF, e.g.:

” -trim -transparent #FFFFFF ”.$this→_tmp_filename.”.ps ”.

or even better:

” -trim -transparent white ”.$this→_tmp_filename.”.ps ”.

I am using ImageMagick v.6.2.5

Hi, I'm having un problem with latexrender install: I can't get the file sysntax.php. I get always the message: “Unable to display file “”: It may not exist, or permission may be denied.” I'm doing something wrong? Thanks. Joao

→ The file is in Érick

→ Hello, first off, thanks a ton for an awsome plugin. 1 question, any idea how to add the syntax rules to the syntax help page (the one linked to from the edit window)? Not a big deal, email to ( would be great. Thanks Nick

Nice work! Thanks for the plugin.

I am trying to install DokuWiki for my class website, which I would like to use your plugin for showing equations on my notes and homeworks pages. I have installed it on my server and receive the errors:

Warning: copy(cd6174dda4b84b998f052ba3e5d9f2fb.png): failed to open stream: No such file or directory in /home/chris/dokuwiki/lib/plugins/latex/class.latexrender.php on line 276 Warning: unlink(/tmp/cd6174dda4b84b998f052ba3e5d9f2fb.aux): No such file or directory in /home/chris/dokuwiki/lib/plugins/latex/class.latexrender.php on line 294 Warning: unlink(/tmp/cd6174dda4b84b998f052ba3e5d9f2fb.dvi): No such file or directory in /home/chris/dokuwiki/lib/plugins/latex/class.latexrender.php on line 296 Warning: unlink(/tmp/ No such file or directory in /home/chris/dokuwiki/lib/plugins/latex/class.latexrender.php on line 297 Warning: unlink(/tmp/cd6174dda4b84b998f052ba3e5d9f2fb.png): No such file or directory in /home/chris/dokuwiki/lib/plugins/latex/class.latexrender.php on line 298

Below the errors shows an invalid image link to fetch.php?cache=&media=latex%3A3ce93eb8fef2cd7a021e88f6651bd559.png. I have tweaked around with the temporary directory variables in both the class.latexrender.php and syntax.php files, but still receive the same errors. To see if my server was the problem, I tried installing everything on my Windows machine (using MikTeX) following the instructions in the previous comment. The error is duplicated exactly, except that the Unix paths are now replaced with Windows paths (ie the line numbers are the same). Unlike the previous comment, I am not seeing any temporary files in the temporary folders; does that mean that something is going wrong before it gets to the point where the warnings are?

Am I overlooking something simple, or what else could I be doing wrong? Thanks so much!

– Chris

This looks an awful lot like a permissions issue. Are you sure that your web server has permission to write in /tmp? You could configure it (in lib/plugins/latex/syntax.php) to write to a tmp subdirectory of data/latex. I also had a problem with ridiculous ownership and permissions for the data/latex directory when I used the plugin manager to install this.
This may be an overall problem with getting images. I had the same trouble. This was because I remade language files. After editing lang.php I saved it in UTF-8 (WScite). It influenced only on fetch.php. At last I saved this file just in 8-Bit format and all became right.


It worked at last!!!

I had exactly the problem mentioned by Chris above and it really went away by installing the unicode package for latex from ... I must say that I also had several permission problems so I also issued the command:

chmod -R 777 dokuwiki

to get rid of all of them at once. This is of course not advisable from a security perspective, but once latexrender works, you can fine-tune the permissions to a better setting Thanks a lot for the plugin!!!


Some share hosting environments (e.g. DreamHost) have a latex install, without the unicode package.... and don't handle the paths to private user LaTeX packages gracefully in PHP scripts. I think its something to do with $HOME not being parsed correctly. Or that kinda stuff. That is, the helpdul instructions on private package install instructions at work only from the shell, not from PHP. Grr. So I brute forced it by editing my conf/local.php to include


as per their backup ideas at

You might really find it useful to go into class.latexparser.php in the distro and add some extra debug code to the lines near

       // create temporary dvi file
        $command = $this->_latex_path." --interaction=nonstopmode ".$this->_tmp_filename.".tex";
        $status_code = exec($command);

the latex rendering class is a bit bad here... the fact that it tries to return a status code makes you think that it is actually doing some form of useful error trapping here. It's not, and latex can throw HEAPS of errors that go undetected. $statuscode is merely set to the last line of output of the function. a better version would be something like:

       // create temporary dvi file
        $command = $this->_latex_path." --interaction=nonstopmode ".$this->_tmp_filename.".tex";

and possibly prints the debug array in case of an error...

I've written a little email to the guy behind class.latexparser.php to express my opinions. I dunno, would you cll it a bug per se?

–dan() 2006-07-20

Hi! I really love the plugin, but I can't get it working (despite all the good hints listed here). * I run apache on a FC4 distro. * dokuwiki works fine, the check delivers DokuWiki version: Release 2006-03-09 PHP version 5.0.4 Changelog is writable Datadir is writable Attic is writable Mediadir is writable Cachedir is writable conf/users.auth.php is writable mb_string extension not available - PHP only replacements will be used Debugging support is disabled Your current permission for this page is 255 The current page is writable by the webserver The current page is writable by you

  • I used the plugin manager to pull the plugin from - plugin appears in list
  • When entering some latex code, my wiki doesn't show formulae but 'latex' which it's not selectable like other t text
  • I can't find any tex-files at all - which is crucial
  • I checked that class.latexrender.php and syntax.php are there - I simply adapted the paths in there

Can somebody help me ? – Erik

Seems I have the same problem. This is the output in my apache error.log file, maybe this helps:

This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (
/usr/bin/dvips: ! DVI file can't be opened.
convert: unable to open image `': No such file or directory.
identify: unable to open image `d691199f46bff930ababdf3ceb922351.png': No such file or directory.
This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (
' TeX output 2006.07.01:1253' ->
. <cmr5.pfb><cmex10.pfb><cmsy7.pfb><cmmi10.pfb><cmr10.pfb><cmsy10.pfb>

Wonko 2006-07-01

I had the same problem but solved it ...
You dont see any tex Files because there is a clean up funktion in class.latexrender.php (line290). I simple disabled the function call in line 278
        $status_code = copy($this->_tmp_filename.".".$this->_image_format,$filename);

       // $this->cleanTemporaryDirectory();

        if (!$status_code) { chdir($current_dir); $this->_errorcode = 6; return false; }

after that you find some files in ./tmp. In my case there was a tex and a log file and i found out that i misset the latex-utf package. So i installed it and voila it works

– Fronk - 2006-08-07

Hi! First of all: Thanks for the Plugin, it's great! (Except one thing ;-))

  • Is it possible to get the images in line with standard text?

Example: I would like Graph here in line, but it appears in an “upper” stile. Any suggestions?


I've made some changes to my copy of the plugin so that inline formulas are properly aligned (to within about 1pt). You can find my explanation of how to do this here, or just download my copy of the plugin here. Beware that I've expanded the syntax used for putting latex on the page, so that it can differentiate between inline and display modes. (Specifically, in the wiki text, a user enters math precisely as he/she would in a latex document.) Also, I use a dark red text color, but this can easily be changed. — Mike

Hi there. Love the plugin but can't install it :(. I keep having the error

Warning: Unexpected character in input: '\' (ASCII=92) state=1 in c:\workshop\dokuwiki\lib\plugins\latex\class.latexrender.php on line 180

Parse error: parse error, unexpected T_STRING in c:\workshop\dokuwiki\lib\plugins\latex\class.latexrender.php on line 180

Fatal error: Cannot instantiate non-existent class: latexrender in c:\workshop\dokuwiki\lib\plugins\latex\syntax.php on line 108

Line 180 is ” $string = “\documentclass[”.$this→_font_size.”pt]{”.$this→_latexclass.”}\n”; ” in my code. Any ideas? Thanks in advance.

In my experience, this is exactly what happens when you've forgotten to close a quote (either double or single) somewhere on a previous line. — Mike

I love this plugin. My wiki is used by physicists, so we use a lot of LaTeX. We use so much, in fact, that I decided to extend the syntax so that expressions like $\alpha$ are recognized and parsed properly. I've also added support for displaymath, eqnarray, and eqnarray*. This is the zip file containing my version.

I must admit that dokuwiki's particular species of regex confounds me utterly, so the syntax contained here may be downright stupid, but it works for me. If anyone would like to take this over to improve it, feel free. — Mike

It is incompatible to ? Can you fix this?

Fix to Enable Copy&Paste from Wikipages:

          $renderer->doc .= '<img src="'.$url.'" class="media" title="'.$title.'" alt="'.$title.'" />';

instead of line 90 in syntax.php

Excellent plugin! However, we ran into trouble because of the line var $_xsize_limit = 500; in class.latexrender.php which simply means that long formulas will not be typeset for, initially, totally mysterious reasons. Just change 500 to a large value and everything will work again. (Petrus)

on which server you can host a DokuWiki with this plugin? Because of the additional package and the enabled exec php-command, I couldn't find a hoster yet :-(

Hi! Thanks for the good work! I am trying to use the latex block to render some tables, because the native dokuwiki syntax does not seem to support rowspan and some features like table size and so on. I have tried the following tables:

option & variants & explanation \\
id & unique string & Identifies the user uniquely.\\
logmask & ALL & Log everything \\
& DBG & Log only debug \\
& WARN & Log only warning messages \\
printTID & flag & Print Thread ID or not.\\
prefix & any string & With this will be prefixed all messages of this user.\\
p & p & p \\
p & p & p \\
p & p & p \\
p & p & p \\

option & variants & explanation \\
id & unique string & Identifies the user uniquely.\\
logmask & ALL & Log everything \\
 & DBG & Log only debug \\
 & WARN & Log only warning messages \\
printTID & flag & Print Thread ID or not.\\
prefix & any string & With this will be prefixed all messages of this user.\\
filename & path string & The whole path to the filename without the date .log suffix, which are set automatically. \\

The second table is not rendering at all. Only the word 'Latex' is printed instead of the table. I have changed _xsize_limit and _ysize_limit to 5000, but still not working.


Th adapt this extention with DokuTeXit ( I add

       if($mode == 'latex' && strlen($data[0]) > 1) {
         $renderer->doc .= "$".$data[0]."$\n";
         return true;


       if($mode == 'xhtml' && strlen($data[0]) > 1) {
         if ( !is_dir($conf['mediadir'] . '/latex') ) {
           mkdir($conf['mediadir'] . '/latex', 0777-$conf['dmask']);
         return true;

In the file syntax.php.

added to darcs repository. — Alexander Krause 2007/02/18 19:15

Hello. Thanks for the great plugin and the equally awesome documentation. I have a few issues however:

  1. the size: the formulas look much better than the phpmathpublisher plugin but they are very small . how to set the size? the formulae are awfully small and i can't find a way to increase the font or formula size (like mathmulti allows) which is a shame. I tried increasing the value of $_font_size in class.latexrender.php , but to no avail. still very small formulae. size matters
  2. vertical alignment with text baseline
    • by default: is elevated about +50%
    • requires nesting inside <html><font style=“vertical-align:-50%”> tags. :(
  3. alt attribute of png is “Graph” ← must change to at least the syntax between the latex tags, like in mediawiki
    • also when there's a syntax error i only get the text “Latex” instead “Latex error” or something.
  4. does not render pure latex (superset with $math$ mode)!
    • thus , cannot make theorem environments
    • btw, the first test on this page , the one that begins \documentclass[14pt]{article} fails — i don't know if i'm supposed to try it out inside &lt; latex &gt; tags on dokuwiki.

Any help on these questions would be greatly appreciated, especially about increasing the font size of formulas. Thanks again. — onion mantis 2008/02/04 09:15

If you change the $_formula_density value in the class.latexrender.php file to a value higher than 120, it will increase the size of the formula. It would be nice to be able to edit this dynamically from the dokuwiki code instead of hacking the plug-in with a hard-coded value. David

Issues with kvoptions.sty

I'm having trouble getting the PDF to render properly using Debian box (Using DokuTexit). When I hit the Generate PDF button, I get

...Document Class: report 2005/09/16 v1.4f Standard LaTeX document class

! LaTeX Error: File `kvoptions.sty' not found.

Methinks something went wrong with the LaTex install. Any ideas? – Jeff

Elegant formulas in text bad centering problem solution/patch

Change in syntax.php lines in 2 places:

$renderer->doc .= '<img src="'.$url.'" class="media" title="Graph" alt="Graph" />';
$renderer->doc .= '<img src="'.$url.'" class="media" title="Latex" alt="Latex" />';


$renderer->doc .= '<img src="'.$url.'" class="media" style="vertical-align: middle;" />';

qwak 2008/05/06 18:59

You should not eliminate the other metadata in the renderer→doc string, consider using instead

$renderer->doc .= '<img src="'.$url.'" class="media" title="Latex" alt="Latex" />';


$renderer->doc .= '<img src="'.$url.'" class="media" style="vertical-align: middle;" title="Latex" alt="Latex" />';

F. Rose

Restrictive ACL setups

The latex namespace only exists under the data/media/ directory, and it is not shown in the ACL setup page of Dokuwiki. If you do not allow the users group access to all namespaces, they won't be able to see the latex rendering.

The quick and dirty fix is to create a latex directory under the data/pages/ directory so that the latex namespace is shown in the ACL setup.

This is either a Dokuwiki bug (only looks at namespaces in the pages directory), or a plugin bug (should create the namespace in both media and pages directories).

wiki/projects/php/dokuwiki/plugins/latex.txt · Last modified: 2010/02/09 15:20 by janhp
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki