AJ Wiebe's personal site. Built from a written product spec, in
stages — discovery, information architecture, voice, design,
implementation — each stage documented before the next one started.
See docs/discovery.md, docs/ia.md, docs/voice.md, and
docs/design.md for that process.
Static site, built with Quarto. Content lives in
.qmd files at the repo root and under writing/ and projects/.
Design tokens and layout are in styles.css.
This repo's devcontainer has Quarto and a Python/Jupyter environment pre-installed (the Jupyter toolchain is there for future notebook-based posts, not required for the current pages).
make extensions # install the Quarto extensions in quarto-extensions.txt
quarto preview # live preview at localhost
quarto render # render the site to _site/Quarto extensions aren't committed. quarto-extensions.txt lists them, pinned to release tags, and
scripts/install-quarto-extensions.sh installs them into _extensions/ (the VS Code Quarto tasks,
the devcontainer, CI and the publish workflow all run it first). Builds need GitHub to be reachable.
With Quarto 2, run QUARTO=q2 make extensions; the script passes --trust, which q2 add needs
to install remote extensions without a prompt.
.github/workflows/publish.yml renders and publishes to the
gh-pages branch on every push to main. The CNAME file points
GitHub Pages at systemsbyaj.com.