...
Info |
---|
In order to make this add-on available for recent current versions of Confluence, ownership has been taken on by ([~javahollic]) and my 1.3 branch has been published as v1.3by The Plugin People. The reference to Stepstone remains to give kudos to the original authors. |
...
Tip |
---|
This plug-in can be installed and updated via Confluence's built-in Find new add-ons section under Confluence Administration, or via the LaTeX Plugin listing on the Atlassian Marketplace website. |
Description/Features
Excerpt |
---|
A plug-in for displaying LaTeX in Confluence. It requires a TeX distribution to be installed separately on the server to function. |
Prerequisites
- You must have a working version of TeX installed on your Confluence server
- The commands
latex
anddvipng
must be reachable by the $PATH system environment variable.
Both latex
and divpng
are included in many TeX distributions.
Installation
Linux/Ubuntu Notes
No Format |
---|
sudo apt-get install dvipng sudo apt-get install texlive-latex-base sudo apt-get install texlive-extra-utils sudo apt-get install texlive-math-extra sudo apt-get install mimetex |
There are many many more tex TeX packages you could install and reference...
It's a great idea to test your environment before installing the LaTeX plug-in. Make sure you generate a PNG file from a valid latex file at the command line. For instance, download [LaTeX Plugin^simple.tex] and type the following:
...
This should generate a file named simple.png
containing a familiar equation:
If not, you'll need to troubleshoot your TeX installation before continuing. Try http://www.tug.org/tetex/ and http://sourceforge.net/projects/dvipng/ for more information. (Mac OS X users might prefer the handy MacTeX installation, but be warned that you'll need to add the appropriate /usr/local/teTeX/bin/
subdirectory to your $PATH. And the TeX Users Group recommends the proTeXt package for installing LaTeX on Windows.)
Finally, if you peeked at the [LaTeX Plugin^simplethe simple.tex] file contents, don't be discouraged by its complexity. The LaTeX plug-in simplifies the code you'll need to add to your wiki mark-up.
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!
...
If you just install this add-on without getting Latex installed on your platform (*and visible to the confluence install via path * - a nod to contegix hosted systems), then you may see the following. A secondary cause is not putting the 'latex' folder in the confluence nominated 'confluence.home' location.
To remedy, find, install and make available to the Confluence PATH (and verify the latex folder is in the right place and readable), the location of the latex binary:
...