Typst: image size in px is not converted when the image has fig-alt
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 75/100
- Tipo de issue
- Error
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- lua
- Área
- cli, documentation
Línea de trabajo
El error está en src/resources/filters/quarto-post/typst.lua, líneas 218-225 y 262-273. Comience leyendo el código del filtro para ver cómo maneja las imágenes con fig-alt. La solución probablemente implica convertir las unidades px a pulgadas usando PANDOC_WRITER_OPTIONS.dpi, de manera similar a cómo se manejan los números simples. Pruebe creando un archivo .qmd mínimo con una imagen que tenga fig-alt y un tamaño en px, luego ejecute quarto render para verificar que el archivo .typ generado ya no contenga 'px'.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Bug description
When I render to Typst, an image with fig-alt keeps its size in px. Typst has no px unit, so compiling the document fails with invalid number suffix: px. The same image without fig-alt renders fine, because Quarto converts its size to inches.
The cause is in the Typst filter, quarto-post/typst.lua. When an image has alt text, the filter doesn't pass it on to Pandoc. It writes the Typst image() call itself as a RawInline and copies the height and width values across unchanged. The filter does convert sizes before that, but only when they're plain numbers. tonumber("200px") returns nil, so 200px ends up in the Typst code as it is.
This is where the filter builds the image() call for an image with alt text:
An image without alt text goes through Pandoc's Typst writer instead, and that writer turns pixel sizes into inches:
Sizes in % still work with fig-alt, because Typst understands %.
Checked against Pandoc
I also ran the same image through Pandoc on its own, and Pandoc isn't the cause. The Pandoc 3.10 bundled with Quarto converts the size and writes the alt text correctly:
printf 'A {height="200px" alt="Quarto logo."} b\n' | quarto pandoc -f markdown -t typst
# #box(image("https://quarto.org/quarto.png", height: 2.08333in, alt: "Quarto logo."))
A comment in the filter says the raw image() call is a workaround, because Pandoc used to leave alt text out of Typst output (jgm/pandoc#11394). Pandoc 3.10 writes alt: itself now, so the workaround might not be needed any more. For the moment, it's the code path that causes this bug.
Steps to reproduce
---
format: typst
keep-typ: true
---
{height="200px"}
{height="200px" fig-alt="Quarto logo."}
Actual behavior
The generated .typ file has these two lines:
#box(image("t3_files/mediabag/quarto.png", height: 2.08333in))
#box(image("t3_files/mediabag/quarto.png", alt: "Quarto logo.", height: 200px))
Typst then stops with this error:
error: invalid number suffix: `px`
Expected behavior
I'd expect the image with fig-alt to have its size converted just like the one without it:
#box(image("t3_files/mediabag/quarto.png", alt: "Quarto logo.", height: 2.08333in))
I can see two ways to fix it. The filter could convert px values to inches with PANDOC_WRITER_OPTIONS.dpi, as it already does for plain numbers. Or, now that Pandoc 3.10 writes the alt text itself, the filter could let Pandoc handle these images as well.
Your environment
I'm on macOS. The bug happens with Quarto 1.10.18 and with the current main branch at commit 03f0fdf586b066ffa81ebefa55e5dad21e08bec0.
Quarto check output
This output comes from the development build I used to confirm the bug on main.
[✓] Checking environment information...
Quarto cache location: /Users/mcanouil/Library/Caches/quarto
[✓] Checking versions of quarto binary dependencies...
Pandoc version 3.10.0: OK
Dart Sass version 1.101.0: OK
Deno version 2.7.14: OK
Typst version 0.15.1: OK
[✓] Checking versions of quarto dependencies......OK
[✓] Checking Quarto installation......OK
Version: 99.9.9
commit: 03f0fdf586b066ffa81ebefa55e5dad21e08bec0
Path: /Users/mcanouil/Projects/quarto-dev/quarto-cli/package/dist/bin
[✓] Checking tools....................OK
TinyTeX: v2026.07
Chrome Headless Shell: (not installed)
VeraPDF: (not installed)
[✓] Checking LaTeX....................OK
Using: TinyTex
Path: /Users/mcanouil/Library/TinyTeX/bin/universal-darwin
Version: 2026
[✓] Checking Chrome Headless....................OK
Using: Chrome from QUARTO_CHROMIUM
Path: /Applications/Brave Browser.app/Contents/MacOS/Brave Browser
[✓] Checking basic markdown render....OK
ℹ R version 4.6.1 (2026-06-24)
! Config '~/.Rprofile' was loaded!
[✓] Checking R installation...........OK
Version: 4.6.1
Path: /Library/Frameworks/R.framework/Versions/4.6/Resources
LibPaths:
- /Users/mcanouil/Projects/quarto-dev/quarto-playground/renv/library/macos/R-4.6/aarch64-apple-darwin23
- /Users/mcanouil/Library/Caches/org.R-project.R/R/renv/sandbox/macos/R-4.6/aarch64-apple-darwin23/46003b10
knitr: 1.51
rmarkdown: 2.31
[✓] Checking Knitr engine render......OK
[✓] Checking Python 3 installation....OK
Version: 3.9.6
Path: /Library/Developer/CommandLineTools/usr/bin/python3
Jupyter: (None)
Jupyter is not available in this Python installation.
Install with python3 -m pip install jupyter
There is an unactivated Python environment in .venv. Did you forget to activate it?
[✓] Checking Julia installation...
- Lenguaje dominante
- JavaScript
- Estrellas
- 6k
- Forks
- 458
- Merge medio
- 1 d 3 h
- PR fusionados (30 d)
- 54
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de quarto-dev/quarto-cli
-
accessibility documentation
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
quarto-dev/quarto-cli#14944 ·
-
maintenance ojs-engine
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
quarto-dev/quarto-cli#14934 ·
-
accessibility bug html themes
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
quarto-dev/quarto-cli#14932 ·
-
documentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 86/100
quarto-dev/quarto-cli#14915 ·
-
binder bug
Dificultad 1/5 Menos de una hora Aptitud para principiantes 92/100
quarto-dev/quarto-cli#14907 · 3 comentarios · 1 reacción ·
Todos los issues de quarto-dev/quarto-cli
Issues similares
-
Update HugeIcons library Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
antfu-collective/icones#398 ·
-
ECmail.com Abierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
wesbos/burner-email-providers#554 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
radiantearth/stac-browser#1023 ·
-
HMR stops working Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
components-web-app/docs#92 ·