mirror of
https://github.com/zensical/zensical.git
synced 2026-09-24 15:25:40 +00:00
Martin Donath
be163399a5
## Summary This version adds 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: ```toml [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](https://zensical.org/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. <img width="557" height="86" src="https://github.com/user-attachments/assets/802d8d99-a205-44af-a29f-6a26eaaa5780" /> Signed-off-by: squidfunk <martin.donath@squidfunk.com>