feat(docs): Enable MathJax physics package and clean up CSS

Enable the MathJax physics package to support advanced mathematical notation in documentation. This enhances the ability to render complex physics-related equations and symbols.

Additionally, this commit deprecates and removes the `api-autonav.css` file and its inclusion from `mkdocs.yaml.jinja`. This cleanup is performed because the `mkdocs-api-autonav` plugin is no longer actively used or supported in this template.

Minor stylistic improvements and browser compatibility adjustments are also included in `material.css`.

Author: liblaf

.config/cspell.config.yaml

@@ -2,6 +2,8 @@
 # This file is @generated by <https://github.com/liblaf/cspell-init>.
 # DO NOT EDIT!
 allowCompoundWords: true
+cache:
+  useCache: true
 caseSensitive: false
 enableGlobDot: true
 ignorePaths:
@@ -15,53 +17,41 @@ ignoreRandomStrings: true
 useGitignore: true
 words:
   - arithmatex
+  - chtml
   - cuda
-  - cython
   - direnv
-  - dmypy
   - elif
   - envops
+  - envrc
   - fieldz
   - getattr
   - hynek
   - inlinehilite
-  - ipynb
-  - ipython
   - libc
   - liblaf
   - mathjax
   - mkdocs
   - mkdocstrings
-  - mypy
   - numprocesses
   - numpy
-  - pipenv
-  - pixi
-  - pybuilder
   - pycache
   - pydantic
   - pydocstyle
-  - pyenv
-  - pyflow
   - pylint
   - pymdownx
   - pypa
-  - pypackages
   - pypi
   - pyplot
   - pyproject
-  - pyright
   - pyrightconfig
   - pytest
-  - pytype
   - pyvenv
   - pyvista
-  - scrapy
   - sdist
   - strftime
   - tombi
   - trimesh
   - unshallow
+  - uuidgen
   - venv
   - virtualenv
-  - xdist

docs/css/mkdocstrings/api-autonav.css

@@ -1,4 +1,6 @@
+/* ! DEPRECATED */
 /* ref: https://github.com/tlambert03/mkdocs-api-autonav */
+
 nav.md-nav code.doc-symbol.doc-symbol-nav {
 	margin-right: 0.25em;
 }

docs/css/mkdocstrings/material.css

@@ -11,13 +11,16 @@ a.external::after,
 a.autorefs-external::after {
 	/* https://primer.style/octicons/arrow-up-right-24 */
 	mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
+	-webkit-mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
 	content: " ";
+
 	display: inline-block;
 	vertical-align: middle;
 	position: relative;
+
 	height: 1em;
 	width: 1em;
-	background-color: currentcolor;
+	background-color: currentColor;
 }
 
 a.external:hover::after,
@@ -33,15 +36,13 @@ a.autorefs-external:hover::after {
 	--tree-offset: 1rem;
 	--tree-thickness: 1px;
 	--tree-style: solid;
-
 	display: grid;
 	list-style: none !important;
 }
 
 .doc-backlink-list li > span:first-child {
 	text-indent: 0.3rem;
 }
-
 .doc-backlink-list li {
 	padding-inline-start: var(--tree-offset);
 	border-left: var(--tree-thickness) var(--tree-style) var(--tree-clr);
@@ -51,7 +52,6 @@ a.autorefs-external:hover::after {
 	&:last-child {
 		border-color: transparent;
 	}
-
 	&::before {
 		content: "";
 		position: absolute;
@@ -68,7 +68,6 @@ a.autorefs-external:hover::after {
 		border-left: var(--tree-thickness) var(--tree-style) var(--tree-clr);
 		border-bottom: var(--tree-thickness) var(--tree-style) var(--tree-clr);
 	}
-
 	&::after {
 		content: "";
 		position: absolute;

docs/javascript/mathjax.js

@@ -6,7 +6,11 @@ window.MathJax = {
 		displayMath: [["\\[", "\\]"]],
 		processEscapes: true,
 		processEnvironments: true,
+		// ref: <https://docs.mathjax.org/en/v3.2/input/tex/extensions/physics.html#physics>
+		packages: { "[+]": ["physics"] },
 	},
+	// ref: <https://docs.mathjax.org/en/v3.2/web/components/combined.html#tex-mml-chtml>
+	loader: { load: ["tex-mml-chtml", "[tex]/physics"] },
 	options: {
 		ignoreHtmlClass: ".*|",
 		processHtmlClass: "arithmatex",

template/.config/copier/mkdocs.yaml.jinja

@@ -16,7 +16,6 @@ edit_uri: blob/main/docs/
 
 extra_css:
   - https://cdn.jsdelivr.net/gh/liblaf/copier-python/docs/css/fonts.min.css
-  - https://cdn.jsdelivr.net/gh/liblaf/copier-python/docs/css/mkdocstrings/api-autonav.min.css
   - https://cdn.jsdelivr.net/gh/liblaf/copier-python/docs/css/mkdocstrings/material.min.css
   - https://cdn.jsdelivr.net/gh/liblaf/copier-python/docs/css/mkdocstrings/syntax-highlight-in-signatures.min.css