Pelican 3.3.1.dev

Warning

This documentation is for the version of Pelican currently under development. Were you looking for version 3.3.0 documentation?

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 3 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
  • Import from WordPress, Dotclear, or RSS feeds
  • Integration with external tools: Twitter, Google Analytics, etc. (optional)
  • Fast rebuild times thanks to content caching and selective output writing.

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. For a more immediate response, you can also join the team via IRC at #pelican on Freenode — if you don’t have an IRC client handy, use the webchat for quick feedback. If you ask a question via IRC and don’t get an immediate response, don’t leave the channel! It may take a few hours because of time zone differences, but if you are patient and remain in the channel, someone will almost always respond to your inquiry.

Documentation

A French version of the documentation is available at Pelican.