Trent W. Buck wrote:
AFAIK, markdown "supports" mathematics by allowing users to insert raw HTML. This has two key problems:
Pandoc "supports" TeX inside Markdown in the sense that it can call up a JavaScript library to convert the TeX. One library, jsMath, replaces the TeX with gifs. I used to think that this was the only option, but another alternative is a library that converts it to MathML.
I'm actually quite unhappy about you using .. raw:: html in the reST sources, and I'm only acceding to it because pandoc's reST support is indeed quite shit at present, and I hope it will improve in the short- to mid-term.
I was sure that you and others would be unhappy. And to be honest, I'm not thrilled either. It's a bastardization of the whole idea of using reST. But after speaking with Eric it was clear that that the priority is to make progress.
I use tables in the patch theory section for navigation ('Prev', 'Up' and 'Next' links) and for presentation (e.g. showing a patch on the left and its effect on the right, or showing a patch on the left, and its inverse on the right).With respect, it sounds like you're obsessing about the presentation of the document. That's not the author's job, it's the typesetter's job.
Presentation is not an unimportant thing that you can just forget about and just let the broken type-setter do what it will. As an experienced math teacher and an experienced technical writer, I know that how you present a concept (even graphically) can make a big difference to how quickly the audience picks up the concept. I have learned similar things when I studied UI design and so on. Some UI layouts can make a concept feel more natural to the reader and can often be more effective than a lengthy explanation.
Daniel. _______________________________________________ darcs-users mailing list [email protected] http://lists.osuosl.org/mailman/listinfo/darcs-users
