Talk:Using TeX Notation

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)

Well, being male, things need to be simple..:) Simple things for simple minds. I agree that important information is often obscured by over-simplifying, and I am certainly guilty of that, but what I am looking at is some sort of consistency. Not being OCD myself, (like most programmers which is probably why I never was much of a programmer) I do not have the urge to track down every minor detail and render it unconscious until I find a place for it. In this case, the over abundance of detail in one aspect, and the often apparent deliberate obfuscation of that detail is appalling. You only have to look at the Mimetex manual to see what has been done there to understand my point, and that is, I think, considerably better than many other sites I went to. Essentially, I am looking at the basics and at that level, most people are not going to worry about the finer points, all they want is "can I get this to work". I suspect that most Maths teachers who are going to be using Moodle are not going to be able to get past Equation Editor, therefore Moodle is a dud as far as they are concerned. We have already seen one example of that recently and this is a simple and non-invasive way of introducing what is an extremely complex subject. Certainly, most will move on to something better than TeX Notation, but for the moment, is there a way to keep this clear and clean and as simple as possible without too much confusion? If MathJax or AsciiMath were native to Moodle, and no doubt there is strong argument to do that, then I doubt I would even have done this.--Colin Fraser 14:19, 8 August 2010 (UTC)

Also, this paragraph: