Jekyll-like blog-aware site management with nodejs/markdown/mustache.

Download as .zip Download as .tar.gz View on GitHub

Build Status Coverage Status Cuervo on NPM Dependency Status


I’ll go ahead and jump on the bandwagon and say at this point: this is NOT a stable or finished project. It’s a work in progress, and there’s a good chance I’ll slowly (or rapidly) develop individual pieces as I go.

If, against your own better judgment, you’re still reading this, you can get this now by just typing

npm install -g cuervo

When the dependencies have been installed, you should be able to change to the directory that contains your blog files, and run…


Along the same vein as Jekyll and Heckle, it parses a _config.yml for default options, and treats _posts, _layouts, and _includes dirs. Your templates (_includes are like partials) should be in Mustache syntax, but all your posts will also be parsed using Markdown.

Typical site format looks like this:

This will result in the following in (_site) :

Config options

The configs are by default determined in the main Cuervo class:

defaults : {
        postLink: "${name}.html", // mustache-formatted output url
        makeRewrites: true, // makes an .htaccess file for your main pages (about.html = /about)
        latestNewsCount: 5, // for the latestNews variable, how many posts?
        makeFeed: false, // make an rss feed?
        summaryWords: 100, // how many words to determine the summary?
        summaryReadMoreText: "... read more" // when you run out of words, what does the link say?

You you should also provide the following in your _config.yml

sitename: Your Site 
description: Your blog of stuff
feedImage: images/feedLogo.png


A fork of a clone! Heckle gave me the idea, which Marijn Haverbeke describes as a “minimal Jekyll clone in node.js.”

Like Marijn, I liked the approach to managing a site taken by Jekyll.

Also like Marijn, I don’t like Ruby. However, unlike Marijn, I DO enjoy logic-less templates.

So the chain goes like this:

And NOW:

Cuervo? Are you drunk?

At the time of writing… maybe.

But cuervo is the spanish word for Crow. Follow my logic here: Jekyll was named after the mad scientist from Dr. Jekyll and Mr. Hyde. Heckle was transferring that logic to the magpies from the old Terry Toons animations. I’m following the common conception that they were the crows from the old Dumbo cartoon, and giving them a classy Mexican mustache. It’s so removed at this point I know you don’t care, but I had to name it something.