Summary
This version adds more comprehensive support for documentation redirects in mkdocs.yml and zensical.toml. Zensical supports page and anchor redirects, resolves redirect chains, rejects cycles, and preserves links when pages are moved or split.
Anchor redirects
Renaming a heading normally breaks bookmarks and external links to its old anchor. For example, after renaming ## Installation to ## Getting started, add:
[project.plugins.redirects.redirect_maps]
"guide.md#installation" = "guide.md#getting-started"Existing links to /guide/#installation will then redirect to /guide/#getting-started. The same configuration can redirect anchors between pages or preserve individual sections when splitting a page.
Automatic redirects
Zensical Studio detects renamed headings and offers an Add anchor redirect CodeLens. It can complete, validate, navigate to, and repair redirect targets while compacting repeated changes, updating redirect chains, and removing redundant self-redirects.
Changelog
Features
- 215d7fa zensical, compat – resolve redirect chains and reject cycles
- a6fdc5f zensical, compat – resolve anchor overrides in page redirects
- 0b1a378 zensical, compat – support anchor redirects
Bug fixes
- 6910d56 compat – relax validation of autorefs settings
- eac9e24 ui – update ui to v0.0.29
- 78a34cd zensical-serve – avoid port conflicts in server doctests
- 304e280 compat – relax search validation (#926)
Refactorings
- 6220f43 zensical – clarify redirect planning and output