Batch release¶

`bubble-batch`¶

Orchestrates a release build: full book variants per language (cover + square interior + none interior), optional per-chapter PDFs, and collection into books/ (override with --output-dir or batch_output_dir in config).

bubble-batch
bubble-batch --chapters
bubble-batch en --cover 7x10 --cover-provider kdp/paperback
bubble-batch all --cover 7x10 --cover-provider ingram/hardcover --cover-version v2
bubble-batch all --no-optimize-pdf
bubble-batch --chapter-opener-size 5

Many book repos expose a thin wrapper:

./run.sh          # exec bubble-batch "$@"

Language selection¶

Argument	Behavior
(none)	Uses `batch_default_langs` from config, or single `lang`, or all scanned langs
`en`, `cn`, …	Build only that locale
`all`	Every language with source files

Typical outputs per language¶

For each selected language, batch generally produces:

Full book with cover (square style by default for cover build)
Interior PDF (square + none styles, often with --no-cover)
Optional: per-chapter PDFs when --chapters is set

Files are copied or linked into books/ (or batch_output_dir).

Cover options¶

--cover 7x10
--cover-provider kdp/paperback | ingram/hardcover | lulu/paperback | lulu/hardcover
--cover-version v1 | v2

Cover scripts in the active folder run before PDF assembly (see Covers & templates).

Optimization¶

PDF optimization follows locale rules (Ghostscript vs qpdf). Controlled by:

batch_optimize_pdf / batch_optimize_pdf_quality in peanut.config
CLI: --optimize-pdf, --no-optimize-pdf, --optimize-pdf-quality

Chapter opener size¶

--chapter-opener-size CM applies to all full-book and per-chapter PDFs in the batch (same as bubble-build / bubble-convert). Set a project default with chapter_opener_size_cm in peanut.config.

Protected chapter PDFs¶

When using --ads / batch_book_ads, per-chapter PDFs can include a footer advertisement string before protection/watermark steps.

Config reference¶

See Configuration — Batch release keys.

Per-chapter builds (--chapters) use the highest chapter number found under chapter*/chapter*.md.