Topbar/Minislide

Topbar and minislide

Slydekit provides optional navigation elements to help structure and navigate presentations. The topbar displays the presentation’s content as a persistent navigation bar, highlighting the current section to provide a clear overview of the presentation structure. The minislide complements the topbar by displaying a compact visual representation of the slides within the current section, allowing the audience to quickly identify the current slide and its position in the presentation. Together, these components provide a lightweight navigation system that improves orientation without taking significant space away from the main slide content.

To activate a given navigation style, you can set the navigation-style argument in the slydekit command.

// For the topbar navigation style
#show: slydekit.with(
  navigation-style: topbar,
)

// For the minislide navigation style
#show: slydekit.with(
  navigation-style: minislide,
)

Minislide

To implement the minislide navigation style, Slydekit provides the mini-slides helper function, adapted from the corresponding implementation in Touying to work seamlessly with Slydekit.

#let mini-slides(
  fill: none,
  alpha: 50%,
  display-subsection: true,
  linebreaks: true,
  display-appendix: "auto",
)

Argument

fill – default: none
color | none

The color used to fill the active slide indicator. If set to none, the indicator uses the header entry defined color dictionary instead.

Argument

alpha – default: 50%
number

The transparency applied to inactive slides. A value of 0% makes them fully transparent, while 100% makes them fully opaque. The default value is 50%, which provides a balanced visibility for inactive slides.

Argument

display-subsection – default: true
boolean

A boolean value that determines whether to display bullets for each slide under the sections. If set to true, bullets will be displayed for each slide under the sections. If set to false, bullets will not be displayed.

Argument

linebreaks – default: true
boolean

A boolean value that determines whether to place the bullets on a new line under the section title. If set to true, bullets will be placed horizontally on a new line under the section title. If set to false, bullets will be placed vertically on the same line as the section title.

Argument

display-appendix – default: “auto”
boolean | “auto”

A boolean value that determines whether to display appendix sections. If set to “auto”, the main sections are displayed during the main presentation and switches to appendix during the appendix. If set to true, it always displays everything (main + appendix). If set to false, it never displays appendix sections.

Usage in custom themes

If you create a presentation using the topbar or minislide navigation style, you only need to implement the navigation element in the header of your theme. For examples of how to implement these navigation styles, refer to the Slydekit GitHub repository, which contains implementations of the topbar and minislide navigation styles for the built-in themes.