Skip to content

CLI reference: the global flags table rendered as a raw template - #89

Merged
Kinflou merged 1 commit into
mainfrom
fix/cli-global-flags-table
Oct 25, 2026
Merged

Kinflou merged 1 commit into
mainfrom
fix/cli-global-flags-table

Conversation

@Kinflou

@Kinflou Kinflou commented Oct 25, 2026

Copy link
Copy Markdown
Member

The live CLI reference showed {% for row in global_flags %}| {{ row.flag }} | {{ row.effect }} | instead of the global flags table. The site is built with zensical, which doesn't run the macros plugin, and --strict didn't notice.

  • reference/cli.md: the four global flags are written out as a plain table. It was the only page using macros.
  • Removed docs/_data/cli-global-flags.yaml, the macros plugin config and its mkdocs-macros-plugin dependency (poetry.lock re-locked). check-cli-drift.py now reads only the page, and cli-drift.yml no longer watches the YAML.
  • New guard in docs.yml: after the build, any {{ or {% left in a built page fails it. With the old page restored, the guard fires on reference/cli/index.html. With the fix, the site is clean.

Checked locally: the strict build passes, search.json is still produced, and check-cli-drift.py reports no drift against comline 0.2.0.

@Kinflou
Kinflou merged commit 0d1dc40 into main Oct 25, 2026
3 checks passed
@Kinflou
Kinflou deleted the fix/cli-global-flags-table branch October 25, 2026 20:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant