Skip to content

docs(language): document crossref title/prefix localisation#2006

Merged
cscheid merged 2 commits intoquarto-dev:mainfrom
mcanouil:docs/crossref-localisation
May 1, 2026
Merged

docs(language): document crossref title/prefix localisation#2006
cscheid merged 2 commits intoquarto-dev:mainfrom
mcanouil:docs/crossref-localisation

Conversation

@mcanouil
Copy link
Copy Markdown
Collaborator

@mcanouil mcanouil commented May 1, 2026

Documents the existing (but undocumented) support for localising cross-reference titles and prefixes via the language: key.

Closes quarto-dev/quarto-cli#14466.

Changes

  • docs/authoring/language.qmd: new "Cross-Reference Titles and Prefixes" subsection under "Alternate Language", with single-language and per-language YAML examples.
  • docs/authoring/cross-reference-options.qmd: new "Localisation" section clarifying crossref: (per-document) vs language: (locale-aware) overrides.
  • docs/authoring/_cross-references-callouts.qmd: localisation snippet for crossref-{nte,tip,wrn,imp,cau}-prefix.
  • docs/authoring/cross-references-custom.qmd: note that custom kinds inherit the same crossref-{key}-(title|prefix) pattern.

@mcanouil mcanouil force-pushed the docs/crossref-localisation branch from 9c68e3c to 87b3126 Compare May 1, 2026 10:51
Copy link
Copy Markdown
Member

@cscheid cscheid left a comment

Choose a reason for hiding this comment

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

I left a small suggestion for improvement, but otherwise LGTM!

Comment thread docs/authoring/language.qmd Outdated
Comment thread docs/authoring/language.qmd Outdated
@cscheid cscheid merged commit c11a03d into quarto-dev:main May 1, 2026
4 checks passed
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

Successfully created backport PR for prerelease:

cscheid pushed a commit that referenced this pull request May 1, 2026
…2009)

* docs(language): document crossref title/prefix localisation

* refactor: reword per suggestion

(cherry picked from commit c11a03d)

Co-authored-by: Mickaël Canouil <8896044+mcanouil@users.noreply.github.com>
@mcanouil mcanouil deleted the docs/crossref-localisation branch May 1, 2026 21:20
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.

Document localisation of cross-reference titles/prefixes via the language key

2 participants