Merge commit '832d0679c4d1f7ecef1e74386f17b6e67a219b89'

Author: mvdebolskiy

docs/conf.py

@@ -138,7 +138,7 @@
 html_favicon = "img/es-logo.ico"
 
 mathjax_path="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"
-mathjax_path = "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML"
+mathjax_path = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js"
 suppress_warnings = ["myst.header","image.not_readable"]
 
 #def setup(app):

docs/learning/notebooks/markdown_example.ipynb

@@ -5,7 +5,23 @@
    "id": "028448b2",
    "metadata": {},
    "source": [
-    "# How to use Markdown in Jupyter notebook"
+    "# How to use Markdown in Jupyter notebook\n",
+    "<!-- code below is just to render mathjax on the doc-pages-->\n",
+    "<script type=\"text/javascript\" id=\"MathJax-script\" async\n",
+    "  src=\"https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js\">\n",
+    "</script>\n",
+    "<script type=\"text/x-mathjax-config\">\n",
+    "  MathJax.Hub.Config({\n",
+    "    tex2jax: {\n",
+    "      inlineMath: [ ['$','$'], [\"\\\\(\",\"\\\\)\"] ],\n",
+    "      processEscapes: true\n",
+    "    }\n",
+    "  });\n",
+    "</script>\n",
+    "    \n",
+    "<script type=\"text/javascript\"\n",
+    "        src=\"https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML\">\n",
+    "</script>"
    ]
   },
   {
@@ -44,7 +60,9 @@
    "id": "1b122974",
    "metadata": {},
    "source": [
-    "We herby define a function $f(x)$ the following way:\n",
+    "## Equations:\n",
+    "\n",
+    "We herby define a function $f(x)$ `(in-line math is done by $f(x)$)`the following way:\n",
     "```md\n",
     "$$f(x)=\\frac{x-1}{x^2}$$\n",
     "```\n",
@@ -57,12 +75,12 @@
    "id": "c8b9bfac",
    "metadata": {},
    "source": [
-    "Now let's define the integrted number concentration $N_{\\rm tot}$:\n",
+    "Now let's define the integrted number concentration $N_{\\rm tot}$ `(in-line math is done by  $N_{\\rm tot}$)`:\n",
     "```md\n",
     "$$N_{\\rm tot}=\\int_{D_{min}}^{D_{max}}\\frac{dN}{d\\log D} d\\log D \\quad\\quad\\quad(1)$$\n",
     "```\n",
     "\n",
-    "$N_{\\rm tot}=\\int_{D_{min}}^{D_{max}}\\frac{dN}{d\\log D} d\\log D \\quad\\quad\\quad(1)$"
+    "$$N_{\\rm tot}=\\int_{D_{min}}^{D_{max}}\\frac{dN}{d\\log D} d\\log D \\quad\\quad\\quad(1)$$"
    ]
   },
   {
@@ -82,7 +100,13 @@
    "id": "9867454d",
    "metadata": {},
    "source": [
-    "<img src=\"Zeppelin.jpg\" alt=\"Alt text that describes the graphic\" title=\"Title text\" />"
+    "To add a local image:\n",
+    "\n",
+    "```md\n",
+    "![Zeppelin](./Zeppelin.jpg) \n",
+    "```\n",
+    "![Zeppelin](../../../_build/_images/Zeppelin.jpg)\n",
+    "\n"
    ]
   },
   {