BOOKS

BOOKS

BOOKS are governed long-form artifacts. Each book IS a scope with PARTS and CHAPTERS.

Open BOOKS
INTERFACE — BOOK FRONT MATTER

Interface — Book Front Matter

Every book .md MUST declare:

FieldTypeRequiredDescription
`layout`stringYES`book` — renders via DESIGN theme (BOOK class)
`title`stringYESBook title
`date`dateYESPublication date
`scope`stringYES`BOOKS`
`math`booleanYES`true` — enables LaTeX rendering
`talk`booleanNO`true` — enables TALK widget
`footerTagline`stringNOFooter attribution
`parts`arrayNOPart definitions for structured TOC
INTERFACE — BOOK STRUCTURE

Interface — Book Structure

Every book .md SHOULD follow this structure:

```

Book Title (from front matter)

PART I: {PART TITLE}

Part I: {Part Title}

Chapter 1: {Chapter Title}

1.1 {Section}

1.2 {Section}

Chapter 2: {Chapter Title}

2.1 {Section}

PART II: {PART TITLE}

Part II: {Part Title}

Chapter 3: {Chapter Title}

APPENDIX A: {TITLE}

Appendix A: {Title}

REFERENCES

References

```

COMPILATION

Compilation

InputOutputCompiler
`BOOKS/*.md` (with front matter)`BOOKS.json` index`bin/build-surfaces`
`BOOKS/*.md` (with front matter)HTML pagesJekyll (`layout: book`)
`BOOKS/*.md` (with front matter)PDFLaTeX backend
RENDERING

Rendering

Books render via layout: book (BOOK class — extends PAPER). TOC includes PARTS and CHAPTERS. Math via KaTeX. PDF export from same .md source via LaTeX backend.

*BOOKS SPEC CANONIC*
TALK AUTO