DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:mathjax

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Both sides next revision
plugin:mathjax [2020-10-27 18:27]
liffiton Update all docs links to v2.7-latest. Add note on 2.7 v 3.x.
plugin:mathjax [2020-12-15 05:58] (current)
liffiton [MathJax Plugin]
Line 6: Line 6:
 email      : liffiton@gmail.com email      : liffiton@gmail.com
 type       : action, syntax type       : action, syntax
-lastupdate : 2018-06-23+lastupdate : 2020-12-14
 compatible : Hogfather, Greebo, Frusterick Manners, Ponder Stibbons, Rincewind, Angua, Adora Belle, Weatherwax, Binky, 2014-09-29 "Hrun", Detritus, Elenor of Tsort compatible : Hogfather, Greebo, Frusterick Manners, Ponder Stibbons, Rincewind, Angua, Adora Belle, Weatherwax, Binky, 2014-09-29 "Hrun", Detritus, Elenor of Tsort
 depends    :  depends    : 
Line 23: Line 23:
 This plugin adds [[http://www.mathjax.org/|MathJax]] to your wiki pages to let you easily write mathematical formulas that will be typeset and displayed cleanly.  It is written to be as simple as possible; it loads and configures the script, protects TeX math expressions from other parsing, and no more. This plugin adds [[http://www.mathjax.org/|MathJax]] to your wiki pages to let you easily write mathematical formulas that will be typeset and displayed cleanly.  It is written to be as simple as possible; it loads and configures the script, protects TeX math expressions from other parsing, and no more.
  
-It has been tested with MathJax version 2.7.x, the default MathJax version loaded by the plugin is 2.7.x, and all of the links to documentation here point to the v2.7 documentation.  The plugin //probably// works with MathJax v3.x as well -- it will require changing the URL in the plugin configuration -- but that has not been tested or verified to work.+It has been tested with MathJax version 2.7.x, the default MathJax version loaded by the plugin is 2.7.x, and all of the links to documentation here point to the v2.7 documentation.  The plugin //does not// work with MathJax v3.x without modifications ([[https://github.com/liffiton/dokuwiki-plugin-mathjax/issues/37|work in progress]]).
  
 ===== Installation ===== ===== Installation =====
Line 79: Line 79:
 ==== Third-Party Extensions ==== ==== Third-Party Extensions ====
  
-Some [[https://docs.mathjax.org/en/v2.7-latest/options/ThirdParty.html|third-party MathJax extensions]] may require a different configuration than the plugin's default to operate properly.  For example, it has been reported that the XyJax extension does not function with the "CHTML" renderer.  In that case, set the Dokuwiki configuration option ''plugin»mathjax»url'' to ''%%https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.4/config/TeX-AMS_HTML.js%%'' (changing it to use the ''Tex-AMS_HTML'' MathJax configuration rather than ''TeX-AMS_CHTML'') to allow XyJax to work.+Some [[https://docs.mathjax.org/en/v2.7-latest/options/ThirdParty.html|third-party MathJax extensions]] may require a different configuration than the plugin's default to operate properly.  For example, it has been reported that the XyJax extension does not function with the "CHTML" renderer.  In that case, set the Dokuwiki configuration option ''plugin»mathjax»url'' to ''%%https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=TeX-AMS_HTML.js%%'' (changing it to use the ''Tex-AMS_HTML'' MathJax configuration rather than ''TeX-AMS_CHTML'') to allow XyJax to work.
  
 ==== AsciiMath ==== ==== AsciiMath ====
  
-MathJax has the ability to parse and render [[http://asciimath.org/|AsciiMath]] markup, but it is not enabled in the default configuration of this plugin.  One easy way to enable the AsciiMath preprocessor is to use a different [[http://docs.mathjax.org/en/v2.7-latest/config-files.html|configuration file]]: set ''plugin»mathjax»url'' to ''%%https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.4/config/TeX-MML-AM_CHTML.js%%'' (That configuration enables both TeX and AsciiMath; see the list of configuration files for other options.)  You may want to modify some [[https://mathjax.readthedocs.org/en/v2.7-latest/options/asciimath2jax.html#configure-asciimath2jax|AsciiMath-specific settings]] as well. +MathJax has the ability to parse and render [[http://asciimath.org/|AsciiMath]] markup, but it is not enabled in the default configuration of this plugin.  One easy way to enable the AsciiMath preprocessor is to use a different [[http://docs.mathjax.org/en/v2.7-latest/config-files.html|configuration file]]: set ''plugin»mathjax»url'' to ''%%https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=AM_CHTML.js%%''.
 ==== Automatic Equation Numbering ==== ==== Automatic Equation Numbering ====
  
Line 100: Line 99:
 The line ''TeX: { equationNumbers: {autoNumber: "AMS"} }'' enables the equation numbering. The line ''TeX: { equationNumbers: {autoNumber: "AMS"} }'' enables the equation numbering.
  
-See the [[http://docs.mathjax.org/en/v2.7-latest/tex.html#automatic-equation-numbering|MathJax documentation]] or the [[https://cdn.rawgit.com/mathjax/MathJax/2.7.4/test/examples.html|MathJax examples page]] for the syntax for creating automatic references to equations, as well.+See the [[http://docs.mathjax.org/en/v2.7-latest/tex.html#automatic-equation-numbering|MathJax documentation]] or the [[https://cdn.rawgit.com/mathjax/MathJax/2.7.7/test/examples.html|MathJax examples page]] for the syntax for creating automatic references to equations, as well.
  
 ==== Changing default size or scale ==== ==== Changing default size or scale ====
plugin/mathjax.1603819635.txt.gz · Last modified: 2020-10-27 18:27 by liffiton