The book presentation MUST write each volume that the configuration's books names as one AsciiDoc file, <volume>/generated/<volume>.adoc, which a book of erga (kind book) includes as a generated chapter source, and books.json, which lists the volumes, their parts and their page counts. A volume has parts, and a part selects pages by section, group and path prefix (exclude leaves some out; perGroup makes a part of each group); a page is in the first part that selects it, is a chapter of its part, and is a section of its parent's chapter where its parent is in the part. The file MUST begin with the line that says it is generated and how to write it again, hold no date and no revision (the same pages give the same bytes), and use only what AsciidoctorJ reads as it is: parts and chapters with anchors that no volume has twice, source blocks, admonitions, tables, lists, cross references to pages of the volume and, for a page that is not in it, a link to the site where books.site names one and its text where it does not. Text that AsciiDoc would read as markup is passed through, and a diagram is shown as its source. A part that selects no page is a finding.
Enforced (check): .github: cd commons/docs && bun run verify — book.test.ts: text that AsciiDoc would read as markup is passed through, a line that would be a list or a title begins safely, and a bracket is an attribute; every block is written: headings with anchors, lists, tables, code, callouts, entries, tabs, diagrams, cards and trees; a link to a page of the volume is a cross reference, to another is a link to the site where the book names one and its text where it does not; a volume is its parts' pages in the order of the navigation: a page is a chapter, a page under it a section, a page once, a part of each group, and a part that takes nothing is found; the files of a presentation are written, a book into a folder that holds other things leaves them, and a file that is not what a build writes is found
Proved by: docs/suite/book.test.ts
Written in: docs/src/book.ts, docs/src/emit/asciidoc.ts
Tests: passed: suite/book.test.ts the files of a presentation are written, a book into a folder that holds other things leav; passed: suite/book.test.ts a link to a page of the volume is a cross reference, to another is a link to the site wher; passed: suite/book.test.ts a volume is its parts' pages in the order of the navigation: a page is a chapter, a page u; passed: suite/book.test.ts every block is written: headings with anchors, lists, tables, code, callouts, entries, tab; passed: suite/book.test.ts text that AsciiDoc would read as markup is passed through, a line that would be a list or
Cited by: book, config, emit/asciidoc, Documentation generator, presentation, Documentation