Migrate docs to Zensical

[dylanhmorris]

When we do this, we should also switch to MathJAX based math rendering (with fallback to vanilla MathML). Would be great to be able to get something like the setup here https://scoringrules.readthedocs.io/en/latest/theory.html

[cdc-mitzimorris]

are the docs building on GitHub?

locally I'm getting this error:

mkdocs build

....

uv
Processed building_multisignal_models.md
Processed observation_processes_counts.md
Processed day_of_week_effects.md
Processed right_truncation.md
Processed observation_processes_measurements.md
Processed random_variables.md
Processed latent_hierarchical_infections.md

Output created: latent_hierarchical_infections.md

uv run mkdocs build

 │ ⚠ WARNING – MkDocs 2.0 is incompatible with Material for MkDocs
 │ 
 │   MkDocs 1.x is unmaintained. We recommend switching to Zensical, our
 │   new static site generator, as soon as possible. We're providing an
 │   analysis of the situation in this article:
 │   
 │   https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

Traceback (most recent call last):
  File "/Users/mitzi/github/CDC/PyRenew/.venv/bin/mkdocs", line 10, in <module>
    sys.exit(cli())
             ~~~^^
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/click/core.py", line 1485, in __call__
    return self.main(*args, **kwargs)
           ~~~~~~~~~^^^^^^^^^^^^^^^^^
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/click/core.py", line 1406, in main
    rv = self.invoke(ctx)
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/click/core.py", line 1873, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
                           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/click/core.py", line 1269, in invoke
    return ctx.invoke(self.callback, **ctx.params)
           ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/click/core.py", line 824, in invoke
    return callback(*args, **kwargs)
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocs/__main__.py", line 288, in build_command
    build.build(cfg, dirty=not clean)
    ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocs/commands/build.py", line 265, in build
    config = config.plugins.on_config(config)
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocs/plugins.py", line 587, in on_config
    return self.run_event('config', config)
           ~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocs/plugins.py", line 566, in run_event
    result = method(item, **kwargs)
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocstrings/_internal/plugin.py", line 153, in on_config
    handlers._download_inventories()
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocstrings/_internal/handlers/base.py", line 602, in _download_inventories
    handler = self.get_handler(handler_name)
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocstrings/_internal/handlers/base.py", line 581, in get_handler
    module = importlib.import_module(f"mkdocstrings_handlers.{name}")
  File "/Users/mitzi/miniconda3/envs/cdcenv/lib/python3.13/importlib/__init__.py", line 88, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1331, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 935, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 1026, in exec_module
  File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocstrings_handlers/python/__init__.py", line 3, in <module>
    from mkdocstrings_handlers.python._internal.config import (
    ...<11 lines>...
    )
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocstrings_handlers/python/_internal/config.py", line 12, in <module>
    from mkdocstrings_handlers.python._internal.rendering import Order  # noqa: TC001
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/mitzi/github/CDC/PyRenew/.venv/lib/python3.13/site-packages/mkdocstrings_handlers/python/_internal/rendering.py", line 17, in <module>
    from griffe import (
    ...<15 lines>...
    )
ModuleNotFoundError: No module named 'griffe'
make: *** [docs] Error 1
(cdcenv) ~/github/CDC/PyRenew (main)>