We built this site…

on Rock and Roll!… and Quarto, RStudio, JupyterLab, git, zsh/bash lots of packages and modules, and immoderate amounts of coffee.

Here are the basics to get started. Once this site is up and running, you can follow the git log history to see all the additional steps went into creating this amazing and wonderful website.

Create quarto website project

Terminal

cd $PROJECTDIR/
quarto create project website typology-map-info

git it!

Terminal

cd $PROJECTDIR/typology-map-info
git init

Activate Jupyter Lab

For editing jupyter notebooks activate a python environment with jupyter modules installed. For example, using venv:

Terminal

source ~/venv/jptr/bin/activate

Enable commenting

We enable Utterances commenting using the utterances option.

First install the utterances app in the repo.

For this we specify the GitHub repo for storing comments:

comments:
  utterances:
    repo: red-list-ecosystem/typology-map-info

quarto publish command

First create the gh-pages branch:

Terminal

git checkout --orphan gh-pages
git reset --hard # make sure all changes are committed before running this!
git commit --allow-empty -m "Initialising gh-pages branch"
git push origin gh-pages

Then ensure that the Source branch of the repository is gh-pages and that the site directory is set to the repository root (/). Check Settings : Pages in our repository.

Now we can do:

Terminal

git checkout main
quarto publish gh-pages

And this site is up and running!