“It's awesome! This plugin together [with] MathJax makes publishing math in dokuwiki a real pleasure. And it is so easy to install both.” (anonymous user)

• Use LaTeX-code and high-quality LaTeX-fonts in your wiki.
• Neither client nor server require additional LaTeX-specific setup.
• LaTeX-code is beautifully rendered by the client's browser using a JavaScript library.

Once this plugin is completely installed, you can embed LaTeX code into your wiki pages.

Each of the following will cause jsmath to display the formula inline:

$e^{i \pi} = -1$

\(e^{i \pi} = -1\)

<jsm>e^{i \pi} = -1</jsm>

Each of the following will display an equation in block format, on its own line:

\[e^{i \pi} = -1\]

<jsmath>e^{i \pi} = -1</jsmath>

For your convenience, the plugin is available in two different archive formats.

To setup your DokuWiki for displaying LaTeX, you need to upload some files to your webspace and install the jsmath plugin.

The jsmath plugin for DokuWiki does not render the LaTeX-code itself. Instead it uses a JavaScript backend that renders the code in the client's browser. Two different JavaScript backends are currently supported:

• jsMath is mature software and in recent versions quite fast. The drawback is that the client needs to manually install additional fonts for best quality.
• MathJax is a modern replacement for jsMath. The high-quality fonts are automatically downloaded and used if the client uses a modern browser.

You only need to install one of those libraries. If unsure, choose MathJax.

Optionally, instead of downloading a local copy, you can use MathJax CDN by using this url http://cdn.mathjax.org/mathjax/latest on the configuration page.

To get the cutting edge version of MathJax, checkout the most recent version from the developer's page. In short:

git clone git://github.com/mathjax/MathJax.git

Now move the mathjax directory to your webspace. You can test your installation by going to URL/mathjax/test/

Follow the installation instructions. In short:

1. Download jsMath and extract the zip-file to a directory on your webspace.
2. Optionally download the jsMath Image Fonts and extract the zip-file to the same directory.
3. Optionally install the TeX fonts for jsMath on your local machine.

1. Install the jsmath plugin for DokuWiki using DokuWiki's plugin manager as usual.
2. Go to the DokuWiki Configuration Settings page (available in the admin menu) and set the full URL to your jsMath or MathJax installation. This is the directory to which you installed the JavaScript library in Step 1.
3. Choose whether you want to use jsMath or MathJax.
4. Optionally choose your syntax options (e.g. if you use dollars as currency symbols).

Note: When trying to display latex formulas for the first time, it may help to clear the browser cache. In Firefox, just press 'Ctrl-Shift-R'. Also try adding somewhere in your latex test page the following code to clear DokuWiki's cache:

~~NOCACHE~~

If you want to contribute to this plugin, go to the project page of this plugin or contact Holger.

Please report your issues to the issue tracker.

I've just switched from jsplugin backend to MathJax one: it's awesome ! This plugin together MathJax makes publishing math in dokuwiki a real pleasure. And it is so easy to install both. Thank you very much ! Now that MathJax is in version 1.0.1 I think you should recommend it over jsmath now.

Hi,

When asciisvg is installed, jsmath does not work anymore.

Any workaround? Thanks.

Answer: Please report details to the issue tracker. – Holger.

Hi,

How to set the JsMath backend_url in the plugin setting with the absolute/relative PATH on my server?

If I set it with current IP, it doesn't work when the IP changed.

Any solution? Thanks

Answer: Try dyndns.org. I'm not sure whether relative paths work. – Holger.

Thanks for the excellent plugin! I needed the AMSmath and AMSsymbols extensions so I manually added them to install_js.php as follows.

document.write('<script type="text/javascript" src="<?php echo($backend_url); ?>/MathJax.js">MathJax.Hub.Config({extensions: ["jsMath2jax.js","TeX/AMSmath.js","TeX/AMSsymbols.js"], jax: ["input/TeX", "output/HTML-CSS"] });</script>');

It would be great if there was an option on the configuration page to list extensions that should automatically be loaded. Did I miss it? Thanks.

Some webspaces set an inode limit for the users (maximum number of files and folders) and, if you unzip the MathJax package directly on the server, it take about 36.000 inodes; this number is really high for a lot of free webspaces, then to resolve the issue you can use the cdn network kindly offered by MathJax, by putting the following url in the field “plugin»jsmath»backend_url”:

 http://cdn.mathjax.org/mathjax/latest/