Presentations in Quarto

For lab meetings, conferences, and stakeholder briefings, we use Quarto to generate presentations. This ensures that the plots shown in slides are identical to the ones in our analysis, with no “copy-paste” errors.

The emLab presentation template

We are actively developing a standardized emLab Quarto presentation template to ensure a consistent, professional visual identity across our projects. You can find the current working version of the template here: presentation-ocean-ghg-ttt.

How to use it:

  1. This repository is configured as a GitHub Template.
  2. Click the “Use this template” button on GitHub to create a new repository for your project.
  3. This will provide you with the necessary SCSS styling, logo assets, and YAML configurations pre-set for emLab.

We need your help! This is a living resource. If you improve the styling, fix a bug, or add a cool new slide component, please contribute back to the template repo so the whole lab can benefit.

Format: Revealjs

At emLab, we primarily use revealjs for HTML-based slides. They are mobile-friendly, searchable, and can be hosted alongside our documentation on GitHub Pages.

---
title: "emLab Project presentation"
subtitle: "Subtitle goes here"
author: "Author"
title-slide-attributes:
  data-background-image: emlab_logo_horizontal.png
  data-background-size: 30%
  data-background-position: 50% 85%
  data-footer: ""
format:
  revealjs:
    theme: emlab.scss
    slide-number: true
    transition: slide
    background-transition: fade
    incremental: false
    footer: "<img src='emlab_logo_horizontal_w.png' class='slide-footer-logo'>"
    fig-cap: false
project:
  output-dir: docs
---

Slide structure

  • New Slide: Use ## to start a new slide.
  • Pauses: Use . . . on its own line to create a “fragment” (pause) that reveals the next part of the slide upon a click.
  • Columns: Use the “div” syntax to create side-by-side layouts for comparing text and figures.
## Motivation
- Point 1...
- Point 2...
- Point 3...

## Results Overview

::: {.columns}
::: {.column width="40%"}
- Yield increased by 15%
- Significance at $p < 0.05$
- Region A led the growth
:::

::: {.column width="60%"}

::: {.cell}

:::

:::
:::

Best practices for slides

  1. echo: false by default: Unless you are giving a coding tutorial, keep code hidden in slides to focus on results.
  2. Speaker Notes: Use ::: {.notes} to add reminders that only you can see during the presentation (press ‘S’ in the browser).
  3. Direct Linking: Always include a final slide with a link to the full Quarto documentation/website where the audience can find the underlying code and data.
  4. Multiplex: For remote presentations, consider enabling multiplex: true in your YAML, which allows the audience to follow along on their own devices as you advance the slides.
  5. GitHub Pages: Host your presentation on GitHub Pages for easy sharing and to ensure the slides are always in sync with the latest analysis.