Metadata-Version: 1.1
Name: blo
Version: 0.8
Summary: Blo - a simple static blog generator
Home-page: https://github.com/savuir/blo
Author: Yann Savuir
Author-email: savuir@gmail.com
License: BSD-3-clause
Download-URL: https://github.com/savuir/blo/tarball/0.1
Description: Blo
        ===
        
        **Blo** (*blog + bro*) - yet another static site generator for personal
        blogs. The aim is to make a really easy tool for creating new notes and
        customizing your site. Do less actions and have much opportunity to make
        a unique site.
        
        Features
        --------
        
        -  Comfortable cli control.
        -  Easy config edit in JSON files.
        -  Drafts templates: default content for new notes, useful for planning
           new posts.
        -  Page templates: easy HTML/Jinja2 customize and improve.
        -  SEO friendly (as I could make it).
        -  Microformats for better snippets in Google/Bing/etc.
        -  Markdown with use of meta-tags to customize pages more with different
           data.
        -  Code highlight with Pygments.
        -  RSS feed generation
        -  Pagination
        
        Installation
        ------------
        
        ::
        
             pip install blo
        
        Or download repo and execute:
        
        ::
        
             python setup.py install
        
        Usage
        -----
        
        Create a new blog:
        
        ::
        
             blo create myblog
             cd myblog
        
        Create a new page or post:
        
        ::
        
             blo post hello-world 
             
        
        You can also use pipe with your favorite editor:
        
        ::
        
             blo post hello-world | xargs subl
        
        Build blog:
        
        ::
        
             blo build
        
        Run blog locally:
        
        ::
        
             blo serve
             
        
        Configure
        ---------
        
        Global site variables and technical paths are in ``default.json``.
        
        Templates for diffirent types of content are in ``draft_templates.json``
        
        Customize
        ---------
        
        Adding a custom type of content
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        You can add you page HTML templates for diffirent types of content.
        
        1. Add new HTML template to ``templates`` folder with a name of post
           type (ex. ``book.html``)
        2. Add new draft template to ``draft_templates.json``, you can also set
           an URL template and default content for new type of page
        3. Now you can make new type of posts:
           ``blo post just-for-fun --type book``
        
Keywords: blogging,blog,static blog generator
Platform: UNKNOWN
