A quarto extension for reveal.js that automatically creates agenda slides from H1 heading titles.

To install this extension in your current directory (or into the Quarto project that you're currently working in), use the following command:

quarto install extension andrie/reveal-auto-agenda

Add this to your document or project options:

filters:
  - reveal-auto-agenda

Simply create your slides as normal, with H1 header slides marking transitions between agenda items.

Important: the extension assumes that your H1 header slides contains no other content, and that you want these slides to be replaced by the rolling agenda.

This extension:

• Creates a list of the text of each H1 slide.
• Insert this list into the body of each H1 slide.
• Inserts CSS that marks the active section with a border box around the text.

The extension will create custom CSS elements. You can override these in your own CSS template:

.agenda {
}

.agenda-slide h1 {
  size: 0em;
  display: none;
}

.agenda-inactive {
  opacity: 0.25;
  margin-top: -0.5em;
  margin-bottom: -0.5em;
}

.agenda-active {
  margin-top: -0.5em;
  margin-bottom: -0.5em;
}

To change the default behaviour, include auto-agenda options in your yaml:

filters:
  - reveal-auto-agenda
auto-agenda:
  bullets: numbered
  heading: Agenda
  clickable: true

You can change these options:

If you want to suppress the agenda on a particular slide, add the class no-auto-agenda to the slide:

# Header {.no-auto-agenda}

You can view a live preview of an example presentation at https://andrie.quarto.pub/reveal-auto-agenda/.