This repository has been archived on 2026-09-13. You can view files and clone it, but cannot push or open issues or pull requests.
podman_ravenous/README.md

2.3 KiB
Raw Blame History

podman_ravenous

Ravenous‑Latex Podman Builder

A lightweight Debian‑based Podman image that bundles a minimal TeX Live installation, Rust, and the ravenous-tools command line suite.
It is intended to compile LaTeX documents inside a reproducible container.

Quick start

# Build the image (you can replace `ravenous-latex` with any tag you prefer)
podman build -t ravenous-podman:latest .

# Save + compress (for offline sharing)
podman save -o ravenous-podman.tar.gz ravenous-podman:latest

# Load back the archive
podman load -i ravenous-podman.tar.gz

# Enter the podman in "interactive" mode
podman run --rm -it -v "$(pwd)":/workspace --entrypoint /bin/sh localhost/ravenous-podman:latest

The image defaults to /workspace as the working directory, so any mounted volume at . will be available for LaTeX source files.

Image contents

  • Base - debian:stable-slim
  • TeX Live - minimal packages needed for most documents
  • Rust - cargo installed system-wide
  • Ravenous tools - cargo install from the public repo

Quick Usage

# Trigger a full build
./build.sh --full

# Rebuild
./build.sh

# Build only the artisant section, suppressing all warnings
./build.sh -o art -v error

# Show help (this tool)
./build.sh --help

# Show help (ravevenous-tool)
./build.sh -h

Usage

# Help
podman run --rm localhost/ravenous-podman:latest --help

# Compile
podman run --rm -v "$(pwd)":/workspace localhost/ravenous-podman:latest tablegen -e all
mkdir -p ~/.local/share/fonts/
mkdir -p ./Images/Radar/
mkdir -p ./Bestiaire/
cp ./Ressources/lmroman8-regular.ttf ~/.local/share/fonts/
podman run --rm --tty -v "$(pwd)":/workspace localhost/ravenous-podman:latest graphs load
podman run --rm --tty -v "$(pwd)":/workspace localhost/ravenous-podman:latest graphs gen
podman run --rm --tty -v "$(pwd)":/workspace localhost/ravenous-podman:latest monsters export --all
podman run --rm --tty -v "$(pwd)":/workspace localhost/ravenous-podman:latest make -N Ravenous.tex
podman run --rm --tty -v "$(pwd)":/workspace localhost/ravenous-podman:latest make -t glossaries -N Ravenous.tex
podman run --rm --tty -v "$(pwd)":/workspace localhost/ravenous-podman:latest make -N Ravenous.tex

Feel free to extend the Dockerfile or wrap it in a CI pipeline.