Note: You are currently viewing documentation for Moodle 2.0. Up-to-date documentation for the latest stable version is available here: Using TeX Notation.

Talk:Using TeX Notation

From MoodleDocs
Revision as of 09:21, 8 August 2010 by Marc Grober (talk | contribs)

At this point it would not be appropriate to promote another TeX package so please be careful. it might be better to add a link to another page that could describe how to change to a full TeX package.--Colin Fraser 15:06, 13 July 2010 (UTC)

Bit inaccurate

The problem, Colin, is that a good deal of this material is inaccurate and I don;t want to start a documentation war - lol- as you know that I agree that documentation is inadequate. WHile I owuld also agree with some of your "editorializing":

The various brands of TeX and other math markup languages have become
something of a nightmare to try and find any reasonable consistency.
Most use sub-sets and variations of TeX rules and fonts and symbols
that seem to be developed on the whim of the developer rather than
any consistent mathematical strategy. Also the lack of user friendly
documentation has worked against the easy spread of knowledge here,
but what is worse, and this is the problem for the Moodle Community,
the lack of directly related documentation in using TeX Notation in
Moodle has not been helpful. (Having said these things, I am sure that
many people will disagree - but I accept there is a large difference
between what the developers of the various TeX "standards" consider
"consistent" and reality..:) ) Please help by adding your own examples
and rules to these pages. If you notice an error, please change it, if
you see something missing, please add it. 

I don't know that it belongs in the doc itself... Marc Grober 21:13, 16 July 2010 (UTC)

Do not think there is much in the way of ego here, I wax profanely due to ignorance as much as knowledge sometimes..:) That is just what I do! You might want to try reading Cicero, my kind of editorializing!!! Anyway, there is a need for accuracy, if there is anything that is so woefully inaccurate that it may reflect poorly on the value of the information that is included, please change it.--Colin Fraser 11:23, 19 July 2010 (UTC)

Marc, I am uncomfortable with the second paragraph here:

 If you are using other than the Moodle Tex filter to render Tex you may find 
 yourself using other tokens, as well as different syntax.  It is critical that 
 you understand what applications you are using to parse your text expression, 
 as well as whether the application is parsing Tex or some other syntax and what 
 application you are using to display the Math.  The Moodle Tex filter outputs 
 gif or png images based on Tex text expressions delimtied by doubledollar signs. 
 But, if you are using the Moodle Algebra filter, you will be using a parser 
 imported from webworks to parse non-Tex text expressions (algebra syntax), as in 
 @@x/y@@, though you will be using the Tex filter to actually display the resulting 
 images as png or gif.  If you use MathJax or ASCIIMathML,  you can easily change 
 the tokens you use. ASCIIMathML on its own uses backticks, as in `root(n)(x)` though 
 it can also parse Tex if delimited by dollar signs. ASCIIMathML by default outputs 
 MathML and falls back to gif or png. MathJax can output MathML or HTML-CSS. The 
 discussion below largely focuses on using Tex syntax text expressions with the Moodle 
 Tex filter.  However, much of the discussion that addresses Tex syntax can be generalized 
 to other applications that parse Tex. FYI, Moodle Docs uses mediawiki with a Tex extension 
 that employs tags for delimiters instead of tokens, as in: <math>x^2</math>

For me, this demonstrates part of the problem I have with the entire TeX/LateX/etc thing. There is so much overlap that it is easy to get tied up in qualifying statements that the main message is lost.:) --Colin Fraser 23:16, 7 August 2010 (UTC)

Colin, Any time one wishes to make something "simple" one runs the risk of obscuring important information, lol. The reason I add the text that you deleted is that you imply that tokens are absolute (they are not) and you run the risk of further confusing users as to the diffs among math notation syntax, parsers, constructors, display methods. Tex in Moodle is, for good or ill, not monolithic, but as with much of open software, a collage of this that or the other. I think there is a balance to be struck, especially in as much as so many users are doing Tex without the Moodle Tex filter, and that popuation is most likely going to grow. Marc Grober 09:21, 8 August 2010 (UTC)