使用Pelican快速开始搭建自己的静态博客

前言

一直想搞一个自己的博客，也想耍耍酷，不管访问量怎么样，总感觉自己很了不起。当然写博客是一件很苦的事情，能坚持下来也是很苦的事情的。自己肚子里没什么货，写出来的东西也没啥深度，所以要经营好一个博客是需要相当大的毅力，特别佩服那些能把自己的博客捯饬得那么好的博主。

所以从今天开始我也要好好的收拾自己的博客，域名也买了有一段时间了。最开始的时候我用的是Octopress，是用Ruby写的，写了两篇文章便没有再坚持。最近有重新找了Pelican，用Python写的，搞Python开发还是用自己熟悉的语言比较好吧。

现在问题来了，打算好好的写博客，但是不知道写啥，仔细读了Pelican的文档，决定根据Pelican的文档写一个完整的Pelican博客搭建教程。当然了，我们在搭建博客之前要先来说说写博客的好处：

• 我本身是做开发的，写博客对技术水平有很大的提高。
• 最近买了kindle，就是为了好好读书，可是不能光读书啊，有什么想法还是要记录下来的。
• 我的文采呢一直都很差，写写博客可以提高自己的文采，也能锻炼自己的语言组织能力。

说了那么多，下面我们就要开始搭建自己的博客了。内容我都是参考Pelican的文档写的，我英语比较差，就勉勉强强的根据文档的翻译一下了。

Pelican 安装

安装Pelican需要本机安装Python 2.7.x或者Python 3.3+，同时需要安装pip，执行下面的命令，如果在linux有权限限制就在命令前面加一个sudo，写博客用Markdown，所以要安装markdown模块.

pip install pelican markdown

创建博客项目

首先为了你博客项目起一个名字，这个名字随便你起了，可以是blog或者是别的，进入到项目的目录里面去。

mkdir -p ~/project/yoursite
cd ~/project/yoursite

我们需要为博客创建一个基础的骨架，通过命令pelican-quickstart，执行命令之后会出现一些问题，依次按照提示回答就可以把骨架搭建好了。

pelican-quickstart

中括号里面的是默认值，按回车表示接受默认值，小括号是选择值，可以选择按y或者N，没有括号就可以自己输入，如果提示输入URL，就输入需要绑定的域名，比如：http://www.xinxingzhao.com

写博客

好了，架子搭起来了接下来就是添加内容了。没有内容的博客是运行不起来的，用一款你喜欢的编辑器，我用的是vim，在content下面创建一个文件keyboard-review.md

Title: My First Review
Date: 2010-12-03 10:20
Category: Review

Following is a review of my favorite mechanical keyboard.

生成博客

博客写好之后还不能进行访问，需要把写好的博客转化为html代码，执行下面的命令进行生成

pelican content

生成的文件都在output目录里面，这些文件就是博客运行需要的静态文件。

本地运行博客

在命令行里面切换到output目录下面，启动Pelican的web服务。

cd ~/project/yoursite/output
python -m pelican.server

打开浏览器，访问地址:http://localhost:8000，是不是很棒！

原文同步发布在我的个人博客：http://www.xinxingzhao.com/blog/2016/03/24/pelican-quickstart.html