Skip to content

Write script headers with plain comments so websites re-render - #8

Merged
coatless merged 3 commits into
mainfrom
fix/plain-comment-header
Nov 6, 2026
Merged

coatless merged 3 commits into
mainfrom
fix/plain-comment-header

Conversation

@coatless

@coatless coatless commented Nov 6, 2026

Copy link
Copy Markdown
Contributor
  • Generated scripts now start their YAML header with plain comments (#, //, --) instead of #', //' and --'. Quarto took a .R script with a #' --- header for a knitr spin document, so the second render of a website failed.
  • README, FAQ, the languages table and the release notes (under breaking changes) describe the new header.
  • Adds two tests, run by the shared extension workflow: a website renders twice, and every script starts with a plain-comment header.

Quarto claims an .R file that starts with a `#' ---` block as a
knitr-spin page. After the first render of a website, the next render
picked up ripper's generated .R scripts, and their HTML collided with
the page's own. Headers now use plain `#`, `//` and `--` comments for
every language.

Verified with Quarto 1.11.9: a test site and the docs site each render
twice without errors, and `quarto inspect` lists only the .qmd pages.
@coatless
coatless merged commit 61fefe1 into main Nov 6, 2026
3 checks passed
@coatless
coatless deleted the fix/plain-comment-header branch November 6, 2026 15:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant