i tried using the auto builder, but either i did something wrong, or there is a bug with it. nikola depends on the python package watchdog for the continuous auto-build. i might try it again some other time.

for now, this blog is built with the following sequence of commands:

nikola check --clean-files
nikola build

and served locally with:

nikola serve -b

in one line:

nikola check --clean-files && nikola build && nikola serve

the first line cleans up any files that no longer exist from the output directory (docs, because github pages is unloved).

new "tabs" can be added with through the NAVIGATION_LINKS variable in conf.py ¹. here is what that variable looks like attow:

NAVIGATION_LINKS = {
    DEFAULT_LANG: (
        ("/archive.html", "archive"),
        ("/categories/", "tags"),
        ("/rss.xml", "rss feed"),
        ("/pages/about/index.html", "about")
    ),
}