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 +`_ list of the +`MathJax web site `_. + +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:: - + -(where ``path-to-MathJax`` is the web-address of the main MathJax -directory for your server) either just before the ```` tag in -your theme file, or at the end of the file if it contains no -````. +either just before the ```` tag in your theme file, or at the end of +the file if it contains no ````. 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 `). - 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 `). .. code-block:: html - + - 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 - ` 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 ` 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 `). +Note that there is a `WordPress plugin for MathJax +`_, 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 `). .. code-block:: html - + 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 - ` 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 ` for more details.