Migrate blog from MkDocs to a Jac web app; rework publishing infra and scheduling workflow#25
Merged
Merged
Conversation
- Introduced a new CSS file for prose styles, defining typography for long-form content with appropriate spacing, headings, links, and code formatting. - Created a typography CSS file to establish a consistent editorial type system using Source Serif for body text, Inter for UI elements, and JetBrains Mono for code. - Defined CSS variables for font families, font sizes, and line heights to ensure a cohesive design across the application.
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
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.
Summary
This PR replaces the MkDocs Material site with a Jac web app and reworks the editorial infrastructure around it — publishing, scheduling, and CI. It's the largest structural change to the repo since launch (~6.7k lines across 42 files).
What changed
1. Site rebuilt as a Jac app (no more MkDocs)
The static MkDocs build is replaced by a Jac Cloud app with a React/Vite client.
posts/*.mdand author metadata from the content dir and serve them as JSON.draft: trueposts are filtered; posts identify byslug:frontmatter, not filename.index,blog/index,blog/posts/[slug],blog/categories/{index,[name]},blog/authors/[id],blog/archive,blog/search, a sharedlayout, and a[...notFound]catch-all.PostBodyandRunnableJacBlock(interactive Jac code blocks, ported from the old MkDocs/Pyodide setup).styles/typography.css,styles/prose.css,styles/main.cssfor readability and prose layout.The old
docs/blog/content tree is kept as the read-only content source so existing posts keep working.2. Publish + scheduling workflow rework
Scheduling is now decoupled from merge and driven from a GitHub issue instead of the PR. New maintainer reference: .github/RELEASE_FLOW.md.
/blog/posts/<slug>): the app serves an in-page "coming soon" state for an unpublished slug and the full article once live — same link throughout. No placeholder page, no date in the URL./schedule <ISO8601 UTC>on the tracker issue →scripts/schedule_lib.pywrites.schedule.ymlon main.draft:, rewritesdate:on first publish), closes the tracker issue, and comments the live URL.3. Test suite + CI
4. Misc
public/symlink for static serving, updated README.md to describe the Jac app..jac/data/server.db*files and added them to.gitignore.Notes for reviewers
docs/blog/posts/is unchanged and remains the source of truth.draft: trueis still the publish gate,.schedule.ymlstays bot-owned viaschedule_lib.py, and posts are still keyed byslug:.