From 8f0f906374d638e612dcaaa629b51f89617d5c2d Mon Sep 17 00:00:00 2001
From: "Davide P. Cervone" <dpvc@union.edu>
Date: Sun, 6 Mar 2011 13:18:12 -0500
Subject: [PATCH] Update platform installation pages
---
docs/source/platforms/index.rst | 23 ++++++++++++++++++-----
docs/source/platforms/movable-type.rst | 19 ++++++++-----------
docs/source/platforms/wordpress.rst | 22 +++++++++++-----------
3 files changed, 37 insertions(+), 27 deletions(-)
diff --git a/docs/source/platforms/index.rst b/docs/source/platforms/index.rst
index 2349c3d85..db6fb5a11 100644
--- a/docs/source/platforms/index.rst
+++ b/docs/source/platforms/index.rst
@@ -4,6 +4,20 @@
Using MathJax in popular web platforms
======================================
+MathJax plugins are available for a growing number of wikis, blogs, and
+other content-management systems. These include WordPress, Blogger,
+Sphinx, TiddlyWiki, and MathEL-Wiki. A list of these is available in the
+`web applications and integrations
+<http://www.mathjax.org/community/mathjax-in-use/#web-apps>`_ list of the
+`MathJax web site <http://www.mathjax.org>`_.
+
+If the program you are using is not one of these, you may still be able to
+use MathJax by modifying the theme or template for your wiki or blog.
+
+
+Using MathJax in a Theme File
+=============================
+
Most web-based content-management systems include a theme or template
layer that determines how the pages look, and that loads information
common to all pages. Such theme files provide one popular way to
@@ -16,12 +30,11 @@ you.
To enable MathJax in your web platform, add the line::
- <script type="text/javascript" src="path-to-MathJax/MathJax.js"></script>
+ <script type="text/javascript"
+ src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
-(where ``path-to-MathJax`` is the web-address of the main MathJax
-directory for your server) either just before the ``</head>`` tag in
-your theme file, or at the end of the file if it contains no
-``</head>``.
+either just before the ``</head>`` tag in your theme file, or at the end of
+the file if it contains no ``</head>``.
The theme files for various popular platforms are:
diff --git a/docs/source/platforms/movable-type.rst b/docs/source/platforms/movable-type.rst
index c98725991..54ff1a67b 100644
--- a/docs/source/platforms/movable-type.rst
+++ b/docs/source/platforms/movable-type.rst
@@ -4,9 +4,6 @@
Using MathJax in Movable Type
=============================
-These instructions assume you already have placed the MathJax files on
-your server (see :ref:`Installing and Testing MathJax <installation>`).
-
1. Open Moveable Type Admin interface for the site on which you want to enable
MathJax.
@@ -25,17 +22,17 @@ your server (see :ref:`Installing and Testing MathJax <installation>`).
.. code-block:: html
- <script type="text/javascript" src="path-to-MathJax/MathJax.js"></script>
+ <script type="text/javascript"
+ src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
+ </script>
- where ``path-to-MathJax`` is replaced by the web-address of the
- main MathJax dorectory on your server.
+ to load MathJax from our distributed netowrk service.
.. image:: ../images/mt_head.png
-5. Save the file. This should enable MathJax, so you should be able
- to start adding mathematical content to your pages. Use the
- ``config/MathJas.js`` file in the MathJax directory to configure
- MathJax to your needs (see :ref:`Configuring MathJax
- <configuration>` for details).
+5. Save the file. This will enable MathJax with both TeX and MathML
+ input, so you should be able to start adding mathematical content to
+ your pages. If you need to adjust the configuraiton, see
+ :ref:`Configuring MathJax <loading>` for more details.
diff --git a/docs/source/platforms/wordpress.rst b/docs/source/platforms/wordpress.rst
index efe1063eb..ef3df88c6 100644
--- a/docs/source/platforms/wordpress.rst
+++ b/docs/source/platforms/wordpress.rst
@@ -4,8 +4,9 @@
Installing MathJax in WordPress
===============================
-These instructions assume you already have placed the MathJax files on
-your server (see :ref:`Installing MathJax <installation>`).
+Note that there is a `WordPress plugin for MathJax
+<http://wordpress.org/extend/plugins/mathjax-latex/>`_, so that may be a
+better choice than editing the theme directly.
1. Open the WordPress admin interface.
@@ -28,15 +29,14 @@ your server (see :ref:`Installing MathJax <installation>`).
.. code-block:: html
- <script type="text/javascript" src="path-to-MathJax/MathJax.js"></script>
+ <script type="text/javascript"
+ src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
+ </script>
just before that. Otherwise, insert the same code at the very
- bottom of the file. Here, ``path-to-MathJax`` should be replaced
- by the web-address of the main MathJax directory on your server,
- e.g., ``src="/mathjax/MathJax.js"``.
+ bottom of the file.
-4. Save the file. This should enable MathJax, so you should be able to
- start adding mathematical content to your pages. Use the
- ``config/MathJas.js`` file in the MathJax directory to configure
- MathJax to your needs (see :ref:`Configuring MathJax
- <configuration>` for details).
+4. Save the file. This will enable MathJax with both TeX and MathML
+ input, so you should be able to start adding mathematical content to
+ your pages. If you need to adjust the configuraiton, see
+ :ref:`Configuring MathJax <loading>` for more details.