Pelican¶
Pelican is a static site generator, written in Python.
- Write your content directly with your editor of choice (vim!) in reStructuredText, Markdown, or AsciiDoc formats
- Includes a simple CLI tool to (re)generate your site
- Easy to interface with distributed version control systems and web hooks
- Completely static output is easy to host anywhere
Features¶
Pelican currently supports:
- Articles (e.g., blog posts) and pages (e.g., “About”, “Projects”, “Contact”)
- Comments, via an external service (Disqus). (Please note that while useful, Disqus is an external service, and thus the comment data will be somewhat outside of your control and potentially subject to data loss.)
- Theming support (themes are created using Jinja2 templates)
- Publication of articles in multiple languages
- Atom/RSS feeds
- Code syntax highlighting
- PDF generation of the articles/pages (optional)
- Import from WordPress, Dotclear, or RSS feeds
- Integration with external tools: Twitter, Google Analytics, etc. (optional)
Why the name “Pelican”?¶
“Pelican” is an anagram for calepin, which means “notebook” in French. ;)
Source code¶
You can access the source code at: https://github.com/getpelican/pelican
Feedback / Contact us¶
If you want to see new features in Pelican, don’t hesitate to offer suggestions, clone the repository, etc. There are many ways to contribute. That’s open source, dude!
Send a message to “authors at getpelican dot com” with any requests/feedback! You can also join the team at #pelican on Freenode (or if you don’t have an IRC client handy, use the webchat for quick feedback.
Documentation¶
A French version of the documentation is available at Pelican.
- Getting started
- Settings
- How to create themes for Pelican
- Plugins
- Pelican internals
- pelican-themes
- Import from other blog software
- Frequently Asked Questions (FAQ)
- What’s the best way to communicate a problem, question, or suggestion?
- How can I help?
- Is it mandatory to have a configuration file?
- I’m creating my own theme. How do I use Pygments for syntax highlighting?
- How do I create my own theme?
- I want to use Markdown, but I got an error.
- Can I use arbitrary metadata in my templates?
- How do I assign custom templates on a per-page basis?
- How can I override the generated URL of a specific page or article?
- How can I use a static page as my home page?
- What if I want to disable feed generation?
- I’m getting a warning about feeds generated without SITEURL being set properly
- My feeds are broken since I upgraded to Pelican 3.x
- Tips
- How to contribute
- Some history about Pelican
- Release history