Quarto: Publication to GitHub Pages

Starts at:

Friday, 15:00

Objectives

💡 You can publish a Quarto website to GitHub Pages using GitHub Actions.
💡 You understand the difference between local and CI-based publishing.
💡 You can configure a GitHub Action for Quarto publication.
💡 You know how to set up custom domains for GitHub Pages.

Tasks

In this session, you will work on the following tasks:

  1. Reading: Read the chapter(s) Publishing Quarto projects to GitHub Pages using GitHub Actions in the Version Control Book.
  2. Implementation: Try out the commands in the chapter.
  3. Exercises: Work on the exercises.

As always:

  1. Try out the commands of this session and play around with them.
  2. Check whether you have achieved the learning objectives.
  3. Ask questions!

Exercises

Publish your Quarto project to GitHub Pages using at least one of the available methods.

Slides

To export the slides to PDF, do the following:

  1. Toggle into Print View using the E key (or using the Navigation Menu).
  2. Open the in-browser print dialog (CTRL/CMD+P).
  3. Change the Destination setting to Save as PDF.
  4. Change the Layout to Landscape.
  5. Change the Margins to None.
  6. Enable the Background graphics option.
  7. Click Save.

Note: This feature has been confirmed to work in Google Chrome, Chromium as well as in Firefox.

Here’s what the Chrome print dialog would look like with these settings enabled:

These instructions were copied from the Quarto documentation (MIT License) and slightly modified.

Resources