73 lines
2.3 KiB
Markdown
73 lines
2.3 KiB
Markdown
# 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.
|