Add boilerplate for docs versioning - #127
Merged
Merged
Conversation
Contributor
❌ Eval Results
GradersNo grader results Full output |
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
lightcone-cli | 8ae0679 | Commit Preview URL Branch Preview URL |
May 11 2026, 08:12 PM |
… workflow Refreshes this branch onto post-#168 main and finishes the integration the original boilerplate left open: - Move [project.extra.version] provider = "mike" from pyproject.toml to zensical.toml — it is zensical site config, not package metadata, and an unknown "extra" key under [project] is invalid PEP 621. - Rework docs-deploy.yml: replace the actions/deploy-pages artifact upload with mike deploy --push --update-aliases <version> latest plus mike set-default --push latest. Version comes from the release tag, or from a workflow_dispatch input for intermediate redeploys. - Update CLAUDE.md to describe the CI-driven release flow and the GitHub Pages "deploy from gh-pages branch" hosting requirement. Verified locally: uv sync --group docs installs squidfunk's mike fork (2.2.0+zensical-0.1.0) and zensical build succeeds with the version provider enabled (selector wiring present in the JS bundle). Note: repo Pages settings must be switched from "GitHub Actions" to "Deploy from a branch" / gh-pages once the first mike deploy has run. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014PC18whir9otmXpQbaEgir
EiffL
marked this pull request as ready for review
August 21, 2026 09:10
EiffL
added a commit
that referenced
this pull request
Aug 21, 2026
…tion Brings PR #127 (mike-based docs versioning) across the rebuild: - zensical.toml keeps [project.extra.version] provider = "mike" - pyproject docs group keeps the squidfunk mike fork dependency - docs-deploy.yml is the mike-based workflow (deploy <version> + latest to gh-pages on release; manual redeploy via workflow_dispatch) - justfile stays deleted (removed intentionally in the rebuild); its mike recipes live in the workflow, CLAUDE.md now points at the raw mike commands for local use Verified: uv sync --group docs installs mike 2.2.0+zensical-0.1.0 and zensical build succeeds with the version provider enabled. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014PC18whir9otmXpQbaEgir
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
2 participants
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.
Inspired on what was done for ASTRA except here I only kept the manual publication and did not port the automated workflow other than the justfile recipes.
Since the docs seem to be handled by Cloudfare, I don't know what kind of setup is required.