From c6cef328c6abccf3c72d1ca2fec8095299fb576a Mon Sep 17 00:00:00 2001
From: Alexis Metaireau <ametaireau@gmail.com>
Date: Mon, 27 Sep 2010 19:24:25 +0100
Subject: [PATCH] Init the repository and add an article about pelican

---
 pelican.py                 | 16 ++++++++
 python/writing-pelican.rst | 76 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 92 insertions(+)
 create mode 100644 pelican.py
 create mode 100644 python/writing-pelican.rst

diff --git a/pelican.py b/pelican.py
new file mode 100644
index 0000000..1c8b60c
--- /dev/null
+++ b/pelican.py
@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+THEME = '/home/alexis/dev/python/pelican/samples/themes/notmyidea' 
+AUTHOR = u'Alexis Métaireau'
+
+BLOGNAME = u"Alexis' log" 
+# BLOGURL = 'http://blog.notmyidea.org'
+
+BLOGROLL = (('Biologeek', 'http://biologeek.org'),
+            ('Filyb', "http://filyb.info/"),
+            ('Libert-fr', "http://www.libert-fr.com"),
+            ('N1k0', "http://prendreuncafe.com/blog/"),
+            (u'Tarek Ziadé', "http://ziade.org/blog"),
+            ('Zubin Mithra', "http://zubin71.wordpress.com/"),)
+
+SOCIAL = (('twitter', 'http://twitter.com/ametaireau'),
+          ('lastfm', 'http://lastfm.com/user/akounet'),)
diff --git a/python/writing-pelican.rst b/python/writing-pelican.rst
new file mode 100644
index 0000000..51ef414
--- /dev/null
+++ b/python/writing-pelican.rst
@@ -0,0 +1,76 @@
+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, loving vim, restructured text and the 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