Instead of (or in addition to) section headings, Hieroglyph also includes a directive that may be used to indicate a Slide should be created. The directive may have a title specified, as well as a level parameter.
.. slide:: The Slide Title :level: 2 This Slide would appear as a level two slide.
Splitting Sections with the
When building slides,
nextslide will split the content at
the point of the directive and copy the section title.
Consider the following example:
Section Title ============= some content .. nextslide:: additional content
When building slides, this will generate two slides with the name Section Title.
A different title may be specified as an argument to
increment argument will add an index to the subsequent slide
titles. For example:
Section Title ============= some content .. nextslide:: :increment: additional content .. nextslide:: :increment: conclusion
Will generate three slides, with the titles Section Title, Section Title (2), and Section Title (3), respectively.
When working with multi-file projects, there may be cases when it is
desirable to override the theme or set configuration value for
specific files. This can be accomplished using the
.. slideconf:: :theme: single-level
Values specified in a
slideconf directive override defaults
conf.py. If more than one
slideconf appears in a
document, only the last one is used.