Metadata-Version: 1.0
Name: rant
Version: 0.2
Summary: 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
Home-page: http://github.com/lrvick/rant
Author: Lance R. Vick
Author-email: lance@lrvick.net
License: LICENSE.md
Description: # Rant #
        
        <http://github.com/lrvick/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](https://github.com/mojombo/jekyll),
        [Pelican](https://github.com/ametaireau/pelican)
        and [Goldbarg](https://github.com/Schnouki/Golbarg)
        
        ## 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](http://yaml.org/) block as you desire, then add
            your post below the '---' in
            [Markdown](http://daringfireball.net/projects/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/201109230245-My_neat_blog_post.md
            rant generate
            ```
        
            From here you can also modify any of the media found in /static, or edit
            any of the [Jinja2](http://jinja.pocoo.org/) layouts found in 'layouts'
            to your liking.
        
            Happy ranting :-)
        
        ## Notes ##
        
          Use at your own risk. You may be eaten by a grue.
        
          Questions/Comments?
        
          You can find me on the web via:
        
          [Email](mailto://lance@lrvick.net) |
          [Blog](http://lrvick.net) |
          [Twitter](http://twitter.com/lrvick) |
          [Facebook](http://facebook.com/lrvick) |
          [Google+](http://plus.google.com/109278148620470841006) |
          [YouTube](http://youtube.com/lrvick) |
          [Last.fm](http://last.fm/user/lrvick) |
          [LinkedIn](http://linkedin.com/in/lrvick) |
          [Github](http://github.com/lrvick/)
        
Platform: UNKNOWN
