`make fabric` -> build/docs/BookOfFabric.pdf (722 pages): Part I the living record (FABRIC-3), Part II the closed documents in the order written, Part III the forward-looking notes; its title page carries the version (git describe --tags: a release's tag) and the commit. Built from the same pandoc fragments as the book; the book's preamble moved into docs/book/preamble.tex, shared by both (the book builds as before, 821 pages). scripts/nightly.sh: the docs stage builds it ($DOCS/fabric.pdf); publish sends it as classifier `fabric`; gitea-release attaches every PDF in $DOCS, so every release carries it. Progress for the rest of alpha.4's documents: docs/v4.0.0/plans/2026-11-10-alpha4-documents.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2
70 lines
1.9 KiB
TeX
70 lines
1.9 KiB
TeX
% docs/book/main.tex -- master file of the single LithosAnanke book.
|
|
%
|
|
% Built by `make docs [TARGET=<board>]` (docs/book/Makefile) with xelatex.
|
|
% Fragments named below (ontology, fabric-0, ...) are generated by pandoc
|
|
% from the Markdown listed in docs/book/Makefile's CHAPTERS into
|
|
% build/docs/gen/; meta.tex is generated per build. Neither is committed.
|
|
\documentclass[11pt,openany]{book}
|
|
|
|
\input{preamble}
|
|
|
|
\title{LithosAnanke and StarForth}
|
|
\author{}
|
|
\date{Built \bookdate{} from commit \texttt{\bookcommit}%
|
|
\ifx\bookboard\empty\else\\Board appendix: \bookboard\fi}
|
|
|
|
\begin{document}
|
|
\frontmatter
|
|
\maketitle
|
|
\tableofcontents
|
|
|
|
\chapter{About this book}
|
|
This book is generated from the repository by \texttt{make docs}. Each
|
|
chapter below is still maintained as the Markdown file named in the table and
|
|
converted at build time; a chapter moves into LaTeX source when it is
|
|
rewritten. Part~III is the design record: those documents are archival and
|
|
are reproduced as written, including their struck-through corrections.
|
|
|
|
\begin{longtable}{@{}ll@{}}
|
|
\toprule
|
|
Chapter & Source \\
|
|
\midrule
|
|
\endhead
|
|
Ontology & \texttt{docs/reference/ONTOLOGY.md} \\
|
|
Roadmap & \texttt{docs/working/archive/superseded/2025-12-14-starforth-roadmap.md} \\
|
|
Boot targets & \texttt{boards/README.md} \\
|
|
v4 justification & \texttt{docs/v4.0.0/JUSTIFICATION.md} \\
|
|
v4 decomposition & \texttt{docs/v4.0.0/DECOMPOSITION.md} \\
|
|
FABRIC-0 \dots{} FABRIC-4 & \texttt{docs/fabric/FABRIC-*.md} \\
|
|
Board appendix (\texttt{TARGET=}) & \texttt{boards/<board>/README.md} \\
|
|
\bottomrule
|
|
\end{longtable}
|
|
|
|
\mainmatter
|
|
|
|
\part{The system}
|
|
\input{ontology}
|
|
\input{roadmap}
|
|
\input{boards}
|
|
|
|
\part{StarForth v4}
|
|
\input{justification}
|
|
\input{decomposition}
|
|
|
|
\part{Design record (FABRIC series)}
|
|
\input{fabric-0}
|
|
\input{fabric-1}
|
|
\input{fabric-2}
|
|
\input{fabric-3}
|
|
\input{fabric-3-5}
|
|
\input{fabric-3-6}
|
|
\input{fabric-3-7}
|
|
\input{fabric-4}
|
|
|
|
\ifdefined\bookboardappendix
|
|
\appendix
|
|
\input{\bookboardappendix}
|
|
\fi
|
|
|
|
\end{document}
|