Publishing

Slides

 Open slides in new window  Download PDF of slides

Exercises

Deploying with Quarto Pub

TipYour turn

1. Go to quartopub.com and create a free account. Make sure you’re logged in.

2. In the terminal, run this:

   Terminal

   quarto publish

3. Select Quarto Pub and press enter. Answer all the other questions.

4. Wait for the site to render and upload.

Deploying with GitHub Pages

Get your project code on GitHub

TipYour turn, part 1

1. Go to github.com and create a free account.

2. Add a .gitignore file to your website project with this:

   .gitignore

   .Rproj.user
   .Rhistory
   .RData
   .Ruserdata
   
   /_site/

3. Initialize a git repository for your website project.

4. Commit the files and push to GitHub.

TipYour turn, part 2

Tell Quarto to use GitHub Pages

5. Change the output-dir option in _quarto.yml to docs.

   _quarto.yml

   project:
     type: website
     output-dir: docs

6. Add an empty file named .nojekyll to the root of your website project (this tells GitHub to not run its own static site generator).

7. Render your site.

8. Commit the newly created docs/ folder and .nojekyll file and push to GitHub.

TipYour turn, part 3

Tell GitHub Pages to serve your site

9. From your GitHub repository, go to Settings > Pages and configure the repository to publish from the docs directory of your main branch.

   

10. Wait for GitHub to build and deploy the site.