XiongXiao's Blog

菜鸟要起飞

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

为什么写博客

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

为什么选择Plican

写博客有两种选择:

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

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

静态Blog生成工具的好处:

  • 静态,对托管空间没有要求,只要支持Web服务即可,可以直接放在Github上
  • 支持 reStructuredTextMarkdown 语法,这种所想即所得的标记语言加上 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 Xiao

Blog具体内容...

生成Blog

生成Blog非常简单,之需要运行

$ make html

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

Comments