Provide Dockerfile to build org-builder container
- CSS 49.2%
- Emacs Lisp 40.7%
- TeX 6.5%
- Dockerfile 1.8%
- HTML 1%
- Other 0.7%
tcolorbox 6.9.0 in Fedora 44 (TeX Live 2025) requires the separate tikzfill package for its enhanced skins, but texlive-tcolorbox does not pull it in as a dependency. Without it, LaTeX fails with "File 'tikzfill.image.sty' not found" for both the APA 7 style and the default orgbuilder style. |
||
|---|---|---|
| .readme | ||
| csl | ||
| css | ||
| doc | ||
| html/en | ||
| plantuml | ||
| tests | ||
| texmf/tex/latex/orgbuilder | ||
| .gitignore | ||
| .gitlab-ci-example.yml | ||
| ATOM.org | ||
| Containerfile.sbcl-update | ||
| Dockerfile | ||
| emacs-package-install.el | ||
| IDEAS.org | ||
| justfile | ||
| LICENSE | ||
| lisp-package-install.lisp | ||
| orgbuilder-xlsx.el | ||
| orgbuilder.el | ||
| orgbuilder.sh | ||
| README.org | ||
orgbuilder
orgbuilder is a containerized Org-mode publishing environment. It converts
.org source files into PDF, HTML, Markdown, EPUB3, Info, and GitLab Pages
through a Fedora-based Podman image running Emacs in batch mode.
Prerequisites
The development baseline is Fedora Linux with:
- Podman
- Just
- PowerShell (
pwsh) — thejustfileshells out topwsh -c
Quickstart
Build the container image:
just build-container
Publish a project whose src/ directory contains .org files:
podman run --rm -v "$PWD":/home/book -e PUBLISH=HTML \
code.metalisp.dev/marcuskammer/orgbuilder:latest
Generated files are written to public/ inside the mounted project.
Run the unit tests for orgbuilder.el:
just test
Documentation
See doc/orgbuilder.org for the full user guide and the system architecture.