I went looking for the most minimal static website generator I could find. My requirements were:
1. That it really was simple not only to run but also in terms of directory structure. (Some generators get a little prolix with files and folders.)
2. That it allows me to create and maintain pages in [Markdown]. [ReST] was an option, and I even tried using **[sphinx]** but I had some problems getting `sphinx-quickstart` to run. (I made a promise to myself to try it again when I have a bit more time to tinker.)
3. I would rather it be written in Python so I could potentially tinker with it.
I’ve long watched [Pelican], but Pelican has become more focused on blogging support. I looked at [Mynt], and even [Wok]. In the end, I found myself deciding to go with [Poole]. At least for now. [Poole] is stupidly simple.
I cloned the Python 3 branch of the Bitbucket repo, and then added Poole to my PATH environment:
Creating websites looks like this:
% mkdir /path/to/site/project
% cd /path/to/site/project
% poole.py –init –theme minimal
% poole.py –build
% poole.py –serve
(Poole serves to port 8080.)
The directory structure looks like this:
That’s it. `page.html` is the template for the site, with the `css` tucked into the header. There are more elaborate themes possible, and I’ll explore those more in a moment.