You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

45 lines
1.4 KiB

4 years ago
////
Included in:
- user-manual
////
You may group the sections of your document into parts when you set the `doctype` to `book`.
In fact, parts can only be used when the `doctype` is `book`.
When a document has its `doctype` set to `book` and contains at least one part, it implicitly becomes a multi-part book.
There is no dedicated doctype value for a multi-part book to distinguish it from a regular book.
That distinction is made by the content.
Part titles are specified with a single equals sign (`=`), the equivalent to the structure of a document title (i.e., level-0 section).
Each part must contain at least one section (a chapter or special section).
Immediately after the part title, you may insert an optional introduction, which is designated by the `partintro` style.
[source]
----
[partintro]
.Optional part introduction title
--
Optional part introduction goes here.
--
----
A part can also include its own preface, bibliography, glossary and index.
[source]
----
include::multi-special-ex.adoc[tag=part]
----
When using the PDF converter (i.e., Asciidoctor PDF), the value of the `chapter-label` attribute (followed by a space) is automatically added to the beginning of the chapter title.
A chapter title is a level-1 section title when the doctype is book.
You can modify this prefix by redefining the `chapter-label` attribute.
[source]
----
:chapter-label: Chapter ~
----
To use no prefix, set the value to blank.