Versions Compared

Old Version 19

changes.mady.by.user Phil Evans

Saved on

compared with

New Version Current

changes.mady.by.user Andy Brook [Plugin People]

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Status
colourGreen
titlesince 1.7.3
The apps rendering of Latex has been done historically though native binary execution, we’ve optimized this process (limiting native renders to first render only) for DC but can understand that requiring and even invoking native binaries as part of page load is not a great solution, so we’re working on supporting a migration of latex macro definitions to our ppl-mathjax variant. You will be able to preview the MathJax rendered output ahead of us supporting a full page content migration, so you can see what impact this could have. See:

  • Latex > Render Migration > Use MathJax Engine

Prerequisites

  1. You must have a working version of TeX installed on your Confluence server

  2. The commands latex and dvipng must be reachable by the $PATH system environment variable.

Both latex and divpng are included in many TeX distributions.

...

The result should be a generated a file named simple.png containing a familiar equation (E=mc^2). Then view the image if it’s a local instance. Which you can view by sftp getting the png file from application node → bastion node → local machine.

Windows Notes

Some Windows users have had difficulty getting dvipng to work. In response to this problem, James Matheson has graciously contributed a mimetex-based version of the plug-in: mimetex-plugin.zip. Thanks, James!

Note that to use the above mimetex version, you will need to ensure that you have a copy of mimetex.exe in the system path. You can find a copy of mimetex.exe in the Mimetex download package at http://www.forkosh.com/mimetex.exe/windows/mimetex.zip.

Shared home Setup

Once you've tested your TeX installation as above, follow these steps to install and configure the LaTeX plug-in. (Note that CONFLUENCE_HOME_DIR should be replaced with the directory specified in your confluence-init.properties file).

...

Server

  1. Create a directory called CONFLUENCE_HOME_DIR/shared-home/latex
    and copy the following files into it:

Info

The properties files you installed in your CONFLUENCE_HOME_DIR/shared-home/latex directory allow the simplification of LaTeX commands in your wiki markup. This is because the header and footer files specify LaTeX commands that are prepended and appended, respectively, to your wiki markup commands.

Also, the properties file includes parameters to send to dvipng to further tailor the image generated.

You won't need to edit these files to use the LaTeX plug-in, although the LaTeX Jedi (you'll know if you are one) won't be able to resist tweaking these files.

...