diff --git a/.claude/rules/release-highlights.md b/.claude/rules/release-highlights.md new file mode 100644 index 0000000000..7c0950a873 --- /dev/null +++ b/.claude/rules/release-highlights.md @@ -0,0 +1,14 @@ +--- +paths: + - "docs/prerelease/**/_highlights.qmd" +--- + +# Release Highlights + +`_highlights.qmd` is a short summary. The download page shows it above the full changelog, so details belong in the changelog. Match the length of earlier releases' highlights (compare `docs/prerelease/1.11/_highlights.qmd`). + +- Feature bullets: one or two sentences, linking to the docs section. +- A dependency update (Pandoc, Typst, Deno) is one line, such as "Pandoc updated to 3.13". Its user-facing additions go in that line or as feature bullets. +- "When upgrading" lists only changes users must act on: a render that now fails, or output that changes visibly. One sentence each, plus the fix when there is one. +- Edge cases, niche behavior changes and per-format details stay in the quarto-cli changelog. +- Before describing a behavior change that comes from a dependency, read the quarto-cli PR and changelog entry for it: Quarto often adjusts the result (a filter or finalizer), so the upstream release notes alone can misstate what users see. diff --git a/docs/output-formats/html-basics.qmd b/docs/output-formats/html-basics.qmd index a9286799f4..e3cce81380 100644 --- a/docs/output-formats/html-basics.qmd +++ b/docs/output-formats/html-basics.qmd @@ -124,7 +124,7 @@ Using the `css` option works well for simple tweaks to document appearance. If y ## LaTeX Equations -By default, LaTeX equations are rendered using [MathJax](https://www.mathjax.org/). Use the `html-math-method` option to choose another method. For example: +By default, LaTeX equations are rendered using [MathJax](https://www.mathjax.org/). HTML documents without the Bootstrap theme (`minimal: true`, `theme: none`, or `theme: pandoc`) render them as MathML instead. Use the `html-math-method` option to choose another method. For example: ``` yaml format: diff --git a/docs/output-formats/typst.qmd b/docs/output-formats/typst.qmd index d8a5377db2..5a6650acf4 100644 --- a/docs/output-formats/typst.qmd +++ b/docs/output-formats/typst.qmd @@ -232,6 +232,38 @@ This gets compiled to [This is a block with gray background and slightly rounded corners.]) ```` +## Typst Labels + +{{< prerelease-callout 1.12 >}} + +The identifier of a div becomes a [Typst label](https://typst.app/docs/reference/foundations/label/) on its content, so [raw Typst](#raw-typst) code can target the div, for example with a show rule. To give the div a Typst label that differs from its identifier, or a label without an identifier, use the `typst-label` attribute: + +```` markdown +```{=typst} +#show : set text(fill: blue) +``` + +::: {typst-label="note-box"} +This text is blue. +::: +```` + +A show rule applies only to content after it, so place the raw Typst block before the div. + +`typst-label` is for raw Typst code. To refer to a figure, table, or theorem, give it a Quarto [cross-reference](/docs/authoring/cross-references.qmd) identifier such as `#fig-plot` and use `@fig-plot`, as in other formats. + +## Text Language + +{{< prerelease-callout 1.12 >}} + +Set `lang` on a span or a div to write content in a language other than the document's `lang`. Typst then uses that language for the content, for example for hyphenation and smart quotes: + +``` markdown +The German greeting [Guten Tag]{lang="de"} means "good day". +``` + +The span renders as `#text(lang: "de")[Guten Tag]`. + ## Theorems {{< prerelease-callout 1.9 >}} diff --git a/docs/prerelease/1.12/_highlights.qmd b/docs/prerelease/1.12/_highlights.qmd index 4da181b1ef..0cd50a817e 100644 --- a/docs/prerelease/1.12/_highlights.qmd +++ b/docs/prerelease/1.12/_highlights.qmd @@ -1 +1,11 @@ -Quarto v1.12 was just released, nothing to see here -- yet! \ No newline at end of file +Quarto 1.12 includes the following new features: + +- Pandoc updated to 3.13, which adds [Typst labels](/docs/output-formats/typst.qmd#typst-labels) with the `typst-label` attribute and [`lang` on spans](/docs/output-formats/typst.qmd#text-language) in `typst` output. +- `quarto render` supports Pandoc's `--math-method` option. The `--katex`, `--mathjax`, `--mathml`, and `--webtex` options are deprecated. + +When upgrading: + +- A duplicated key in a YAML [bibliography file](/docs/authoring/citations.qmd#bibliography-files) now stops the render with an error. +- In `docx` output, cross-reference targets are bookmarks with generated names, so a link from outside the document such as `report.docx#fig-plot` no longer finds its target. +- HTML documents without the Bootstrap theme (`minimal: true`, `theme: none`, or `theme: pandoc`) now render [math](/docs/output-formats/html-basics.qmd#latex-equations) as MathML. Set `html-math-method: plain` for the previous output. +- A Typst binary set through the `QUARTO_TYPST` environment variable must be version 0.15 or later. diff --git a/docs/presentations/powerpoint.qmd b/docs/presentations/powerpoint.qmd index 8095357585..f046af9c74 100644 --- a/docs/presentations/powerpoint.qmd +++ b/docs/presentations/powerpoint.qmd @@ -78,7 +78,7 @@ When creating slides, the pptx writer chooses from a number of pre-defined layou **Content with Caption** -: This layout is used for any non-two-column slides which contain text followed by non-text (e.g. an image or a table). +: This layout is used for any non-two-column slides which contain text followed by an image, unless the slide also contains a table. **Blank**