PRJ-domus-asciidoc-build: Standalone AsciiDoc Build Toolchain

Project Summary

Field Value

PRJ ID

PRJ-2026-TOOL-004

Date Created

2026-04-19

Owner

Evan Rosado

Priority

P2 (Infrastructure tooling)

Category

Personal Infrastructure / Build Toolchain

Status

Active

Repository

GitHub (private). GitLab and Gitea pending

Local Path

~/atelier/_bibliotheca/domus-asciidoc-build

Purpose

domus-asciidoc-build is a standalone AsciiDoc build toolchain extracted from Principia. It provides multi-format document rendering (HTML, PDF, DOCX, EPUB, Markdown) with professional styling, diagram support, and workflow automation.

The extraction separates build infrastructure from knowledge content. Any domus spoke repo or standalone document project can consume this toolchain without depending on Principia. This is the standalone counterpart to domus-antora-ui — where the UI bundle handles Antora rendering, this repo handles everything outside Antora.

Why Extract

  • Build scripts were coupled to Principia’s .principia/ directory structure

  • Multiple repos (domus spokes, CHLA runbooks, private playbooks) need the same build toolchain

  • The docinfo-footer monolith needed separation of concerns for maintainability

  • Theme selection was hardcoded instead of parameterized

New Machine Quick Start

Clone two repos and render any .adoc file anywhere.

1. Install prerequisites

Arch:

gem install asciidoctor asciidoctor-pdf asciidoctor-diagram rouge
sudo pacman -S pandoc

Ubuntu/Debian:

sudo apt install -y ruby ruby-dev pandoc
sudo gem install asciidoctor asciidoctor-pdf asciidoctor-diagram rouge

2. Clone the toolchain

gh repo clone EvanusModestus/domus-asciidoc-build ~/atelier/_bibliotheca/domus-asciidoc-build

3. Verify

for cmd in asciidoctor asciidoctor-pdf pandoc d2 mmdc age; do
  printf "%-20s %s\n" "$cmd" "$(command -v $cmd >/dev/null 2>&1 && echo 'OK' || echo 'MISSING')"
done

4. Build any document

# HTML with Catppuccin dark theme + syntax highlighting
~/atelier/_bibliotheca/domus-asciidoc-build/bin/build-adoc.sh document.adoc html --variant catppuccin

# PDF with operations theme
~/atelier/_bibliotheca/domus-asciidoc-build/bin/build-adoc.sh document.adoc pdf --theme operations

# All formats
~/atelier/_bibliotheca/domus-asciidoc-build/bin/build-adoc.sh document.adoc all

Output lands in <source-dir>/output/. Works on Arch, Ubuntu, macOS — any machine with the prerequisites installed.

Optional alias

Add to ~/.zshrc:

alias build-adoc="$HOME/atelier/_bibliotheca/domus-asciidoc-build/bin/build-adoc.sh"

Then from anywhere: build-adoc file.adoc html --variant catppuccin

Metadata

Field Value

PRJ ID

PRJ-2026-TOOL-004

Author

Evan Rosado

Date Created

2026-04-19

Last Updated

2026-04-19

Status

Active

Next Review

2026-05-19

Related