A callout with an id loses its number in the default title

Cerrado Apto para principiantes
  • ¿Algo no está bien?
#1,020 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Ya se ha fusionado un pull request relacionado.

  • #1050 de @cscheid — fusionado

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
76/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
rust
Área
backend

Línea de trabajo

Empieza en crates/quarto-core/src/transforms/callout_resolve.rs, alrededor de las líneas 240–262, donde el issue indica que se construye el título predeterminado y que ref_type está disponible. Renderiza el index.qmd proporcionado con q2 render index.qmd --to html e inspecciona el título del callout junto al texto de referencia. Se considera terminado cuando el título predeterminado incluye el mismo prefijo y número de referencia cruzada, en consonancia con Quarto 1.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Bug description

A callout with an id such as nte-x and no title gets the title "Note 1" in Quarto 1.
q2 gives it the title "Note".
The reference @nte-x reads "Note 1" in both engines, so the page names a number that the callout does not show.

The default title is built from the callout type alone.
The transform knows that the callout is a cross-reference target (ref_type), but it does not add the number:

https://github.com/quarto-dev/q2/blob/a2a1cb948b1aec42c93200b880dc73567160f691/crates/quarto-core/src/transforms/callout_resolve.rs#L240-L262

The comment in that block expects such a callout to carry a cross-reference prefix in its title, so the number seems meant to be there.

Steps to reproduce

index.qmd:

---
format: html
---

::: {#nte-x .callout-note}
Body.
:::

See @nte-x.

Run q2 and Quarto 1 on it:

q2 render index.qmd --to html
quarto render index.qmd --to html
Actual behavior

q2 gives the callout the title "Note", while the link text has the number:

<div class="callout-title-container flex-fill">
Note
</div>
...
<p>See <a href="#nte-x" class="quarto-xref">Note 1</a>.</p>

Quarto 1.12.0 writes "Note 1" in both places.

Expected behavior

The title reads "Note 1", as in Quarto 1.
The default title should use the same prefix and number as the cross-reference.

Your environment
  • q2: Q2 (quarto 2) 0.40.0-nightly.20261101 (nightly built from a2a1cb9).
  • Quarto 1 for comparison: 1.12.0 (pre-release).
  • OS: macOS 27.2 (arm64).
  • Terminal, no IDE.
Lenguaje dominante
Rust
Estrellas
293
Forks
20
Merge medio
12 h 30 min
PR fusionados (30 d)
175

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de quarto-dev/q2

Todos los issues de quarto-dev/q2

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.