在GitHub Pages上使用Pelican搭建博客的教程

Pelican 介绍

首先看看 Pelican 的一些主要特性：

• Python实现，开放源码

• 输出静态页面，方便托管
• 支持主题，采用Jajin2模板引擎
• 支持代码语法高亮
• 支持reStructuredText、Markdown、AsciiDoc格式
• 支持Disqus评论
• 支持Atom和RSS输出

这些特性都是大爱，完全满足我对博客系统的基本需求，再配合免费无限制的GitHub Pages，一切近乎完美了。
安装 Pelican

开始前请自行安装Python环境，支持2.7.X和3.3+，为方便，再顺手装上distribute、pip、virtualenv。(注：我的操作系统是：Windows 7)

创建Pelican虚拟环境

    virtualenv PelicanEnv --distribute
    PelicanEnv\Scripts\activate

安装 Pelican

    pip install pelican

如果您使用Markdown来写文章的话，还需要安装Markdown库

    pip install Markdown

创建 Blog

创建一个 Blog 目录

    mkdir myblog
    cd myblog

快速创建 Blog

    pelican-quickstart

根据提示一步步输入相应的配置项，不知道如何设置的接受默认即可，后续可以通过编辑pelicanconf.py文件更改配置。

以下是生成的目录结构：

复制代码 代码如下:

myblog/
├── content # 存放输入的源文件
│ └── (pages) # 存放手工创建的静态页面
├── output # 生成的输出文件
├── develop_server.sh # 方便开启测试服务器
├── Makefile # 方便管理博客的Makefile
├── pelicanconf.py # 主配置文件
└── publishconf.py # 发布时使用的配置文件

撰写文章

在 content 目录下用 Markdown 语法来写一篇文章

复制代码 代码如下:

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

This is the content of my super blog post.