Bucket3

bucket3 is a simple, blog aware, static site generator written in python.

Download .zip Download .tar.gz View on GitHub

Welcome to bucket3

bucket3 is a simple, blog aware, static site generator written in python. It reads your content and spits out a complete, static website in HTML, that can be histed in any web server or even GitHub Pages or Amazon S3.

bucket3 intends to be an “information bucket” where you throw pieces of information (texts, images, audio, etc), and presents them in a nice blog-like format.

Quick intro

Install bucket3

$ pip install bucket3

Create a local directory to hold your blog and initialize a new bucket3 blog

$ mkdir myblog
$ cd myblog
$ bucket3 init

Configure your blog: Edit .bucket3/conf.yaml and set your blog name, URL, etc.

Create a new post.

$ cd posts
$ bucket3 new hello-world-1

Edit the file generated, and add some text, then generate/update your blog's HTML.

$ bucket3 update

Upload the contents of html/ to your server.

Note: if you want to host your bucket3-generated blog on GitHube pages, make sure you create a .nojekyll file. Bucket3 puts all assets (css, js, etc) unded the directory "_/" that's ignored by GitHub Pages otherwise.

Examples.

News, tips

News and tips can be found at blog.vrypan.net/tag/bucket3.

License & Copyright.

bucket3 is distributed under the MIT LICENSE.

Copyright by Panayotis Vryonis.