doc/todo/latex.mdwn

   1 How about a plugin adding a
   2 [[preprocessor_directive|preprocessordirective]] to render some given LaTeX
   3 and include it in the page?  This could either render the LaTeX as a PNG via
   4 [[debpkg dvipng]] and include the resulting image in the page, or perhaps
   5 render via [HeVeA](http://pauillac.inria.fr/~maranget/hevea/index.html),
   6 [TeX2page](http://www.ccs.neu.edu/~dorai/tex2page/tex2page-doc.html), or
   7 similar. Useful for mathematics, as well as for stuff like the LaTeX version
   8 of the ikiwiki [[/logo]].
   9
  10 ----
  11
  12 ikiwiki could also support LaTeX as a document type, again rendering to HTML.
  13
  14 ----
  15
  16 Conversely, how about adding a plugin to support exporting to LaTeX?
  17
  18 >> I did some tests with using Markdown and a customized HTML::Latex and html2latex
  19 >> and it appears it will work for me now. (I hope to use ikiwiki for many
  20 >> to collaborate on a printed book that will be generated at least once per day in PDF format.)
  21 >>
  22 >> --JeremyReed
  23
  24 >>> Have a look at [pandoc](http://code.google.com/p/pandoc/).  It can make PDFs via pdflatex. --[[roktas]]
  25
  26 ----
  27
  28 [here](http://ng.l4x.org/gitweb/gitweb.cgi?p=ikiwiki.git/.git;a=blob;f=IkiWiki/Plugin/latex.pm) is a first stab at
  29 a latex plugin. Examples [here](http://ng.l4x.org/latex/). Currently without image support for hevea. And the latex2html
  30 output has the wrong charset and no command line switch to change that. Dreamland.
  31
  32 ----
  33
  34 Okay, now is the time for a mid term report i think.
  35
  36 The LaTeX Plugin for ikiwiki is now usable, except for the security check. This means at the moment the latex code is not validated, but only added into a very basic latex template. and the image is generated via this path: latex -> dvips -> convert (.tex -> .dvi -> .ps -> .png).
  37 The resulting .png is moved into the imagefolder. The name of this image is the md5hash of the code the user wrote into the wiki. So on a second run there is no need to recreate this image, if it exists. This will fasten up all but the first generation of the page.
  38 The generation of the image is done in an temporary folder in /tmp created with tempdir from File::Temp. The tmp-folder name is something like: $md5sumdigest.XXXXXXXX. if there is an .tex file already in this dir it will be overwritten.
  39
  40 So until now i finished the basic things, now the most important task is to make an good input validation.
  41 This is a bit eased since it is not possible to execute shell commands in perl. Furthermore adding additional packages won't work since the code comes from the user is inserted after \begin{document}. Therefore this will result in an error (and this will stop latex from working --> no image is created).
  42
  43 So my task for the next weeks is to write an good input validation.
  44 I think this progress is okay, since I'll had to learn the last 5-6 weeks for my final exams in university therefore I can't do anything. From now on I have 3 months of freetime and I'll use them to work heavily on this plugin.
  45 So I think I'm inside my own timetable. :)
  46
  47 ps: Since I found nothere the possibility to upload an file, here is an link to my page where you can have a look. Comments are very welcome ;-)
  48 https://www.der-winnie.de/~winnie/gsoc07/tex.pm
  49
  50 You'll find an demo site here:
  51 https://www.der-winnie.de/wiki/opensource/gsoc2007/
  52 I'll add some more complex formulas over the days. But this is basically only pure latex. ;-)
  53
  54 -- Patrick Winnertz
  55
  56 > Looks like you're very well on schedule.
  57
  58 > But I wonder: Do you have any plans to work on the latex to html side of
  59 > things too? This page kinda combines both uses of latex; creating gifs
  60 > for formulas etc, and creating html. Dreamland already has a latex2html
  61 > using plugin submitted above, but it still needs some work, and
  62 > particularly, needs the same input validation stuff. And then there's the
  63 > idea of using html2latex, to convert an ikiwiki site into a book. Any
  64 > plans to work on that too? I guess I'm not sure what the scope is of what
  65 > you plan to do as part of GSoC.
  66
  67 Yes I plan to write an html -> tex (or pdf) plugin as well. But I think it is better to work first on the first one and complete it and then work and complete the second one. If it is in the scope of GSoC i don't know, but I'll write it since it is fun to write on an Opensource project ;-)
  68
  69 For latex-> html:
  70 I have the problem that I don't really see the sense to create html code (this means text or charts) from latex code. But if you like I can also add this variant to create html code. In my eyes it is much more important that it is possible to have complex chemical/physical & math formulas on the website without the need to use extern programs. (and upload the pictures manually).
  71
  72
  73 ### code review
  74
  75 > The main problem I see with the code is that you seem to unnecessarily create a dummy div tag
  76 > in preprocess, and then in format you call create(), which generates an img tag. So, why not
  77 > just create the img tag in preprocess?
  78
  79 Mh okay, I'll improve this.
  80
  81 > Another problem: Looks like if latex fails to create the image, the user won't be shown any
  82 > of its error message, but just "failed to generate image from code". I suspect that in this
  83 > case being able to see the error message would be important.
  84
  85 Yes, that's true. It would be _very_ hard to provide the user the output of latex since this is really very much. For an simple formula as \frac{1}{2} this could be 2 printed out.
  86
  87 > The url handling could stand to be improved. Currently it uses $config{url}, so it depends on that being set. Some ikiwiki builds don't have an url set. The thing to do is to use urlto(), to generate a nice relative url from the page to the image.
  88
  89 Mh... i choose one single dir explizitly since if you use on several pages the same formula  this would really improve the time to generate the formulas and it would waste extra space if you store every formula 3-4 times. But if you really like I'll change this behaviour.
  90
  91
  92 > Another (minor) problem with the url handling is that you put all the images in a "teximages" directory in the toplevel of the wiki. I think it would be better to put each image in the subdirectory for the page that created it. See how the `img` and `sparkline` plugins handle this.
  93
  94 > It looks like if the tempdir already exists, tempdir() will croak(), thus crashing ikiwiki. It would be good to catch a failure there and fail more gracefully.
  95 Okay, I'll improve this behaviour. Maybe: if tempdir croak rerun it to get another not existing dir? (But only x times so that this is no endless loop, with x maybe = 3).
  96 Then it would not be necessary to inform the user about not generating the image.
  97
  98 > I'm not sure why you're sanitising the PATH before calling latex. This could be problimatic on systems where latex is not in /bin or /usr/bin
  99
 100 Okay what do you suggest to use as PATH?
 101 I'll have to change the default settings, since we ikiwiki runs in taint mode. (which is good ;-))
 102
 103 > --[[Joey]]
 104
 105 -- [[PatrickWinnertz]]
 106
 107 ----
 108
 109 [[tag soc]]