rhymeswithlion.github.io

Personal blog and site (i.stolethis.website), built with Quarto and published via GitHub Pages.

Setup

• Python 3.12+ and uv (recommended) or pip.
• The project uses uv for the virtual environment and dependencies (including Quarto via the quarto-cli pip package).

Create the virtual environment and install dependencies:

make .venv

Or with uv directly:

uv sync

Activate the environment (optional; the Makefile targets activate it for you):

source .venv/bin/activate

Development

• Preview the site locally (watch mode):

  make preview

• Build the static site (output in _site/):

  make render

Publishing

1. Publishable content lives under posts/. Posts in posts/drafts/ are marked as drafts (draft: true in _metadata.yml) and are unlinked from the main listing until you move them out of drafts/ or change the metadata.
2. Run make render to build the site.
3. Push to the rhymeswithlion.github.io repo. GitHub Pages serves from the default branch (e.g. main) — if your site is configured to use the root, ensure the output directory in _quarto.yml matches what GitHub Pages expects (e.g. / or /docs). The current config uses the default output dir _site/; if your Pages source is “GitHub Actions” or a custom path, adjust project.output-dir in _quarto.yml and your workflow or branch settings accordingly.

Project layout

Path	Purpose
_quarto.yml	Quarto website config (theme, navbar, output)
index.qmd	Homepage and post listing
about.qmd	About page
posts/	Blog posts (.qmd, .ipynb)
posts/drafts/	Draft posts (not listed until published)
_site/	Rendered HTML (generated by make render)
pyproject.toml	Python dependencies (uv); includes quarto-cli
Makefile	.venv, preview, render

Dependencies

Managed in pyproject.toml and uv.lock. Key dependency: quarto-cli (Quarto via pip). To add a Python package:

uv add <package-name>