[[PageOutline(2-5,Contents,pullout)]]

= ASCII-Math: Convert ASCII to MathML

== Description

This macro allows equations to be written in a simple text format using a subset of the ASCIIMathML syntax. When the page is requested, the 
ASCII text is transformed into [wikipedia:MathML MathML], which can be rendered in any capable browser: Firefox for sure, IE with the !MathPlayer plugin, maybe Opera.

To create a MathML representation of the Pythagorean theorem:
{{{
{{{#!ASCIIMath
a^2 + b^2 = c^2
}}}
}}}

and the resulting wiki page's source should now contain properly formatted MathML code for display:

[[Image(pythagorean.png)]]

For more information about formatting the ASCII code describing the equation, see the [http://www1.chapman.edu/~jipsen/mathml/asciimath.html ASCIIMathML documentation]. Some items might not display exactly as shown.

No other executables, modules, or plugins are necessary for this to work.

See [https://github.com/favalex/python-asciimathml] for more info.

== Bugs/Feature Requests

Existing bugs and feature requests for AsciiMathMacro are 
[report:9?COMPONENT=AsciiMathMacro here].

If you have any issues, create a 
[/newticket?component=AsciiMathMacro new ticket].

[[TicketQuery(component=AsciiMathMacro&group=type,format=progress)]]

== Download

Download the zipped source from [export:asciimathmacro here].

== Source

You can check out AsciiMathMacro from [/svn/asciimathmacro here] using Subversion, or [source:asciimathmacro browse the source] with Trac.

== Recent Changes

[[ChangeLog(asciimathmacro, 3)]]

== Author/Contributors

'''Author:''' [wiki:ArmstrongJ] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''