auto-populate Overview/Überblick slides with a clickable TOC
Port the convention from the old Google Docs slide workflow: at
presentation time, any slide whose (only) heading is Overview or
Überblick gets its body content replaced with a hierarchical list of
the deck's h1/h2 slide headings, each entry linking to its slide.
Styled in the ids theme; slides without headings and the title slide
are left out.
Change-Id: I3bfd62d530f297a389030e431a6066b5adc99bb8
diff --git a/README.Rmd b/README.Rmd
index b8e1d9d..3a34e5a 100644
--- a/README.Rmd
+++ b/README.Rmd
@@ -154,6 +154,18 @@
To compute the time budget without rendering the presentation, you can call `slide_timing()` directly on the `.Rmd` source file.
+## Overview Slides
+
+Like in the old Google-Docs-based slide workflow, a slide titled "Overview" or "Überblick" is automatically turned into a table of contents: its body content is replaced with a hierarchical list of all `#` and `##` slide headings, and each entry links to the corresponding slide.
+
+``` markdown
+## Overview
+
+(any placeholder content -- replaced automatically)
+```
+
+The TOC is generated when the presentation is opened, so it always reflects the deck it is part of. Slides without a heading and the title slide are left out.
+
## Incremental Bullets
You can render bullets incrementally by adding the `incremental` option: