OTTR Quarto Course
Set Up

Download cheatsheet
Last updated: June 23, 2025

Create your own repository from the OTTR_Quarto template

In the upper right, click on:

Set your repo to “Public

Enable workflow actions

In your OTTR repository, go to Settings in the top navigation tabs settings gear icon

Go to Actions (General) in the side navigation actions icon

Under Workflow permissions

  1. Select Read and write permissions

  2. Check Allow GitHub Actions to create and approve pull requests

  3. Click Save

Set up GitHub Pages

In your OTTR repository, go to Settings in the top navigation tabs settings gear icon

Go to Pages in the side navigation pages icon

In the Build and deployment section

  1. Under Source, select Deploy from a branch
  2. Under Branch, pick main and choose /docs, and click Save

at the bottom of the page, check Enforce HTTPS

Set up your GitHub personal access token

Click on your profile photo in the upper right profile photo icon

Go to Settings settings gear icon

Go to Developer Settings in the side navigation settings gear icon

Select Generate new token (classic) personal access token icon

Underneath Select Scopes, check both repo and workflow

Click:

Copy the personal access token copy icon


Click here to see GitHub documentation on creating a personal access token.

Save the copied personal access token as a repository secret

In your OTTR repository, go to Settings in the top navigation tabs settings gear icon

Go to Secrets and variables in the side navigation secrets and variables icon

Click on Actions

Under Repository secrets, click on
New repository secrets

Under Name, enter GH_PAT

For Secret, paste your copied personal access token

Click on:
Add secret


Click here to see GitHub documentation on setting repository secrets.



Authors: Kate Isaac wrote the content and created the original styling, Carrie Wright did the css styling and Carrie Wright and Candace Savonen did the publishing engineering for the cheatsheet. OTTR was created and or is maintained by the following team: Candace Savonen, Carrie Wright, Kate Isaac, Ava Hoffman, Katherine Cox, Federick Tan, John Muschelli, Howard Baek, and Jeffrey Leek.