initial image

README.md

@@ -0,0 +1,83 @@
+# texlive
+
+A "batteries-included" LaTeX toolchain in a Docker image: `texlive-full` +
+`latexmk` + `biber` on `debian:trixie-slim`. Built for academic writing —
+heavy math, `biblatex`/`biber`, TikZ/pgfplots, German `babel` + `fontspec`.
+
+Multi-arch: `linux/amd64` and `linux/arm64`, so it runs natively on an Asahi
+Mac (arm64) and an Arch desktop (amd64) alike.
+
+```
+ghcr.io/agresdominik/texlive:latest
+```
+
+## Pull
+
+```sh
+docker pull ghcr.io/agresdominik/texlive:latest
+```
+
+Docker picks the right arch from the manifest automatically.
+
+## Use
+
+The image's entrypoint is `latexmk` with `WORKDIR /data`, so anything after
+the image name is passed straight to `latexmk`.
+
+### `tex` wrapper
+
+Mounts the current directory into the container and fixes file ownership so
+output isn't root-owned (`--user` + a writable `HOME` for TeX's cache).
+
+zsh function — drop into `~/.zshrc`:
+
+```zsh
+tex() {
+  docker run --rm \
+    --user "$(id -u):$(id -g)" \
+    -e HOME=/tmp \
+    -v "$PWD:/data" \
+    ghcr.io/agresdominik/texlive:latest "$@"
+}
+```
+
+Or use the standalone [`tex`](./tex) script — put it on your `$PATH`:
+
+```sh
+install -m755 tex ~/.local/bin/tex
+```
+
+Then:
+
+```sh
+tex -pdf main.tex      # build
+tex -pvc main.tex      # watch + rebuild
+tex -C                 # clean aux files
+```
+
+## How the multi-arch build works
+
+`.github/workflows/build.yml` builds **natively per arch** — no QEMU:
+
+1. A matrix `build` job runs once on `ubuntu-24.04` (amd64) and once on
+   `ubuntu-24.04-arm` (arm64). Each builds for its own platform and pushes a
+   per-arch tag: `:<sha>-amd64`, `:<sha>-arm64`.
+2. A final `manifest` job merges those into single multi-arch tags with
+   `docker buildx imagetools create`, publishing both `:latest` and `:<sha>`.
+
+Auth is `GITHUB_TOKEN` with `packages: write`, logging in to `ghcr.io`.
+Triggers: push to `main` and manual `workflow_dispatch`.
+
+## Trimming the image later
+
+`texlive-full` is large (multiple GB). If size becomes a problem, swap the
+Debian package for a custom TeX Live install driven by a `texlive.profile`,
+selecting `scheme-full` down to e.g. `scheme-medium` plus only the collections
+you need (`collection-latexextra`, `collection-bibtexextra`,
+`collection-pictures`, `collection-langgerman`, `collection-fontsrecommended`,
+…). Build with `install-tl --profile texlive.profile`, then `tlmgr install`
+any stragglers. Keep `scheme-full` until the size actually hurts.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).