Skip to content

Switch from MkDocs to Zensical#1160

Open
MichaIng wants to merge 3 commits intodevfrom
zenical
Open

Switch from MkDocs to Zensical#1160
MichaIng wants to merge 3 commits intodevfrom
zenical

Conversation

@MichaIng
Copy link
Owner

@MichaIng MichaIng commented Feb 21, 2026

MkDocs is dead, but Zensical from the mkdocs-material developer is an active fork.

Also, install Zensical and PySpelling directly with the setup-python action, and assure latest markdownlint-cli2 is used.

@MichaIng MichaIng added this to the v10.1 milestone Feb 21, 2026
@MichaIng MichaIng self-assigned this Feb 21, 2026
@MichaIng MichaIng added the CI label Feb 21, 2026
@MichaIng MichaIng force-pushed the zenical branch 3 times, most recently from 53f3637 to 572dc23 Compare February 21, 2026 14:04
@MichaIng MichaIng changed the title Switch from MkDocs to Zenical Switch from MkDocs to Zensical Feb 21, 2026
@MichaIng
Copy link
Owner Author

Okay it builds and generally works. But a bunch of classes have changed, so not all of our CSS rules apply anymore. Some other changes actually look nicer than before. However, requires some adjustments by comparing our CSS rules and actual classes in browser devtools. Moving to v10.2 milestone.

Links within snippets seem to be resolved differently, as the .md => / rewrite does not work for the link inside the Avahi-Daemon info box. We need to find out relative to where it is resolved now, or whether the rewrite might be missing for snippets in general.

@MichaIng MichaIng modified the milestones: v10.1, v10.2 Feb 21, 2026
MkDocs is dead, but Zensical from the mkdocs-material developer is an active fork.

Also, install Zensical and PySpelling directly with the setup-python action, and assure latest markdownlint-cli2 is used.
Zensical does not support the "-d" option to specify the target directory. Instead of site_dir setting needs to be used.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant