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

= ASCII-Math: Convert ASCII to MathML

== Description

This macro allows mathematical expressions to be written in a simple text format using a subset of the ASCIIMathML syntax and subsequently displayed on your Trac wiki page. 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. See [https://caniuse.com/mathml Can I use] for current browser support.

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://asciimath.org/ ASCIIMathML documentation]. See also [https://github.com/ShadowKyogre/python-asciimathml] for more info, or [https://github.com/favalex/python-asciimathml] for an older version.

No other executables, modules, or plugins are necessary for this to work. However, where items do not display exactly as shown, a better alternative is TracMathJaxPlugin, which relies on an external library and has global support by the scientific community.

== 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.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(asciimathmacro, 3)]]

== Author/Contributors

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