@@ -309,11 +309,17 @@ For further documentation, see the `pandoc(1)` man page.
309 It is selected automatically when the output format is `latex` or
309 It is selected automatically when the output format is `latex` or
310 `context`.)
310 `context`.)
312−`-m` or `--asciimathml`
312+`-m`*[URL]* or `--asciimathml=`*[URL]*
313: will cause LaTeX formulas (between $ signs) in HTML or S5 to display
313: will cause LaTeX formulas (between $ signs) in HTML or S5 to display
314 as formulas rather than as code. The trick will not work in all
314 as formulas rather than as code. The trick will not work in all
315 browsers, but it works in Firefox. Peter Jipsen's [ASCIIMathML]
315 browsers, but it works in Firefox. Peter Jipsen's [ASCIIMathML]
316− script is used to do the magic.
316+ script is used to do the magic. If a local copy of `ASCIIMathML.js`
317+ is available on the webserver where the page will be viewed,
318+ provide a *URL* and a link will be inserted in the generated
319+ HTML or S5. If no *URL* is provided, the contents of the script
320+ will be inserted directly; this provides portability at the price of
321+ efficiency. If you plan to use math on several pages, it is much
322+ better to link to a copy of `ASCIIMathML.js`, which can be cached.
318`-i` or `--incremental`
324`-i` or `--incremental`
319: causes all lists in S5 output to be displayed incrementally by
325: causes all lists in S5 output to be displayed incrementally by
@@ -784,10 +790,9 @@ closing $ must have a character immediately to its left. Thus,
784`$20,000 and $30,000` won't parse as math. The $ character can be
790`$20,000 and $30,000` won't parse as math. The $ character can be
785escaped with a backslash if needed.
791escaped with a backslash if needed.
787−If you pass the `-m` (`--asciimathml`) option to `pandoc`, it will
793+Pandoc can use the [ASCIIMathML] script to display LaTeX formulas
788−embed the [ASCIIMathML] script in the resulting HTML. This will
794+in HTML (at least on better browsers). See above on the
789−cause LaTeX math to be displayed as formulas in better
795+`-m|--asciimathml` command-line option.
792[ASCIIMathML]: http://www1.chapman.edu/~jipsen/asciimath.html
797[ASCIIMathML]: http://www1.chapman.edu/~jipsen/asciimath.html
@@ -797,7 +802,7 @@ include BibTeX citations:
798 This result was proved in \cite{jones.1967}.
803 This result was proved in \cite{jones.1967}.
800−You can also use LaTeX environments. For example,
805+Note that in LaTeX environments, like
802 \begin{tabular}{|l|l|}\hline
807 \begin{tabular}{|l|l|}\hline
803 Age & Frequency \\ \hline
808 Age & Frequency \\ \hline
@@ -806,17 +811,8 @@ You can also use LaTeX environments. For example,
806 36--45 & 22 \\ \hline
811 36--45 & 22 \\ \hline
807 \end{tabular}
812 \end{tabular}
809−Note, however, that material between the begin and end tags will
814+the material between the begin and end tags will be interpreted as raw
810−be interpreted as raw LaTeX, not as markdown.
815+LaTeX, not as markdown.
812−[^2]: If you are serving several pages that use ASCIIMathML, it will be
813− more efficient to link to an external copy of `ASCIIMathML.js`
814− instead of using the `-m|--asciimathml` option to embed it directly
815− in web pages. To do this, get a copy of `ASCIIMathML.js` from the
816− [ASCIIMathML] website and make it available on your webserver. Then
817− create a custom header for your web page that includes the line
819− <script src="/path/to/ASCIIMathML.js"></script>
821Custom headers
817Custom headers
822==============
818==============