[Pelican] 使用Pelican搭建静态博客

为什么写博客

一方面是对自己平时工作和学习中收获的自我总结和积累，另一方面，借用知乎的一句话说就是“与世界分享你的知识”。

为什么选择Plican

写博客有两种选择:

一种是博客社区，中文的比如CSDN，博客园等，我之前在CSDN上的博客在这里。社区中不乏很多好的文章，而且搜索起来比较方便。

第二种是搭建个人的独立博客。一直以来搭建独立Blog的首选只有 Wordpress ，不但安装快捷简单，还有无数的插件和主题。我也学习过Python 和Django，尝试过用Django自己搭建一个博客，感兴趣的可以看看django-blog-zinnia，但最终因为相对繁杂的配置和管理放弃了。请原谅我的孤陋寡闻，我是直到三个月前才知道Github Pages 和静态博客这个概念的。

静态Blog生成工具的好处：

静态，对托管空间没有要求，只要支持Web服务即可，可以直接放在Github上
支持 reStructuredText 和 Markdown 语法，这种所想即所得的标记语言加上 Emacs的定制配置，写起来很顺手
管理，日志都是文本文件，可以用 Git 方便的管理、进行版本控制。
内嵌代码支持，使用 pygments 代码高亮
轻量级，美观，自定义性强，让你专注于内容等等其他优点就不多说了

Github Pages 官方支持的是Jekyll。看到很多使用Pelican的教程中都有这样一句话“之所以没有使用的Jekyll, 是因为它是Ruby编写, 而我又对Ruby没有啥兴趣, 所以还是选择了使用了我熟悉的Python编写的Pelican”。我自己也是一个Python爱好者，Ruby接触的很少，所以Python自然也是我的首选。

安装

建议在virtualenv下使用，首先安装virtualenv:

$ sudo pip install virtualenv

建立 virtualenv 环境

$ virtualenv pelican
$ cd pelican
$ source bin/activate

从 `Github` 克隆最新代码安装 `Pelican`

$ git clone git://github.com/getpelican/pelican.git
$ cd pelican
$ python setup.py install

到此Pelican就安装好了。

新建Blog

创建文件夹并新建Blog

$ mkdir myblog
$ cd myblog
$ pelican-quickstart

回答一系列的问题之后会自动在当前目录生成以下文件

.
|-- content              # 所有的文章和图片都放在此目录
|-- develop_server.sh    # 用于开启测试服务器
|-- Makefile             # 方便管理博客的Makefile
|-- output               # 静态文件生成目录
|-- pelicanconf.py       # 配置文件
|-- publishconf.py       # 发布用的配置文件

新建文章

在 content 目录下新建文件夹，文章便会自动归类到该文件夹名的分类中。

如果要建立页面（比如about页面），在 content 中新建文件夹 pages ，将文件放在该文件夹中即可。

以下用 Markdown 为例:

Title: [Pelican] 使用Pelican搭建静态博客
Date: 2014-03-25 22:20
Category: Python
Tags: pelican, python
Slug: build-blog-with-pelican  #指定生成页面的名称, 比如这个页面的最后生成的名称为build-blog-with-pelican.html
Author: Xiong XiaoBlog具体内容...

生成Blog

生成Blog非常简单，只需要运行

$ make html

即可在 output 目录下生成全站的页面。只需把 output 下的所有文件上传至Web服务器就可以访问了。

----------------------------------------------------------------

欢迎大家转载我的文章。

转载请注明出处

http://blog.csdn.net/xiongxiaoxx

我已在Github Pages 上搭建了个人博客，欢迎访问：http://xiongxiaoxx.github.io/