Date Mon 13 January 2014 Tags HTML

There are blogs used by the team I'm working with, but in talking with Avtar, he was suggesting that they are not happy with their current solution and are exploring static site generation tools.

Static site generation tools give some great options for building a full web site from a bit of content and a few template files, and for refactoring an entire site easily to suit changing requirements.

Avtar recommended Pelican, a content generation tool written in Python. Before committing, I wanted to review the full range of options to see what suited me best.

In my initial research, I found Static Site Generators, a site that includes both a listing of the site generators out there as well as the raw JSON data used to generate the site. The analyst in me loves getting access to the raw data, although I ended up mostly sticking to their simple sortable table.

I was looking for something lightweight, that let me get the most for the least effort. I didn't want to fight the template language or data formatting conventions too much. I also wanted something with a good theme system, that I could see myself adapting for use with our Fluid component library down the road.

Since the list is over two hundred entries long, I let the wisdom of the crowd do my first cull for me and sorted by the number of stars each solution had received. I worked my way down, skipping now and then if I saw something that piqued my interest or that I had already heard of. I read up on Harp, WinterSmith, Punch, and others. I looked through their available template languages (no Jade, please), their conventions for storing blog and page content, the size of their community, the language they were based on.

I ended up finally coming back to Pelican, just as Avtar had recommended.

Why commit to Pelican? Even though I like its features and overall ease of use, ultimately I chose Pelican because of its community. As I said, support for themes was one of my key criteria. Of the top tools I tried, Pelican was the only one I saw that not only supported themes, but that had a clear community of people contributing themes, and a showcase for those themes.

That tells me that care not only about features, but about how people use them, about showcasing the work of their community. Want confirmation? Check out the graph of contributors. They have a steady stream of people keeping the software alive.

Once they had me, I was impressed with the quality of their documentation and the polish of their bundled tools. I encountered only small glitches, and those were either obvious or easily Googleable.

That's basically it. Convince me your project is alive, and don't turn me off too badly as I'm getting started.


Comments

comments powered by Disqus