X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/f760fcfa3fe4660831f30651c203c3c9686c7bae..651cdd4b2a85f4e5f9d298a7eea7d0e6d94442b1:/doc/todo/latex.mdwn?ds=sidebyside diff --git a/doc/todo/latex.mdwn b/doc/todo/latex.mdwn index f23f0a254..4b9413ca2 100644 --- a/doc/todo/latex.mdwn +++ b/doc/todo/latex.mdwn @@ -1,16 +1,24 @@ How about a plugin adding a -[[preprocessor_directive|preprocessordirective]] to render some given LaTeX +[[preprocessor_directive|ikiwiki/directive]] to render some given LaTeX and include it in the page? This could either render the LaTeX as a PNG via -[[debpkg dvipng]] and include the resulting image in the page, or perhaps +[[!debpkg dvipng]] and include the resulting image in the page, or perhaps render via [HeVeA](http://pauillac.inria.fr/~maranget/hevea/index.html), [TeX2page](http://www.ccs.neu.edu/~dorai/tex2page/tex2page-doc.html), or similar. Useful for mathematics, as well as for stuff like the LaTeX version of the ikiwiki [[/logo]]. +> [[users/JasonBlevins]] has also a plugin for including [[LaTeX]] expressions (by means of `itex2MML`) -- [[plugins/mdwn_itex]] (look at his page for the link). --Ivan Z. + +>> I've [[updated|mdwn_itex]] Jason's plugin for ikiwiki 3.x. --[[wtk]] + +>>> I've updated [[Jason's pandoc plugin|users/jasonblevins]] to permit the TeX processing to be managed via Pandoc. See for details. --Profjim + ---- ikiwiki could also support LaTeX as a document type, again rendering to HTML. +> [[users/JasonBlevins]] has also a [[plugins/pandoc]] plugin (look at his page for the link): in principle, [Pandoc](http://johnmacfarlane.net/pandoc/) can read and write [[LaTeX]]. --Ivan Z. + ---- Conversely, how about adding a plugin to support exporting to LaTeX? @@ -23,12 +31,19 @@ Conversely, how about adding a plugin to support exporting to LaTeX? >>> Have a look at [pandoc](http://code.google.com/p/pandoc/). It can make PDFs via pdflatex. --[[roktas]] +>>>> Interesting, just yesterday I was playing with pandoc to make PDFs from my Markdown. Could someone advise me on how to embed these PDFs into ikiwiki? I need some guidance in implementing this. --[[JosephTurian]] + +>>>> [[users/JasonBlevins]] has a [[plugins/pandoc]] plugin (look at his page for the link). --Ivan Z. + ---- [here](http://ng.l4x.org/gitweb/gitweb.cgi?p=ikiwiki.git/.git;a=blob;f=IkiWiki/Plugin/latex.pm) is a first stab at a latex plugin. Examples [here](http://ng.l4x.org/latex/). Currently without image support for hevea. And the latex2html output has the wrong charset and no command line switch to change that. Dreamland. +As this link is not working, I setted a mirror here: http://satangoss.sarava.org/ikiwiki/latex.pm. + + ---- Okay, now is the time for a mid term report i think. @@ -167,24 +182,63 @@ Okay, the last version of the tex plugin for ikiwiki can be downloaded [here](ht > fixed a bug (the first time it was run, it tried to write the png file > before the teximages/ directory existed) and checked the result in. > -> Can you please flesh out [[plugins/tex]] with +> Can you please flesh out [[plugins/teximg]] with > whatever documentation people who know tex will expect to see? -> + +Okay, I'll fill this up today I think with information about the plugin + +Done. Is that docu fine with you? + +>> Perhaps add some documentation about the kind of tex code that can be +>> used, or a link to some documentation so people who don't know latex +>> well can figure this out? + > Also, please review my changes. In particular, I changed the @badthings > array to use qr//, which is much clearer, but it needs to be tested that > I didn't break the checking code when I did it. It would be nice to write > a test case that tries to feed it bad code and makes sure it rejects it. + +I'll test this now on my server. I'll report here later. +Okay, checked. it works fine. My blacklist tests were successfull. + > -> Question: does it really make sense to have an alt tag for the image +> Does it really make sense to have an alt tag for the image > that contains the tex code? Will that make any sense when browsing > without images? -> + +Mh.. For people who know latex very well this would be enough to imagine how the image would look like. +This are of course the minority of people (but I guess also the minority of people are using non-gui browsers). + + + +> I'm thinking about renameing the preprocessor directive to teximg. +> \[[!teximg code="" alt="foo"]] makes sense.. Would it make sense to rename +> the whole plugin, or do you think that other tex stuff should go in this +> same plugin? + +I'll think over this until I'm at work ;) Only for rendering images... not for generating .tex files .../wiki/ +the name is all the same i think. If you like teximg better than switch :) + + > Note: I removed the style= attribute, since as I've told you, the > htmlsanitizer strips those since they can be used to insert javascript. I > put in a class=teximage instead; the style sheet could be modified to > style that, if you want to send a patch for that. + +Ah yes.. sorry forgot to update the plugin in my public_html folder %-). This was my last change in this plugin :) Sorry. + + > > --[[Joey]] -[[tag soc]] -[[tag wishlist]] +----- + +I'm using a [plugin](http://metameso.org/~joe/math/tex.pm) created by [Josef Urban](http://www.cs.ru.nl/~urban) that gets LaTeX into ikiwiki by using [LaTeXML](http://dlmf.nist.gov/LaTeXML). This could well be "the right way" to go (long term) but the plugin still does not render math expressions right, because ikiwiki is filtering out requisite header information. Examples (I recommend you use Firefox to view these!) are available [here](http://li101-104.members.linode.com/aa/math/) and [here](http://li101-104.members.linode.com/aa/simple/). Compare that last example to the [file generated by LaTeXML directly](http://metameso.org/~joe/math/math.xml). I posted the sources [here](http://metameso.org/aa/sources/) for easy perusal. How to get ikiwiki to use the original DOCTYPE and html fields? I could use some help getting this polished off. --[[jcorneli]] + +> update: it seems important to force the browser to think of the content as xml, e.g. [http://metameso.org/~joe/math/example.xml](http://metameso.org/~joe/math/example.xml) has the same source code as [http://metameso.org/~joe/math/example.html](http://metameso.org/~joe/math/example.html) and the former shows math working, but the latter doesn't. --[[jcorneli]] + +>> Looking at the source code, it seems Ikiwiki is doing more than filtering header information - it is filtering out all HTML formatting around MathML constituent objects. In the first example, we see that formatting for tables and such is preserved. --[[jcorneli]] + + +[[!tag soc]] +[[!tag wishlist]]