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) and are set in italic:

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

The same styling applies to ::: quote and ::: quotation fenced divs. See Quotations in the Common Core chapter of the book documentation for the full description of both styles.

Epigraphs

The epigraph convention shared by all RexxPub document classes also works on slides --- handy for opening a presentation or a section with a quotation. Use the outer ::::: epigraph fenced div with optional :::cite and :::attribution inner divs. See Epigraph in the Common Core chapter of the book documentation for the full description.

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

:::::