TSYS Group COO
e4887f7609
Fleet document-generation image. DejaVu/Noto fonts for unicode + box-drawing. Remote push + cross-links queued (gitea incident #937).
45 lines
1.6 KiB
Markdown
45 lines
1.6 KiB
Markdown
# KNELPDF
|
|
|
|
Fleet document-generation image: **pandoc + texlive (xetex/luatex) + DejaVu
|
|
and Noto fonts**, built for the TSYS Group agent fleet. Runs markdown → PDF
|
|
with full unicode support (box-drawing org charts, tables, code blocks).
|
|
|
|
## Status
|
|
|
|
- Built locally as `knelpdf:v1` on the COO workstation (2026-09-07).
|
|
- **Remote not yet created** — Gitea pushes are blocked by the
|
|
2026-09-07 box incident (gitea receive-pack 500s, see Redmine #937).
|
|
When infra recovers: create repo `KNEL/KNELPDF` on
|
|
git.knownelement.com, push, and cross-link the Redmine ticket +
|
|
Discourse doc here (links land at birth per house rules).
|
|
|
|
## Usage
|
|
|
|
```sh
|
|
# markdown -> PDF (xelatex engine, landscape, DejaVu mono keeps box-drawing)
|
|
docker run --rm -v "$PWD:/data" knelpdf:v1 \
|
|
pandoc /data/input.md -o /data/output.pdf \
|
|
--pdf-engine=xelatex \
|
|
-V geometry:landscape -V geometry:margin=2cm \
|
|
-V mainfont="DejaVu Sans" -V monofont="DejaVu Sans Mono"
|
|
```
|
|
|
|
The image has NO entrypoint (fleet rule) — invoke tools directly:
|
|
`pandoc`, `xelatex`, `lualatex`.
|
|
|
|
## Version policy (bump on rebuild, never float)
|
|
|
|
| Component | Pinned at |
|
|
|---|---|
|
|
| Base | `debian:bookworm-slim@sha256:88200866…` (digest in Dockerfile) |
|
|
| pandoc | 3.11 (`pandoc-3.11-1-amd64.deb` from GitHub releases) |
|
|
| texlive | Debian bookworm archive (pulled at build time, pinned by base digest) |
|
|
| Image tag | `knelpdf:vN` — `:latest` is forbidden by house rules |
|
|
|
|
## Contents
|
|
|
|
- texlive-latex-base / recommended / extra
|
|
- texlive-xetex, texlive-luatex, texlive-fonts-recommended, lmodern
|
|
- fonts-dejavu (mono has box-drawing glyphs), fonts-noto-core
|
|
- curl + ca-certificates
|