Replace pre-release feature includes with version-aware shortcode#1961
Merged
cderv merged 7 commits intoprereleasefrom Mar 12, 2026
Merged
Replace pre-release feature includes with version-aware shortcode#1961cderv merged 7 commits intoprereleasefrom
cderv merged 7 commits intoprereleasefrom
Conversation
Rename _extensions/prerelease-docs-url/ to _extensions/prerelease/ and combine both shortcodes into a single Lua file with shared helpers: - prerelease-docs-url: existing shortcode for prerelease subdomain links - prerelease-callout: new shortcode that shows version-aware callouts for feature docs (hidden after release) and blog posts (switches from pre-release to released text)
Migrate 5 include references across 3 files (all version 1.5, already released) to use the new version-aware shortcode instead.
Migrate 5 blog posts to use {{< prerelease-callout X.Y type="blog" >}}
instead of including shared _quarto-X.Y-feature.qmd files.
These files are no longer needed now that the prerelease-callout shortcode generates callout content dynamically based on version.
Documents both shortcodes (prerelease-docs-url and prerelease-callout), usage examples, and version comparison logic with scenario table.
Migrate 8 additional include references (only present on prerelease branch) to use the version-aware prerelease-callout shortcode.
Contributor
Collaborator
Author
Preview verification — all 16 modified pages checkedVerified the preview at https://deploy-preview-1961.quarto.org against the expected shortcode behavior with site Feature docs with ref=1.5 — no callout (3 pages)
Feature docs with ref=1.9 — "Pre-release Feature" callout (8 pages)
Blog posts with ref=1.3 type="blog" — "Quarto 1.3 Feature" callout (4 pages)Blog post with ref=1.9 type="blog" — "Pre-release Feature" callout (1 page)Download links also verified: pre-release callouts link to |
cderv
added a commit
to quarto-dev/quarto-cli
that referenced
this pull request
Mar 12, 2026
quarto-dev/quarto-web#1961 replaces per-version `_pre-release-feature.qmd` include files with an automatic `prerelease-callout` shortcode. Update the release checklist to reflect that these files no longer need to be created, and update the shortcode reference from the old extension name.
This was referenced Mar 12, 2026
cderv
added a commit
to quarto-dev/quarto-cli
that referenced
this pull request
Mar 12, 2026
quarto-dev/quarto-web#1961 replaces per-version `_pre-release-feature.qmd` include files with an automatic `prerelease-callout` shortcode. Update the release checklist to reflect that these files no longer need to be created, and update the shortcode reference from the old extension name.
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.
Each release cycle requires manually editing per-version
_pre-release-feature.qmdinclude files (and corresponding blog post includes) to toggle pre-release callouts on and off. This is error-prone and adds steps to the release checklist.This replaces all
_pre-release-feature.qmdand_quarto-X.Y-feature.qmdincludes with aprerelease-calloutshortcode that reads the siteversionfrom_quarto.ymland automatically determines whether to show a callout:{{< prerelease-callout 1.5 >}} {{< prerelease-callout 1.9 type="blog" >}}The shortcode is added to the existing
_extensions/prerelease/extension (renamed fromprerelease-docs-url/) alongside the existingprerelease-docs-urlshortcode, sharing version-parsing helpers.Changes
_extensions/prerelease-docs-url/into_extensions/prerelease/with a singleprerelease.luacontaining both shortcodes_pre-release-feature.qmdincludes across docs and blog posts_quarto-X.Y-feature.qmdincludesVersion comparison scenarios (feature docs)
versionBlog posts (
type="blog") follow the same version logic, but instead of showing nothing when released, they show a "Quarto X.Y Feature" callout linking to the stable download page.