On Fri, 17 Apr 2009 12:24:35 +0200 Daniel Carrera <dcarr...@gmail.com> wrote:
> Hello, > > This is really frustrating. The math doesn't work with > reST+gitit/pandoc. How can I document patch theory without subscripts > and superscripts? Maybe it's a little premature switching format, storage and "renderer" at the same time. > I'm having a real issue with reST on gitit. You might list whatever > theoretical features reST has, but those are useless if they are not > implemented in gitit/pandoc. With markdown at least I can write > math. Please, don't confuse the two things. It's unfair talking about "theoretical features": reST is an ASCII-only representation format, pretty well documented as it is. There are quite a few toolsets that implement its specifications. The original one, Docutils, is quite good and complete, even if still in its 0.x age. The merits of the reST transition should not be obfuscated by the (currently) weaker reST support in pandoc. > It is also ironic and frustrating that forcing the switch to reST is > actually making my work *less* portable and forcing it to have *more* > HTML because (1) pandoc doesn't support reST properly and (2) reST > does not allow me to mix HTML and reST, so whenever I hit something > that pandoc cannot do but can be done with HTML (e.g. tables) I end > up having to write the whole thing in HTML. You are wrong: reST is a good media for writing discretely articolated books, and I had only a bunch of occasion where I needed to insert raw HTML, that by its own makes PDF output almost impossible. By the way of its extensibility, you keep the door open for future enhancements[1] If we want a /good/ manual, I'd suggest writing good reST, using Docutils to produce static pages at darcs apply time, until pandoc is up to the task. ciao, lele. [1] http://www1.american.edu/econ/itex2mml/mathhack.rst -- nickname: Lele Gaifax | Quando vivrò di quello che ho pensato ieri real: Emanuele Gaifas | comincerò ad aver paura di chi mi copia. l...@nautilus.homeip.net | -- Fortunato Depero, 1929. _______________________________________________ darcs-users mailing list darcs-users@darcs.net http://lists.osuosl.org/mailman/listinfo/darcs-users
