STACK static representations: provide PNG and SVG images alongside PDF

Abierto
#3,033 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

  • #3043 de @geoo89 — cerrado sin fusionar

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
50/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
latex
Área
build-system

Línea de trabajo

Start from the STACK static-representation harvesting path and the EPUB image handling changed in PR #3032, then trace where stack-plot-render-0.pdf is produced. Check closed PR #3043 for prior attempts before editing. Done when each harvested STACK image writes both an SVG and a PNG alongside the PDF, and the EPUB build packages the SVG without a placeholder.

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

Descripción

The static representation of a STACK exercise arrives with its images only as PDF files (for example stack-plot-render-0.pdf in the sample article's generated directory). PDF serves the LaTeX/print route well, but an EPUB reading system displays no PDF, and the EPUB specification requires a fallback for any such resource (epubcheck error MED-003).

As of the commit "EPUB: an image available only as PDF leaves a placeholder" (PR #3032), the EPUB conversion does not package a PDF-only image: it issues a build warning and places a text placeholder where the image belongs. So a reader of an EPUB containing STACK exercises currently sees a placeholder instead of a plot.

The durable fix is on the harvesting side: the static representation of each STACK exercise should include both an SVG and a PNG for each image, alongside the PDF. The conversions already choose per output: SVG for EPUB and other web-derived formats, PNG for the Kindle variant (whose images are always PNG). With both present, every route gets its preferred format with no fallback machinery.

cc @geoo89

Claude Fable 5, acting as a coding assistant for Rob Beezer

Lenguaje dominante
XSLT
Estrellas
466
Forks
251
Merge medio
4 min
PR fusionados (30 d)
13

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

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 PreTeXtBook/pretext

Todos los issues de PreTeXtBook/pretext

Issues similares

Más issues de Build System

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.