mirror of
https://github.com/almet/notmyidea.git
synced 2025-04-29 20:12:38 +02:00
Alexis Metaireau
bd72122b70
--HG-- rename : associatif/amap-medias-paniers-bio-a-5e.rst => asso/amap-medias-paniers-bio-a-5e.rst rename : associatif/le-temps-de-graces-courrez-y.rst => asso/le-temps-de-graces-courrez-y.rst rename : associatif/semaine-de-lenvironnement-consommation-etudiante.rst => asso/semaine-de-lenvironnement-consommation-etudiante.rst rename : python/a-distutils2-gsoc.rst => dev/a-distutils2-gsoc.rst rename : python/a-distutils2-month-pypi-simple-index-ready.rst => dev/a-distutils2-month-pypi-simple-index-ready.rst rename : python/a-distutils2-sprint-in-tours.rst => dev/a-distutils2-sprint-in-tours.rst rename : python/an-amazing-summer-of-code-working-on-distutils2.rst => dev/an-amazing-summer-of-code-working-on-distutils2.rst rename : misc/bebox-reboot.rst => dev/bebox-reboot.rst rename : python/distutils2-paris-sprint-wrapup.rst => dev/distutils2-paris-sprint-wrapup.rst rename : python/distutils2-paris-sprint.rst => dev/distutils2-paris-sprint.rst rename : python/dynamically-change-your-gnome-wallpapers.rst => dev/dynamically-change-your-gnome-wallpapers.rst rename : python/gsoc-distutils-first-report.rst => dev/gsoc-distutils-first-report.rst rename : python/pypioncouch.rst => dev/pypioncouch.rst rename : python/python-go.rst => dev/python-go.rst rename : misc/use-restructured-text-rest-to-power-your-presentations.rst => dev/use-restructured-text-rest-to-power-your-presentations.rst rename : python/writing-pelican.rst => dev/writing-pelican.rst rename : freebsd/php5-nginx.rst => system/php5-nginx.rst
83 lines
3 KiB
ReStructuredText
83 lines
3 KiB
ReStructuredText
Pelican, a simple static blog generator in python
|
|
#################################################
|
|
|
|
:date: 2010-10-06
|
|
|
|
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, so
|
|
I've made a little tool that makes good use of all that.
|
|
|
|
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 (via jinja2).
|
|
|
|
I've made it to fit *my* needs. I hope it will fit yours, but maybe it wont, and
|
|
it have not be designed to feet everyone's needs.
|
|
|
|
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 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
|
|
|
|
Enjoy :)
|
|
|
|
.. _Pelican: http://alexis.notmyidea.org/pelican/
|