book

Author: Hendler

Makefile

@@ -1,4 +1,4 @@
-.PHONY: build-jacs build-jacsbook test test-jacs audit-jacs test-jacs-cli test-jacs-observability test-jacspy \
+.PHONY: build-jacs build-jacsbook build-jacsbook-pdf test test-jacs audit-jacs test-jacs-cli test-jacs-observability test-jacspy \
         publish-jacs publish-jacspy publish-jacsnpm \
         release-jacs release-jacspy release-jacsnpm release-all \
         retry-jacspy retry-jacsnpm \
@@ -38,6 +38,9 @@ build-jacsnpm:
 build-jacsbook:
 	cd jacs/docs/jacsbook && mdbook build
 
+build-jacsbook-pdf:
+	./jacs/docs/jacsbook/scripts/build-pdf.sh
+
 # ============================================================================
 # TEST
 # ============================================================================
@@ -236,6 +239,7 @@ help:
 	@echo "  make build-jacspy    Build Python bindings (dev mode)"
 	@echo "  make build-jacsnpm   Build Node.js bindings"
 	@echo "  make build-jacsbook  Generate jacsbook (mdbook build)"
+	@echo "  make build-jacsbook-pdf  Generate single PDF book at docs/jacsbook.pdf"
 	@echo ""
 	@echo "TEST:"
 	@echo "  make test            Run all tests (alias for test-jacs)"

docs/jacsbook.pdf

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BOOK_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
+REPO_ROOT="$(cd "${BOOK_DIR}/../../.." && pwd)"
+
+OUTPUT_PDF="${1:-${REPO_ROOT}/docs/jacsbook.pdf}"
+OUTPUT_DIR="$(dirname "${OUTPUT_PDF}")"
+PRINT_HTML="${BOOK_DIR}/book/print.html"
+
+if ! command -v mdbook >/dev/null 2>&1; then
+  echo "error: mdbook is required but not installed" >&2
+  exit 1
+fi
+
+if ! command -v playwright >/dev/null 2>&1; then
+  echo "error: playwright CLI is required but not installed" >&2
+  exit 1
+fi
+
+mkdir -p "${OUTPUT_DIR}"
+
+(
+  cd "${BOOK_DIR}"
+  mdbook build
+)
+
+if [[ ! -f "${PRINT_HTML}" ]]; then
+  echo "error: expected print HTML was not generated at ${PRINT_HTML}" >&2
+  exit 1
+fi
+
+PAPER_FORMAT="${JACSBOOK_PDF_PAPER_FORMAT:-Letter}"
+BROWSER="${JACSBOOK_PDF_BROWSER:-chromium}"
+
+playwright pdf \
+  --browser "${BROWSER}" \
+  --paper-format "${PAPER_FORMAT}" \
+  "file://${PRINT_HTML}" \
+  "${OUTPUT_PDF}"
+
+echo "Generated PDF: ${OUTPUT_PDF}"