From a47e87bbb6fde812bcffd7e89314b2586c9fed7d Mon Sep 17 00:00:00 2001
From: Konstantin Podsvirov <konstantin@podsvirov.pro>
Date: Wed, 9 Nov 2022 23:23:40 +0300
Subject: [PATCH] MathJax: Documentation

---
 guide/src/format/mathjax.md | 69 ++++++++++++++++++++++++++++++++-----
 1 file changed, 61 insertions(+), 8 deletions(-)

diff --git a/guide/src/format/mathjax.md b/guide/src/format/mathjax.md
index 3dd79215..3f9aa967 100644
--- a/guide/src/format/mathjax.md
+++ b/guide/src/format/mathjax.md
@@ -3,14 +3,6 @@
 mdBook has optional support for math equations through
 [MathJax](https://www.mathjax.org/).
 
-To enable MathJax, you need to add the `mathjax-support` key to your `book.toml`
-under the `output.html` section.
-
-```toml
-[output.html]
-mathjax-support = true
-```
-
 >**Note:** The usual delimiters MathJax uses are not yet supported. You can't
 currently use `$$ ... $$` as delimiters and the `\[ ... \]` delimiters need an
 extra backslash to work. Hopefully this limitation will be lifted soon.
@@ -41,3 +33,64 @@ you would write:
 ```bash
 \\[ \mu = \frac{1}{N} \sum_{i=0} x_i \\]
 ```
+
+## MathJax 2
+
+To enable MathJax 2, you need to add the `mathjax-support` key to your `book.toml`
+under the `output.html` section.
+
+```toml
+[output.html]
+mathjax-support = true
+```
+
+## MathJax 3
+
+To enable MathJax 3, you need to add the `enable` key to your `book.toml`
+under the `output.html.mathjax` section.
+
+```toml
+[output.html.mathjax]
+enable = true
+```
+>**Note:** Remove or set to the `false` value the `mathjax-support` key
+> under the `output.html` section if you set it previously.
+
+Additionaly you can set `config` key to select used [configuration][comb-comp].
+You can select one of:
+
+| Value | Input | Output | Default
+| :-- | :-- | :-- | :--
+| tex-chtml | tex | chtml |
+| tex-chtml-full | tex | chtml |
+| tex-svg | tex | svg |
+| tex-svg-full | tex | svg |
+| tex-mml-chtml | tex, mml | chtml | yes
+| tex-mml-svg | tex, mml | svg |
+| mml-chtml | mml | chtml |
+| mml-svg | mml | svg |
+
+Use the `source` key to set used MathJax distribution.
+By default the `https://cdn.jsdelivr.net/npm/mathjax@3/es5` value is used.
+If value starts with `/` symbol it will be interpreted relative
+to [source/build](configuration/general.md) directory.
+
+For example to use local MathJax copy for tex input and svg output you can
+do something like:
+
+```console
+$ wget https://github.com/mathjax/MathJax/archive/refs/tags/3.2.2.tar.gz
+$ tar -xf 3.2.2.tar.gz MathJax-3.2.2/es5
+$ mv MathJax-3.2.2 src/mathjax@3
+```
+
+Then add to your `book.toml` file:
+
+```toml
+[output.html.mathjax]
+enable = true
+source = "/mathjax@3/es5"
+config = "tex-svg"
+```
+
+[comb-comp]: https://docs.mathjax.org/en/v3.2-latest/web/components/combined.html