docs: fix rendering of math equations

Lightning-AI · Mar 21, 2024 · 77c4a8e · 77c4a8e
1 parent 3492f14
commit 77c4a8e
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 3 deletions.
diff --git a/.github/workflows/docs-build.yml b/.github/workflows/docs-build.yml
@@ -14,12 +14,11 @@ defaults:
     shell: bash
 
 jobs:
-  build-docs:
+  docs-make:
     uses: Lightning-AI/utilities/.github/workflows/check-docs.yml@v0.11.0
     with:
       python-version: "3.10"
       requirements-file: "requirements/docs.txt"
-      install-tex: true
 
   deploy-docs:
     needs: docs-make

diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -92,7 +92,7 @@ def _transform_changelog(path_in: str, path_out: str) -> None:
     "sphinx.ext.linkcode",
     "sphinx.ext.autosummary",
     "sphinx.ext.napoleon",
-    "sphinx.ext.imgmath",
+    'sphinx.ext.mathjax',
     "myst_parser",
     "nbsphinx",
     "sphinx_autodoc_typehints",
@@ -209,6 +209,13 @@ def _transform_changelog(path_in: str, path_out: str) -> None:
     (master_doc, project + ".tex", project + " Documentation", author, "manual"),
 ]
 
+# MathJax configuration
+mathjax3_config = {
+    'tex': {
+        'packages': {'[+]': ['ams', 'newcommand', 'configMacros']}
+    },
+}
+
 # -- Options for manual page output ------------------------------------------
 
 # One entry per manual page. List of tuples