Build system for https://writings.agg.im/ and https://github.com/agg23/writings. Pulls in static docs from https://github.com/agg23/writings and specific other repos containing writings and pulls them into a single Hugo site.

• Hugo v0.151.0
• Python 3.9+
• git and rsync for fetching content

# Fetch content from a local checkout and build the site
WRITINGS_SOURCE=/Users/adam/code/writings ./scripts/build.sh

Key scripts live in scripts/:

• fetch_writings.sh clones/copies the writings repo into tmp/writings-src. Use WRITINGS_REPO_URL, WRITINGS_SOURCE, and optionally WRITINGS_REF to control the source.
• sync_content.sh converts the fetched repo into Hugo-ready content under content/posts and static assets under static/.
• build.sh runs the full pipeline (fetch → sync → hugo). Set SKIP_FETCH=1 or SKIP_SYNC=1 to reuse prior outputs.

Generated Hugo content lives under content/posts and is ignored by git aside from the checked-in _index.md. Assets from the writings repo are copied into static/images and static/writings/.

1. Ensure the writings repo is available (either locally or via a remote URL).
2. Run ./scripts/build.sh to generate content and produce the Hugo site in public/.
3. Use SKIP_FETCH=1 with hugo server for rapid iteration:

   ./scripts/fetch_writings.sh
   ./scripts/sync_content.sh
   SKIP_FETCH=1 SKIP_SYNC=1 hugo server --source . --disableFastRender