Quarto Websites: Create and Publish Your First Website
R
Quarto
Github
A hands-on workshop for researchers, students, and practitioners.
Quarto Websites: Create and Publish Your First Website
A hands-on workshop for researchers, students, and practitioners.
Who is the Course For?
This course is designed for researchers, students, and practitioners, who wish to create a personal or project website using the Quarto framework.
It assumes familiarity with R and RStudio, but no prior experience with HTML, CSS, or GitHub Pages is required.
Learning Objectives
Set up and connect Git with RStudio
Build and preview a basic website using Quarto templates
Customize website appearance using YAML
Create multiple pages, listings, and navigation bars
Publish the website using GitHub Pages and GitHub Actions
Understand how websites can be used to share research and project outputs
Prerequisites (Before the Training)
- Install R, RStudio, RTools (for Windows users), Quarto, and Git.
- Create a GitHub account.
- Install required R packages:
install.packages(c("usethis", "gitcreds")) - Ensure you are comfortable using `.qmd` files, the R Console, the Terminal, and basic GitHub navigation.
- Bring a photo of yourself (.jpg or .png) and prepare a short personal introduction (3–4 lines).
Topics & Structure
| Section | Topic | Activities |
|---|---|---|
| 1 | Connect RStudio with Git | Live demo + setup + token config |
| 2 | Build the Homepage | Use quarto use template |
| 3 | Styling your Website | Modify _quarto.yml |
| 4 | Pages and Navigation | Add `.qmd` pages and navbar |
| 5 | Listings | Create blog/projects listings |
| 6 | Publish using GitHub Pages | Configure workflow + publish |
| 7 | Wrap-up & Q&A | Share published sites |