mirror of
https://github.com/almet/notmyidea.git
synced 2025-04-28 19:42:37 +02:00
Init the repository and add an article about pelican
This commit is contained in:
commit
c6cef328c6
2 changed files with 92 additions and 0 deletions
16
pelican.py
Normal file
16
pelican.py
Normal file
|
@ -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'),)
|
76
python/writing-pelican.rst
Normal file
76
python/writing-pelican.rst
Normal file
|
@ -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
|
Loading…
Reference in a new issue