About this presentation

This slide deck documents the slides document class for RexxPub.

It is itself a slides.md file, rendered by the class it describes --- so every slide you see is a live example of the features being documented.

Structure of a slide deck

The title slide

The title slide uses the same ::::: title-page fenced div as the article class, so the same Markdown source works in both.

::::: title-page

Presentation Title <small>Subtitle</small>
==========================================

::: author       ::: affiliation
::: event        ::: venue
::: email        ::: date

:::::

Two new elements are available for slides: event and venue, useful for conference presentations.

Content slides

Each <h1> with {.slide} starts a new slide. The heading becomes the slide title, rendered in blue with an underline.

Slide Title {.slide}
======================

Content goes here.

The body text is set in Helvetica/Arial at 20pt, left-aligned, without justification or hyphenation --- optimised for projection readability.

{.newpage} also works and is equivalent to {.slide}, but {.slide} is preferred for clarity.

Section dividers

A section divider is an <h1> with {.part}:

Section Name {.part}
=============================

This produces a centred title without the underline bar, useful for separating major parts of the presentation. The page break is implicit --- no need to add {.newpage} or {.slide}.

Lists on slides

Lists are the bread and butter of conference slides:

• Body text is 20pt sans-serif for projection readability
• Items are more generously spaced than in article
• Left margin is tighter (1.5em) to save horizontal space
• Nested lists are supported:
  • Second level
  • Also with generous spacing
• No text-indent --- block style throughout

1. Numbered lists work the same way
2. With consistent spacing
3. And compact margins

Code on slides

Slides support both generic code blocks and Rexx-highlighted blocks.

Generic code has a subtle rounded background:

[rexx] md2pdf --docclass slides slides.md

Rexx-highlighted blocks work exactly as in article:

/* Highlight quality is identical to articles */
Parse Arg name
Say "Hello," name"!"

The code font is 14pt --- smaller than the body text, but large enough for projection.

Tables and blockquotes

Tables use the booktabs convention, with the accent colour:

Blockquotes keep a coloured left bar (useful on projection):

This is a blockquote. The left bar helps it stand out at a distance --- unlike article, where it is removed.

Page layout

• Page size: 254mm x 142.875mm (exact 16:9, FHD-compatible)
• Margins: 1.5cm top/bottom, 1.8cm sides
• Slide numbers: bottom-right, small (10pt), grey --- hidden on the title slide
• Footnotes: supported, smaller font (12pt)¹

YAML front matter

Slides support YAML front matter for setting RexxPub options directly in the Markdown source:

---
rexxpub:
  style: print
  number-figures: false
---

Structural options set in the YAML (such as number-figures or section-numbers) take precedence over URL parameters --- the author's intent is always respected.

The highlighting style is an exception: it can always be overridden by the reader via the style chooser.

The closing slide

Use ::::: closing-page for a centred closing slide:

::::: closing-page

Thank You! {.slide}
=====================

Questions?

name@example.com

:::::