Image in the Background (Hack)
LectureDoc is an authoring system for creating lecture material; i. e., lecture slides, notes and exercises. LectureDoc enables you to write a single (HTML or) reStructuredText document that contains the slides, additional annotations and also exercises. Using LectureDoc's module system even more advanced use cases, such as integrated quizzes, are possible.
This tutorial is written in reStructuredText and can be used as a template for creating your own lecture slides. The code of this tutorial is available on GitHub: Delors/reStructuredTextToLectureDoc2/main/ld_base_example.rst
Prof. Dr. Michael Eichberg
1.0
A basic slide consists of a (section) header and some reStructuredText content.
Embed math equations using reStructuredText's default directive (.. math::) and role (:math:`...`).
A slide without an explicit title can be created by explicitly creating an empty title.
Alternatively and also recommended, you can use the following class: no-title in combination with the class directive:
Basic appear animations can be created using the (CSS) class incremental[1]. You can also define a corresponding custom role (.. role:: incremental) to animate parts of a text.
In case of (un-)ordered lists (ol or ul in HTML) it is sufficient to associate the class incremental using the class directive with the list. It is also possible, to only specify the class attribute for the required list items.
The slide dimensions can be controlled by specifying the corresponding meta information. If not specified, the dimension is set to \(1920 \times 1200\) (default); i.e., a ratio of 16:10.
Many functions in LectureDoc2 - e.g. persistence of the slide progress - require that a slide set is associated with a unique id. This id can be set using the meta directive.
Adding information that should not be on the slides, but provide additional information/explanations, can be added using the supplemental directive.
Alternatively, a container with the class supplemental can also be used:
Formatting Slides
Creating heavily formatted slides is easily possible using rst directives and roles which are mapped to CSS classes.
Creating a slide which marks the beginning of a new section can be done using the new-section class.
Slide transitions can be controlled using the transition-... classes:
transition-fade
transition-move-left
transition-move-to-top
transition-scale
See the LectureDoc2 Cheat Sheet for a comprehensive list of predefined transitions.
Adding code can be done using reStructuredText's code directive.
LectureDoc2 supports links to external resources:
The title of a slide can be used as a link target: Advanced Formatting
An element which is explicitly marked as a target can be used as a link target:
Citations are fully supported in LectureDoc2.
A reference to a book: [Martin2017] (Details are found in the bibliography (see next slide)).
Clean Architecture: A Craftsman's Guide to Software Structure and Design; Robert C. Martin, Addison-Wesley, 2017
...
LectureDoc comes with a set of predefined (CSS) classes that can be used to format the slides. Some of these classes have explicit support by LectureDoc and will be rendered differently in the different situations (e.g., continuous view vs. slide view will render stacked layouts or supplemental information differently).
dhbw-red
minor
obsolete
See the LectureDoc2 Cheat Sheet for a comprehensive list of predefined CSS classes.
Stacked layouts enables updating parts of a slide by putting the content into layers and then showing the layers incrementally.
Exercises can be integrated into the slide set.
If you have multiple exercises, you can define a master password to unlock all solutions at once (press m to open the dialog).
.. meta::
:exercises-master-password: 123456Image in the Background