blog

Website code

stonecharioteer.com

This is the sphinx-based source code for my blog.

To build this using gh-actions, I recommend starting a runner using docker. I prefer running the runner locally instead of using a cloud runner.

First, set the following environment variables:

RUNNER_NAME
GITHUB_ACCESS_TOKEN
REPO_URL

Check the justfile for easier ways to do this. Currently, the actions uses the cloud runner, but this is left documented for legacy purposes.


docker run -d --name blog-runner --rm --pull=always -e RUNNER_WORK_DIR=/tmp/runner/ \
    -e RUNNER_NAME=$RUNNER_NAME -e GITHUB_ACCESS_TOKEN=$GITHUB_ACCESS_TOKEN -e RUNNER_REPOSITORY_URL=$REPO_URL \
    -v /tmp/runner:/tmp/runner--rm tcardonne/github-runner:ubuntu-20.04

Tips

Set the values of those envvars using direnv, it makes things easy.

Use incrontab to configure the autobuild. Here's what I use right now:

$HOME/code/checkouts/personal/blog/source    IN_MODIFY,IN_ATTRIB,IN_CREATE,IN_DELETE,IN_MOVE    /usr/bin/bash $HOME/code/checkouts/personal/blog/build.sh $@/$#

blog

stonecharioteer.com

Tips

Categories

Tags