From c3b50f47568be14168a8ee9b537e1eebe1cdf114 Mon Sep 17 00:00:00 2001 From: Naruto TAKAHASHI Date: Thu, 3 Sep 2026 10:01:31 +0900 Subject: [PATCH] docs: bump zensical to 0.0.58 and declare the redirects plugin 0.0.58 rebuilds the plugin pipeline on a new scheduler and moves the `search` replacement onto it, so the bump was checked by building rather than by reading the changelog: both locales build `--strict` clean, and all 19 pages per locale plus both search indexes -- including the segmented Japanese one -- come out byte-identical to 0.0.56. Only the theme assets change, and there only their hashes. `redirects` is one of the six MkDocs plugins 0.0.58 reimplements natively, so it needs no pin of its own. Nothing has shipped from this site yet, so there is nothing to redirect; the plugin is declared now so the first page to move after release has an obvious place to go, keeping its old URL working, anchors included. One entry in `mkdocs.base.yml` covers both locales. --- docs/requirements.txt | 2 +- mkdocs.base.yml | 6 ++++++ 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/requirements.txt b/docs/requirements.txt index ab7525b..483ac88 100644 --- a/docs/requirements.txt +++ b/docs/requirements.txt @@ -5,4 +5,4 @@ # # `mkdocs-static-i18n` is replaced by building each locale from its own config, and # `mkdocs-callouts` by Zensical's native `> [!NOTE]` parsing (`pymdownx.quotes`). -zensical==0.0.56 +zensical==0.0.58 diff --git a/mkdocs.base.yml b/mkdocs.base.yml index 325d3ae..eaea998 100644 --- a/mkdocs.base.yml +++ b/mkdocs.base.yml @@ -72,6 +72,12 @@ plugins: # one is segmented into words rather than indexed as unbroken runs of characters. - search + # Nothing has shipped from this site yet, so there is nothing to redirect. Add a + # `redirect_maps:` entry the moment a published page moves or is renamed: the stub keeps + # the old URL working, anchors and all. Sources are relative to `docs_dir`, and the two + # locales mirror each other, so a single entry covers en and ja. + - redirects + # Restores the one thing `mkdocs-callouts` did for the pages here: rendering the # `> [!NOTE]` blockquote syntax as admonitions. Zensical parses it natively, so the plugin # is gone. See docs/*/stylesheets/extra.css for the one type it maps differently.