aboutsummaryrefslogtreecommitdiff
path: root/MANUAL.txt
diff options
context:
space:
mode:
authorSalim B <git@salim.space>2021-08-22 11:13:39 +0000
committerJohn MacFarlane <jgm@berkeley.edu>2021-08-22 08:25:29 -0700
commit03b50c0f78ecdebf91a0dac76ccd07b547ff3d27 (patch)
treee80179393d6dc4149b029c561e63232974a0fcab /MANUAL.txt
parent607d71662416786d716e4e93bfbb611851531ae7 (diff)
downloadpandoc-03b50c0f78ecdebf91a0dac76ccd07b547ff3d27.tar.gz
Add some more info regarding `--slide-level=0`
Diffstat (limited to 'MANUAL.txt')
-rw-r--r--MANUAL.txt17
1 files changed, 9 insertions, 8 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index a61c8ca09..bc17763bc 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -5781,8 +5781,8 @@ By default, the *slide level* is the highest heading level in
the hierarchy that is followed immediately by content, and not another
heading, somewhere in the document. In the example above, level-1 headings
are always followed by level-2 headings, which are followed by content,
-so the slide level is 2. This default can be overridden using
-the `--slide-level` option.
+so the slide level is 2. This default can be overridden using the
+`--slide-level` option.
The document is carved up into slides according to the following
rules:
@@ -5806,19 +5806,20 @@ rules:
subsequent slide with the same title (for beamer).
* A title page is constructed automatically from the document's title
- block, if present. (In the case of beamer, this can be disabled
+ block, if present. (In the case of beamer, this can be disabled
by commenting out some lines in the default template.)
These rules are designed to support many different styles of slide show. If
you don't care about structuring your slides into sections and subsections,
-you can just use level-1 headings for all each slide. (In that case, level-1
-will be the slide level.) But you can also structure the slide show into
-sections, as in the example above.
+you can either just use level-1 headings for all slides (in that case, level 1
+will be the slide level) or you can set `--slide-level=0`.
Note: in reveal.js slide shows, if slide level is 2, a two-dimensional
layout will be produced, with level-1 headings building horizontally
-and level-2 headings building vertically. It is not recommended that
-you use deeper nesting of section levels with reveal.js.
+and level-2 headings building vertically. It is not recommended that
+you use deeper nesting of section levels with reveal.js unless you set
+`--slide-level=0` (which lets reveal.js produce a one-dimensional layout
+and only interprets horizontal rules as slide boundaries).
## Incremental lists