* docs: migrate documentation site from MkDocs to Zensical
Replace the Material for MkDocs toolchain with Zensical (its successor),
leaving no parallel MkDocs build behind.
- release-docs.yml builds with scripts/zensical_build.py and publishes the
generated ./site to GitHub Pages (was: pip install requirements-docs.txt
+ mkdocs gh-deploy).
- requirements-docs.txt pins zensical + nbconvert + mkdocstrings-python in
place of mkdocs / mkdocs-material / mkdocs-jupyter.
- scripts/zensical_build.py pre-converts the notebook samples with nbconvert
(Zensical has no MkDocs plugin lifecycle, so mkdocs-jupyter never runs) and
emits a generated zensical.yml from mkdocs.yml, which Zensical reads natively.
- mkdocs.yml: drop the now-unused mkdocs-jupyter plugin (the build script
handles notebooks); the Material-compatible theme, custom_dir overrides
(Microsoft Clarity + cookie consent) and mkdocstrings API reference are all
honored by Zensical.
- docs/stylesheets/extra.css: style the nbconvert-rendered notebook output.
- NOTICE: attribute Zensical (MIT) and nbconvert (BSD-3 Clause); drop the
MkDocs and mkdocs-jupyter notices, keep mkdocstrings and pymdown-extensions.
Verified locally: 104 pages build, all 18 sample notebooks render, the API
reference and brand styling are intact.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* docs: improve Zensical mobile homepage
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
---------
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Omri Mendels <omri374@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
