Skip to content

Prepare the reports for Quarto 1.11.9 - #206

Merged
Brar merged 1 commit into
NeoIPC:mainfrom
Brar:feature/reports-toolchain-quarto-1-11
Nov 11, 2026
Merged

Brar merged 1 commit into
NeoIPC:mainfrom
Brar:feature/reports-toolchain-quarto-1-11

Conversation

@Brar

@Brar Brar commented Nov 11, 2026

Copy link
Copy Markdown
Member

The reports move from Quarto 1.10.18 to 1.11.9 with the reporting image. Two things in this repository depend on the version:

  1. scripts/Build-ValidationReport.ps1 refuses a public address that carries a line terminator, because Quarto drops such a -P argument without a warning. The comment saying so cites parseMetadataFlagValue() in Quarto's src/command/render/flags.ts, which is the same at both versions, so it now names the version the reports render with.
  2. Quarto 1.11 merges a document's front matter with the metadata its project, profiles, directories, and metadata files set. Before Pandoc runs, 1.10.18 let the front matter replace the merged value of a key that is not one of Quarto's own options, whose lists it combined already; 1.11.9 merges the two where execution leaves the key unchanged, so lists are combined, a single value joins a list beside it, and maps merge key by key, while a single value still replaces a single value. A report's front matter sets its lang and params, which no other source sets, and the Partner Certificate's also sets date-meta, a single value on both sides, so no report renders differently.

The Validation Report's _quarto.yml gains the final newline it lacked.

Quarto 1.11.9 also gives every external link in the reports' HTML a description for screen readers, "(opens in a new tab)", which it has in English only, and Bootstrap HTML a "Skip to main content" link that it does not translate into Greek. Supplying both in every report language belongs with the translation of the text Quarto generates in the reports.

…lies on

The reports move from Quarto 1.10.18 to 1.11.9. Build-ValidationReport.ps1
refuses a public address that carries a line terminator because Quarto
drops such a -P argument without a warning, and the comment saying so
cites parseMetadataFlagValue() in src/command/render/flags.ts. That file is
the same at both versions, so the citation names the version the reports
now render with.

Quarto 1.11 also changes how a document's front matter meets the metadata
its project, profiles, directories, and metadata files set. Before Pandoc
runs, 1.10.18 let the front matter replace the merged value of a key that
is not one of Quarto's own options, whose lists it combined already;
1.11.9 merges the two where execution leaves the key unchanged, so lists
are combined, a single value joins a list beside it, and maps merge key by
key, while a single value still replaces a single value. A report's front
matter sets its lang and params, which no other source sets, and the
Partner Certificate's also sets date-meta, a single value on both sides,
so no report renders differently for it. The Validation Report's
_quarto.yml gains the final newline it lacked.
Copilot AI balanced review requested due to automatic review settings November 11, 2026 14:16

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues remain for the documentation and configuration-formatting changes.

No open issues 🎉

What changed in this PR

This PR prepares report documentation and configuration formatting for the reporting image’s move to Quarto 1.11.9. It does not change report behaviour or upgrade Quarto itself.

Changes:

  • Updates the Quarto version cited in the validation wrapper’s explanation of rejected line terminators.
  • Removes trailing whitespace and adds the missing final newline in the Validation Report configuration.
File Description
scripts/​Build-ValidationReport.ps1 Updates a comment’s Quarto version reference to 1.11.9; validation logic is unchanged.
reports/​Validation-Report/​_quarto.yml Normalizes whitespace and the final newline without changing configuration values.

Review effort: Balanced

@Brar
Brar merged commit 21bbc06 into NeoIPC:main Nov 11, 2026
15 of 18 checks passed
@Brar
Brar deleted the feature/reports-toolchain-quarto-1-11 branch November 11, 2026 19:13
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.

2 participants