chapter_numbering yaml option: turn numbering off or start at a value
The automatic chapter numbering can now be controlled from the yaml
header. The default TRUE numbers the # chapters from 1 as before.
chapter_numbering: false turns the numbering off -- headings keep
exactly what was typed, including manually typed numbers, and the
overview TOC shows the titles as typed (the numbering script is not
emitted at all). A number starts the enumeration at that value, e.g.
chapter_numbering: 5 for a continuation deck; references, appendix and
thank-you chapters stay excluded and uncounted in every mode.
Change-Id: I69af1414aedd14c9be09650c78b3219bf63c4d1a
diff --git a/README.Rmd b/README.Rmd
index 9418dbd..aecb0a8 100644
--- a/README.Rmd
+++ b/README.Rmd
@@ -182,6 +182,22 @@
Decks with `slide_level: 1` (one `#` heading per slide) are left unnumbered -- there, headings denote slides, not chapters.
+The numbering can be turned off with the `chapter_numbering` option -- headings then keep exactly what was typed:
+
+``` yaml
+output:
+ revealjs.ids::revealjs_presentation:
+ chapter_numbering: false
+```
+
+A number starts the enumeration at that value instead, which is useful for continuation decks:
+
+``` yaml
+output:
+ revealjs.ids::revealjs_presentation:
+ chapter_numbering: 5
+```
+
## Vertical Content Centering
Slides with little content no longer sit glued below the title bar: whenever there is free space, the slide's body content is centered in the area between the heading and the footer. Slides that are too packed start directly below the heading and overflow downwards exactly as before, and centered content never covers the footer. Reveal.js' own `center` option could not be used for this, because it also vertically centers the headings. Heading-only section-divider slides keep their dedicated centered-title layout.