This site aims to be a comprehensive guide to Bunto. We’ll cover topics such as getting your site up and running, creating and managing your content, customizing the way your site works and looks, deploying to various environments, and give you some advice on participating in the future development of Bunto itself.

So what is Bunto, exactly?

Bunto is a simple, blog-aware, static site generator. It takes a template directory containing raw text files in various formats, runs it through a converter (like Markdown) and our Liquid renderer, and spits out a complete, ready-to-publish static website suitable for serving with your favorite web server. Bunto also happens to be the engine behind GitHub Pages, which means you can use Bunto to host your project’s page, blog, or website from GitHub’s servers for free.

Helpful Hints

Throughout this guide there are a number of small-but-handy pieces of information that can make using Bunto easier, more interesting, and less hazardous. Here’s what to look out for.

ProTips™ help you get more from Bunto

These are tips and tricks that will help you be a Bunto wizard!

Notes are handy pieces of information

These are for the extra tidbits sometimes necessary to understand Bunto.

Warnings help you not blow things up

Be aware of these messages if you wish to avoid certain death.

You'll see this by a feature that hasn't been released

Some pieces of this website are for future versions of Bunto that are not yet released.

If you come across anything along the way that we haven’t covered, or if you know of a tip you think others would find handy, please file an issue and we’ll see about including it in this guide.