mirror of
https://github.com/Vateron-Media/XC_VM.git
synced 2026-09-14 12:01:31 +02:00
Add a version selector to the docs and publish one snapshot per release instead of a single rolling site, so readers can pick the docs matching their installed version (the docs change release to release). - mkdocs.yml: enable the Material version selector (extra.version.provider: mike, alias: true). - docs/requirements.txt: add mike==2.1.3. - pages.yml: deploy with mike, triggered by a release TAG (semver) instead of every push to main — publishing is tied to the release because docs/ru is only regenerated then. Deploys `X.Y.Z` + the `latest` alias to the gh-pages branch and sets latest as default. workflow_dispatch takes an explicit version. - updates_checklist.md: note the tag-triggered versioned publish. One-time setup (GitHub UI): Settings → Pages → Deploy from a branch → gh-pages.
10 lines
441 B
Plaintext
10 lines
441 B
Plaintext
# MkDocs site BUILD toolchain — used by CI (.github/workflows/pages.yml) and by
|
|
# `make docs-build` / `docs-serve`. Translation is a separate, local-only step;
|
|
# its dependencies live in tools/docs/requirements.txt.
|
|
|
|
mkdocs-material==9.7.7
|
|
mkdocs-static-i18n==1.3.1
|
|
# Versioned docs: one published snapshot per release tag, with a `latest` alias
|
|
# and the version selector in the Material header (extra.version in mkdocs.yml).
|
|
mike==2.1.3
|