diff --git a/.claude/rules/quarto-web-workflow.md b/.claude/rules/quarto-web-workflow.md new file mode 100644 index 0000000000..69c2c8e153 --- /dev/null +++ b/.claude/rules/quarto-web-workflow.md @@ -0,0 +1,10 @@ +# quarto-web Workflow + +## Stable → Prerelease + +1. PRs target `main` (stable/released docs) +2. On merge, `port-to-prerelease.yml` (korthout/backport-action) auto-creates a cherry-pick PR to `prerelease` +3. Prerelease-specific changes (e.g., v1.10 features) are layered in a follow-up PR after the backport merges + +Always PR to `main` first for shared content. Never PR directly to `prerelease` for changes that apply to both stable and prerelease. + diff --git a/.github/workflows/preview.yml b/.github/workflows/preview.yml index 329188d6ae..9750fb0471 100644 --- a/.github/workflows/preview.yml +++ b/.github/workflows/preview.yml @@ -155,6 +155,8 @@ jobs: docs/reference/**/*.json docs/cli/*.json docs/**/images/*.png + files_ignore: | + **/CLAUDE.md json: true escape_json: false diff --git a/bug-reports.qmd b/bug-reports.qmd index 1d49561170..53a1e97265 100644 --- a/bug-reports.qmd +++ b/bug-reports.qmd @@ -100,25 +100,26 @@ For instance, the markdown code you would provide might look like this: ````md ```bash -Quarto 1.5.42 +Quarto 1.9.37 [✓] Checking versions of quarto binary dependencies... - Pandoc version 3.2.0: OK + Pandoc version 3.4.0: OK Dart Sass version 1.70.0: OK - Deno version 1.41.0: OK + Deno version 1.46.3: OK Typst version 0.11.0: OK [✓] Checking versions of quarto dependencies......OK [✓] Checking Quarto installation......OK - Version: 1.5.42 + Version: 1.9.37 Path: /Applications/quarto/bin [✓] Checking tools....................OK - TinyTeX: v2024.03.13 + TinyTeX: v2026.04 Chromium: (not installed) + Chrome Headless Shell: (not installed) [✓] Checking LaTeX....................OK Using: TinyTex Path: /Users/username/Library/TinyTeX/bin/universal-darwin - Version: 2024 + Version: 2026 [✓] Checking basic markdown render....OK @@ -126,18 +127,18 @@ Quarto 1.5.42 Version: 3.12.1 Path: /.venv/bin/python3 Jupyter: 5.7.2 - Kernels: julia-1.10, python3 + Kernels: python3 [✓] Checking Jupyter engine render....OK [✓] Checking R installation...........OK - Version: 4.3.3 - Path: /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources + Version: 4.4.2 + Path: /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources LibPaths: - - /Users/username/Library/R/arm64/4.3/library - - /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources/library - knitr: 1.45 - rmarkdown: 2.26 + - /Users/username/Library/R/arm64/4.4/library + - /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources/library + knitr: 1.49 + rmarkdown: 2.29 [✓] Checking Knitr engine render......OK ``` diff --git a/docs/authoring/diagrams.qmd b/docs/authoring/diagrams.qmd index 4c50090e49..3bf6591e2d 100644 --- a/docs/authoring/diagrams.qmd +++ b/docs/authoring/diagrams.qmd @@ -246,8 +246,15 @@ quarto install chrome-headless-shell [Chrome Headless Shell](https://developer.chrome.com/blog/chrome-headless-shell) is a lightweight, headless-only browser from Google's [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing) infrastructure. It has fewer system dependencies than full Chromium, making it a good fit for Docker containers and WSL environments. -::: callout-note -## Legacy Chromium +::: callout-warning +## Chromium (Deprecated) + +The `quarto install chromium` command is deprecated as of Quarto 1.9 and will be removed in a future release. It still works but displays a deprecation warning. To migrate to Chrome Headless Shell, run: + +``` {.bash filename="Terminal"} +quarto uninstall chromium +quarto install chrome-headless-shell +``` -The older `quarto install chromium` command (which installs Chromium via Puppeteer) is still available but no longer recommended. If you use it, note that the Puppeteer-bundled Chromium may not work in Docker or WSL — see [Puppeteer troubleshooting](https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md#running-puppeteer-in-docker) for details. +The Puppeteer-bundled Chromium installed by the old command may not work in Docker or WSL — see [Puppeteer troubleshooting](https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md#running-puppeteer-in-docker) for details. Chrome Headless Shell does not have these limitations and also supports arm64 Linux. ::: diff --git a/docs/cli/cli-info.json b/docs/cli/cli-info.json index e8fee7dcae..69d2760fb2 100644 --- a/docs/cli/cli-info.json +++ b/docs/cli/cli-info.json @@ -1,5 +1,5 @@ { - "version": "1.9.36", + "version": "1.9.37", "commands": [ { "name": "render", @@ -361,7 +361,7 @@ { "name": "preview", "hidden": false, - "description": "Render and preview a document or website project.\n\nAutomatically reloads the browser when input files or document resources (e.g. CSS) change.\n\nFor website preview, the most recent execution results of computational documents are used to render\nthe site (this is to optimize startup time). If you want to perform a full render prior to\npreviewing pass the --render option with \"all\" or a comma-separated list of formats to render.\n\nFor document preview, input file changes will result in a re-render (pass --no-watch to prevent).\n\nYou can also include arbitrary command line arguments to be forwarded to \u001b[1mquarto render\u001b[22m.", + "description": "Render and preview a document or website project.\n\nAutomatically reloads the browser when input files or document resources (e.g. CSS) change.\n\nFor website preview, the most recent execution results of computational documents are used to render\nthe site (this is to optimize startup time). If you want to perform a full render prior to\npreviewing pass the --render option with \"all\" or a comma-separated list of formats to render.\n\nFor document preview, input file changes will result in a re-render (pass --no-watch to prevent).\n\nYou can also include arbitrary command line arguments to be forwarded to quarto render.", "options": [ { "standalone": true, diff --git a/docs/cli/includes/CLAUDE.md b/docs/cli/includes/CLAUDE.md new file mode 100644 index 0000000000..af54dc0339 --- /dev/null +++ b/docs/cli/includes/CLAUDE.md @@ -0,0 +1,10 @@ +# CLI Reference: Auto-Generated Files + +Files in this directory are auto-generated. Do not edit manually. + +## Regeneration + +1. `quarto dev-call cli-info > docs/cli/cli-info.json` +2. `Rscript --vanilla _tools/reference-cli-generate-md.R` + +Descriptions come from quarto-cli source. To change them permanently, update the CLI command definitions in quarto-cli. diff --git a/docs/output-formats/pdf-engine.qmd b/docs/output-formats/pdf-engine.qmd index 5caf2cb362..ed3ae45955 100644 --- a/docs/output-formats/pdf-engine.qmd +++ b/docs/output-formats/pdf-engine.qmd @@ -44,9 +44,11 @@ which will provide a list of available tools, the installed versions, and the la ``` bash [✓] Inspecting tools -Tool Status Installed Latest -chromium Not installed --- 869685 -tinytex Up to date v2022.10 v2022.10 +Tool Status Installed Latest +chrome-headless-shell Not installed --- 147.0.7727.56 +chromium Not installed --- 869685 +tinytex Up to date v2026.04 v2026.04 +verapdf Not installed --- 1.28.2 ``` To update to the latest version, use the command: diff --git a/docs/projects/binder.qmd b/docs/projects/binder.qmd index eba3283873..c748313272 100644 --- a/docs/projects/binder.qmd +++ b/docs/projects/binder.qmd @@ -116,7 +116,7 @@ The following files may be generated by the `quarto use binder` command. Note th `postBuild` -: The post build script runs code after restoring the environment. This script is generated with commands required to ensure the proper version of Quarto is present in the environment, install any required tools like TinyTex or Chromium, and to configure VSCode and the Quarto extension for VSCode when applicable. +: The post build script runs code after restoring the environment. This script is generated with commands required to ensure the proper version of Quarto is present in the environment, install any required tools like TinyTeX or Chrome Headless Shell, and to configure VSCode and the Quarto extension for VSCode when applicable. `apt.txt` diff --git a/docs/troubleshooting/index.qmd b/docs/troubleshooting/index.qmd index cc8bd16323..4017896461 100644 --- a/docs/troubleshooting/index.qmd +++ b/docs/troubleshooting/index.qmd @@ -13,9 +13,7 @@ but this page might help you get up and running quickly. You can check the version of Quarto and its dependencies by running `quarto check`. Here's an example of the output it generates: ``` -Quarto 1.6.30 -[✓] Checking environment information... - Quarto cache location: /Users/cscheid/Library/Caches/quarto +Quarto 1.9.37 [✓] Checking versions of quarto binary dependencies... Pandoc version 3.4.0: OK Dart Sass version 1.70.0: OK @@ -23,17 +21,18 @@ Quarto 1.6.30 Typst version 0.11.0: OK [✓] Checking versions of quarto dependencies......OK [✓] Checking Quarto installation......OK - Version: 1.6.30 - Path: /Users/cscheid/repos/github/cscheid/quarto-regress/releases/v1.6.30/binQuarto 1.5.42 + Version: 1.9.37 + Path: /Applications/quarto/bin [✓] Checking tools....................OK - TinyTeX: v2024.03.13 + TinyTeX: v2026.04 Chromium: (not installed) + Chrome Headless Shell: (not installed) [✓] Checking LaTeX....................OK Using: TinyTex Path: /Users/username/Library/TinyTeX/bin/universal-darwin - Version: 2024 + Version: 2026 [✓] Checking basic markdown render....OK @@ -41,18 +40,18 @@ Quarto 1.6.30 Version: 3.12.1 Path: /.venv/bin/python3 Jupyter: 5.7.2 - Kernels: julia-1.10, python3 + Kernels: python3 [✓] Checking Jupyter engine render....OK [✓] Checking R installation...........OK - Version: 4.3.3 - Path: /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources + Version: 4.4.2 + Path: /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources LibPaths: - - /Users/username/Library/R/arm64/4.3/library - - /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources/library - knitr: 1.45 - rmarkdown: 2.26 + - /Users/username/Library/R/arm64/4.4/library + - /Library/Frameworks/R.framework/Versions/4.4-arm64/Resources/library + knitr: 1.49 + rmarkdown: 2.29 [✓] Checking Knitr engine render......OK ```