Posts about meta

Upgrading Nikola: some pitfalls and how I climbed out of them

After some hacking of my dotfiles and python settings, I lost my nikola virtual environment (I think it broke after a brew update or something. The hacking's only partly recorded in the issues on GitHub).

But that's no biggie, just make a new one and re-install, right? Well, not quite. The re-install gives you the latest Nikola (great!) and that means I have to review and update my (okay...) and figure out runtime errors like this:

[src:?][[email protected]:~/hax/net/blog/]
[07:27](nikola)$ nikola version
Traceback (most recent call last):
  File "/Users/mjl/lib/nikola/bin/nikola", line 11, in <module>
  File "/Users/mjl/lib/nikola/lib/python3.6/site-packages/nikola/", line 171, in main
    _ =
  File "/Users/mjl/lib/nikola/lib/python3.6/site-packages/nikola/", line 339, in run
  File "/Users/mjl/lib/nikola/lib/python3.6/site-packages/nikola/", line 1077, in init_plugins
  File "/Users/mjl/lib/nikola/lib/python3.6/site-packages/nikola/", line 1233, in _activate_plugins_of_category
  File "/Users/mjl/lib/nikola/lib/python3.6/site-packages/nikola/plugins/misc/", line 328, in set_site
  File "/Users/mjl/lib/nikola/lib/python3.6/site-packages/nikola/plugins/misc/", line 316, in _register_path_handlers
    doc = taxonomy.path_handler_docstrings[name]
KeyError: 'page_index_folder_index'

(well, pooh).

I decided a while back that I wasn't going to meta-blog (otherwise most of my posts would be about blogging!), but I think in this case, Rule 4 will come to the rescue. Anyway at least you know this story has a happy ending, or else I wouldn't be able to add this new_post!

Read more…

Meta: Setting up Nikola blogging

Tonight I thought that I'd sit down at my home server, Tesla, and do a bit of blogging. This server's recently been rebuilt after a bad run-in with a hard-drive problem and I had not got around to putting my blog onto it. Instead I was blogging with work's laptop.

After spending an hour cloning and installing my blog repositories and the necessary software through trial-and-error, I thought it best to write down what is necessary to bootstrap my blogging environment, and save myself some trouble in the future.

Ideally I will make a script to get most of this going soon … but in the meantime, you are treated to a meta-blog.