[Sync to prerelease] Rework blog-post skill for the new blog home - #2134
Merged
Conversation
* Rework blog-post skill for the open-source-website blog home Posts are now authored in posit-dev/open-source-website: frontmatter is scaffolded from its blog archetype via hugo new (mirroring /new-post), docs links become absolute quarto.org URLs, thumbnails move to 1920x1080 (Typst templates rescaled and re-verified), and the old quarto.org scaffolding, categories, publish-date.ts, and backport sections are dropped. Release-post specifics move out of the general sections into references/post-types.md. * Read docs from the repo, link to quarto.org, flag pending-merge links Drafting ahead of a release means the docs may only exist on the prerelease branch, not yet on quarto.org. Direct the skill to source terminology from quarto-web (working tree, then origin/prerelease), derive absolute quarto.org URLs from repo paths, verify each link, and flag links that won't resolve until the release-time merge. * Add release-post prose guidance from the 1.10 draft run Document the summary-paragraph convention (one short noun phrase per major feature) and lean feature prose: cut why-this-matters clauses, scope claims precisely, cover only the headline change. * Document how to display literal shortcode syntax in posts Verified against the ported Quarto posts and scratch renders: displayed shortcode examples need a code context (never prose), a Quarto-side escape (triple braces or shortcodes="false" on the fence), and the site's escape-shortcodes Lua filter, which ported Quarto posts get via _metadata.yml and new posts opt into via frontmatter. Escapes in prose reach Hugo live - a known name silently renders, an unknown name fails the site build. * Advise on tags as the home for the old categories vocabulary The port moved each post's quarto.org categories into its tags, so tags carry that vocabulary forward (Releases, Quarto X.Y, Features, Learn, ...). Reuse existing corpus tags, skip a bare Quarto tag that would duplicate source/software, and give release posts Quarto X.Y + Releases. (cherry picked from commit 29bccf3)
Member
|
/deploy-preview |
Contributor
Author
📝 Preview Deployment🔍 Full site preview: https://deploy-preview-2134.quarto.org |
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.
Description
Sync of #2133 to
prerelease.Original PR
Rework blog-post skill for the new blog home
The Quarto blog moved to posit-dev/open-source-website in May 2026, but
.claude/skills/blog-post/still described the olddocs/blog/posts/workflow. This reworks the skill so posts are authored where they publish, while keeping the Quarto-specific knowledge (post types, voice, thumbnail production) here.Changes
content/blog/<slug>/on ablog/<slug>branch;index.qmd+ renderedindex.mdare committed together; PR to itsmainfor a Netlify preview. The old quarto.org scaffolding,categories,_metadata.yml,subtitle,_tools/publish-date.ts, and backport sections are dropped.hugo newagainst open-source-website'sarchetypes/blog.md(mirroring its/new-postcommand), so the schema can't drift out of sync. The skill keeps only Quarto-specific additions (source: quarto, thumbnail conventions, date-based scheduling).origin/prerelease), while posts link with absolutehttps://quarto.org/docs/...URLs derived from repo paths — each verified, with pending-merge links flagged for a re-check at publish time.--ppi 72→ exact size,--ppi 144→ 2x)._contribs.md, summary-paragraph and lean-prose guidance) move out of the general sections intoreferences/post-types.md.Validation
Prototyped by drafting the Quarto 1.10 release post with the reworked skill from a cold session (posit-dev/open-source-website#363); the prose lessons from that run are folded into
references/post-types.md.