使用Pelican搭建静态Blog

Wed 30 October 2013

Filed under Tech

什么是静态博客

如果你关注了我的主博客RyekeeBlog，那么你应该知道，现今最流行的博客系统是WordPress。不但安装快捷方便，还有无数的开发者为它开发插件和主题，有的空间甚至提供了一键安装（如SAE），把搭建自己的Blog门槛降到了最低。但是，我们可能并不需要这么多的自由度，不需要那么多酷炫的主题和拖慢加载速度的插件，我们需要的仅仅是一个顶级域名和对内容的绝对控制权。因此，Qzone和SinaBlog已经满足不了你了，而WordPress又给了我们太多不需要的东西。

静态博客就是在本地生成HTML文件，并托管在支持Web服务的第三方空间上以供读者访问。

静态博客的优势

静态，对托管空间没有太高的要求
支持Markdown语法，内容与样式分离
Blog文章的文件全部都是文本，使用Git可以非常方便的备份和管理
天然的内嵌代码支持，这是一个程序员的基本素养（lol）

Let's ROCK

接下来讲解如何在Windows环境下配置Pelican

安装Pelican

在cmd中输入以下指令：$ pip install pelican
于是我们的Pelican就安装好了。如果出现错误，那么错误的可能有以下几种：
1. 你没有安装Python
2. 你没有安装pip
3. 你安装了Python和pip，却没有将他们的路径添加到环境变量中去
4. 你没有联网
5. 你敲指令的姿势不对

建立Blog

在你想要建立博客的目录处新建一个文件夹，并进入文件夹使用Pelican新建一个Blog。

$ mkdir blog        
$ cd blog   
$ pelican-quickstart

Pelican会问你很多问题，根据你自身的需求。一般情况下，一路回车是不会出错的:P

新建博文

本地的Blog文章保存在content目录下，在此目录下新建文件夹，Pelican会自动将文件夹下的文章归类到此分类中去。

在你想要存放文章（content或者你新建的文件夹下）的地方touch一个*.md文件即可，编辑你创建的*.md文件。

下面以我的博客的About me页面为例：

Title: About me # 文章的标题
Date: 2013-10-21 15:15 # 文章的创建日期
Category: About # 文章存放的分类，如果已经创建了文件夹可以不必添加此标签
Tags: about # 文章的标签
Author: Ryekee # 文章作者，如果在设置文件中填写了可以不必添加
Slug: about-me # 指定生成HTML页面的名称，about-me.html
Summary: A page about me # 文章的缩略
# 下面是文章的内容
First release in '92, a nerd, programmer. Version 0.2.3

Hi, I'm [Ryekee Zhong](http://aboutme.ryekee.com), study Intelligence Science and Technology in [Xidian University](http://www.xidian.edu.cn). And now I am the Chairman of [XDU-MSTC](http://xdmstc.com).

This is a brand new blog for me, I use [Pelican](http://www.pelican.com) to create a blog on [Github](http://github.ryekee.com). And my main blog [RyekeeBlog](http://ryekee.com) is still working with Wordpress.

You can visit [here](http://ryekee.com/aboutme) to view more information about me.

生成Blog

回到上层目录：$ cd ..
输入指令：$ pelican -s pelicanconf.py content/ -o myblog/
进入myblog目录看看〜你的博客已经生成好了。现在只要把myblog下的所有文件上传到服务器就可以访问了。

配置Github

Github用来托管再合适不过了，支持绑定顶级域名、全球均衡的访问速度、GFW特别关照……

Github的配置流程如下：
1.注册一个Github帐号
2.新建一个repo，以*.github.io命名，其中*代表着你的Github的帐号ID
3.把myblog目录下的所有文件上传到这个repo的master分支下，如果有困难可以查看一下Github提供的git教程，其实只有短短的三行：

$ git add .
$ git commit -m "your message here"
$ git push origin master

好了，过一会儿就可以通过*.github.io来访问你的博客了。

如果需要绑定域名，在根目录下新建一个CNAME文件，写入你的域名即可。在域名DNS记录中添加一个A记录，指向204.232.175.90。

OK, now you can go to change your world, my dear David.

安装插件 更换主题 修改配置什么的，等我心情好了再来填坑吧。。