You'll need to install Nix.
For plain Nix there's no other setup. If you have direnv
enabled, just cd into this directory and run direnv allow to enable
automatic compilation.
To enter the environment without direnv, run nix-shell. With direnv, you just
need to cd into this directory, and it will build in the background.
Run niv update. Generally we should be using the latest stable
"nixos-YY.MM" channel.
See test workflow
pre-commit install --hook-type=commit-msg --hook-type=pre-commit --overwriteYou'll see references to secrets.CACHE_SEED in the
CI configuration. This is a hack to allow you to
effectively ignore the existing cache entries in case of a cache corruption
(such as caching an invalid package). Simply
set the CACHE_SEED secret
for all relevant contexts ("Actions" being the main one) to an arbitrary new
value, and the cache key changes correspondingly to something new, resulting in
a fresh cache.
Use
nix-shell --pure --run 'github-pages build && jekyll serve --no-watch --skip-initial-build'
to serve up a local copy of the website. This ensures that you see exactly what
the github-pages build produces, as opposed to letting jekyll serve rebuild
the site.
Make sure to exclude any new files which are not explicitly
part of the website. The simplest way to verify this is to run
github-pages build and look at the contents of the _site directory.