OTTR Quarto Course
Set Up
Log into GitHub or make a GitHub profile if you are new to GitHub
Go to https://github.com/
Sign up for GitHub if you haven’t already - it’s free!
Make sure you are logged into GitHub - check at https://github.com/ - you should see your profile in the upper right corner
Create a repository from the OTTR_Quarto template
Go to https://github.com/ottrproject/OTTR_Quarto
In the upper right, click on:Make sure you don’t click on the green “Code” button instead!
Set your repo to “Public”
Enable workflow actions
In your OTTR repository, go to
Settings in the top navigation tabs
Go to Actions (General) in
the side navigation
Under Workflow permissions
Select Read and write permissions
Check Allow GitHub Actions to create and approve pull requests
Click Save
Set up GitHub Pages
In your OTTR repository, go to Settings in
the top navigation tabs
Go to Pages in the side
navigation
In the Build and deployment section
- Under Source, select Deploy from a branch
- 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
Go to Settings
Go to Developer Settings in
the lower left side navigation
Click on Personal access
tokens
Select Tokens (classic)
Click gray “Generate new token” button
Select Generate new token (classic)
Confirm your access
Name your token GH_PAT
Underneath Select Scopes, check both repo and workflow (all check boxes in those sections)
Click: Copy the personal access
token
and save somewhere safe and private
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
Go to Secrets and variables
in the side navigation
Click on Actions
Under Repository secrets, click onUnder Name, enter GH_PAT
For Secret, paste your copied personal access token
Click on:Click here to see GitHub documentation on setting repository secrets.
