Poole

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:

export PATH=$PATH:/some/where/poole

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:

|-project
|-/input
|-/output
|-page.html`

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.

[Markdown]: https://en.wikipedia.org/wiki/Markdown
[ReST]: https://en.wikipedia.org/wiki/ReStructuredText
[sphinx]: http://sphinx-doc.org/
[Pelican]: http://docs.getpelican.com/en/3.6.3/#
[Mynt]: http://mynt.uhnomoli.com
[Wok]: http://wok.mythmon.com
[Poole]: https://bitbucket.org/obensonne/poole

Leave a Reply