STACK static representations: provide PNG and SVG images alongside PDF

オープン
#3,033 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

  • #3043 @geoo89 による — マージされずにクローズ

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
50/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
静か
技術スタック
latex
領域
build-system

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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

主要言語
XSLT
スター
466
フォーク
251
平均マージ
4分
マージ済み PR(30日)
13

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

PreTeXtBook/pretext のほかの issue

PreTeXtBook/pretext の issue をすべて見る

似ている issue

Build System の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。