Enable prefix translation for callout cross-references

[luifrancgom]

Description

I would like to suggest adding the ability to translate prefixes for callout cross-references in _language.yml, specifically for non-English languages.

I was not able to find this aspect in Cross Reference Options or in _language-es.yml.

Actual behavior

Expected behavior

Minimal reproducible example

---
title: Test
format: 
  html: default
lang: es
---

::: {#nte-test-note .callout-note}
## Test note

Some text
:::

::: {#wrn-test-warning .callout-warning}
## Test warning

Some text
:::

@nte-test-note

@wrn-test-warning

[cscheid]

It might just be a bug; I would have expected those to use the translations.

[luifrancgom]

Thank you, Carlos Scheidegger. In this case, should I open an issue or wait for your confirmation?

[mcanouil]

I'll double check and open one if needed.

[mcanouil]

There is localisation support, but no translations necessarily set in languages files.

---
format: html
language:
  crossref-fig-prefix: "Whatever"
  crossref-fig-title: "Amazing"
  crossref-nte-prefix: "My Note"
  crossref-nte-title: "Amazing Note"
---

::: {#fig-one}
Figure

Caption
:::

@fig-one

::: {#nte-test-note .callout-note}
## Test note

Some text
:::

@nte-test-note

The reason, from my understanding of the codebase, is that cross-reference "keys" are dynamically built to allow localisation of custom cross-reference, while standard/legacy cross-references floats are hardcoded as constant.

• quarto-cli/src/command/render/filters.ts

  Lines 465 to 497 in ff77c43

  	function languageFilterParams(format: Format) {
  	const language = format.language;
  	const params: Metadata = {
  	[kCodeSummary]: format.metadata[kCodeSummary] || language[kCodeSummary],
  	[kTocTitleDocument]: language[kTocTitleDocument],
  	};
  	// default prefixes based on titles
  	[
  	"fig",
  	"tbl",
  	"lst",
  	"thm",
  	"lem",
  	"cor",
  	"prp",
  	"cnj",
  	"def",
  	"exm",
  	"exr",
  	].forEach((type) => {
  	params[`crossref-${type}-prefix`] = language[`crossref-${type}-title`];
  	});
  	Object.keys(language).forEach((key) => {
  	if (
  	key.startsWith("callout-") || key.startsWith("crossref-") ||
  	key.startsWith("environment-")
  	) {
  	params[key] = language[key];
  	}
  	});
  	return params;
  	}

• quarto-cli/src/core/language.ts

  Lines 161 to 174 in ff77c43

  	export function translationsForLang(language: FormatLanguage, lang: string) {
  	// start with the defaults
  	let translations = {} as FormatLanguage;
  	Object.keys(language).forEach((key) => {
  	// crossrefs can be custom, so be more lenient
  	if (
  	kLanguageDefaultsKeys.includes(key) ||
  	key.match(/^crossref-.*-title$/) ||
  	key.match(/^crossref-.*-prefix$/)
  	) {
  	translations[key] = language[key];
  	}
  	});

• quarto-cli/src/config/constants.ts

  Lines 324 to 353 in ff77c43

  	export const kCrossrefFigTitle = "crossref-fig-title";
  	export const kCrossrefTblTitle = "crossref-tbl-title";
  	export const kCrossrefLstTitle = "crossref-lst-title";
  	export const kCrossrefThmTitle = "crossref-thm-title";
  	export const kCrossrefLemTitle = "crossref-lem-title";
  	export const kCrossrefCorTitle = "crossref-cor-title";
  	export const kCrossrefPrfTitle = "crossref-prp-title";
  	export const kCrossrefCnjTitle = "crossref-cnj-title";
  	export const kCrossrefDefTitle = "crossref-def-title";
  	export const kCrossrefExmTitle = "crossref-exm-title";
  	export const kCrossrefExrTitle = "crossref-exr-title";
  	export const kCrossrefFigPrefix = "crossref-fig-prefix";
  	export const kCrossrefTblPrefix = "crossref-tbl-prefix";
  	export const kCrossrefLstPrefix = "crossref-lst-prefix";
  	export const kCrossrefChPrefix = "crossref-ch-prefix";
  	export const kCrossrefApxPrefix = "crossref-apx-prefix";
  	export const kCrossrefSecPrefix = "crossref-sec-prefix";
  	export const kCrossrefEqPrefix = "crossref-eq-prefix";
  	export const kCrossrefThmPrefix = "crossref-thm-prefix";
  	export const kCrossrefLemPrefix = "crossref-lem-prefix";
  	export const kCrossrefCorPrefix = "crossref-cor-prefix";
  	export const kCrossrefPrpPrefix = "crossref-prp-prefix";
  	export const kCrossrefCnjPrefix = "crossref-cnj-prefix";
  	export const kCrossrefDefPrefix = "crossref-def-prefix";
  	export const kCrossrefExmPrefix = "crossref-exm-prefix";
  	export const kCrossrefExrPrefix = "crossref-exr-prefix";
  	export const kCrossrefLofTitle = "crossref-lof-title";
  	export const kCrossrefLotTitle = "crossref-lot-title";
  	export const kCrossrefLolTitle = "crossref-lol-title";
  	export const kEnvironmentProofTitle = "environment-proof-title";

So the main issue is that the general pattern does not seem to be documented rather than a missing support.

language:
  crossref-*-prefix: ...
  crossref-*-title: ...

[mcanouil]

Opened a documentation issue:

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

Edit: I also made a PR to improve few pages of the documentation about this.