On 11/15/2011 9:47 PM, Kent A. Reed wrote: > Gentle persons: > > As I understand it, the problem with the use of latexmath is that it > renders beautifully in the pdf format and is useless in the html format > of the 2.5 docs. Is that a fair read of the problem? > I withdraw my categorical remarks about rendering math in html. They used to be true but as our political administrations like to say, they have been rendered inoperative (yes, I intended the pun).
After spending some time digging through documentation, I have discovered that our existing toolchain should be able to render latexmath in both pdf and html formats. It turns out that some folks in the math community have developed a technique involving the use of a javascript function to render latexmath markup while the page is being rendered in a browser. The technique, called latexmathml, has been added to asciidoc and it looks like it should work with our existing latexmath: markup (but see below). I downloaded a test page (http://www.methods.co.nz/asciidoc/latexmathml.txt), processed it with the command "asciidoc -a latexmath latexmathml.txt". The latexmath markup was passed through to the html page and the latexmathml javascript function was embedded in the page's header; the resulting page rendered in my firefox browser exactly as did the original (http://www.methods.co.nz/asciidoc/latexmathml.html). This worked for me in our Ubuntu 10.04LTS setup including asciidoc 8.5.2 and dblatex 0.2.12 which are somewhat behind the current versions asciidoc 8.6.6 and dblatex 0.3. I tried the same command with one of the EMC2 docs/src source pages containing latexmath markup and it worked but revealed a markup problem I hadn't noticed before (see below). After a brief look at our asciidoc configuration I have some thoughts why this isn't working for our toolchain, but not wanting to reinvent the wheel again (and possibly screw up something else in the processing of EMC2 docs) I thought I should ask Pavel if he already has the answer. (To start, it looks to me like we need to add a '-a latexmath' attribute to the asciidoc processing of htmldocs and fix up xhtml11.conf, but there's more). Concerning the use of latexmath markup in our EMC2 docs, there are 47 instances of 'latexmath:' in the English *.txt files. Of these, 24 use the LaTeX '$" delimiter (e.g., latexmath:[$...$]) and 23 do not. Only the strictly LaTeX versions render properly with the new latexmathml technique. It turns out, however, that the remaining latexmath markup has not been rendering particularly well previously in the pdf format either. I don't think the authors' intentions are being met. I'll be making some recommendations. I chalk this one up in the "yes, you really can teach an old dog new tricks" column. Regards, Kent aka cncdreamer ------------------------------------------------------------------------------ All the data continuously generated in your IT infrastructure contains a definitive record of customers, application performance, security threats, fraudulent activity, and more. Splunk takes this data and makes sense of it. IT sense. And common sense. http://p.sf.net/sfu/splunk-novd2d _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
