skip to navigation
skip to content

rant 0.2

A CLI driven blog-aware website generator. It is intended to make maintianing a blog or personal website easy using only your favorite console editor such as Vim, and a few simple commands

# Rant #


## About ##

“Rant” is a CLI driven blog-aware website generator written in python. It is intended to make maintaining a blog or personal website easy using only your favorite CLI editor such as vim, and a few simple commands.

Insipired by great projects such as: [Jekyll](, [Pelican]( and [Goldbarg](

## Current Features ##

  • Simple post/page authoring as markdown text files
  • sitemap.xml support
  • RSS / Atom support
  • Full jinja2 templating integration
  • Pagination
  • Pygments syntax hilighting
  • Disqus commenting integration in default templates
  • Other stuff

## Requirements ##

  • Python 2.7+
  • pip
  • libyaml
  • jinja2
  • pygments

## Usage / Installation ##

  1. Install rant

    `bash pip install rant `

  2. Start a new rant project

    Create a folder where you intend your site to live and initialize rant.

    `bash mkdir my_rant_blog cd my_rant_blog rant install `

    This will populate the folder with the basic rant project ready to add posts to.

  3. Create a post or page

    To make a first blog post do:

    `bash rant publish `

    This will open your default $EDITOR with a template like the following:

    `bash --- layout: post title: date: 2011-09-23 02:45 image: tags: comments: true draft: false --- `

    Fill out the top [YAML]( block as you desire, then add your post below the ‘—’ in [Markdown]( format.

    On saving it will automatically generate any needed html for the page according to the ‘post’ templates found in ‘layouts/post.html’ .

    To edit a post in the future simply edit it and regenerate.

    `bash vim posts/ rant generate `

    From here you can also modify any of the media found in /static, or edit any of the [Jinja2]( layouts found in ‘layouts’ to your liking.

    Happy ranting :-)

## Notes ##

Use at your own risk. You may be eaten by a grue.


You can find me on the web via:

[Email](mailto:// | [Blog]( | [Twitter]( | [Facebook]( | [Google+]( | [YouTube]( | []( | [LinkedIn]( | [Github](

File Type Py Version Uploaded on Size
rant-0.2.tar.gz (md5) Source 2014-08-25 17KB