Extension talk:Math/Archive 1

Difficulty Installing in Mediawiki 1.19.2, head version of Math extension incompatible, must use version from 2012-08-20
I have a freshly installed mediawiki with the following settings, as reported by the special version page.

with only the math, and vector extensions enabled, and showing up on the special version page

I have successfully compiled texvc.

The problem comes about when I try to use the math extension. As soon as I try adding the following

$$\theta$$

to a page and try to save it I immediately get the error



I have checked /var/log/apache2/error.log and found

[Thu Oct 11 15:53:25 2012] [error] [client 192.168.56.1] PHP Fatal error: Call to undefined method TempFSFile::autocollect in /home/cgeroux/public_html/notes/extensions/Math/Math.body.php on line 129, referer: http://192.168.56.101/notes/index.php?title=Main_Page&action=edit

It seems that some function definition is missing, but I have no idea why, I followed the installation instructions as closely as possibly but there are some gabs that I had to fill in with, which I think, were fairly reasonable assumptions.

The version of the math extension I downloaded is

author	Translation updater bot  Sat, 6 Oct 2012 21:29:28 +0000 (21:29 +0000) committer	Translation updater bot  Sat, 6 Oct 2012 21:29:28 +0000 (21:29 +0000) commit	5bbee223c4e3e2de7cb5a9b20298bb7ff0bb498b tree	7453c887642980b34ca900523365f9d9423d70f8	tree | snapshot parent	22a09c87d3895c6e23dab09539ff5887c24eb81f	commit | diff

I have read that this extension is incompatible with mediawiki 1.19.1, but what about 1.19.2? If not compatible with these version of media wiki, which version is it compatible with? I also found a link that said there was a version that was compatible with media wiki version 1.19, but the link didn't produce any downloadable version, or useful information. Is there a working version of the math extension for 1.19.2? This is a huge feature for me, without it, it almost makes mediawiki, for my purposes, useless (I working in a field that uses math formulas heavily). Any help with getting this extension working with mediawiki would be greatly appreciated.

I have also tried version 1.18.5 with similar errors. If this is a result of picking an unstable version of the extension from the head, perhaps a clear link to a stable version should be added to the download section of the extension page.

Cgeroux (talk) 21:27, 12 October 2012 (UTC)

After doing some hunting around I found that there was a fairly recent change on the git repository that had to do with added file backend support which seems to have added code which uses function calls to undefined methods, at least in mediawiki 1.19.2. After some googling, I found a Doxygen page for some version of mediawiki, which clearly showed function definitions for these missing functions. I am not sure which version of mediawiki it was as it didn't clearly indicate, perhaps it is an up and coming release.

author	Aaron  Mon, 20 Aug 2012 22:11:16 +0000 (15:11 -0700) committer	Aaron  Thu, 23 Aug 2012 00:16:49 +0000 (17:16 -0700) commit	ae9e0d989b744996ac2229b0dfeb740921f642f4 tree	ffe09c16ae00daa6dcb7bcf60b801bf876896e8b 	tree | snapshot parent	29a0a80e8fbb2d33507760075e4da9103439cbd9	commit | diff Added file backend support via $wgMathFileBackend. * Also removed old legacy migration code. Change-Id: I43cfd7f0da49690a2d0b4eb2daab9b8a110137b7

after I went to a snapshot just before this commit it worked :). At least my simple $$\theta$$ test worked. If it is simply a case of not picking the right version of this extension which is compatible with my mediawiki 1.19.2 install, it should really be much more clearly indicated which git snapshots are compatible with which mediawiki versions.

Cgeroux (talk) 21:45, 14 October 2012 (UTC)

How to retrieve a compatible version with 1.19.2
Thank you Cgeroux for your research. I was able to get Math running using your guidelines.

Here are the commands to get i work on 1.19.2.

cd extensions git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Math.git cd Math git reset --hard 29a0a80e8fbb2d33507760075e4da9103439cbd9

Jgrocha (talk) 12:30, 15 October 2012 (WEST)


 * Thanks guys, this really helped me. Was also getting an error about "TempFSFile::autocollect". --Romanski (talk) 13:12, 18 October 2012 (UTC)


 * This solved the problem for me too (mediawiki 1.18) 83.46.86.109 19:27, 27 January 2013 (UTC)


 * This also save me a lot of time as well, I'm using (mediawiki 1.19.2). Thanks a lot!


 * This fixed my problem as well (1.19.2) Niubrad (talk) 03:24, 13 May 2013 (UTC)

About the old texvc
hi, I have compiled a texvc.exe when I used the version 15.1 of Mediawiki. it works very well. May I upload the former texvc.exe to my website of version 18.1? --Simonlsw (talk) 14:08, 15 March 2012 (UTC)

Would be great to have a place where you can define the absolute path for the various TeX functions
Math is calling among other the following TeX functions: dvips, latex, dvipng. It assumes that those functions are located in a directory on a web server which is loaded in the PATH of the web user (usr/bin). If this is not the case, the extension will give the following error message:

"Failed to parse (PNG conversion failed; check for correct installation of latex, dvips, gs, and convert)"

I don't want to clutter up usr/bin by adding a symbolic links to each of the funcions so it would be nice to have a file where you can define a variable for the installation path of TeX (so before you actually do the 'make' command. A work around (what I did) would be to edit the render.ml file and add the absolute path to the various dvips, latex and diving functions. But remember that you have to set this every time you update the math extension.

--Albert Ke (talk) 22:36, 27 February 2012 (UTC)

MathAfterTexvc Hook
I was wondering about the MathAfterTexvc hook. I downloaded MediaWiki 1.18, installed everything I needed and built everything. MediaWiki creates the .tex files using texvc and puts them in the directory I specified, but nothing else happens from there. I was looking in the PHP files and it calls MathAfterTexvc hook, but it seems there is no definition anywhere for that hook. Blahtex has that function, but I was under the impression that this extension would take the .tex file and call latex and dvipng somewhere to generate the PNG file. I can call latex and dvipng from the command line and generate the PNG, so I'm pretty sure I've got everything installed right. Is that hook the problem, or is it something else I've overlooked?

Mac OS X 10.6.8 (Snow Leopard), MAMP 2.0.5

--Capoeirista.muralha 14:24, 17 January 2012 (MST)

MathAfterTexvc was removed completely in version 1.18.0
this issue is an general issue, it has nothing to do with OS.

This feature was removed completely in version 1.18.0. pls refer to http://www.mediawiki.org/wiki/Manual:Hooks/MathAfterTexvc

--MarkYin

Note about location of texvc during upgrade from Mediawiki 1.18 before extension
If you had customized the location of TeX parser in $wgTexvc in LocalSettings.php for previous version of this service, that global is not read in from the extension in Math.php so it complains about not finding texvc. The extension should check to see if the variable is already set in LocalSettings.php and use that value is present. Instead, that value is now hard coded in the extension. Ubuntu installed with Mediawiki math, for example, has the texvc file located at '/usr/bin/texvc'. One can manually set it, as a workaround, in Math.php in the extension.

Gary Anderson 01:20, 30 April 2011 (UTC)
 * It is sufficient to define $wgTexvc in LocalSettings.php after calling require_once("$IP/extensions/Math/Math.php"); --Moejoe000 07:41, 18 May 2011 (UTC)

Localization malfunction
Hello,

I'm having some trouble when non-Englhish characters are place in formulas, like ç, á, ó, é and others. Is that a bug or is it possible for a simple user to fix that?

Thanks in advance.

Paulo.s.lima 13:11, 28 September 2011 (UTC)
 * Take a look on meta:Help:Displaying_a_formula and 798. Helder 12:03, 29 September 2011 (UTC)


 * I am interested in fixing this but being a native English speaker with little experience in latex'ing non-english formulas. I could use examples of things that should work.  The current examples in the bug reports only international characters in \mbox{}'s.  When I personally try to switch to a utf-8 input encoding and latex something like $$á$$ I get errors. Any thoughts welcome. Thenub314 16:58, 13 October 2011 (UTC)

Feature Requests
3840 Looks for high math images printing. The only thoughts I have here are to switch form dvipng to dvisvg and use svg images which would look better at all scales and hopefully would print better. Related 15777

4915 This bug looks to tweak the size of the images produced by texvc. I think this should simply be a WONTFIX. While it may look nice on his browser, at some scale. The real issue is to get the fonts of the math and the surrounding text to match. That would be a lot f work to make texvc do something like that. Mathml/Mathjax are better suited to these tasks.

5856, 10186 and 6722 are related to mhchem package. Users seem to be very interested in this. Perhaps this should looked into.

12223 Desperately needed and long overdue inline math tags. Probably would only make sense if base line issue is sorted out. Should we use a slightly smaller font for inline math? Not done in latex but may look nice on the web.

28258 It would be nice to have some commutative diagram packages. xy-pic may be a good option.

HTML Rendering
1594 Change the way - is rendered in HTML. Complication unary vs. binary minus are spaced differently, and not currently distinguished by texvc because automatically handled by LaTeX.

25645 Suggests we need a better algorithm for deciding about which mathematics is not render-able as HTML. Makes a good point, but rather nebulous and requires some thought.

10434 Don't italicize variables, but mark them as variables in HTML. Low priority, as it has no visible impact in most setups but is mostly a matter of "doing it right".

11663 Problems with &rho; on safari browser, upstream seems to be a wontfix, actually it seems more of a "we do it right". Low priority.

Backwards compatibility issues
31442 Should be fixed now. Some non-standard LaTeX and AMS-LaTeX work under texvc. Must be careful not to break texvc features.

Security and Misc
6248 Permissions issues on some machines. Very old bug, not sure if it still an issue. Not clear which configurations should be tested to confirm/reproduce.

Visual Appearance Issues
15777 I have to agree this looks fairly bad. Curious if switching to dvisvg would straighten this out.


 * Can we move that to Extension:Math/Roadmap ? ... I'll just copy and paste it --Schubi87 (talk) 17:15, 17 April 2013 (UTC)

Script to generate test corpus
The following flex grammar run on a dump generates an XML document of use cases. It probably doesn't cover some corner cases and doesn't eliminate duplicates, but it should be useful to some developers interested in having a larger test corpus.

--Tim&#160;Landscheidt 18:02, 10 January 2012 (UTC)

I get an error after installing the extension
My Wiki is in german and I got the error "Fehler beim Parsen (Das texvc-Programm wurde nicht gefunden. Bitte zur Konfiguration die Hinweise in der Datei math/README beachten.)" after installing the extension. Can someone help me. In english, french or german? --Carl Soehne 16:56, 25 January 2012 (UTC)
 * I get the same error too here.
 * MediaWiki: 1.19.1
 * PHP: 5.2.17 (apache2handler)
 * MySQL: 5.1.57
 * --Luca Ghio (talk) 20:24, 5 July 2012 (UTC)
 * Generally means that texvc is not compiled, texvc is not located in the right place, or you have some permission error. Did you read the README? Bawolff (talk) 13:17, 6 July 2012 (UTC)
 * As the README says, I installed ocaml-native-compilers and I compiled texvc, then I put it into /extensions/Math/math/. How can I check for permission errors?--Luca Ghio (talk) 13:29, 6 July 2012 (UTC)
 * In LocalSettings.php I added only the line: require_once("$IP/extensions/Math/Math.php");. Is something missing?--Luca Ghio (talk) 13:34, 6 July 2012 (UTC)
 * First step to check is can you from the command line run the texvc executable. Can you succesfully run the executable if you su to whatever user apache is running under. Bawolff (talk) 14:43, 6 July 2012 (UTC)
 * Please explain yourself better: should I open the Ubuntu terminal and enter my FTP folder?--Luca Ghio (talk) 14:56, 6 July 2012 (UTC)
 * Basically you can only do that test if you have shell access (So when you say unbuntu terminal, if unbuntu is where your website is hosted, that works, but you cannot do this test over ftp). If you enable MW's logging facilities (see How_to_debug), and render a page with a math tag on it, the debug log will say exactly what commands are executed. (you'll probably want to disable the debug log directly after that. the log file grows very fast). Once you have the individual commands, try them out from the command line to see if they work. p.s. For the permission issue, make sure the apache user has permission to read/execute the texvc command (See docs for chmod command if you don't know how to do that). Bawolff (talk) 16:26, 8 July 2012 (UTC)
 * I changed the permissions of the texvc file from 644 to 744 (see https://goput.it/bby.png). But... now there is another error!--Luca Ghio (talk) 19:43, 8 July 2012 (UTC)
 * Unfortunately I think I have to change my web host.--Luca Ghio (talk) 21:56, 8 July 2012 (UTC)

Supporting Arabic Digit
Hello. Anyone have an idea about supporting Arabic digits in this extension? a package (Arabi) has been released in 2005 in most of LaTeX distributions such as MiKTeX.(See User Guide here). For viewing it's output go to this link and insert these codes in blank area:

\documentclass{article} \usepackage[T1,LFE,LAE]{fontenc} \usepackage[utf8]{inputenc} \usepackage[farsi,arabic,english]{babel} \TOCLanguage{farsi}

\makeatletter %due to a bug in ARABI in which the command \textRL is not %changed to write Farsi though the main TOC language is Farsi. \def\textRL#1

%due to a bug in ARABI in which the quotaion marks are not %assigned to their counterpart font-glyphs in lfeenc.def \DeclareTextSymbol{\guillemotright}{LFE}{62} \DeclareTextSymbol{\guillemotleft}{LFE}{60} \makeatother

\begin{document} \selectlanguage{farsi} %a paragraph in Farsi %to write a number use \I{NUMBER} %to write some phrases in English use \textLR{English phrase} سلام. بالاخره یک سرور \textLR{On Line} پیدا شد که از فارسی نویسی در \textLR{ \LaTeX\ } حمایت کند!

$$\sum^{+ \infty}_{i=1} \frac{1}{i^2} = \frac{\pi^2}{6}$$

\end{document}

Any help is appreciated.--وحید قاسمیان 18:39, 13 February 2012 (UTC)

get independent of texvc
Hi,

I extended the math extension in the way that one can choose which tool to use to convert tex to image, html and mathml. In the code there are just a few lines which work as a driver for the texvc program. The other things can be used for any other converter like LaTeXML for example. Therefore I restructured the code of the math plugin and added two new classes.

Now I'd like to share that code and discuss what can be improved. I'm not sure if that's the right place for the discussion, but I didn't found a better place...

--Schubi87 (talk) 13:47, 7 April 2012 (UTC)

MathJax doesn’t work on IE9
MathJax doesn’t work on IE9 on wikipedia. It works on Firefox. A:-)Brunuś (talk) 15:03, 2 June 2012 (UTC)


 * I did not test on Wikipeda, but tested on my wiki with IE8 with Math (47e3cdb) of 2012-10-22 and everything seems to be fluffy. Cheers --&#91;&#91;kgh&#93;&#93; (talk) 12:27, 3 February 2013 (UTC)

"LaTeX on a shared host" instructions outdated; possible feature request
The given instructions no longer seem to be applicable to the current versions of Math. I am on a shared host, and I installed mimetex.cgi and got it working (tested ok from the command line at least). I went to the next section of instructions where it tells me to modify the function in Math.php that returns the &lt;img> tag instead of doing the stuff the function normally does. I opened up Math.php, and I see that it has been completely rewritten and converted into OOP using classes and stuff. I followed the logic to Math.body.php where the actual rendering appears to happen, hoping that I could find a similar section of code to modify. Sadly, I could not. It seems that there are several places within the code that generate the URL to display the image. There also seems to be a detailed validation that Math is configured correctly. Even if I tweak the outputs to use my CGI path, I think the validations will fail prior to that point, and it will not work.

So, if it is easier to fix the docs to explain how to edit a MW 1.19+ installation with the current version of the Math extension, please do so. Otherwise, I'd like to request that the extension be updated to permit the site owner to simply add a configuration variable to LocalSettings.php with a full URL to the mimetex.cgi script, and then end-users will not have to edit anything else (once they get the CGI working or use a public server). Personally, I like this idea the best, because otherwise I will be very leery of updating my extension, because I had editing core files within extensions. Thanks! Will scrlt  ( Talk ) 00:15, 1 July 2012 (UTC)
 * You could try Extension:Mimetex alternative Bawolff (talk) 16:29, 8 July 2012 (UTC)

Fatal error on the latest git version
On the pages include formulas I get fatal error: Fatal error: Call to undefined method FSFileBackend::getRootStoragePath in /home/wiki/psylab.info/public_html/extensions/Math/Math.body.php on line 361 MW 1.19.1, PHP 5.3.10. Artem Klevtsov (talk) 10:06, 27 August 2012 (UTC)

commit ae9e0d989b744996ac2229b0dfeb740921f642f4 Author: Aaron <aschulz@wikimedia.org> Date:  Mon Aug 20 15:11:16 2012 -0700 Added file backend support via $wgMathFileBackend. * Also removed old legacy migration code. Change-Id: I43cfd7f0da49690a2d0b4eb2daab9b8a110137b7
 * I confirm that the following commit is not compatible with MW 1.19.1. --Rineau (talk) 10:57, 14 September 2012 (UTC)
 * Can anyone check whether the version of the Math extension that was available on, say, August 19th works with MediaWiki core 1.19? 2012-06-13: 1.19.1 released. The offending commit: August 20th. 2012-08-31: 1.19.2 released  I believe the extension should work on 1.19.1 sites but not 1.19.2 or 1.19.3 sites, or sites running off git master. Sharihareswara (WMF) (talk) 16:26, 21 November 2012 (UTC)


 * broken with 1.19.3 any ideas?
 * For me it's not broken with MW 1.19.2 on shared hosting. Here is how I got LaTex running. Maybe this problem is related only to not-shared hosting? Stefahn (talk) 23:31, 4 December 2012 (UTC)
 * No problems here (MW 1.19.3), too. However I am using the MathJax implementation. Perhaps you switch to this one, too for the time being. --&#91;&#91;kgh&#93;&#93; (talk) 12:29, 3 February 2013 (UTC)

Quick fix to a fatal error accessing Special:SpecialPages after switching Math from master to LaTeXML
Fatal error: Class 'SpecialMathDebug' not found in includes/SpecialPageFactory.php on line 345

Description:

Downloading the Math extension using git is not working properly for me. I get the following errors:

Failed to parse (PNG conversion failed; check for correct installation of latex and dvipng (or dvips + gs + convert)): x + y

Failed to parse (unknown function\large): \large a_2 + a^2

After a

git checkout LaTeXML

functions, sums, derivatives, integrals look ok.

LaTeXML is working very well using Firefox 19 on a KDE desktop and it doesn't require MathJax.

Then attempting to visit SpecialPages from the sidebar, I get the above fatal error.

Quick fix:

I added the missing Class in includes/SpecialPage.php as a quick fix:

I'm not sure if this is the right thing to do, at least it heals the error.


 * Oh I didn't see this comment. I just fixed this bug. --Schubi87 (talk) 17:11, 17 April 2013 (UTC)

eqnarray vs align
I seems that eqnarray dose not work in png mode, but align works, so it is not a big problem. Both works in MathJax.

Is it a known problem. Is there somewhere of a list of LaTex (and amsart) commands that dose not supported? Can you put a link to this list from this page? can you add this one to the list?

Thank you very much, Aizenr (talk) 00:18, 17 May 2013 (UTC)

Failed to parse (PNG conversion failed; check for correct installation of latex, dvips, gs, and convert)
Installed the Math extension with git clone ...</tt> under Debian 7 and got the above error message when using a  $$...$$ </tt>.

Solution: apt-get install texlive-latex-extra</tt>. --Sigbert (talk) 15:53, 31 August 2013 (UTC)


 * Also see Manual:Enable_TeX/problems. --Felipe (talk) 06:35, 18 July 2014 (UTC)

Truecolor
Would it be possible to add the --truecolor tag to the dvipng command in render.ml. Currently, colors may render wrong if there are a lot of them - see Color Problems on Wikipedia for an example of the problem and My Fixed Color Problems on my site when I went in and changed the render.ml to include the --truecolors tag (and then re-rendered all the math...). DukeEgr93 (talk) 03:38, 17 September 2013 (UTC)

Installation problems
I've just installed mediawiki v.1.20.3 on a Mac 10.6.8 server and have been having problems getting the Math extension to work. I'm getting the following error at the top of wiki pages with LaTex:

"Notice: Warning: XML Type check skipped! Check if your MediaWiki installation is version wmf/1.22wmf7 or newer. in /Library/WebServer/Documents/w/extensions/Math/MathRenderer.php on line 150"

I get this in addition to the problematic "Failed to parse(PNG conversion failed; check for correct installation of latex and dvipng (or dvips + gs + convert)):" error. I have hard coded the paths for latex, dvipng, etc. into the render.ml file and recompiled.

Any suggestions?

--141.214.17.4 21:24, 24 September 2013 (UTC)

Math PDF Export
I have a wiki set up with the following:
 * MediaWiki 	1.21.2
 * PHP 	5.3.10-1ubuntu3.8 (apache2handler)
 * MySQL 	5.5.32-0ubuntu0.12.04.1

Installed the Math renderer (and set up a local MathJax server) to render my equations on my wiki, where they look great. I run into a problem when I try to export the wiki page as a PDF. Some of the equations do not print (there is just blank space in the PDF where equation should be) and the equations that do print are not very good quality. Anybody know why they may be missing and how I can improve the quality?

Thanks! SpartanGuy07 (talk) 19:49, 2 October 2013 (UTC)


 * Hello. What are you using to generate the PDF's? --Jongfeli (talk) 09:38, 3 October 2013 (UTC)


 * The PDF is generated using PDF_Writer from the Extension:Collection. This is also run by a local server.SpartanGuy07 (talk) 18:49, 3 October 2013 (UTC)


 * Ok. I am not familiar with Extension:PDF Writer we use Extension:Collection. The reason we do is because it is used on "all" Wikimedia sites, the output can be customized and it is relative easy to setup when you want to run your own render server (see: Setup a render server on Ubuntu 12.04 LTS). When you use MathJax the math formulas look indeed great but it is not a picture it is code (when i am correct). Pdf export extensions like PDF Writer & Collection don't use MathJax to create the formulas. I don't know if that is even possible. I did try to increase the quality of the formulas in the pdf's but had no luck yet.


 * As for the not printing (showing) part, we noticed that some syntax is not handled well when exporting to pdf. It works fine in the browser when handled by MathJax but on the pdf output there is just empty space.


 * Example (set your Preferences to MathJax):
 * This  shows $$E=mc^2$$ on the page and in the pdf output.
 * This  shows $$E \space =mc^2$$ on the page with the extra empty space but there noting to be seen in the pdf output, just empty space.


 * We did not investigate any further we just don't use  anymore. There is probably more syntax that does work with MathJax and not when rendered to pdf. --Jongfeli (talk) 06:59, 4 October 2013 (UTC)


 * I think there is some confusion as to the problems I am experiencing, so I am attaching some screenshots that I made to demonstrate the problems. First off, I am using the Extension:Collection, I was just referring to the PDF_Writer as being the function that generates the PDFs. Note: All these images are uploaded to the wiki, they are not really external links, I just didn't want to embed them to this page due to their size.


 * Bad quality in PDF
 * Quality in wiki and quality in PDF


 * Equations not rendering in PDF
 * Normal equations, rendered in wiki but not in PDF


 * Inline equations, rendered in wiki but not in PDF


 * As I mentioned, certain equations (such as $$E=mc^2$$) do render in both the wiki and the PDF, but they have poor quality. Since I am using the Extension:Collection, the same used as the rest of the Wikimedia sites, I don't know why the quality of my equations is worse in PDF form. Others just don't show up at all, as demonstrated by the quadratic equation.


 * Hope this clarifies things. Thank you. -SpartanGuy07 (talk) 16:38, 4 October 2013 (UTC)


 * Ok. The quality difference between browser and pdf is there because your wiki is setup to use MathJax to generate the formula's. I do not know what the Collection extension is using to generate the formula's but it is not using MathJax. The quality of the formula's in the pdf is indeed poor. We also tried to increase the quality but we did not find a solution yet (see comparison on: Math formulas). You can test pdf output on the MediaWiki site, when your math formula's also fail to show up in the pdf's generated by the render server at PediaPress there is probably something wrong with the math syntax. You can post the actual math syntax on this page and export this page to pdf to see if it shows up. --Jongfeli (talk) 19:09, 4 October 2013 (UTC)

fix error in extension math
hi please fix an error with extension:math my error says

[2a2a6828] /mw-config/?page=ExistingWiki Exception from line 181 of /home/paladox/public_html/en/includes/Hooks.php: Invalid callback in hooks for ParserFirstCallInit

Backtrace:


 * 1) 0 /home/paladox/public_html/en/includes/GlobalFunctions.php(4031): Hooks::run(string, array)
 * 2) 1 /home/paladox/public_html/en/includes/parser/Parser.php(275): wfRunHooks(string, array)
 * 3) 2 /home/paladox/public_html/en/includes/parser/Parser.php(287): Parser->firstCallInit
 * 4) 3 /home/paladox/public_html/en/includes/parser/Parser.php(4823): Parser->clearState
 * 5) 4 /home/paladox/public_html/en/includes/parser/Parser.php(367): Parser->startParse(Title, ParserOptions, integer, boolean)
 * 6) 5 /home/paladox/public_html/en/includes/installer/Installer.php(591): Parser->parse(string, Title, ParserOptions, boolean)
 * 7) 6 /home/paladox/public_html/en/includes/installer/WebInstaller.php(668): Installer->parse(string, boolean)
 * 8) 7 /home/paladox/public_html/en/includes/installer/WebInstallerPage.php(358): WebInstaller->getInfoBox(string)
 * 9) 8 /home/paladox/public_html/en/includes/installer/WebInstallerPage.php(346): WebInstaller_ExistingWiki->showKeyForm
 * 10) 9 /home/paladox/public_html/en/includes/installer/WebInstaller.php(275): WebInstaller_ExistingWiki->execute
 * 11) 10 /home/paladox/public_html/en/mw-config/index.php(61): WebInstaller->execute(array)
 * 12) 11 /home/paladox/public_html/en/mw-config/index.php(29): wfInstallerMain
 * 13) 12 {main}

when going to mw-config and using update script in browser I have tested my other extension and they work but when I have extension:math enabled it seems to stop the update in the browser from working please fix it.

86.135.255.245 15:42, 22 December 2013 (UTC)


 * I've installed MediaWiki 1.22.0, added Math extension, and re-run the installer again: I don't see this error happening. Please always provide what MediaWiki version are you running --Ciencia Al Poder (talk) 19:57, 22 December 2013 (UTC)


 * hi I am now using mediawiki 1.23 wmf 11 but all I did is run update.php in my browser and so it only add the table to my database and I have installed the extension but is there anything elease I need to add to localsettings.php or and other maintenice scripts I need to run 86.135.250.146 17:24, 25 January 2014 (UTC)


 * update.php can't run on your browser. --Ciencia Al Poder (talk) 10:37, 27 January 2014 (UTC)

installing math on Windows for mere mortals...
A few years ago using mediaWiki 1.15 I have installed math and used it a lot since then. I don't recall much problems to get it working. Now, using v1.22, I am getting nowhere. Where can I find a clear step-by-step tutorial which tells me what to do to get it to run on Windows? <Br><Br> For the time being I found a zero-installation option: template: equation <includeOnly> <IMG src='http://latex.codecogs.com/gif.latex?'> </includeOnly>

purpose
Poor man's equation parser

usage
enter 1=e=m\cdot{c^{2}}

to get eqn=e=m\cdot{c^{2}} (requires $wgAllowImageTag)

Wim WimW 15:40, 7 January 2014 (UTC)


 * On my user page I present an update of the old math.php that worked in the pre 1.18 (?) versions until it had to become an extension. This math-version does not use texvc and therefore is much easier to install. WimW (talk) 15:00, 9 January 2014 (UTC)

Installation guidelines unclear
// permission and that these two variables are set or // default to that directory:
 * // Set this if you don't use MediaWiki Math's texvc: - what is MediaWiki Math's texvc? How I should know wether I am using it or no?
 * // Be sure to have a math directory with writing

This means I have two options. One is to set the two variables below, the other one is to set a default directory. What does it mean? Where and how I can set the default directory?--Juandev (talk) 19:53, 11 January 2014 (UTC)

Uninstall
It would be nic to write down the way how to uninstall this extension.--Juandev (talk) 16:48, 16 January 2014 (UTC)

How to keep the documentation up to date
A new version of the Math extension aka Math 2.0 is planned. What do you think is the best practice to keep the documentation up to date with the current version. For example https://git.wikimedia.org/commit/mediawiki%2Fextensions%2FMath.git/013cb707498fdb9e998363bbf2afbe2a0ef0b292 changed the name of some globals. We tried to document the most important changes in https://git.wikimedia.org/blob/mediawiki%2Fextensions%2FMath.git/ff83048597fb256c2579f16ddcd982ef2ae75460/RELEASE-NOTES-2.0 unfortunately some of the changes are already live now in Wikipedia also Math-2.0 was not released. My new proposal is now to develop the changes in a different branch https://git.wikimedia.org/log/mediawiki%2Fextensions%2FMath.git/refs%2Fheads%2Fmath2_0_0 and merge it once everything is tested and reviewed by the community. --Physikerwelt (talk) 12:21, 10 February 2014 (UTC)


 * As I expected changes were just incorporated before actual release. :| Yeah, I think it is best to develop in a different branch and merge this one with master. However I would develop in smaller chucks, so instead of doing a big change, incorporate smaller changes step by step. Useful changes e.g. translation updates to master should somehow end up in the special development branch too so syncing them somehow will be necessary. I would ask another developer on how to do this best. Cheers --&#91;&#91;kgh&#93;&#93; (talk) 16:02, 10 February 2014 (UTC)

__DIR__
I changed the line require_once __DIR__. "/extensions/Math/Math.php"; to require_once "$IP/extensions/Math/Math.php";

because __DIR__ was added in PHP v.5.3.0 and so crashes on hosts such as DreamHost that (still!) run older versions of PHP, while "$IP" apparently works both on old and new versions of PHP. (See Manual:$IP and template talk:ExtensionInstall ).

Please revert if there is a good reason to use "__DIR__" rather than "$IP". --DavidCary (talk) 18:52, 18 February 2014 (UTC)

Alignment of formulas
The MathJax extension centers formulas instead of aligning them to the left. This behavior is different from the PNG mode. While I don't mind centering in general, there are some cases where it looks really bad, which is when multiple formulas are listed below one another. This makes the first centered and the latter left-aligned. See https://en.wikipedia.org/wiki/Greatest_common_divisor for some examples of that.

There are at least two possible fixes:

71.222.122.167 18:31, 20 February 2014 (UTC)
 * Make all formulas centered. One problem with this is that pages are probably authored for math on the left so it could lead to other problems.
 * Align formulas to the left like with PNGs. This can be done with, and possibly other ways. See http://docs.mathjax.org/en/latest/options/hub.html for more info.

$wgTexvcBackgroundColor?
The documentation on this parameter is rather unclear. I've been looking on how colors are defined in the \special command in Latex, but I'm not really getting anywhere. So I have no idea how to set this variable... An example or two and/or a link to a page explaining how colors are set in the \special command would be very much appreciated!

193.244.33.47 08:37, 10 May 2014 (UTC)

Terrible documentation - just had a hard time to make it work
Just wanted to give you guys some user feedback.

I just had a terrible time trying to make this extension to work. I am using MediaWiki 1.19.11 on shared hosting at Dreamhost.com, and it took me the best part of three hours to get an equation to be displayed. Hopefully this comment will help others in a similar situation and help improvement of the docs.

This is how I finally got my math notation going:


 * Downloaded Math extension, added  to   ; updated the database structure (I skipped it, but a full wiki backup is always recommended prior to update)


 * Downloaded MimeTex from http://www.forkosh.com/mimetex.html, uploaded to my server and compiled it (following instructions on the previous link).


 * Dreamhost doesn't have a specific cgi folder (didn't know that) so I ended up creating a  directoy and placing   there with the proper (755) permissions.


 * My, after several attemps, ended up keeping only:


 * I used this (as of today) awfully written page to guess the changes I had to do the the extension code, and edited my, although the code I had here for function   was not exactly the same as the one shown there. I simply added the following line as the first line of the function:

This got me going. Equations are displayed albeit quite pixelated.

Things I wanted to do, but couldn't, no matter what:


 * To download and install texvc on my shared hosting server
 * To understand a little better what texvc actually does
 * To use MathJax
 * To use any other render method other than mimetex.cgi
 * To get top quality equation renders
 * To have a nicer user experience

Hope it helps,

Rbirmann (talk) 22:27, 16 May 2014 (UTC)

Installation instructions for LaTeXML incorrect/out of date?
I'm currently trying to get LaTeXML support working (I don't have TeX installed on my server and would rather not commit the disk space for an installation of it, which IIRC from last time I used it was quite significant), but am having problems following the instructions. I initially followed the simplified guide to installing the Math extension (I downloaded the version provided in the download link below, which is in a folder in the archive called `wikimedia-mediawiki-extensions-Math-d0e998f` and is therefore I presume a snapshot version...?):



but this didn't work. I wasn't getting math rendering correctly (I got a warning about `texvc` not being installed), and navigating to my user preferences page showed an error message (apparently "MW_MATH_LATEXML" is defined as "7" which is not a valid value for the user option "math").

Looking at the source code I have, I can see *why* this doesn't work -- the variable `$wgUseLaTeXML` is never read, so I wouldn't expect setting it to achieve anything -- but I don't see how to actually make it work. Any ideas? 146.200.200.49 00:14, 29 June 2014 (UTC)

Unable to compile texvc, for literally years
/srv/www/htdocs/ddw3/extensions/Math/math # make ocamlopt -c util.ml sh: as: command not found File "util.ml", line 1: Error: Assembler error, input left in file /tmp/camlasm001200.s make: *** [util.cmx] Error 2 (* vim: set sw=8 ts=8 et: *) --Docduke (talk) 21:48, 14 October 2014 (UTC)
 * Environment: SuSE 13.1-64 including ocaml 4.01.0
 * Math-REL1_23-d0e998f.tar.gz
 * Result of make:
 * Line 1 of util.ml reads:
 * So I have no idea where the missing "as" is to be found.
 * camlasm001200.s is 7846 bytes in length and contains nothing I can use to identify the problem.
 * This error was generated today, 8/8/14. I believe it is the same that I got when I first tried to install 1.19.
 * I have been using MediaWiki at home since about 2007 as my journal. The Math extension is an essential part of it.  I have been using 1.16 since I first failed to compile texvc.  I would like to move from 1.16 on a 32-bit CPU to a more current version of MediaWiki on a 64-bit platform.  Who can diagnose this problem?
 * Incidentally, SuSE has an assembler which it calls asl. A search on "assembler" also finds bin86, hping, nasm and yasm.  I am certainly not prepared to guess which of these should be given the synonym "as."
 * This is clearly in SuSE's court. I found a "Hello world" example that works in ocaml, but fails in ocamlopt.
 * SuSE has analyzed it and a fix for the package is in the pipeline. In the meantime, updating the compiler solves the problem.
 * The workaround is at the end of this Bugzilla thread: Bug 891177 - ocamlopt, the native code generator of ocaml, is broken in the distribution package.

Upgrade broke MathJax
I just upgraded MediaWiki from 1.21 to 1.23. Got a fresh install of the Math extension. Ran the makefile to build texvc, texvccheck. Changed my LocalSettings.php to look like this: require_once("$IP/extensions/Math/Math.php"); $wgMathValidModes = array( MW_MATH_MATHML, MW_MATH_SOURCE ); $wgUseMathJax = true; $wgDefaultUserOptions['math'] = MW_MATH_MATHJAX; All math in the wiki (http://math.slu.edu/escher) is now broken. Instead of rendered output like $$\alpha _{1}+\delta _{1}+\gamma =180^{\circ }$$, I see (with Safari and Chrome): $ \alpha _{1}+\delta _{1}+\gamma =180^{\circ } $ My apache server log reports this error: [Tue Aug 12 11:43:35 2014] [error] [client 153.107.97.166] File does not exist: /export/mathcs/www/escher/mediawiki/extensions/Math/modules/MathJax/extensions And indeed, that file does not exist. It did in the old version of the Math extension. Here's the contents of the Math/modules/MathJax directory: fonts images  LICENSE	README-branch.txt  README.md  unpacked Suspiciously, the 'unpacked' directory does contain a subdirectory called 'extensions'.

If I disable MathJax and revert to PNG rendering, things do work. But before the upgrade, MathJax was working fine and looks considerably better.

Bryanclair (talk) 19:06, 12 August 2014 (UTC)

Solved
This was cleared up by Ian Kelling, who has also fixed the page to reflect the correct settings. The issue is that $wgDefaultUserOptions['math'] = MW_MATH_MATHJAX; //INCORRECT is incorrect. You can list $wgMathValidModes which will show up as radio buttons in user preferences, but MathJax apparently doesn't work as one of these radio buttons. Instead, you turn it on with $wgUseMathJax, which creates a checkbox in the user preferences that overrides the radio button setting. Then, to make MathJax the default, you use $wgDefaultUserOptions['mathJax'] = true; //CORRECT It seems like not very clear behavior, and that it would make sense to make MathJax just another radio button, defaulted with $wgDefaultUserOptions['math']. Maybe in the future. Bryanclair (talk) 04:28, 15 August 2014 (UTC)


 * At 13:25, 16 October 2014 (UTC), the correct setting is:
 * $wgDefaultUserOptions['math'] = MW_MATH_MATHJAX; //CORRECT
 * The solution above didn't work for me.
 * --Papapasan (talk) 13:25, 16 October 2014 (UTC)

texvccheck with empty result
I'm currently testing an upgrade of my Wiki to 1.23. The problem with Math is that some of the equations are not rendered but I get Failed to parse (unknown error)</tt>. When the page is purged some of the equations (but not necessarily the same as before) are rendered.

I set $wgDebugLogFile</tt> and in the log files for all the equations that are rendered the output of texvccheck</tt> is an empty string. For the rendered equations there is a non-empty (correct) result. Copy/pasting the the command from the log to the command line and executing gives a non-empty result

When I switch off checking with $wgMathDisableTexFilter</tt> all equations are rendered.

No idea what is happening here. Don't think that it is a permission-thing as the equations are sometimes rendered. Also tried the current official release of Math and the git version. The same happens for both of them --Bgschaid (talk) 08:18, 27 August 2014 (UTC)

Addition: It is my impression that this only happens if more than one equation is on the page. Is it possible that the PHP executes more than one instance of texvccheck</tt> at once and there is some kind of race-condition (temporary file etc)?

MathJax (MW_MATH_MATHJAX) depreciated
When looking at the code I realised that MathJax is now a depreciated rendering method. On shared hosting this seems however to be the only way to get this extension working at all. Thus it will be cool to continue support for this mode for all the ("unfortunate") people out there who have no command line access to their server (shared hosting). --&#91;&#91;kgh&#93;&#93; (talk) 15:40, 4 September 2014 (UTC)

On a shared host with a limited shell access
The section On a shared host with a limited shell access describes installing dependencies using sudo apt-get but then goes on to describe fetching and compiling texvc with wget, make, etc. It would be better if the process were described once for on Ubuntu/Debian using sudo apt-get and again for other systems where using make would be necessary. -- Rob Kam (talk) 20:33, 5 September 2014 (UTC)

MathJax extensions
How to add MathJax third-Party extensions? For example XyJax to draw various graphs and diagrams. -- Rob Kam (talk) 23:20, 7 September 2014 (UTC)

MathJax on the same server
To have MathJax on the same server as the wiki is it really necessary to download and unpack all 53Mb of the the latest distribution? -- Rob Kam (talk) 16:29, 8 September 2014 (UTC)


 * Yes, it is. I've done that and MathJax is running OK in my wiki. Andreluciani (talk) 16:34, 12 September 2014 (UTC)

Math folder doesn't contain texvc
I've installed the extension Math in my wiki(1.23) and when I try to render by PNG method (texvc) I get the error: Failed to parse (Missing texvc executable); please see math/README to configure.). I've checked the math directory in my server, and I figured out there actually isn't a folder texvc, which I guess is necessary to get things working. How can I solve this problem? I've done some research and couldn't find anything helpful. Thanks Andreluciani (talk) 16:31, 12 September 2014 (UTC)

I've the same problem. MediaWiki 	1.23.5 Installed Extension Math, used 7-zip to extact the folder Math, but it does not contain the texvc file.

Math rendering with MathJax not working with Mediawiki 1.23
I've upgraded my wiki to version 1.23 and also upgraded the Math extension to version 1.2.0

After that, the Math extension doesn't seems to be working.

Here's my configuration

require_once("extensions/Math/Math.php"); $wgMathValidModes[] = MW_MATH_MATHJAX; // Define MathJax as one of the valid math rendering modes $wgUseMathJax = true; // Enable MathJax as a math rendering option for users to pick $wgDefaultUserOptions['math'] = MW_MATH_MATHJAX; // Set MathJax as the default rendering option for all users (optional) $wgMathDisableTexFilter = true; // or compile "texvccheck" $wgMathJaxUrl = "$IP/extensions/MathJax/MathJax.js?config=TeX-AMS-MML_HTMLorMML";

I even tried to change the value of $wgMathJaxUrl to "http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" but no changes.

Nothing seems to working, and my formula is not parsed and displayed as it is.

I even tried to install the older version 1.0 Math but that throws some error with the class name not found (related MathRenderer).

One difference I found before upgrading and after upgrading is the js fils like /extensions/Math/modules/MathJax/config/TeX-AMS-texvc_HTML.js are not loading now. And I'm not even seeing the config folder under MathJax folder.

Any reason why this is not working?

Same here ... no Rendering using MW1.23.6 and Math 1.2/MathJax ... need some help --192.166.53.201 14:24, 2 December 2014 (UTC)


 * I also have the same issue. I'm new to all this and using MW but I feel I did everything right. Also I have observed that when I activate the MathJax settings in LocalSettings.php, I can't get to the user preference page of the wiki. Disabeling the option in LocalSettings.php reopens the user settings page. I've tried what was stated above on setting the default mode but it didn't work. Could the problem be in the adding of the mathjax option of the settings menu? I'm using MW 1.24.0. Thanks with to anyone who can help. Letartean (talk) 18:32, 17 December 2014 (UTC)


 * Same settings, same issue here as well. 140.112.41.107 05:57, 24 February 2015 (UTC)


 * I'm completely new to this. I have installed MediaWiki 1.24.1 and I am using MathJax "latest distribution". I did all changes in LocalSettings.php but it does not work. Any idea? Are there any other settings? --2003:63:3E0E:E900:C4B7:7013:A7B5:BB1B 19:15, 23 March 2015 (UTC)
 * I found a solution. Install http://www.mediawiki.org/wiki/Extension:SimpleMathJax/en and edit SimpleMathJax.class.php like you wish. It works fine for me! --2003:63:3E0E:E900:C4B7:7013:A7B5:BB1B 19:35, 23 March 2015 (UTC)

\not in MathJax puts the slash in the wrong place
I'm seeing bad rendering with \not followed by a digit, e.g. $$\not 3$$, in MathJax but not in other math rendering modes. This affects the en.wikipedia article en:Anomalous cancellation; see en:Wikipedia talk:WikiProject Mathematics for more details. —David Eppstein (talk) 05:09, 7 December 2014 (UTC)

Installation on Windows 7 SP1 x64
Added January 25, 2015 09:27 EST

This is my solution to installing Extension:Math on a private mediawiki v1.23.5 under Windows 7 Ultimate SP1 x64 with LaTeX installed locally. Your performance will vary.

being comments

If one of my students turned in this software for a grade I'd give them an F for the software and an F- for the documentation. end comments

Wikipedia faces the same choices as us and they settled on this solution. So adopt it since it would take more time and aggravation to write your own solution.

Steps

1. Install from Cygwin dvipng, ghostscript, and LaTeX.

1.1 The LaTeX executable is pdftex.exe. Since the Cygwin UNIX-links do not work in Windows 7 copy the bin\pdftex.exe to bin\latex.exe. Make sure the directory links point to bin\pdftex.exe so they do not break after an update.

2. Install and compile Math\math and Math\texvccheck without any modifications. Do not run the update.php until last.

3. Add this line to the ImageMagick section in the LocalSettings.php file.

$wgImageMagickIdentifyCommand = "C:\\Program Files\\ImageMagick-6.9.0-Q16\\identify.exe";

4. Add the below to the LocalSettings.php file.

require_once "$IP/extensions/Math/Math.php"; // See below for installation requirements and configuration settings: $wgUseTeX= true; // enables the tag
 * 1) Extension::Math 2.4 23-JAN-2015
 * 2) Working configuration

$wgTexvc = "$IP/extensions/Math/math/texvc.exe";
 * 1) texvc binary

$wgDefaultUserOptions['math'] = MW_MATH_LATEXML; $wgMathValidModes[] = MW_MATH_LATEXML; // adding LaTeXML as rendering option

$wgTexvcBackgroundColor = 'transparent'; $wgMathTexvcCheckExecutable = "$IP/extensions/Math/texvccheck/texvccheck.exe"; $wgUploadDirectory = "$IP/images"; $wgMathPath = "$IP/images/math"; $wgMathDirectory = "$IP/images/math"; $wgTmpDirectory = "$IP/images/temp";


 * 1) Disable MathJax

$wgDefaultUserOptions['mathJax'] = false;

$wgMathDisableTexFilter = true; # true any LaTeX expression is parsed. false a safer subset is used.
 * 1) Set the default rendering mode to pictures

$wgLaTexCommand = "C:\\cygwin64\\bin\\pdftex.exe"; $wgDvipsCommand = "C:\\cygwin64\\bin\\dvips.exe";
 * Tex


 * 1) End Math 2.4 configuration

5. Now run the update.php to add the database changes.

Note: There are LaTeX/MathML GUI equation editors available where you can create a complex mathematical equation and the equivalent LaTeX or MathML script is produced.

this solution works well --MarkYin

This is certainly unclear for me also.

1º for Cygwin new users. What packages do we need to install those 3 programs? As i am not pretty sure what to do when i type for example "Latex" and i have 9 packages in there, or when i type "dvipng" and nothing appears.

2º How to compile Math\math and Math\texvccheck? --Maiser

Please see math/README to configure. in /var/www/wiki/extensions/Math/MathInputCheckTexvc.php on line 65
I found this error in my php error log: [14-Apr-2015 02:17:50 America/New_York] PHP Notice: Missing &lt;code&gt;texvccheck&lt;/code&gt; executable. Please see math/README to configure. in /var/www/wiki/extensions/Math/MathInputCheckTexvc.php on line 65

Looking around the web, I found numerous other wikis with the same error.

It is fixed by compiling the texvccheck extension:
 * 1) cd /var/www/wiki/extensions/Math/texvccheck
 * 2) make

Haribo~mediawikiwiki (talk) 06:04, 4 May 2015 (UTC)


 * Thanks. That did the trick at our wiki, too. Thanks for sharing. Dennisroczek (talk) 16:18, 24 September 2015 (UTC)

A lot of errors
Hi there, I get a lot of errors when I'm using the math extension. I was able to solve some issues on my own, but there are still some left.

http://www.mediawiki.org/wiki/Extension:Math Was the installation guide I used.

I tried all of this: http://www.mediawiki.org/wiki/Manual:Troubleshooting_math_display_errors#.22Failed_to_parse_.28PNG_conversion_failed.3B_check_for_correct_installation_of_latex.2C_dvips.2C_gs.2C_and_convert.29.22

But it didn't work at all. I still get the message "Failed to parse (PNG conversion failed; check for correct installation of latex, dvips, gs, and convert)" and another message which tells me that a command was unknown.

Any Idea what I could still do?

Mediawiki version is 1.24.1

REL_1.25 doesn't work with MediaWiki 1.25!
Just an FYI: The commit tagged REL_1.25 doesn't work with MediaWiki 1.25.1; the extension uses a logging API (MWLoggerFactory) that was renamed before MW 1.25 was released. Current HEAD isn't playing nice with VisualEditor; I had to go back to 81dbee82 to get a version that worked.

MW 1.25 is complaining about extension.json. I was not able to install it on MW 1.25.

<Note: I had this same issue, loaded the latest development version and it worked>

MathJax removed
See T99369. Please update the page to say that the latest version has no MathJax and how people can install a version before its removal if they so desire. --Nemo 19:28, 20 July 2015 (UTC)
 * Done, if only roughly. --Rob Kam (talk) 11:08, 21 July 2015 (UTC)
 * I tweaked a bit. Sad to see this go. Now we have the schizoid mathoid which is not even documented. --&#91;&#91;kgh&#93;&#93; (talk) 09:10, 27 July 2015 (UTC)

How to get VisualEditor to render math in real time?
I just installed VisualEditor and Math in a wiki. However, the behavior is not the same as in Wikipedia, where after you have entered a math formula it is rendered and displayed on the editable surface. Instead, my installation shows the $$formula$$ that makes up the image.

Does anybody know what could be going on?


 * I also have this problem. Anyone? --189.41.24.14 20:13, 23 June 2016 (UTC)

Math function revert to text after going to visual editor?
I have the math function working in the standard wikipedia text editor. But, the next time when i use visual editor, the math function got reverted back to text as such [math]]I= 1.5 \cdot I_{rated} = 0 [/math] What can i do to prevent this from happening?

Extension talk:Math/Roadmap
see above--Debenben (talk) 18:22, 29 November 2015 (UTC)

Impossible to make Math work with latest MW (1.26.2) on shared hosting
Hi,

After upgrading MW from 1.22 to 1.26 I spent hours trying to make the Math extension work. With no success.

The documentation is completely outdated and confusing. Different articles say different things and apparently about different versions. It also seems that some big changes have been made to the extension code lately without keeping backward compatibility.

Check this quote from https://www.mediawiki.org/wiki/Extension:Math/Roadmap : " The Math extension (or, more broadly, the rendering of the tag) has a long history. It has been modified by a number of different people with different goals, different ideas, and different and programming styles, using different underlying technologies. As a result, the extension's current implementation is more a grown than a well-designed or -documented structure. "

The currently available installation instructions seemed promising (mentioning a relatively recent version of MW (1.23)), but simply downloading math, adding the "require_once" directive to LocalSettings.php and running the update script - as instructed in such page - are clearly not enough to make it work.

In my case, I was stuck when trying to compile texvc (never mentioned on the installation instructions, btw) on a shared host without OCaml (note: I bet most shared-host installations can't meet these requirements). Couldn't find an alternative or a workaround for this.

Best,

Rbirmann (talk) 03:22, 29 December 2015 (UTC)


 * Amen. --146.137.70.70 00:21, 7 January 2016 (UTC)


 * I have exactly the same problem trying to get the Math extension working on shared hosting with MW 1.24, I don't even have access to make - this is a major issue! --Eboyle1 2016 (talk) 11:48, 15 January 2016 (UTC)
 * One workaround is mentioned at https://www.mediawiki.org/wiki/Extension:Math/advancedSettings#On_a_shared_host_with_a_limited_shell_access, basically compile texvc on a local version of the shared hosting OS version (presumably Linux) and then upload to your shared hosting server - not an ideal solution, but it might work. --Eboyle1 2016 (talk) 12:11, 15 January 2016 (UTC)


 * Sorry but the documentation is only as good as you make it. If it's not good enough then re-write it yourself, nobody else will.


 * The Wikimedia Foundation supports its own powerful expensive hosting. It's just fortunate that it mostly still runs on shared hosting. Shared hosting isn't actively supported by the developers, outside users have to find their own solutions. Use Extension:SimpleMathJax instead of Math.


 * --Rob Kam (talk) 12:05, 15 January 2016 (UTC)


 * Extension:SimpleMathJax worked for me on shared hosting and might be a good alternative, thanks Rob Kam --Eboyle1 2016 (talk) 12:27, 15 January 2016 (UTC)


 * Extension:SimpleMathJax worked great for me as well. Rob Kam, thanks for that. As for "the documentation is only as good as you make it" - true, but here is where we would start discussing bad docs before changing it, so....... Anyway.. I would add a link to SimpleMathJax to the extension page, but you beat me at that ;) Thanks again. Rbirmann (talk) 21:30, 18 January 2016 (UTC)

Not for shared hosting
There ought to be a warning that if you're using shared hosting don't waste your time trying to install this extension. Rob Kam (talk) 15:05, 23 February 2016 (UTC)
 * Try switching on the mathml mode. From what I can tell it shouldn't need further configuration.  -- Prod (talk) 20:27, 27 February 2016 (UTC)

Find pages with math formulas
Is there an easy way to find pages where there are math formulas? Perhaps something similar to Extension:GraphViz's tracking category or Extension:DynamicPageList3's tracking template? -- Prod (talk) 17:21, 28 February 2016 (UTC)
 * It depends on what you consider to be easy;-) You could use the build in search insource:/\<math/ or if you are importing a d dump you can use https://github.com/physikerwelt/wikiFilter
 * More complicated is Extension:MathSearch. Maybe you can explain what you are trying to do? --Physikerwelt (talk) 17:02, 7 March 2016 (UTC)
 * On a 3rd party wiki, I'd like to be able to find instances of math usage to validate things are working. We using the default mediawiki search functionality, so insource doesn't seem to work. -- Prod (talk) 17:40, 7 March 2016 (UTC)

Description update
When will be the extension page be updated to reflect 1.26.x changes?

What is the relationship between $wgMathFullRestbaseURL and mathoid, exactly?
If we set up mathoid, what do we do with $wgMathFullRestbaseURLto make it actually work? What do we put?

Given that this extension does not work without either of these, this seems... important. -— Isarra ༆ 00:00, 17 April 2016 (UTC)

Math REL-1_23 with MW1.23LTS on Windows with ImageMagick, MikTeX, GhostScript and class LatexRender
The math extension in MW1.23 replaces the file math.php from the includes directory in older MW versions like 1.16. For using ImageMagick/MikTeX/GhostScript on Windows instead of Texvc there was a file Math.php with class LatexRender for older MW versions.

The math extension REL-1_23 has no exe files for texvc and texvccheck, so there will occur errors on Windows systems. A way could be to use a modified file math.php with class LatexRender instead of compiling exe files. Three files have to be modified:
 * Math.php with class LatexRender from older MediaWiki version
 * Math.php from extension Math
 * MathRenderer.php from extension Math

All files with AutoLoadClasses of the Math extension are named like "Math..." so the modified file Math.php with class LatexRender from Benjamin Zeiss, 2003, should be called MathLatexRender.php with a class MathLatexRender and should be stored in the extensions directory "Math". All Changes are described below.

Add in file Math.php of extension Math, for example between line 191 and 192: $wgAutoloadClasses['MathLatexRender.php']

Change the new object creation from MathTexvc to MathLatexRender in file MathRenderer.php below "default", line 123: $renderer = new MathLatexRender( $tex, $params ); #$renderer = new MathTexvc( $tex, $params );

In file MathLatexRender.php instead of functions LatexRender(...) in class LatexRender and renderMath(...) in class MathRenderer a new function __constructor(...) and only the class MathLatexRender should be used. Class MathLatexRender extends class MathRenderer like other classes of the Math extension. Changes:
 * Rename class LatexRender to MathLatexRender extending class MathRenderer
 * Constructor function __constructor(...)
 * Delete or set as comment function LatexRender(...)
 * Delete class MathRenderer
 * Since MathLatexRenderer is a subclass of MathRenderer there has to be a new function render.
 * For newer PHP versions in function "htmlentities(...)" use parameters for XHTML and UTF-8 or what you need
 * The variables $url and $text should be set to class variables.
 * To prevent warnings in case of trying to delete non-existing files in function cleanTemporaryDirectory a file check should be added.
 * In function renderLatex a file check should be added, too.

/** * LaTeX Rendering Class * Copyright (C) 2003 Benjamin Zeiss &lt;e-mail address removed in Extension_talk:Math&gt; * --- * Changed to MathLatexRender Class for HAWK HHG by Gunnar Werner 2016 * to be used with MW 1.23 LTS and extension Math REL-1_23... * for Windows with GhostScript+ImageMagick+MikTeX instead of Texvc * Notice 1: In file Math.php loading this class has to be added: * $wgAutoloadClasses['MathLatexRender'] = $dir. 'MathLatexRender.php'; * Notice 2: In file MathRenderer.php new default object $renderer has to be changed: * $renderer = new MathLatexRender( $tex, $params ); #$renderer = new MathTexvc( $tex, $params ); * --- * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. ... * @author Benjamin Zeiss &lt;e-mail address removed in Extension_talk:Math&gt; * => @author Gunnar Werner for HAWK HHG &lt;e-mail address removed in Extension_talk:Math&gt; * @version v0.8 => v0.8.2016.05 * @package latexrender => class MathLatexRender for extension Math ...

// "extends MathRenderer" new by changes 2016 class MathLatexRender extends MathRenderer { ... // new by changes 2016 var $url = ""; var $text = ""; ... /* function replaced with function __constructor below by changes 2016 function LatexRender($picture_path,$picture_path_httpd,$tmp_dir) { ... }  */  // new constructor combining old function LatexRender // and function renderMath from old class MathRenderer // by changes 2016 public function __construct ($latex_formula, $params = array ) { global $wgMathDirectory, $wgMathPath, $wgTmpDirectory, $wgLaTexCommand, $wgDvipsCommand, $wgImageMagickConvertCommand, $wgImageMagickIdentifyCommand;

$latex_formula = '\displaystyle '. $latex_formula;

// from old function LatexRender $this->_picture_path = $wgMathDirectory; $this->_picture_path_httpd = $wgMathPath; $this->_tmp_dir = $wgTmpDirectory; $this->_tmp_filename = md5(rand);

// check Math dir if(!file_exists($wgMathDirectory)){@mkdir($wgMathDirectory);} if(!file_exists($wgTmpDirectory)){@mkdir($wgTmpDirectory);}

// Objects $latex and $url replaced with $this by changes 2016 $this->_latex_path = $wgLaTexCommand; $this->_dvips_path = $wgDvipsCommand; $this->_convert_path = $wgImageMagickConvertCommand; $this->_identify_path = $wgImageMagickIdentifyCommand;

$this->url = $this->getFormulaURL($latex_formula);

// htmlentities for newer PHP versions changed 2016 $alt_latex_formula = htmlentities($latex_formula, ENT_QUOTES|ENT_XHTML, "UTF-8"); $alt_latex_formula = str_replace("\r", "", $alt_latex_formula); $alt_latex_formula = str_replace("\n", "", $alt_latex_formula); $alt_latex_formula = str_replace('\displaystyle ', "", $alt_latex_formula);

if($this->url != false){ $this->text = '<img src="'.$this->url.'" title="'.$alt_latex_formula.'" alt="'.$alt_latex_formula.'" />'; }   else{ $this->text = '[Unparseable or potentially dangerous latex formula. Error '.$this->_errorcode.' '.$this->_errorextra.']'; } }  ...  // new for abstract function in "MathRenderer.php" by changes 2016 public function render{ return $this->text."\n"; } ...  function renderLatex($latex_formula) { ...   // create temporary dvi file ...   $status_code = exec($command); // added checking file by changes 2016 if (!$status_code || !file_exists($this->_tmp_filename.".dvi")) { ...     $this->_errorcode = 4; return false; }   ...  }  ...  function cleanTemporaryDirectory { ...   // check existence before deleting to prevent warnings added by changes 2016 /*   unlink($this->_tmp_dir."/".$this->_tmp_filename.".tex"); ...   */    $file_types = array("tex", "aux", "log", "dvi", "ps", $this->_image_format); foreach($file_types as $f_typ){ $tmp_file = $this->_tmp_dir."/".$this->_tmp_filename.".".$f_typ; if(file_exists($tmp_file)){ unlink($tmp_file); }     $tmp_file = ""; }

chdir($current_dir); } }



Nothing shows up after saving the page
I just set up the math extension and tried to test it with. Nothing shows up when saved. The MathStatus page shows the following two errors:
 * Test Comparing the generated SVG with the reference failed.
 * Test Checking if the link to SVG image is correct failed.

(Returned string has  and the expected string has a  ).

What's the issue here? How do I fix this?

Documentation
I know this is not productive, but documentation is shit. How is it possible that the variables that Math is using are not properly documented? I could continue, but.....