Pelican, a simple static blog generator in python
#################################################

Those days, I've wrote a little python application to fit my blogging needs.
I'm an occasional blogger, a vim lover, I like restructured text and DVCSes.

Pelican (for calepin) is just a simple tool to generate your blog as static 
files, letting you using your editor of choice (vim!). It's easy to extend, 
and has a template support.

I've made it to fit *my* needs. I mean that I hope it will fit yours, but maybe
it wont.

Need an example ? You're looking at it ! This weblog is using pelican to be
generated, also for the atom feeds.

I've released it under AGPL, since I want all the modifications to be profitable
to all the users.

You can find a mercurial repository to fork at http://hg.lolnet.org/pelican/,
feel free to clone and hack it !

If you just want to get started, use your installer of choice (pip, easy_install, …)
And then have a look to the help (`pelican --help`)

.. code-block:: bash

    $ pip install pelican

Usage
======

Here's a sample usage of pelican

.. code-block:: bash

    $ pelican .
    writing /home/alexis/projets/notmyidea.org/output/index.html
    writing /home/alexis/projets/notmyidea.org/output/tags.html
    writing /home/alexis/projets/notmyidea.org/output/categories.html
    writing /home/alexis/projets/notmyidea.org/output/archives.html
    writing /home/alexis/projets/notmyidea.org/output/category/python.html
    writing
    /home/alexis/projets/notmyidea.org/output/pelican-a-simple-static-blog-generator-in-python.html
    Done !

You also can use the `--help` option for the command line to get more
informations

.. code-block:: bash

    $pelican --help 
    usage: pelican [-h] [-t TEMPLATES] [-o OUTPUT] [-m MARKUP] [-s SETTINGS] [-b]
                   path

    A tool to generate a static blog, with restructured text input files.

    positional arguments:
      path                  Path where to find the content files (default is
                            "content").

    optional arguments:
      -h, --help            show this help message and exit
      -t TEMPLATES, --templates-path TEMPLATES
                            Path where to find the templates. If not specified,
                            will uses the ones included with pelican.
      -o OUTPUT, --output OUTPUT
                            Where to output the generated files. If not specified,
                            a directory will be created, named "output" in the
                            current path.
      -m MARKUP, --markup MARKUP
                            the markup language to use. Currently only
                            ReSTreucturedtext is available.
      -s SETTINGS, --settings SETTINGS
                            the settings of the application. Default to None.
      -b, --debug