Publishing

Slides

 Open slides in new window  Download PDF of slides

Exercises

Deploying with Quarto Pub

  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

  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.

Tell Quarto to use GitHub Pages

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

    _quarto.yml
    project:
      type: website
      output-dir: docs
  2. Add an empty file named .nojekyll to the root of your website project (this tells GitHub to not run its own static site generator).

  3. Render your site.

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

Tell GitHub Pages to serve your site

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

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