42 lines
1.2 KiB
Markdown
42 lines
1.2 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
|
||
```
|
||
|
||
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
|
||
|
||
## Usage
|
||
|
||
```bash
|
||
# Help
|
||
podman run --rm ravenous-latex --help
|
||
|
||
# Compile
|
||
podman run --rm -v "$(pwd)":/workspace localhost/ravenous-podman:latest make -t glossaries -N Ravenous.tex
|
||
podman run --rm -v "$(pwd)":/workspace localhost/ravenous-podman:latest make -N Ravenous.tex
|
||
```
|
||
|
||
Feel free to extend the Dockerfile or wrap it in a CI pipeline. |