callout-note-title localization not working as expected

[MarcoPortmann]

Bug description

I would like to cross-reference a callout note in a German Quarto document. Therefore, the reference should have the prefix "Hinweis" instead of note. As I understand it, this should work with

language:
  de:
    callout-note-title: "Hinweis"

in the yaml header. The reference is still labeled "Note 1". Am I doing something wrong?

Steps to reproduce

---
title: "Reproducible Quarto Document"
format: html
lang: de
language:
  de:
    callout-note-title: "Hinweis"
---
  
# A title  
This is a reproducible Quarto document.


::: {#nte-test .callout-note collapse="true" appearance="simple"}
## This is a callout note

Some text.
:::

This is @nte-test.


The end.

Expected behavior

The reference should be labeled "Hinweis 1".

Actual behavior

The reference is still labeled "Note 1".

Your environment

RStudio Server
2023.09.0 Build 463

Quarto check output

1.4.542

[mcanouil]

Thanks for the report!

FYI, no need to set:

language:
  de:
    callout-note-title: "Hinweis"

It's the default.

• quarto-cli/src/resources/language/_language-de.yml

  Line 38 in cfeb822

  callout-note-title: "Hinweis"

[MarcoPortmann]

Two questions to make sure I have understood correctly:

There is a bug in that the default value from _language-en.yml is not applied as well?
And if I wanted to set a different title

language:
  de:
    callout-note-title: "Vertiefungsbox"

would the correct way to do it, right?

[cscheid]

There is a bug in that the default value from _language-en.yml is not applied as well

Yes, that's correct. What's happening here is that the crossreferenceable title resolution happens against the crossref-{KEY}-title metadata entry, while the callout title resolution happens against the callout-{TYPE}-title metadata entry.

As a current workaround, you should be able to provide the correct localization with

language:
  de:
    crossref-nte-title: "Hinweis"
    crossref-nte-prefix: "Hinweis"

A couple of things to note: for callouts, you write "callout-note-title". For crossreferenceable callouts you write "crossref-nte-title", and you also have to write crossref-nte-prefix, because in the case of crossreferenceable entries, these can be written differently.

This is a bit unfortunate, but inevitable for the moment. We'll consider making these uniform in a later Quarto version.

[MarcoPortmann]

Thank you for this workaround. This works fine for format: html. I've tested the same for pdf.

---
title: "Reproducible Quarto Document"
format: pdf
lang: de
language:
  de:
    crossref-nte-title: "Hinweis"
    crossref-nte-prefix: "Hinweis"
---
  
::: {#nte-test .callout-note icon=false}
## Test

Text.
:::

This is @nte-test.

This yields:

Does format: pdf even require another localized expression for the title?

[cscheid]

Does format: pdf even require another localized expression for the title?

No, it shouldn't.

It's really that the bug workaround doesn't appear to work in pdf.

[MarcoPortmann]

Ok, thanks for the clarification.

[mcanouil]

For reference, the issue was also reported later on #9263.

[cscheid]

@cderv Do you still want to take a shot at this one?

[MarcoPortmann]

We would be very grateful for a fix. I currently have pdfs where I use adobe acrobat pro to manually correct the callout headings.