Outlines

Table of contents

In Slydekit, you can create an outline using the tableofcontents command.

#import "@preview/slydekit:0.1.0": *

#show: slydekit.with(...)

// Title slide
#title-slide

// Insert a table of contents
#tableofcontents

If you want to create a custom theme, Slydekit provides the toc command to create a simple table of contents with the current theme primary color. Actually, tableofcontents is just a wrapper around toc, that includes the title slide and the table of contents in a single slide.

You can see the source code of the toc command to see implementation details.

Progressive outline

Slydekit provides a progressive-outline command that creates a progressive outline, where each section is revealed one by one. This function is inspired by Touying but is implemented in a different way. Only the simple and cambfurt built-in themes support progressive outlines.

#let progressive-outline(
  it,
  active-color,
  inactive-color,
  entry-size: 0.8575em,
  gutter: 4%,
  section-numbering: "1.1.",
  appendix-numbering: "A.1.",
)
Argument
it
content

The content of the slide.

Argument
active-color
color

The color used to fill the active slide indicator.

Argument
inactive-color
color

The color used to fill the inactive slide indicators.

Argument
entry-size – default: 0.8575em
number

The size of the text used for the outline entries. The default value is 0.8575em, which is a good size for most presentations.

Argument
gutter – default: 4%
number

The space between the outline entries. The default value is 4%.

Argument
section-numbering – default: “1.1.”
string

The numbering format for sections. The default value is "1.1.".

Argument
appendix-numbering – default: “A.1.”
string

The numbering format for appendices. The default value is "A.1.".

A typical implementation of the progressive-outline command when creating a theme is as follows:

#show heading.where(level: 1): it => {
  // Formatting the content
  ...

  // Creating the progressive outline
  progressive-outline(it, active-color, inactive-color)
}

Hide sections

Slydekit provides the hide-new-section-slide function to hide the slide that introduces a new section, while keeping the section in the outline. This is useful when you want to keep the outline clean and concise, but still want to have the section in the outline. To use this function, simply add the following line to your presentation:

#show: hide-new-section-slide
Warning
This function can’t be used in conjunction with progressive-outline, since hide-new-section-slide hides level 1 heading slides. However, the section will still be present in the tableofcontents.

If you want to have a fine-grained control over which sections are hidden, you can use the label hide-toc command to hide specific sections.

Without <hide-toc>

With <hide-toc>