A tool to generate a static blog, with restructured text (or markdown) input files.
Project description
Pelican is a simple weblog generator, writen in python.
Write your weblog entries directly with your editor of choice (vim!) and directly in restructured text, or markdown.
A simple cli-tool to (re)generate the weblog.
Easy to interface with DVCSes and web hooks
Completely static output, so easy to host anywhere !
Files metadatas
Pelican tries to be smart enough to get the informations he needs from the filesystem (for instance, about the category of your articles), but you need to provide by hand some of those informations in your files.
You could provide the metadata in the restructured text files, using the following syntax:
My super title ############## :date: 2010-10-03 10:20 :tags: thats, awesome :category: yeah :author: Alexis Metaireau
You can also use a mardown syntax:
Date: 2010-12-03 Title: My super title Put you content here.
Note that only the date metadata is mandatory, so you just have to add that in i your files. The category can also be determined by the directory where the rst file is. For instance, the category of python/foobar/myfoobar.rst is foobar.
Features
Pelican currently supports:
blog articles
comments, via an external service (disqus). Please notice that while it’s useful, it’s an external service, and you’ll not manage the comments by yourself. It could potentially eat your data.
theming support (themes are done using jinja2)
PDF generation of the articles/pages (optional).
Getting started — Generate your blog
Yeah? You’re ready? Let’s go ! You can install pelican in a lot of different ways, the simpler one is via pip:
$ pip install pelican
Then, you have just to launch pelican, like this:
$ pelican /path/to/your/content/
And… that’s all! You can see your weblog generated on the content/ folder.
This one will just generate a simple output, with the default theme. It’s not really sexy, as it’s a simple HTML output (without any style).
You can create your own style if you want, have a look to the help to see all the options you can use:
$ pelican --help
Why the name “Pelican” ?
Heh, you didnt noticed? “Pelican” is an anagram for “Calepin” ;)
Dependencies
At this time, pelican is dependent of the following python packages:
feedgenerator, to generate the ATOM feeds.
jinja2, for templating support.
pygments, to have syntactic colorization
docutils and Markdown
If you’re not using python 2.7, you will also need argparse.
All those dependencies will be processed automaticaly if you install pelican using setuptools/distribute or pip.
Source code
You can access the source code via mercurial at http://hg.notmyidea.org/pelican/ or via git on http://github.com/ametaireau/pelican/
Feedback !
If you want to see new features in Pelican, dont hesitate to tell me, to clone the repository, etc. That’s open source, dude!
Contact me at “alexis at notmyidea dot org” for any request/feedback !
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pelican-2.4.4.tar.gz.
File metadata
- Download URL: pelican-2.4.4.tar.gz
- Upload date:
- Size: 21.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3504f3195a4bf7ab5ef918c5a29f94afc0680503348ca31a9924d2970efce332 |
|
| MD5 | 944eb18438ecd0774b590ed5d12eccef |
|
| BLAKE2b-256 | 576e4e0c075f42c46c3bafe6bfd498757656f5f6650b2f979f4ead07cc98ed7a |
File details
Details for the file pelican-2.4.4-py2.py3-none-any.whl.
File metadata
- Download URL: pelican-2.4.4-py2.py3-none-any.whl
- Upload date:
- Size: 60.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2ec9c883ef3082776ca1f0e21462907ba3063fd96e09a22f9b4f9ba7a334de87 |
|
| MD5 | 84c10c908d2125fcbf888940408293df |
|
| BLAKE2b-256 | 9de7e02502f2656ea4c5053fb342a6b7de1a8c659528c1d1ff15934e3ba3f480 |
