From 146fe8e15d8fead683d642bc9dd44703bffccd2b Mon Sep 17 00:00:00 2001
From: Matthias Geier <Matthias.Geier@gmail.com>
Date: Thu, 21 Mar 2019 22:52:09 +0100
Subject: [PATCH] WIP \require in Markdown cell

---
 doc/conf.py              |  5 +----
 doc/markdown-cells.ipynb | 27 ++++++++++++++-------------
 2 files changed, 15 insertions(+), 17 deletions(-)

diff --git a/doc/conf.py b/doc/conf.py
index ec188d79..b6337fd1 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -97,10 +97,7 @@
 #}
 
 mathjax_config = {
-    'TeX': {
-        'equationNumbers': {'autoNumber': 'AMS', 'useLabelIds': True},
-        'extensions': ['newcommand.js', 'begingroup.js'],
-    },
+    'TeX': {'equationNumbers': {'autoNumber': 'AMS', 'useLabelIds': True}},
 }
 
 # Additional files needed for generating LaTeX/PDF output:
diff --git a/doc/markdown-cells.ipynb b/doc/markdown-cells.ipynb
index 9515add4..e1c89c60 100644
--- a/doc/markdown-cells.ipynb
+++ b/doc/markdown-cells.ipynb
@@ -97,7 +97,10 @@
     "```\n",
     "<div hidden>\n",
     "\n",
+    "\\def\\require#1{}\n",
+    "$\\require{begingroup}\\require{newcommand}$\n",
     "$\\gdef\\vec#1{\\boldsymbol{#1}}$\n",
+    "$\\gdef\\i{\\mathrm{i}}$\n",
     "\n",
     "\\vskip-\\parskip\n",
     "\\vskip-\\baselineskip\n",
@@ -107,7 +110,10 @@
     "\n",
     "<div hidden>\n",
     "\n",
+    "\\def\\require#1{}\n",
+    "$\\require{begingroup}\\require{newcommand}$\n",
     "$\\gdef\\vec#1{\\boldsymbol{#1}}$\n",
+    "$\\gdef\\i{\\mathrm{i}}$\n",
     "\n",
     "\\vskip-\\parskip\n",
     "\\vskip-\\baselineskip\n",
@@ -123,25 +129,20 @@
     "but in LaTeX, it doesn't have any effect on later math expressions.\n",
     "Using `\\gdef` works in both.\n",
     "Sadly, `\\gdef` isn't activated by default in MathJax,\n",
-    "therefore we need some additional configuration in our `conf.py` file:\n",
+    "so we have to use `\\require` to activate the `newcommand` and `begingroup` extensions.\n",
+    "Since `\\require` is a MathJax feature that's unknown to LaTeX,\n",
+    "we'll have to provide a dummy definition to not confuse LaTeX\n",
     "\n",
-    "```python\n",
-    "mathjax_config = {\n",
-    "    'TeX': {\n",
-    "        'extensions': ['newcommand.js', 'begingroup.js'],\n",
-    "    },\n",
-    "}\n",
-    "\n",
-    "```\n",
-    "\n",
-    "With the above definition and the `conf.py` setting in place,\n",
+    "With the above definitions,\n",
     "you can use your new macro like this:\n",
     "\n",
     "```\n",
     "$2 \\vec{a} + \\vec{b}$\n",
     "```\n",
     "\n",
-    "... which looks like this: $2 \\vec{a} + \\vec{b}$"
+    "... which looks like this: $2 \\vec{a} + \\vec{b}$.\n",
+    "\n",
+    "You can of course use as many `\\gdef` lines as you want."
    ]
   },
   {
@@ -556,7 +557,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.7.2+"
+   "version": "3.7.3rc1"
   }
  },
  "nbformat": 4,