Voltaire Quickstart
Voltaire is static site toolkit built on top of Pelican and various other libraries to provide an opinionated, “batteries-included” setup so that you can focus immediately on the actual writing.
You might think of it as an alternative to Pelican’s built-in quickstart where you can inherit improvements automatically on each update.
Quick Start
Install voltaire:
$ pip install voltaire
Voltaire provides build tasks via invoke, so create a tasks.py containing:
import voltaire
namespace = voltaire.site()
You can now see tasks available via invoke -l. As this is now your own tasks.py file for invoke, you are welcome to add any custom tasks later.
Now we can create a minimal pelicanconf.py file with just the line:
from voltaire.pelican import *
Again, this is a normal configuration file for pelican so you can add custom configuration e.g.:
from voltaire.pelican import *
SITENAME = "My Website"
Now do mkdir content and add a single page at content/page.md:
title: My Page
This is my page.
Now you can run invoke build to build and you should see an output file at output/page/index.html.
This has built a static site with opinionated defaults.
Features
See all included features.