Skip to content

ci: check that every page is in the nav independently of the build engine - #16

Merged
edmondas merged 1 commit into
mainfrom
ci/nav-check
Nov 2, 2026
Merged

edmondas merged 1 commit into
mainfrom
ci/nav-check

Conversation

@edmondas

@edmondas edmondas commented Nov 2, 2026

Copy link
Copy Markdown
Member

Refs #13. Zensical does not enforce validation.nav, so a page left out of the nav would go unreported after a switch. scripts/check_nav.py checks the same rule from mkdocs.yml directly, in both directions:

  • every docs/**/*.md is listed in the nav
  • every nav entry exists

It runs in validate.yml and deploy.yml before the build, and in build.sh. The loader ignores the !!python/name tags used by the markdown extension options.

Checked locally: passes on main (151 pages), fails on an added orphan page and on a nav entry pointing at a missing file.

@edmondas
edmondas merged commit 271f8b5 into main Nov 2, 2026
4 checks passed
@edmondas
edmondas deleted the ci/nav-check branch November 2, 2026 10:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant