unaltraweb 0.3.0

data/scripts/cv/render_pdf_preview.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [ "$#" -lt 2 ]; then
+  printf 'Usage: %s path/to/cv.pdf path/to/cv-preview.jpg\n' "$0" >&2
+  exit 2
+fi
+
+pdf=$1
+out=$2
+density=${DENSITY:-180}
+
+if [ ! -f "$pdf" ]; then
+  printf 'PDF not found: %s\n' "$pdf" >&2
+  exit 1
+fi
+
+mkdir -p "$(dirname "$out")"
+
+if command -v pdftoppm >/dev/null 2>&1; then
+  tmp_dir=$(mktemp -d)
+  trap 'rm -rf "$tmp_dir"' EXIT
+  pdftoppm -f 1 -singlefile -jpeg -r "$density" "$pdf" "$tmp_dir/page"
+  mv "$tmp_dir/page.jpg" "$out"
+elif command -v mutool >/dev/null 2>&1; then
+  mutool draw -r "$density" -o "$out" "$pdf" 1
+elif command -v magick >/dev/null 2>&1 && command -v gs >/dev/null 2>&1; then
+  magick -density "$density" "${pdf}[0]" -background white -alpha remove -alpha off -quality 90 "$out"
+elif command -v convert >/dev/null 2>&1 && command -v gs >/dev/null 2>&1; then
+  convert -density "$density" "${pdf}[0]" -background white -alpha remove -alpha off -quality 90 "$out"
+else
+  printf 'No supported PDF renderer found. Install poppler-utils, mupdf-tools, or Ghostscript for ImageMagick.\n' >&2
+  exit 1
+fi
+
+printf 'Wrote %s\n' "$out"

data/scripts/deploy/publish_branch.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PUBLISH_REMOTE="${PUBLISH_REMOTE:-origin}"
+PUBLISH_BRANCH="${PUBLISH_BRANCH:-gh-pages}"
+PUBLISH_SOURCE="${PUBLISH_SOURCE:-_site}"
+PUBLISH_WORKTREE="${PUBLISH_WORKTREE:-tmp/publish-${PUBLISH_BRANCH}}"
+PUBLISH_DRY_RUN="${PUBLISH_DRY_RUN:-0}"
+PUBLISH_PREPARE_ONLY="${PUBLISH_PREPARE_ONLY:-0}"
+PUBLISH_ALLOW_PROTECTED_BRANCH="${PUBLISH_ALLOW_PROTECTED_BRANCH:-0}"
+
+die() {
+  printf 'publish_branch: %s\n' "$*" >&2
+  exit 1
+}
+
+is_true() {
+  case "${1:-0}" in
+    1|true|TRUE|yes|YES|y|Y) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+case "$PUBLISH_BRANCH" in
+  main|master)
+    is_true "$PUBLISH_ALLOW_PROTECTED_BRANCH" || die "refusing to publish to protected branch '$PUBLISH_BRANCH'"
+    ;;
+esac
+
+repo_root="$(git rev-parse --show-toplevel 2>/dev/null)" || die "run from inside a git repository"
+cd "$repo_root"
+
+git diff-index --quiet HEAD -- || die "working tree has uncommitted tracked changes"
+
+untracked="$(git ls-files --exclude-standard --others)"
+if test -n "$untracked"; then
+  printf '%s\n' "$untracked" >&2
+  die "working tree has untracked files"
+fi
+
+test -d "$PUBLISH_SOURCE" || die "publish source '$PUBLISH_SOURCE' does not exist; run the build first"
+
+source_abs="$(cd "$PUBLISH_SOURCE" && pwd)"
+worktree_abs="$repo_root/$PUBLISH_WORKTREE"
+source_rev="$(git rev-parse --short HEAD)"
+message="${PUBLISH_MESSAGE:-Publish site from ${source_rev}}"
+
+git worktree remove --force "$worktree_abs" >/dev/null 2>&1 || true
+mkdir -p "$(dirname "$worktree_abs")"
+git worktree add --detach "$worktree_abs" HEAD >/dev/null
+
+(
+  cd "$worktree_abs"
+  git rm -r --ignore-unmatch . >/dev/null
+  cp -a "$source_abs"/. .
+  if test -f "$repo_root/CNAME" && ! test -f CNAME; then
+    cp "$repo_root/CNAME" CNAME
+  fi
+  touch .nojekyll
+
+  if ! git config user.name >/dev/null; then
+    git config user.name "unaltraweb local publish"
+  fi
+  if ! git config user.email >/dev/null; then
+    git config user.email "unaltraweb-local-publish@example.invalid"
+  fi
+
+  git add -A
+  git commit --allow-empty -m "$message" >/dev/null
+)
+
+printf 'Prepared %s from %s in %s\n' "$PUBLISH_BRANCH" "$PUBLISH_SOURCE" "$PUBLISH_WORKTREE"
+
+if is_true "$PUBLISH_DRY_RUN" || is_true "$PUBLISH_PREPARE_ONLY"; then
+  printf 'Dry run or prepare-only mode: not pushing. Inspect with:\n'
+  printf '  git -C %s log --oneline -1\n' "$PUBLISH_WORKTREE"
+  exit 0
+fi
+
+git -C "$worktree_abs" push --force "$PUBLISH_REMOTE" "HEAD:refs/heads/$PUBLISH_BRANCH"

data/scripts/generate_logo_variants.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import argparse
+import re
+from pathlib import Path
+
+
+MONOCHROME_COLOR_RE = re.compile(r"(?i)(?P<prefix>\b(?:fill|stroke)\s*[:=]\s*[\"']?)#(?:000000|000)\b")
+HEX_COLOR_RE = re.compile(r"^#[0-9a-fA-F]{6}$")
+
+
+def variant(value: str) -> tuple[Path, str]:
+    try:
+        output, color = value.rsplit("=", 1)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError("variants must use OUTPUT=#RRGGBB") from exc
+    if not output or not HEX_COLOR_RE.fullmatch(color):
+        raise argparse.ArgumentTypeError("variants must use OUTPUT=#RRGGBB")
+    return Path(output), color.lower()
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Create color variants from a black monochrome SVG logo.")
+    parser.add_argument("source", type=Path)
+    parser.add_argument("variants", nargs="+", type=variant, metavar="OUTPUT=#RRGGBB")
+    args = parser.parse_args()
+
+    source = args.source.resolve()
+    text = source.read_text(encoding="utf-8")
+
+    for output, color in args.variants:
+        rendered, replacements = MONOCHROME_COLOR_RE.subn(lambda match: match.group("prefix") + color, text)
+        if replacements == 0:
+            parser.error(f"{source} has no black fill or stroke declarations to replace")
+        destination = output.resolve()
+        if destination == source:
+            parser.error("output must not overwrite the source SVG")
+        destination.parent.mkdir(parents=True, exist_ok=True)
+        destination.write_text(rendered, encoding="utf-8")
+        print(f"{destination}: {color} ({replacements} replacements)")
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

data/scripts/manual/Dockerfile

@@ -0,0 +1,31 @@
+FROM python:3.13-slim-trixie@sha256:ffb752e139c0a19692a43af8d8523b274222dd68eebad5d583b45c2201c6e30a
+
+ENV DEBIAN_FRONTEND=noninteractive
+ARG DEBIAN_SNAPSHOT=20260822T000000Z
+
+RUN printf '%s\n' \
+        "deb [check-valid-until=no] https://snapshot.debian.org/archive/debian/${DEBIAN_SNAPSHOT}/ trixie main" \
+        "deb [check-valid-until=no] https://snapshot.debian.org/archive/debian-security/${DEBIAN_SNAPSHOT}/ trixie-security main" \
+        > /etc/apt/sources.list \
+    && rm -f /etc/apt/sources.list.d/debian.sources \
+    && apt-get update \
+    && apt-get install --no-install-recommends -y \
+        fonts-dejavu-core \
+        librsvg2-bin \
+        pandoc \
+        poppler-utils \
+        qpdf \
+        texlive-fonts-recommended \
+        texlive-lang-european \
+        texlive-lang-spanish \
+        texlive-latex-extra \
+        texlive-xetex \
+    && rm -rf /var/lib/apt/lists/* \
+    && pip install --no-cache-dir PyYAML==6.0.2
+
+COPY build_pdf.py /opt/unaltraweb/manual/build_pdf.py
+COPY Dockerfile /opt/unaltraweb/manual/Dockerfile
+COPY filters /opt/unaltraweb/manual/filters
+COPY templates /opt/unaltraweb/manual/templates
+
+ENTRYPOINT ["python3", "/opt/unaltraweb/manual/build_pdf.py"]