Bump zensical to 0.0.58 and declare the redirects plugin - #300
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Zensical 0.0.58 rebuilds the build pipeline on a new scheduler, migrates the
search,mkdocstringsandautorefsreplacements onto it, and adds six more MkDocs plugin replacements (meta,redirects,minify,tags,literate-nav,awesome-nav). That is a large enough change under the hood that the version was checked by building both locales and diffing, not by reading the release notes.Same change as cri-middleware/SpriteStudio-Docs#51, going into every repo that shares this pin.
Verified
Built en and ja with 0.0.56 and again with 0.0.58, and compared:
<meta name="generator">and the theme asset hashes.search.jsonandja/search.jsonbyte-identical. The Japanese index is segmented into words rather than indexed as unbroken runs, and thesearchreplacement is exactly what 0.0.58 moved onto the new architecture — so this was the thing most at risk.sitemap.xmlandja/sitemap.xmlbyte-identical.--strict, "No issues found", no new warnings.zensicalitself moves.base.htmldiffers only in six asset hashes, so theoverrides/templates are unaffected.page.is_homepageis still never set, so that workaround is still needed.The one breaking change in 0.0.58 is dropped wheels —
manylinux i686,musllinux i686,musllinux armv7andwin32. CI isubuntu-latestand local work is macOS, so neither is affected; a 32-bit Windows Python would now fall back to the sdist and demand a Rust toolchain.What changed
docs/requirements.txt— the pin.mkdocs.base.yml— declaresredirects. It goes in the base config for two reasons: theplugins:sequence stays defined in exactly one of the three files, and one entry there emits stubs into bothsite/andsite/ja/, each pointing at its own locale's target. Verified with a throwaway entry before settling on the empty form.Why there is no redirect map
Nothing has been published from this repo, so there is no live URL to preserve — the map would only point away from URLs nobody ever had. This wires the mechanism, not any particular redirect: the first page that moves after release gets a
redirect_maps:entry and keeps its old URL working, anchors included.