how-to-publish.md

How to Publish Cookbook on GH Pages

I am following these instructions provided by Quarto.

1. Freeze Computations

I am only allowing code to be executed locally.

In _quarto.yml, I have added the following

execute:
  freeze: auto

Now render the site

quarto render

If a _freeze directory is created, add and commit this.

2. Publish Action

Run

quarto publish gh-pages

Add .github/workflows/publish.yml and add text from quarto instructions

3. Push changes to GH

Check all of the newly created files (including the _freeze directory) into your repository and then push to GitHub. A GitHub Pages site will be created for your repository, and every time you push a new change to the repository it will be automatically rebuilt to reflect the change.

4. Make GH Pages visible on repo

To make the GH pages visible from the site click settings gearwheel next to About and check Use Github Pages.