commit ae68387564c0a8263df5cf4dfe29c7f10befdef0
parent 34b8a4cd43467dbcc99241885dca3c84c6271f45
Author: Davide P. Cervone <dpvc@union.edu>
Date: Fri, 4 Mar 2011 11:12:44 -0500
Update jsMath conversion documentation
Diffstat:
1 file changed, 23 insertions(+), 5 deletions(-)
diff --git a/docs/source/jsMath.rst b/docs/source/jsMath.rst
@@ -19,13 +19,31 @@ class="math">...</span>`` and ``<div class="math">...</div>`` tags to
mark the mathematics in your document, then you should use MathJax's
``jsMath2jax`` preprocessor when you switch to MathJax. To do this,
include ``"jsMath2jax.js"`` in the `extensions` array of your
-configuration, with the `jax` array set to include ``"input/TeX"``.
+configuration, with the `jax` array set to include ``"input/TeX"``. For
+example,
-.. code-block:: javascript
+.. code-block:: html
- extensions: ["jsMath2jax.js"],
- jax: ["input/TeX", ...]
+ <script type="text/x-mathjax-config">
+ MathJax.Hub.Config({
+ extensions: ["jsMath2jax.js"]
+ });
+ </script>
+ <script
+ src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML">
+ </script>
+
+would load the ``jsMath2jax`` preprocessor, along with a configuration
+file that processes TeX input and produces HTML-with-CSS output.
There are a few configuration options for ``jsMath2jax``, which you
-can find in the ``config/MathJax.js`` file, or in the :ref:`jsMath
+can find in the ``config/default.js`` file, or in the :ref:`jsMath
configuration options <configure-jsMath2jax>` section.
+
+If you are generating your jsMath documents programmatically, it would be
+better to convert from generating the jsMath ``<span>`` and ``<div>`` tags
+to producing the corresponding MathJax ``<script>`` tags. You would use
+``<script type="math/tex">`` in place of ``<span class="math">`` and
+``<script type="math/tex; mode=display">`` in place of ``<div
+class="math">``. See the section on :ref:`How mathematics is stored in the
+page <mathjax-script-tags>` for more details.
