feat: add superderive stepwise derivation figures

A third sibling toolkit: rewrite steps, justification rails, cancel/substitute highlights, and lint-on-warning builds.
2026-08-17 10:05:03 +08:00
commit 9f635d358b
22 changed files with 724 additions and 0 deletions
@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+#   ./scripts/build.sh figure.tex [outdir]
+set -euo pipefail
+SRC="${1:?usage: build.sh figure.tex [outdir]}"
+[[ -f "$SRC" ]] || { echo "no such file: $SRC" >&2; exit 2; }
+SRCDIR="$(cd "$(dirname "$SRC")" && pwd)"
+BASE="$(basename "$SRC" .tex)"
+OUT="${2:-$SRCDIR/build}"
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+mkdir -p "$OUT"
+
+if [[ "${SD_SKIP_LINT:-0}" != "1" ]]; then
+  echo "==> lint $BASE"
+  python3 "$ROOT/scripts/lint.py" "$SRC"
+fi
+
+echo "==> xelatex $BASE"
+TEXINPUTS="$ROOT/assets:$SRCDIR:" \
+  xelatex -halt-on-error -interaction=nonstopmode \
+          -output-directory="$OUT" "$SRC" >/dev/null 2>&1 \
+  || { echo "!! xelatex failed; last errors:" >&2
+       grep -n -A4 -m3 '^!' "$OUT/$BASE.log" >&2 || tail -30 "$OUT/$BASE.log" >&2
+       exit 1; }
+
+LOG="$OUT/$BASE.log"
+status=0
+if grep -q "Missing character" "$LOG"; then
+  echo "!! missing glyphs:" >&2
+  grep -m5 "Missing character" "$LOG" >&2
+  status=1
+fi
+if grep -qE "^(Overfull|Underfull) \\\\[hv]box" "$LOG"; then
+  echo "!! overfull/underfull boxes:" >&2
+  grep -m5 -E "^(Overfull|Underfull) \\\\[hv]box" "$LOG" >&2
+  status=1
+fi
+if grep -q "Package superderive Warning" "$LOG"; then
+  echo "!! superderive warnings:" >&2
+  grep -m5 -A2 "Package superderive Warning" "$LOG" >&2
+  status=1
+fi
+
+if command -v pdftocairo >/dev/null 2>&1; then
+  echo "==> exporting svg / png"
+  pdftocairo -svg "$OUT/$BASE.pdf" "$OUT/$BASE.svg"
+  pdftocairo -png -r 300 -singlefile "$OUT/$BASE.pdf" "$OUT/$BASE"
+  pdftocairo -png -r 300 -singlefile -transp "$OUT/$BASE.pdf" "$OUT/$BASE-alpha"
+  pdftocairo -png -scale-to-x 360 -scale-to-y -1 -singlefile \
+    "$OUT/$BASE.pdf" "$OUT/$BASE-thumb"
+else
+  echo "!! pdftocairo missing: PDF only" >&2
+  status=1
+fi
+echo "==> artifacts in $OUT"
+ls -1 "$OUT/$BASE"*.{pdf,svg,png} 2>/dev/null | sed 's/^/    /'
+exit $status