<?php include 'HEADER.php' ?>

<h1>Pelican</h1>

<p><a href="http://blog.getpelican.com/">Pelican</a> is blogging software that outputs static HTML pages using Python. See the full <a href="http://docs.getpelican.com/en/latest/">Pelican documentation</a> for details.</p>

<p>Installation on Debian is simple:</p>

<pre>
sudo apt-get install python-pip
sudo pip install pelican
sudo pip install Markdown
</pre>

<p>Create a blog:</p>

<pre>
pelican-quickstart
</pre>

<p>Write blog content in Markdown (or reStructuredText), and save it in <code>myblog/content/</code>. Pelican saves the static pages to <code>myblog/output/</code>.</p>

<p>Markdown posts follow this template:</p>

<pre>
Title: My super title
Date: 2010-12-03 10:20
Category: Python
Tags: pelican, publishing
Slug: my-super-post
Author: Alexis Metaireau
Summary: Short version for index and feeds

Here's a picture of [my cat](|filename|/images/cat01.png).
</pre>

<p>(Note that internal content links to non-post and non-page content beyond stuff in the pre-configured <code>myblog/images/</code> directory needs to be configured in <code>myblog/pelicanconf.py</code> with the <code>STATIC_PATHS</code> array.)</p>

<p>Save non-post pages in <code>myblog/pages/</code>.</p>

<?php include '../FOOTER.php' ?>
