Parts can only be used when the document type is
The presence of at least one part implies that the document is a multi-part book.
(There’s no dedicated
doctype for a multi-part book to distinguish it from a book with only chapters).
A part is a level 0 section.
A part must contain at least one level 1 section.
The first part is the first level 0 section in the document that comes after the document title.
Like the document title, a part is designated by a level 0 section title (
= Book Title :doctype: book = Part I ...
A part can have an optional introduction (similar to the preamble of the document), known as a part intro.
The part intro is the content between the part title and the first section in the part.
The part intro can be marked explicitly using the
partintro style on either a paragraph or open block.
AsciiDoc provides document attributes to control the numbering and labeling parts.
The content between the part title and the first section in the part is the part intro. Normally, the part intro is inferred, as shown here:
= Book Title :doctype: book = Part I This is the implicit partintro. == Chapter A
You can mark the part intro explicitly by adding the
partintro style on the sole block before the first section.
= Book Title :doctype: book = Part I [partintro] This is the implicit partintro. == Chapter A
= Book Title :doctype: book [preface] = Forward This is the preface for the whole book. = Part 1 This is the introduction to the first part of our mud-encrusted journey. == Chapter 1 There was mud... == Chapter 2 Great gobs of mud... [glossary] == Part 1 Glossary [glossary] mud:: wet, cold dirt = Part 2 [preface] == Part 2 Preface This is a preface for part 2. == Chapter 3 The mud had turned to cement...