| Name | LaTeX Plugin |
|---|---|
| Vendor | Stepstone Technologies Inc. (Website) |
| Authors | |
| Homepage | http://confluence.atlassian.com/display/CONFEXT/LaTeX+Plugin |
| Issue Management | n/a |
| Continuous Integration | n/a |
| Categories | Content Macros |
| Most Recent Version | 1.2.1 |
| Availability | Confluence v2.0 to v3.0.0_01 |
| State | Stable |
| Support |
|
| License | Freeware / Open Source (BSD) |
| Price | Free |
| Release Docs | http://confluence.atlassian.com/display/CONFEXT/LaTeX+Plugin |
| Java API Docs | n/a |
| Download Source | https://svn.atlassian.com/svn/public/contrib/confluence/latex-plugin |
| Download JAR | latex-plugin-1.2.1.jar |
| This plug-in can be installed and updated via the Confluence Repository Client. However, see the instructions below for adding the necessary configuration files and installing TeX before using the LaTeX plug-in. |
Description/Features
A plug-in for displaying LaTeX in Confluence. (Requires TeX to be installed separately.)
Prerequisites
- You must have a working version of TeX installed on your Confluence server, and
- The commands latex and dvipng must be reachable by the $PATH system environment variable.
Both latex and divpng are included in many TeX distributions.
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 simple.tex and type the following:
latex simple.tex dvipng simple.dvi
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 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 markup.
Windows Users Take Note
Some 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. Thanks, James! Note that to use the 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
Installation
Once you've tested your TeX installation as above, follow these steps to install the LaTeX plug-in. (Note that CONFLUENCE_HOME_DIR should be replaced with the directory specified in your confluence-init.properties file).
- Install the latex-plugin-1.2.1.jar using the Confluence Plug-in Manager or the Confluence Repository Client.
- Create a directory called CONFLUENCE_HOME_DIR/latex and copy the following files into it:
Usage
| Do not use the 'Rich Text' editor to write LaTeX markup. The rich text editor escapes some of the LaTeX characters, generating unpredictable output. |
In your wiki markup, use the parameter-free {latex} macro to wrap your LaTeX code. For example, to generate the same equation you saw in the simple.tex test above, your wiki markup would look like:
{latex}
\( E=mc^{2} \)
{latex}
which would cause the following to appear in your Confluence page: 
You'll notice that the wiki markup is much simpler than the test example. See the Configuration section below to learn why.
Here is a more complicated example.
Configuration
The properties files you installed in your CONFLUENCE_HOME_DIR/latex directory allow the simplification of LaTeX commands in your wiki markup. This is because the latexheader.tex and latexfooter.tex files specify LaTeX commands that are prepended and appended, respectively, to your wiki markup commands.
Also, the latex.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.
| Please do not specify an output file for the dvipng paramaters in latex.properties, as this disables the LaTeX macro! |
Logging
To turn logging on, add the following text to CONFLUENCE_INSTALL_DIR/confluence/WEB-INF/classes/log4j.properties (replace CONFLUENCE_INSTALL_DIR with your actual installation directory):
#### # LaTeX debug messages #### log4j.logger.com.stepstonetech.confluence.plugins.latex=DEBUG,confluencelog log4j.additivity.com.stepstonetech.confluence.plugins.latex=false
This will print all LaTeX debugging messages to your atlassian-confluence.log file.
To turn logging off, change the word DEBUG to ERROR.
Compatibility
We've successfully used the LaTeX plug-in in Linux and Mac OS X environments with:
- tetex version 3.0
- dvipng versions 1.6 & 1.8
- ava 1.5.0
- Confluence 2.2.4, 2.2.5, and 2.2.9
Version History
| Version | Description |
|---|---|
| latex-plugin-1.2.1.jar | Fixes a minor file-cleanup bug |
| latex-plugin-1.2.jar | Public release of the LaTeX Plug-in |
Tips & Tricks
If you would like to reuse Latex statements several times on a page, or across multiple pages, you may like to start a Latex statement library. Create a page specifically for storing statements and add a child page for each statement. Then use the Include Page macro to embed those statement pages wherever they are needed.


Comments (77)
Feb 15, 2007
James Matheson says:
Has anyone installed this on a Windows server? And if so, how did they do it?Has anyone installed this on a Windows server? And if so, how did they do it?
Feb 15, 2007
Darryl Duke says:
The TeX Users Group recommends the proTeXt for installing LaTeX on Windows.The TeX Users Group recommends the proTeXt for installing LaTeX on Windows.
Mar 01, 2007
Dirk Ringe says:
We just successfully installed the plugin on a windows server 2003 utilizing mik...We just successfully installed the plugin on a windows server 2003 utilizing miktex. It runs fine so far but we have two issues:
Mar 27, 2007
Matt Jones says:
Has anyone found a solution to the first bullet point here? I'm having the exact...Has anyone found a solution to the first bullet point here? I'm having the exact same issue and it's a show stopping bug for us. I've played around with the permissions of the temp directories and it didn't help at all.
Aug 03, 2007
Bert Pluymers says:
I think I found a workaround for the first problem mentioned above. After some ...I think I found a workaround for the first problem mentioned above.
After some investigations I found that dvipng does not produce correct png files when encountering new symbols. If you run dvipng again it seems to do things right.
To work around this problem I created a simple .exe file in VB that runs dvipng twice. I trick confluence in using this new .exe file by renaming the original dvipng.exe to _dvipng.exe and naming this VB application dvipng.exe
The downside is of course that the conversion takes somewhat longer.
I use confluence 2.5.4 and miktex 2.6, which includes dvipng 1.9.
Feb 07, 2008
Darryl Duke says:
Please see the "Windows Users Take Note" section above. James Matheson has kindl...Please see the "Windows Users Take Note" section above. James Matheson has kindly contributed a mimetex version of the plug-in to get around problems with dvipng on Windows. Thanks, James!
May 19, 2008
Ian Pottier says:
Hi, If you run confluence as a service under another account than "LocalSystem"...Hi,
If you run confluence as a service under another account than "LocalSystem" then dvipng does not hang. I believe that this problem comes from the environment which is inherited from confluence (and not explicitely set when spawning the dvipng process). Does someone have any idea of which (missing) part of the environment could make dvipng hang?
mimetex plugin works otherwise fine, but is not quite as good looking in the rendering...
BR
Jun 03, 2008
Jamie says:
I have MikTex 2.7 installed and working on a Confluence 2.7.3 server (runni...I have MikTex 2.7 installed and working on a Confluence 2.7.3 server (running Windows and Websphere 6.1). This was installed because proText was recommended for Windows and it has you install MikTex. I can run the samples above from the command line and they work correctly. Then, I installed the Latex plugin and it did not work - the page hangs when I try to view any page using the latex macro.
I saw the note to Windows users above and installed the Mimetex plugin (in addition to the Latex plugin, although I've tried removing it also and no difference). I can run mimetex.exe successfully from the command line. I put mimetex.exe into the Java bin folder on the server and made sure that the folder is in the system PATH variable. Still... the pages with latex macros hang and will not display.
Can anyone tell me what I might be missing to get this plugin to work in Windows?
Thanks, Jamie
Feb 15, 2007
Carter M. Snowden says:
Thanks. Installed on our test server (running v. 2.2/Linux/Tomcat ) and it looks...Thanks. Installed on our test server (running v. 2.2/Linux/Tomcat ) and it looks good.
This has been a much requested feature at our institution.
Feb 19, 2007
David Aldrich says:
To display math equations, we have used MimeTex (http://www.forkosh.com/mim...To display math equations, we have used MimeTex (http://www.forkosh.com/mimetex.html) as a CGI on our server. Does the LateX plugin use a same approach?
Can the equations be exported to HTML/PDF?
It would be nice if your example worked live rather than show a png.
Feb 19, 2007
Darryl Duke says:
I believe there are two main differences between mimeTeX and this plug-in. (1) F...I believe there are two main differences between mimeTeX and this plug-in. (1) From their site: "mimeTeX is an entirely separate little program that doesn't use TeX or its fonts in any way." It's a single cgi installation, which simplifies the install a bit. The downside is that it's not the official or full TeX implementation. (2) To display equations with mimeTeX, you need to write something like: <img src="/cgi-bin/mimetex.cgi?x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}"> in the HTML, which would require someone to write a macro to generate it.
As for exporting LaTeX Plug-in equations, the following are supported: (1) exporting space as PDF, and (2) when printing a screen using the browser's print page. (It doesn't currently export equations when exporting space as HTML.)
Perhaps the folks at Confluence would consider installing LaTeX and this plug-in to support live examples here. I'll try to find time this week to set up a demo space on the stepstonetech.com site.
Feb 20, 2007
David Ruddock says:
The confluence bug that prevents image plugins from exporting to .doc or .html i...The confluence bug that prevents image plugins from exporting to .doc or .html is tracked here:
[CONF-7601] - Macro plugins which produce images are not able to export to .doc or .html formats
Please vote for it to be fixed.
May 27, 2008
Don Willis says:
That bug is now fixed.That bug is now fixed.
Mar 21, 2007
Frederico Guth says:
I have had a hard time trying to insall Latex Plugin in Windows environment unsu...I have had a hard time trying to insall Latex Plugin in Windows environment unsuccessfully .
My Latex distribution is MikTex (I know there are a recommendation for ProTeX, but I already had MikTex installed and working).
The problem seems to be in dvipng (version 1.8). When I try to convert simple.dvi to simple.png it generates a 1kb png 1 pixel squared (just a dot). I had never have to use dvipng. Does anyone have a clue why?
Mar 22, 2007
Frederico Guth says:
I finally found another dvipng and it worked with windows.I finally found another dvipng and it worked with windows.
Jun 28, 2007
Egon Kuster says:
I found that I needed to edit the latex.properties file to change the word 'tran...I found that I needed to edit the latex.properties file to change the word 'transparent' to 'Transparent' (note capital T). This then seemed to fix the problem. Very weird.
Aug 15, 2007
Kjetil Frydenlund says:
I find same thing pretty weird. In the test environment, I changed 'transparent'...I find same thing pretty weird. In the test environment, I changed 'transparent' to 'Transparent' and it worked out after some configuration. When I later copied the configuration files to production environment, I had to change back to 'transparent' without capital T to get it to work. I wonder why a change to the tolatex.properties file is needed?
Mar 31, 2007
Reinhard Simon says:
This seems to be a very useful plugin. Is the source code available? The subvers...This seems to be a very useful plugin. Is the source code available? The subversion directory has only *.class files in the .jar file.
Thanks,
Reinhard
Jun 28, 2007
Egon Kuster says:
quick bug. If the dvipng does not respond or the users cancels an operation then...quick bug. If the dvipng does not respond or the users cancels an operation then it will leave running dvipng processes running and therefore possibly consuming all the system resources. In addition the Confluence Home Temp directory becomes littered with temporary files.
Jun 29, 2007
Vipan Bahl says:
Hi I installed the TEX live plugin as part of the prerequisite and when i test ...Hi
I installed the TEX live plugin as part of the prerequisite and when i test this i get the dvipng not found error, i understand that this should be part of the texlive install but it does not look like unless i am wrong or missing out something.Can anyone help me with this .Also i downloaded the dvipng 1.9 tar file and get error trying to compile to get the binaries created , any help on either will be really helpfull to me in installing this and making use of latex plugin.
Thanks
Sep 11, 2007
Michael Ogrinz says:
No joy here, either. I've installed proTeXt, and verified the system path settin...No joy here, either. I've installed proTeXt, and verified the system path settings (I can run the above sample with no problems). But my pages still say they can't find latex. Restarting the server is no help. This is what I have in the logs:
debugMsg Finished writing LaTeX markup to: LaTeX41494.tex
debugMsg The tex file should be created and called: LaTeX41494tex
debugMsg Creating a a new dvi file from the tex file using the command: latex
debugMsg Running the process: latex
debugMsg Using the arguments:
debugMsg ... arg 1 = -interaction=batchmode
debugMsg In working directory: D:\confluence\data\temp
debugMsg Started cleaning up all generated files from the conversion process.
debugMsg Removing generated file: LaTeX41494.tex
debugMsg Finished cleaning up all generated files from the conversion process.
debugMsg Unable to run latex. Please make sure latex is in the system PATH and can be run using the commandline.
debugMsg CreateProcess: latex -interaction=batchmode D:\confluence\data\temp\LaTeX41494.tex error=2
Sep 23, 2007
Dirk Bethe says:
Michael, The Latex file is generated and the plugin looks for lates.exe in your...Michael,
The Latex file is generated and the plugin looks for lates.exe in your PATH but doesn't find it. If the sample files work on the command line then your latex is installed for a user. You've probably updated a User PATH and not the the System PATH.
Check that latex is in the System PATH and restart Tomcat
Sep 24, 2007
Michael Ogrinz says:
Nope - it's definitely on the system path (server restart didn't help). My users...Nope - it's definitely on the system path (server restart didn't help). My users really want this - does anyone have any other ideas?
Sep 24, 2007
Chris Marshall says:
Hi - I've followed the directions and installed LaTeX and dvipng, tried the sam...Hi -
I've followed the directions and installed LaTeX and dvipng, tried the sample simple.tex example (all worked OK, except the output of the dvipng command was simple1.png, not simple.png) but it is nopt working when I use it:
2007-09-24 15:49:59,954 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg Creating a a new png file from the dvi file using the command: dvipng
2007-09-24 15:49:59,983 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg Running the process: dvipng
2007-09-24 15:49:59,985 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg Using the arguments:
2007-09-24 15:49:59,986 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg ... arg 1 = -T
2007-09-24 15:49:59,988 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg ... arg 2 = tight
2007-09-24 15:49:59,989 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg ... arg 3 = -bg
2007-09-24 15:49:59,990 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg ... arg 4 = transparent
2007-09-24 15:49:59,992 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg ... arg 5 = -o
2007-09-24 15:49:59,993 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg ... arg 6 = /nfs/arbitrage/statarb/gsatrader/runtime/confluence-2.5.4/data/temp/LaTeX24226.png
2007-09-24 15:49:59,994 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg In working directory: /nfs/arbitrage/statarb/gsatrader/runtime/confluence-2.5.4/data/temp
2007-09-24 15:50:00,221 DEBUG [http-8087-Processor1] [confluence.plugins.latex.LatexMacro] debugMsg Process failed with exit code: 134
Do you have any ideas about this?
Oct 14, 2007
Tom Wilger says:
Great plugin!! I was able to get it up on my linux system pretty fast. I...Great plugin!! I was able to get it up on my linux system pretty fast. I put some LaTeX code in on a page and it worked. I then logged out then logged back in, went to the page and things kind of hung. Eventually, I had to restart my confluence server. Unfortunately, when I went back to the page with my LaTeX code in it I got this:
When I run latex or dvipng from the command line it works fine. Any thoughts?
Oct 14, 2007
Tom Wilger says:
I turned on debugging and got this (see my problem above) 2007-10-14 15:36:29,9...I turned on debugging and got this (see my problem above)
2007-10-14 15:36:29,975 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg Finished writing LaTeX markup to: LaTeX44540.tex
2007-10-14 15:36:29,976 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg The tex file should be created and called: LaTeX44540tex
2007-10-14 15:36:29,978 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg Creating a a new dvi file from the tex file using the command: latex
2007-10-14 15:36:29,979 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg Running the process: latex
2007-10-14 15:36:29,981 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg Using the arguments:
2007-10-14 15:36:29,982 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg ... arg 1 = -interaction=batchmode
2007-10-14 15:36:29,984 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg In working directory: /opt/confluence/temp
2007-10-14 15:36:30,018 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg Started cleaning up all generated files from the conversion process.
2007-10-14 15:36:30,022 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg Removing generated file: LaTeX44540.tex
2007-10-14 15:36:30,024 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg Finished cleaning up all generated files from the conversion process.
2007-10-14 15:36:30,025 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg Unable to run latex. Please make sure latex is in the system PATH and can be run using the commandline.
2007-10-14 15:36:30,027 DEBUG [TP-Processor3] [confluence.plugins.latex.LatexMacro] debugMsg java.io.IOException: Cannot allocate memory
Oct 17, 2007
River Tarnell says:
i notice that this plugin allows any latex command, including ones like \input{}...i notice that this plugin allows any latex command, including ones like \input{}, which seems like a possible security issue... is there any way to disable that?
Nov 21, 2007
Tiffany Bartlett says:
I'm using Confluence 2.6.0, and I'm getting weird spacing when I export LaTeX to...I'm using Confluence 2.6.0, and I'm getting weird spacing when I export LaTeX to PDF. Any thoughts?
Thanks!
Apr 30, 2008
Jeff Tanner says:
LaTeX: Fonts I am having problems with some LaTeX commands that deal with Fonts...LaTeX: Fonts
I am having problems with some LaTeX commands that deal with Fonts
This works:
{latex} \Large\textsl{Hello} {latex}But these fail:
Error in LaTeX formatting.
This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6) (format=latex 2008.4.11) 30 APR 2008 09:59
entering extended mode
%&-line parsing enabled.
**/mnt/operations/backups/confluence/data-v251/temp/LaTeX23376.tex
(/mnt/operations/backups/confluence/data-v251/temp/LaTeX23376.tex
LaTeX2e <2005/12/01>
{latex} \textcolor{red}{Hello} {latex}! Undefined control sequence.
l.13 \textcolor
{red}
{Hello}
{latex} \usepackage{antiqua} \Large\textsl{Hello} {latex}! LaTeX Error: Can be used only in preamble.
l.13 \usepackage
{antiqua}
Your command was ignored.
Ideas ???
May 01, 2008
Cliff Brown says:
I am having trouble displaying large elements of LaTeX on my pages. Ater c...I am having trouble displaying large elements of LaTeX on my pages. Ater comparing the image of my code rendered through an external LaTeX processor, to the code generated using this plugin, it appears that my rendered LaTeX takes up two pages and only the image of the second page is being displayed. Does anyone have suggestions as to why this would happen, and whether there is a solution to it.
May 01, 2008
Tiffany Bartlett says:
The way the LaTeX plugin works is it turns the actual LaTeX output into a .png f...The way the LaTeX plugin works is it turns the actual LaTeX output into a .png file and inserts that into the page. The maximum size of the image is about a page, so the easiest work around for this problem is to divide your page into two sections and wrap both in {latex}.
Jun 20, 2008
Fedor says:
I'm trying to export a page with an inline latex expression. When I export to pd...I'm trying to export a page with an inline latex expression. When I export to pdf a new line is inserted after the rendered picture. Does anybody know how to avoid this?
I have the following dvipng settings:
dvipng.parameters=-T;tight;-bg;Transparent
Jun 24, 2008
Tiffany Bartlett says:
Are there any plans now for changing this plugin so that the latex automatically...Are there any plans now for changing this plugin so that the latex automatically appears in exports to Word docs?
I raised a support ticket for this a while ago, and was told that the developers would need to fix this issue by reading this: http://confluence.atlassian.com/pages/viewpage.action?pageId=107185152.
Thanks!
Aug 01, 2008
kubo44 says:
How can i cache rendered images? I have more expressions on one page and it take...How can i cache rendered images? I have more expressions on one page and it takes long time to render every time. Logical would be update rendered images after clicking save button, not every view of the page. Thank you for tip.
Aug 01, 2008
Bob Swift says:
Cache PluginCache Plugin
Aug 03, 2008
kubo44 says:
Thanx Bob, i installed the plugin but it doesn't work with Latex Plugin (Conflue...Thanx Bob, i installed the plugin but it doesn't work with Latex Plugin (Confluence 2.8.0, Cache Plugin 3.1.0, Linux server, Firefox on win client). I tried simple example, but i get empty square without image. What am i doing wrong?
{cache}
{latex}
\ ( E=mc^{2} \ )
{latex}
{cache}
Latex Plugin is working, but when i add cache around it, it doesn't work.
Sep 03, 2008
Andy Brook says:
Can someone confirm what platform this instance of Confluence runs on, and what ...Can someone confirm what platform this instance of Confluence runs on, and what Tex distro is being used? Im running into problems with the Complex example. I was using MikTex2.6/win32 but have had to use mimetex to fix problems with even simple markup. (Protex 500MB+ download is underway :/).
Nov 18, 2008
Ryan Tetzlaff says:
I'm having the same issue that Jamie (above) is having- I'm running Windows...I'm having the same issue that Jamie (above) is having-
I'm running Windows 2003 server - I follow the instructions by installing ProText and verify it works by using the sample tex file given. Everything seems to work fine on the server side. I then try to use the macro in a page and the page locks up when I try to access it. I am using dvipng - which seemed to work fine from the command line.
Should I try the mimetex version of the plugin? If so, what do I need to do - just take the JAR file from the mimetex zip and upload it to the repository? I'm confused....
Nov 21, 2008
David Tawse says:
I echo Ryan's comments. I'm new to Confluence and I'm having trouble getting thi...I echo Ryan's comments. I'm new to Confluence and I'm having trouble getting this to work on a Windows 2003 SBS with IIS environment. I tried installing with MiKTeX and can successfully run the simple test from the command line. However, any pages with latex markup added hang when attempting to access leaving dvipng processes running.
I'd like to try the mimetex solution suggested but I'm not sure how to proceed. Could someone please provide clear instructions on how to implement the mimetex solution?
Thanks.
Dec 22, 2008
Andy Brook says:
Better late than never... Goto the Mimetex page, 90% down there is a binary do...Better late than never...
Goto the Mimetex page, 90% down there is a binary download page, choose whats appropriate for your server OS (the plugin will just do a native call to the mimetex(.exe) application). Put the binary on the path that can be found by the process that launched Confluence. In windows maybe C:\windows\system32, on linux, maybe /usr/local/bin.
The plugin is inside a zip attached to this page, download and extract, get the mimetex-1.0-SNAPSHOT.jar from target, and upload through the admin console (plugin repository/browse for jar).
that should just work.
Jan 08
David Tawse says:
Thanks very much for the info, Andy. It seems to be working for the mostpart now...Thanks very much for the info, Andy. It seems to be working for the mostpart now although dvipng.exe seems to still hang occassionally and lock the page.
On a different note, are there any resources that you can point me to that will help my clients learn/use the LaTeX markup?
Jan 08
Andy Brook says:
latex-project intro and guide wikibooks hope that helps, ttfn.hope that helps, ttfn.
Dec 22, 2008
Hicham Mouline says:
all works fine. subscripting, vertical division ... However, I fail to use greek...all works fine. subscripting, vertical division ...
However, I fail to use greek letters like \alpha
Jan 08
Andy Brook says:
symbols-a4.pdf Typing Math {latex} $\alpha$ {latex}{latex} $\alpha$ {latex}Feb 05
Hicham Mouline says:
thanks.... I'm looking now for partial derivative, tilted d.thanks.... I'm looking now for partial derivative, tilted d.
Feb 08
coatespt says:
I hope this is the right place for a question on utility of this plugin. Is the ...I hope this is the right place for a question on utility of this plugin. Is the scenario described below a reasonable thing to ask of this plugin?---perhaps if the answer is in the negative, someone could suggest a better way to attack this problem in the Confluence world. Thanks in advance for any opinions and advice.
I have an already-existing 300 page book written in LaTex. I want to create a wiki version of the book which would be isomorphic with the original in terms of chapters, sections, illustrations, etc., but would allow user-supplied enhancements, comments, etc. that would ultimately be folded back into the original document for physical publication in succeeding versions. In other words, the physical book would evolve along with the site, but would not be a direct function of the raw user input.
Virtually no public user in the target audience will understand LaTex or Tex. Using confluence will be a stretch for most. Thus, user input would be ordinary comments, new pages, etc, not LaTex. Professional editors would ultimately fold the content back into a definitive LaTex version for physical publication, but ideally the conversion from book to wiki would be automated with a script
Is this a realistic use of Confluence plus this plugin, or is it a pipe dream?
Feb 12
Andy Brook says:
Hello, prior to the version I just added, you probably would not have been able...Hello,
prior to the version I just added, you probably would not have been able to accomplish this. Even with the changes added, in theory, yes it could work, but its an awful lot of splicing and dicing. My gut says this is possible asking too much, but being a LaTeX jedi, try one page, prove me wrong.
Feb 12
coatespt says:
Thanks--an extremely helpful answer. I was hoping for "it's a no-brainer" but a ...Thanks--
an extremely helpful answer. I was hoping for "it's a no-brainer" but a realistic assessment is the next best thing. We're not a tech company so any solution can't be radically harder than vanilla confluence (which is gratifyingly easy.) But there are many ways to skin a latex cat-I'll let you know what happens. Maybe latex, to html, to confluence.Feb 12
Andy Brook says:
As you mention it, hosting the Html offsite, perhaps a simple CGI with a page pa...As you mention it, hosting the Html offsite, perhaps a simple CGI with a page parameter? you could then use HTML Include Replace to embed the HTML in Confluence saving a whole heap of manual editing. maybe.
Feb 09
Andy Brook says:
Anyone from Stepston monitoring? A useful feature would be to enable the dynami...Anyone from Stepston monitoring?
A useful feature would be to enable the dynamic addition of more packages, as the current plugin only allows those latex packages defined in the header.ext file (amsmath, amsthm, amssymb, bm). Given the massive number of packages, something like the following + some parsing /splicing into the existing header would expand the usefulness of the plugin.
{latex:packages=textcomp} \texteuro {latex}Well, curiosity got the better of me, I've just checked out the code and done this, when I get it tested should I tag a branch including the fix for review?
Feb 12
Andy Brook says:
I've created a branch of the main plugin code, and made the following enhancemen...I've created a branch of the main plugin code, and made the following enhancements/changes. The authors should indicate if they want it in trunk. These changes enables much more access to Latex packages - however, you mileage will definitely vary.
The 1.3-SNAPSHOT jar is not in the plugin repository so you'll need to download and install manually to test it.
Macro parameter examples
Additional Packages
{latex:packages=textcomp} \texteuro {latex}Raw Markup Entry
{latex:rawMarkup=true} \documentclass{article} \usepackage{color} \pagestyle{empty} \begin{document} \fontsize{22}{28}\selectfont \color{red}\( E=mc^{2} \) \end{document} {latex}Render Timeout
{latex:renderTimeout=5000|rawMarkup=true} \documentclass{article} \usepackage{color} \usepackage{mnsymbol} \usepackage{textcomp} \usepackage{undertilde} \pagestyle{empty} \begin{document} \color{blue} \texteuro $\utilde{abc}$ $\boxbackslash \filledmedtriangledown \pentagram \iiiint \oiint$ \end{document} {latex}Feb 26
David Demner says:
I finally got this to work with MiKTeX 2.7. The key was to go to MiKTex settings...I finally got this to work with MiKTeX 2.7. The key was to go to MiKTex settings and on the first tab change "Install missing packages on the fly" to Yes. Otherwise it often hangs when looking at pages with {latex} tags
Feb 26
Darryl Duke says:
David, thanks very much for resolving this elusive problem!David, thanks very much for resolving this elusive problem!
Mar 10
Brian Carr says:
Disregard comment...I figured out what was wrong. Still having problems, but I t...Disregard comment...I figured out what was wrong. Still having problems, but I think they are more in line with the comments above.
Mar 12
John Baker says:
Hello, I took the 1.2.1 branch and added ehcache support because running the La...Hello,
I took the 1.2.1 branch and added ehcache support because running the LaTeX command over and over again wasn't practical in any production system. I've also got a maven 2 pom.xml file to build the plugin (I pinched it from graphviz!).
How do I go about submitting this back to the project?
John
Mar 12
Andy Brook says:
Hey John, I'd like to pull that into my branch also if it offers performance im...Hey John,
I'd like to pull that into my branch also if it offers performance improvements. Why not just commit in the branches SVN folder? Im not sure the original developers are monitoring any more.
Apr 08
Turing Eret says:
Any word on how this is going? Caching the rendered latex would be awesome as t...Any word on how this is going? Caching the rendered latex would be awesome as this plugin is currently unusable for any sort of production and ASCII Math doesn't quite work for me as latex can do far more.
Apr 08
Andy Brook says:
Nothing has been done in that area as John hasn't committed any code as yet.Nothing has been done in that area as John hasn't committed any code as yet.
Mar 12
Keith Brunton says:
Hi, This may be of interest to people here who are interested in the Math side o...Hi,
This may be of interest to people here who are interested in the Math side of things.
A while back I tested the Latex-plugin soln for Math in Confluence and felt it was too brittle and resource hungry. So for our institution instance of Confluence I developed a plugin that is based on Peter Jipsen's ASCIIMath (with image alternatives (mathTex) for non-MathML capable browsers) that works well for Edinburgh University. Math markup {math} is inline by default but there are markup options for block-level display and labels.
When I get time (been saying this for over a year) I'll go through the process of adding it to the repository here. In the meantime, you can download it from here:
http://www.ph.ed.ac.uk/~kbrunton/confluence/asciimath/plugins-asciimath.jar
The download contains a readme on how to install, use, etc. Current version is v1.09. You can see a comprehensive test page showing the features here:
https://www.wiki.ed.ac.uk/display/CONF25/ASCII+Math+Help
Tested on:
Confluence: Versions 2.6.x, 2.10.1.
with
Mozilla 1.5.x 2.x, IE 6, 7.0 (MathPlayer), Opera 9, Safari 3.x (image-fallback) on Windows
Mozilla 1.5.x 2.x, Safari 3.x (image-fallback) on Mac
Mozilla 1.5x, 2.0x on Linux
Regards,
Keith Brunton
Mar 12
Andy Brook says:
Looks very useful, I know a bunch of people in my co who will love it. Let me k...Looks very useful, I know a bunch of people in my co who will love it. Let me know if you need a hand getting the plugin setup sooner than later.
Mar 13
Brian Carr says:
Keith, I have downloaded the file (and unzipped), but I do not see any sort of ...Keith,
I have downloaded the file (and unzipped), but I do not see any sort of readme file with installation instructions. But I am anxious to give it a try. Would you be able to post the installation instructions separately? Or update https://www.wiki.ed.ac.uk/display/CONF25/ASCII+Math+Help to include some information on how to install?
Thanks,
Brian Carr
Mar 13
Keith Brunton says:
Hi Brian, Apologies - this was my mistake in my original posting. I'm working ...Hi Brian,
Apologies - this was my mistake in my original posting.
I'm working with Andy Brook to get this plugin into shape where it can be made available more generally.
In the meantime, I've temporarily made available an install doc here: http://www.ph.ed.ac.uk/~kbrunton/confluence/asciimath/readme.txt - the jar file mentioned above is a standard plugin jar but there is an extra manual inclusion of some javascript (and css) reqd to get it working - see the readme.txt for what I mean. I'm hoping that with Andy's expertise that this manual step can be removed soon.
I hope this helps,
Keith
Mar 13
Brian Carr says:
Thanks Keith, This should help a lot! I look forward to spending some time with...Thanks Keith,
This should help a lot! I look forward to spending some time with this, and I'll let you know how it turns out.
Appreciate the help!
Brian
Mar 17
Andy Brook says:
For anyone wanting simple math markup, the Math (ASCIIMath) plugin is no...For anyone wanting simple math markup, the Math (ASCIIMath) plugin is now available in the plugin repository. It also now dynamically loads the javascript resources so no custom html is required (removing the extra http ping on pages that don't use the plugin). Ive got it installed here and its working fine with IE6/IE7 and FF3. Thanks to Keith for bringing this forward!
Apr 17
Hicham Mouline says:
I have this formula {latex} \( x = {\ln {X \over F} \over T^\alpha }\) {...I have this formula
{latex} \( x = {\ln {X \over F} \over T^\alpha }\) {latex}It is rendered too small however. How can I make it look bigger?
rds,
Apr 17
Andy Brook says:
For starters you may have to use the branched version listed above. This then a...For starters you may have to use the branched version listed above. This then allows full control over latex body content, and allows for font size changes, as shown in the same comment.
Apr 21
Ming Yu says:
Hi - I am new to confluence wiki. Just installed latex plugin with conflu...Hi -
I am new to confluence wiki. Just installed latex plugin with confluence 2.7.3 with Apache Tomcat 5.5.20, teTeX 3.0, on a Solaris system. I got this message (Unable to find DVI conversion log file.
) in the log, and any advise will be appreciated.
2009-04-21 09:01:16,795 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg Writing the LaTeX body:
( E=mc^
)
2009-04-21 09:01:16,799 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg Writing the LaTeX footer:
\end
2009-04-21 09:01:16,804 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg Finished writing LaTeX markup to: LaTeX20412.tex
2009-04-21 09:01:16,808 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg The tex file should be created and called: LaTeX20412tex
2009-04-21 09:01:16,812 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg Creating a a new dvi file from the tex file using the command: latex
2009-04-21 09:01:16,816 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg Running the process: latex
2009-04-21 09:01:16,820 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg Using the arguments:
2009-04-21 09:01:16,824 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg ... arg 1 = -interaction=batchmode
2009-04-21 09:01:16,828 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg In working directory: /usr/local/data/confluence-2.7.3/temp
2009-04-21 09:01:17,234 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg Process failed with exit code: 9
2009-04-21 09:01:17,251 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg Unable to find DVI conversion log file.
2009-04-21 09:01:17,257 DEBUG [TP-Processor7] [confluence.plugins.latex.LatexMacro] debugMsg /usr/local/data/confluence-2.7.3/temp/LaTeX20412.log (No such file or directory)
May 01
Andy Brook says:
Is there a plugin maintainer monitoring this page? Id like to get the 1.3 branc...Is there a plugin maintainer monitoring this page? Id like to get the 1.3 branch I did made the official version, any care to test and indicate acceptability?
May 29
kalyan says:
Hi we r using Confluence-2.8.2 on WindowsXP environment.Is this plugin is compat...Hi we r using Confluence-2.8.2 on WindowsXP environment.Is this plugin is compatible for our confluence?
I followed all the instalation and configuration part and
I tried following code, but it is showing some formatting error.
"{latex}
\documentclass[12pt]{article}%We have defined the document to be an article useing 12 pt font
%Blank lines mean nothing here in the preamble.
\begin{document}
\section{This is a Section}\subsection{This is a subsection}This is the body of the subsection.
I can move to a new line anytime, and I can put in lots of
blanks with no effect.
Skipping four lines is the same as skipping one line
-------- it starts a new paragraph.
\subsection{Here is another subsection}\section{Here is another section}\end{document}
{latex} "
I tried same latex code using command prompt.It has given output fine.
Would u please help me in this case?
Thank you,
regards,
Kalyan
May 29
Andy Brook says:
Showing the latex error might help...Showing the latex error might help...
Jun 01
kalyan says:
The error is like this "Error in LaTeX formatting. This is pdfTeX, Version 3.1...The error is like this
"Error in LaTeX formatting.
This is pdfTeX, Version 3.1415926-1.40.9 (MiKTeX 2.7) (preloaded format=latex 2009.1.19) 1 JUN 2009 08:20
entering extended mode
**D:/Program*Files/Confluence-Home/temp/LaTeX30377.tex
("D:/Program Files/Confluence-Home/temp/LaTeX30377.tex"
LaTeX2e <2005/12/01>
Babel and hyphenation patterns for english, dumylang, nohyphenation, ge
rman, ngerman, german-x-2008-06-18, ngerman-x-2008-06-18, french, loaded.
("C:\Program Files\MiKTeX 2.7\tex\latex\base\article.cls"
Document Class: article 2005/09/16 v1.4f Standard LaTeX document class
("C:\Program Files\MiKTeX 2.7\tex\latex\base\size10.clo"
File: size10.clo 2005/09/16 v1.4f Standard LaTeX file (size option)
)
\c@part=\count79
\c@section=\count80
\c@subsection=\count81
\c@subsubsection=\count82
\c@paragraph=\count83
\c@subparagraph=\count84
\c@figure=\count85
\c@table=\count86
\abovecaptionskip=\skip41
\belowcaptionskip=\skip42
\bibindent=\dimen102
) ("C:\Program Files\MiKTeX 2.7\tex\latex\amsmath\amsmath.sty"
Package: amsmath 2000/07/18 v2.13 AMS math features
@mathmargin=\skip43
For additional information on amsmath, use the `?' option.
("C:\Program Files\MiKTeX 2.7\tex\latex\amsmath\amstext.sty"
Package: amstext 2000/06/29 v2.01
("C:\Program Files\MiKTeX 2.7\tex\latex\amsmath\amsgen.sty"
File: amsgen.sty 1999/11/30 v2.0
@emptytoks=\toks14
\ex@=\dimen103
)) ("C:\Program Files\MiKTeX 2.7\tex\latex\amsmath\amsbsy.sty"
Package: amsbsy 1999/11/29 v1.2d
\pmbraise@=\dimen104
) ("C:\Program Files\MiKTeX 2.7\tex\latex\amsmath\amsopn.sty"
Package: amsopn 1999/12/14 v2.01 operator names
)
\inf@bad=\count87
LaTeX Info: Redefining \frac on input line 211.
\uproot@=\count88
\leftroot@=\count89
LaTeX Info: Redefining \overline on input line 307.
\classnum@=\count90
\DOTSCASE@=\count91
LaTeX Info: Redefining \ldots on input line 379.
LaTeX Info: Redefining \dots on input line 382.
LaTeX Info: Redefining \cdots on input line 467.
\Mathstrutbox@=\box26
\strutbox@=\box27
\big@size=\dimen105
LaTeX Font Info: Redeclaring font encoding OML on input line 567.
LaTeX Font Info: Redeclaring font encoding OMS on input line 568.
\macc@depth=\count92
\c@MaxMatrixCols=\count93
\dotsspace@=\muskip10
\c@parentequation=\count94
\dspbrk@lvl=\count95
\tag@help=\toks15
\row@=\count96
\column@=\count97
\maxfields@=\count98
\andhelp@=\toks16
\eqnshift@=\dimen106
\alignsep@=\dimen107
\tagshift@=\dimen108
\tagwidth@=\dimen109
\totwidth@=\dimen110
\lineht@=\dimen111
@envbody=\toks17
\multlinegap=\skip44
\multlinetaggap=\skip45
\mathdisplay@stack=\toks18
LaTeX Info: Redefining [ on input line 2666.
LaTeX Info: Redefining ] on input line 2667.
) ("C:\Program Files\MiKTeX 2.7\tex\latex\amscls\amsthm.sty"
Package: amsthm 2004/08/06 v2.20
\thm@style=\toks19
\thm@bodyfont=\toks20
\thm@headfont=\toks21
\thm@notefont=\toks22
\thm@headpunct=\toks23
\thm@preskip=\skip46
\thm@postskip=\skip47
\thm@headsep=\skip48
\dth@everypar=\toks24
) ("C:\Program Files\MiKTeX 2.7\tex\latex\amsfonts\amssymb.sty"
Package: amssymb 2002/01/22 v2.2d
("C:\Program Files\MiKTeX 2.7\tex\latex\amsfonts\amsfonts.sty"
Package: amsfonts 2001/10/25 v2.2f
\symAMSa=\mathgroup4
\symAMSb=\mathgroup5
LaTeX Font Info: Overwriting math alphabet `\mathfrak' in version `bold'
(Font) U/euf/m/n --> U/euf/b/n on input line 132.
)) ("C:\Program Files\MiKTeX 2.7\tex\latex\tools\bm.sty"
Package: bm 2004/02/26 v1.1c Bold Symbol Support (DPC/FMi)
\symboldoperators=\mathgroup6
\symboldletters=\mathgroup7
\symboldsymbols=\mathgroup8
LaTeX Font Info: Redeclaring math alphabet \mathbf on input line 137.
LaTeX Info: Redefining \bm on input line 203.
)
No file LaTeX30377.aux.
LaTeX Font Info: Checking defaults for OML/cmm/m/it on input line 11.
LaTeX Font Info: ... okay on input line 11.
LaTeX Font Info: Checking defaults for T1/cmr/m/n on input line 11.
LaTeX Font Info: ... okay on input line 11.
LaTeX Font Info: Checking defaults for OT1/cmr/m/n on input line 11.
LaTeX Font Info: ... okay on input line 11.
LaTeX Font Info: Checking defaults for OMS/cmsy/m/n on input line 11.
LaTeX Font Info: ... okay on input line 11.
LaTeX Font Info: Checking defaults for OMX/cmex/m/n on input line 11.
LaTeX Font Info: ... okay on input line 11.
LaTeX Font Info: Checking defaults for U/cmr/m/n on input line 11.
LaTeX Font Info: ... okay on input line 11.
! LaTeX Error: Can be used only in preamble.
See the LaTeX manual or LaTeX Companion for explanation.
Type H for immediate help.
...
l.13 \documentclass
[12pt]{article}
Your command was ignored.
Type I to replace it with another command,
or to continue without it.
! LaTeX Error: Can be used only in preamble.
See the LaTeX manual or LaTeX Companion for explanation.
Type H for immediate help.
...
l.18 \begin{document}
Your command was ignored.
Type I to replace it with another command,
or to continue without it.
[1
] (LaTeX30377.aux) )
(\end occurred inside a group at level 1)
### semi simple group (level 1) entered at line 18 (\begingroup)
### bottom level
Here is how much of TeX's memory you used:
1197 strings out of 95305
12485 string characters out of 1183059
59899 words of memory out of 1500000
4455 multiletter control sequences out of 110000
4850 words of font info for 18 fonts, out of 3000000 for 5000
14 hyphenation exceptions out of 8191
27i,4n,24p,263b,133s stack positions out of 5000i,500n,10000p,200000b,50000s
Output written on LaTeX30377.dvi (1 page, 748 bytes).
LaTeX Markup:
\documentclass[12pt]{article}
%We have defined the document to be an article useing 12 pt font
%Blank lines mean nothing here in the preamble.
\begin{document}
\section{This is a Section}
\subsection{This is a subsection}
This is the body of the subsection.
I can move to a new line anytime, and I can put in lots of
blanks with no effect.
Skipping four lines is the same as skipping one line
-------- it starts a new paragraph.
\subsection{Here is another subsection}
\section{Here is another section}
\end{document}"
Jun 03
Ashley Featherstone says:
Is anyone else having problems getting the square root symbol to show up? ...Is anyone else having problems getting the square root symbol to show up? It works in the MikTex editor on the server, but doesn't work thru the latex plug-in.
It just renders "sqrt2" on my page. Other latex symbols seem to be working fine.
Jun 03
Andy Brook says:
Hi Ashley, Try {latex} \begin{eqnarray} \sqrt{abc} \end{eqnarray} {latex} ...Hi Ashley,
Try
{latex} \begin{eqnarray} \sqrt{abc} \end{eqnarray} {latex}Jun 03
Ashley Featherstone says:
fantastic...that seems to have worked. even better, if you replace&nb...fantastic...that seems to have worked. even better, if you replace with {eqnarray*} (in both places), it removes the line numbers.
Jun 16
hock huat says:
hi, is it possible to "hide" the error messages generated by the Latex plugin. ...hi, is it possible to "hide" the error messages generated by the Latex plugin.
It seem to display quite a bit of system information that might pose some security issues.
regards
Jun 16
Andy Brook says:
No it can't, at the moment. If its important to you, drop me a line.No it can't, at the moment. If its important to you, drop me a line.
Jun 19
Franz Regensburger says:
Would anyone please comment on the Tip & Tricks section? I am not able to fa...Would anyone please comment on the Tip & Tricks section?
I am not able to fathom how to build and use a LaTeX statement library.
The version of the plugin I am using is latex-plugin-1.2.1.jar on a Linux Debian Etch.
I tried to build a statement library and to use the include page macro to load my LaTeX statements.
I started with a simple {latex} section like this
Markup:
{latex}
\newcommand{\myacto}[2]{ {\mbox{acto}_{#1}({#2})}} % macro for acto
[
\frac{ \myacto{pa \le d}{AC} }{ \myacto{}{AC'} }
]
{latex}
This renders perfectly!
Now, I tried to move the command definition
\newcommand{\myacto}[2]{ {\mbox{acto}_{#1}({#2})}}
into a separate page and to include that page in my remaining latex markup by using the confluence
include page macro.
{latex}
{include:~fabr:LaTeX_Makros_MT_II}
[
\frac{ \myacto{pa \le d}{AC} }{ \myacto{}{AC'} }
]
{latex}
The problem is that the confluence framework calls the execute method of the LaTeX plugin with the entire markup between the {latex} keywords. Especially, the confluence macro
{include:~fabr:LaTeX_Makros_MT_II}
gets interpreted by the external LaTeX process, which obviously causes LaTeX errors.
Question: Is there some way to make the confluence framework evaluate the
{include:~fabr:LaTeX_Makros_MT_II} macro before it is calling the
LaTeX plugin?
Of course, putting my definitions into the LaTeX header file of the plugin is not an option.
I need to maintain my LaTeX command definitions inside my user space.
Many thanx,
FABR