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

73 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```bash
# 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
```bash
# 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
```bash
# 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.