diatypst

Diatypst is a Typst-based package designed for creating presentation slides easily. It provides several built-in features to streamline slide creation:

• Heading-based structure: Uses standard Typst headings as delimiters for slides and sections.
• Sensible styling: Comes with pre-configured layouts and styles.
• Slide numbering: Includes a dot counter in the upper right corner, similar to LaTeX Beamer.
• Theming: Supports adjustable color themes.
• Automatic formatting: Includes default show rules for terms, code, lists, and other elements that automatically adapt to the selected color theme.

To adjust a presentation for dimmed environments, use the bg-color option within the slides.with() function. When changing the background color, you should also update the title-color (for headings and other elements) and the global text color using #set text(fill: ...) to ensure readability. You can use any valid Typst color, including RGB codes.

#show: slides.with(
  title-color: white, // color for elements like headings 
  bg-color: black,    // background color
)

#set text(fill: white) // text color

To use diatypst in an existing or manual Typst project, import the package and use the slides function with a show rule. The title parameter is required.

#import "@preview/diatypst:0.9.3": *
#show: slides.with(
  title: "Diatypst", // Required
  subtitle: "easy slides in typst",
  date: "01.07.2024",
  authors: ("John Doe"),
)

Diatypst is available as a Quarto extension.

1. Install the extension using the CLI:

   quarto add skriptum/diatypst/diaquarto

2. Create a .qmd file and configure the diaquarto-typst format in the YAML frontmatter.

Note: Only a subset of the standard Typst options are available in the Quarto version.

title: "Untitled"
...
format:
  diaquarto-typst:
    layout: medium # small, medium, large
    ratio: 16/9 # any ratio possible
    title-color: "013220" # Any Hex code for the title color (without #)

In diatypst, you can create hyperlinks to specific slides by combining Typst labels with the #ref() function or the @label shorthand.

1. Assign a label to a target: Add a label to a heading using the <label_name> syntax (e.g., == Heading <label1>).
2. Create the link:
   • Use #ref(<label_name>, supplement: "text") to create a link with custom descriptive text.
   • Use the @label_name syntax for a standard Typst reference link.

// 1. Define the target slides with labels
== Heading <label1>
#lorem(100)

== Another Heading <label2>
#lorem(100)

// 2. Link to them
You can go to the #ref(<label1>, supplement: "first slide") or maybe to @label2 if that suits you better.

The easiest way to start is using the typst.app web application.

1. Navigate to the Typst Universe page for diatypst.
2. Click the "Create Project in App" button.
3. This will prompt you to create a new file in your web app that is pre-configured with the diatypst template and initial explanations.

Diatypst uses standard Typst heading levels to manage the presentation structure:

• Level-one headings (= Heading): Create new sections.
• Level-two headings (== Heading): Create new slides.
• Manual breaks: Use the #pagebreak() command to force a new slide.

Example:

= First Section

== First Slide

#lorem(20)

To use Diaquarto in your Quarto project, download the extension to your project directory using the quarto add command.

quarto add skriptum/diatypst/diaquarto

To use diatypst in a Typst document, import the package and initialize the presentation using the slides.with function. The title parameter is required. You can define the presentation structure using headings:

• Level-one headings (=) create new sections.
• Level-two headings (==) create new slides.
• Alternatively, use #pagebreak() to manually create a new slide.

#import "@preview/diatypst:0.9.3": *
#show: slides.with(
  title: "Diatypst", // Required
  subtitle: "easy slides in typst",
  date: "01.07.2024",
  authors: ("John Doe"),
)

= First Section

== First Slide

#lorem(20)