Hello, world: how this blog works

Quarto notebooks, frozen results, GitHub Actions and Netlify. The whole pipeline in one picture.

Every post here is a Quarto document. It can mix prose, Python, R and diagrams, and the output you see is generated from the code you see.

The pipeline

flowchart LR
  A[Write .qmd] --> B[quarto render<br/>on my laptop]
  B --> C[(_freeze/<br/>cached results)]
  C --> D[git push]
  D --> E[GitHub Actions<br/>quarto render]
  E --> F[Netlify]

The trick is freezing. Code only runs on my machine. The results are saved in _freeze/ and committed, so the build server never needs Python or R installed.

Python or R, same post format

Python

import pandas as pd
df = pd.read_csv("data.csv")
df.groupby("team").size()

R

library(dplyr)
read.csv("data.csv") |> count(team)

Writing a new post

python scripts/new_post.py data "My next analysis"
quarto preview

That’s it. Thanks for reading!