GITHUB个人博客搭建-Pelican 在Windows环境下的安装及配置
前言
此篇博客主要为Pelican在Windows平台下的配置安装所写，在此过程中主要参考资料烟雨林博客、poem_of_sunshine和frantic1048，他们写得都很好，内容流程完善，但在具体实施过程中小白还是会遇到很多问题，因此本文结合现有的教程，再进一步指出整个操作过程中所可能遇到的问题，也为自己留个纪念。
本文架构
本文将从以下几个方面进行描述：
一、安装环境
1.1 Windows安装环境
本文基于Windows7 32位操作系统
1.2 安装软件系列
在整个安装配置过程中，所需要的软件清单如下所示,点击相应软件可直接从网站下载。
1.3 安装步骤
1.3.1 Python安装
进官网下载python2.7 Windows安装版本，我用的是python2.7.6，msi类型，直接点击安装文件进行安装，安装路径自己选，安装好之后，将安装路径加入到系统环境变量PATH中,例如我安装的路径如下：
C:\Program Files\Python27\
1.3.2 setuptools安装
安装此插件的主要目的当然就是为了大名鼎鼎的easy_install了撒，它与pip齐名，呆会也要装起。在我用python setup.py install过程中，一开始出现了编码错误问题，python的默认编码为ascii，有网上资料说改Python的默认编码为utf-8就可以，即在出现编码错误的文件中执行如下语句：
import sys
reload(sys)
sys.setdefaultencoding("utf8")
但这方法在我的系统中无效，最后解决方法是下载.exe类型的setuptools进行安装，下载地址如上软件清单链接,此过程中安装很顺利。安装好后在python安装目录下的Scripts文件夹会有一些关于easy_install的文件，所以要将此路径加到系统环境变量PATH，我的路径如下:
{python install path}/scripts/
1.3.3 Pip安装
pip我是直接用easy_install安装的，安装命令: easy_install pip 。安装好之后也会在Scripts文件夹生成一些Pip的可执行文件。
1.3.4 Git Bash安装
Git 客户端的安装，直接选择默认安装就行了,Git版本不能太低。
Pelican是用PIP安装的，一开始安装时也出现一些错误，就是PIP默认使用国外镜像，在获取安装源过程中会出现握手超时现象，即镜像不稳定，后来查相关资料找到国内清华大学的镜像安装源，其网址如下：
http://e.pypi.python.org/simple/
在Pip安装时指定此路径即可，速度搜搜的，很爽很稳定，指定格式如下：
pip install pelican -i http://e.pypi.python.org/simple/
安装其它相关python包时也可以这样安装，速度有保证。
1.3.5 Markdownpad2安装
此软件是Window下比较好的Markdown编辑器，不过是收费的，为了满足大家的使用需求，对于我等穷屌丝只能找些破解软件用用，所以在网上找了相关的破解文件，请点击此下载。破解方法已经在下载的文件包中有所说明，这里也提一下，分两步：
首先，将user.config放在如下格式路径中：
%LOCALAPPDATA%\MarkdownPad2\MarkdownPad2.exe_Url_bakzl5xvna20knbzwksj2a0nyzlicvaa\2.3.2.34663\
e.g: c:\users\{username}\AppData\Local\MarkdownPad2.exe_Url_2o2l2qlnbxt2ueyxs3lr3txdmzazbghc\2.3.2.34664\
其次，运行下Patch.exe注册机程序，Patch下安装主目录中的Markdownpad2程序即可。注：运行此patch之前务必不要先启动Markdownpad2程序
最后，启动Markdownpad2即可享受专业版的服务了。
1.3.6 Make 安装
下载完Make后，直接放到一个文件夹，将此路径添加到系统环境变量PATH中，重启或注销电脑后就可以进行make操作了
二、Pelican配置
配置Pelican，首先需要新建一个BLOG目录，然后执行pelican-quickstart,具体步骤如下：
mkdir blog
cd blog
pelican-quickstart
在执行完pelican-quickstart后，在blog目录会产生如下目录结构的文件：
blog/
|--content #存储所写的blog文件目录，
| └──（blog pages) #博客文件，如*.md后缀的文件
|--output #执行make publish之后，会将博客文件转换成相应的html文件及相应的存储目录
| └──.git #执行git init之后，产生的远程仓库目录
| └──author #作者目录，存放pelicanconf.py中指定的Author文件
| └──category #分类目录，默认目录文件为misc，在编辑器中指定
| └──feeds #目录，pelicanconf.py中FEED_RSS指定的XML文件
| └──pages #目录，pelicanconf.py中ARTICLE_URL指定格式分类文件
| └──tag #目录，存放编辑器开头所指定的Tag
| └──theme #目录，存放博客模板文件
| └──archives.html,authors.html,categories.html,index.html, tags.html
|——pelican-plugins #目录，pelican插件
|——develop_server.sh #pelican简易web服务器操作文件
|——fabfile.py # 与make类似，可用fab publish, fab server命令
|——Makefile #make 命令文件
|——pelicanconf.py #主要的pelican配置文件
|——publishconf.py #发布配置文件,可有可无
2.1 Git远程仓库配置
要将blog部署到git上，必须在本地建立一个git仓库，同时必须确保在github server端有远程仓库，名字一般为username.github.io。本地操作命令如下：
cd output
git init #产生一个.git文件夹
git remote add origin https://github.com/username.github.io.git#将远程仓库配置到本地
2.2 Pelican常规配置
对于Pelican常规配置，主要配置选项如下，具体说明可参考getpelican网站的命令说明。
Author=u""
SITENAME=u""
SITEURL=u""
GITHUB_URL=u""
ARCHIVES_URL=u""
ARTICLE_URL=u""
ARTICLE_SAVE_AS=u"" DEFAULT_LANG=u"zh"#默认语言设置
DATE_FORMAT={"zh":("zh_CN","%Y-%m-%d,%a"),}#日期格式设置，可按自己喜好设定
DEFAULT_PAGINATION=5 #默认的分页数量
TIME_ZONE = u"Asia/Shanghai"#时区设置
2.3 Pelican进阶配置
一些进阶设置可以帮助更好的管理blog，比如用到Google的Analytical，第三方的Disqus评论系统，还有Feed、插件、Blogroll及Social设置，如果还想要导航菜单项，还可设置MENUITEMS等，下面一一介绍：
2.3.1 Feed设置
Feed的设置方便博客的订阅，在pelicanconf.py中需添加如下命令:
FEED_RSS = u"feeds/all.rss.xml"
CATEGORY_FEED_RSS=u"feeds/%s.rss.xml"#为分类添加Feed
2.3.2 Plugin设置
可以根据需要添加相应的插件，插件可从github克隆，克隆命令如下：
git clone git://github.com/getpelican/pelican-plugins.git
比如要设置Sitemap插件，然后在pelicanconf.py中设置如下：
PLUGIN_PATH=u"pelican-plugins"
PLUGINS = ["sitemap"]
SITEMAP = {
"format":"xml",
"priorities":{
"articles":0.7,
"indexes":0.5,
"pages":0.3,
},
"changefreqs":{
"articles":"monthly",
"indexes":"daily",
"pages":"monthly",
}
}
2.3.3 Theme设置
git clone https://github.com/getpelican/pelican-themes.git
cd pelican-themes
pelican-themes -i bootstrap2 #可换成你自己的theme
2.3.4 Analytical设置
需要到Google的Analytical申请一个账号，记录下追踪ID，然后在pelicanconf.py中添加如下命令：
GOOGLE_ANALYTICS = u"UA-********-*" #ID以UA开头
2.3.5 Disqus
第三方评论系统有很多，这里选用很流行的Disqus作为第三方评论系统，同样需要到Disqus官网申请账号，然后填写两处：
Site name: {your git account name}.github.io
Admin URL: {Shortname}.disqus.com
记下Shortname，然后在pelicanconf.py中添加如下命令行：
DISQUS_SITENAME = u"{Shortname}" #填入你的Shortname
2.3.6 独立域名设置
如果你有独立域名，则可用自己的域名去访问github博客，在godaddy上可用支付宝购买，同时我们用dnspod进行动态域名解析，步骤如下:
步骤1：修改godaddy中的NameServers的两个地址为dnspod的DNS地址：
f1g1ns1.dnspod.net
f1g1ns2.dnspod.net
步骤2：在Dnspod中添加一条A记录，指向github URL
207.97.227.245
步骤3：在Pelican主目录，即上面创建的blog/output目录，添加CNAME文件，在文件中添加你的独立域名
2.3.7 Menu Item设置
在你的博客中，可设置相应的菜单项，菜单项是通过MENUITEMS设置的，具体如下所示：
MENUITEMS = (("ITEM1","http://github.com"),
("ITEM2",URL),
......)
2.3.8 BlogRoll和Social设置
设置一些Blog链接，通过设置LINKS实现,具体如下：
LINKS = (("Github", "https://github.com"),
("Cnblogs", URL),)
SOCIAL = (("博客园", "http://www.cnblogs.com"),
("Github','http://github.com"),)
三、Markdown博客编写
利用Markdownpad编辑器可方便进行Markdown格式的博客编写，编写格式如下所示：
Date: 2013-11-27
Title: pelican install
Tags: pelican
Category: Pelican
Slug: pelican-install
【blog正文内容】
在编好之后，执行如下命令：
make publish # 将.md发布到output目录
make server # 在本机查看预览博客，localhost:8000
如果要一次性部署到github,可以配置Makefile文件中的github，要修改两处，一处是将$(PUBLISHDIR)替换成$(CONFFILE),另一处增加一些git命令，具体如下所示：
publish:
$(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)
github: publish
cd $(OUTPUTDIR) && git add . ;
cd $(OUTPUTDIR) && git pull origin master;
cd $(OUTPUTDIR) && git commit -m 'commit';
cd $(OUTPUTDIR) && git push origin master
最后，只要进行Makefile的同级目录，执行make github即可完成一次性部署。注：在此过程中，可能要输入github username 和 password，要避免重复输入，请查看我的另一篇博客。
四、安装配置出错问题集绵
在安装过程中，出现一些错误，在此统一写出来，以留个纪念
4.1 Setuptools问题
此问题在上述有所提到，就是用python setup.py install安装时提示编码出错，最后重新下载.exe文件安装解决此问题，编码本身暂时还未找到有效解决方法。
4.2 Pelican握手超时问题
此问题上述也有所提及，就是国外镜像不稳定导致，换成清华镜像后就好了
4.3 Git pull & push问题
在Git pull和Git push过程中出现如下图所示问题：
即以https进行git操作时，会出现libcurl库不支持https的错误，此错误主要是由于现有libcurl库不支持ssl所致，解决方法是下载支持ssl的libcurl,然后将相应的.dll文件拷贝到c:\windows\system32中即可。
4.4 Makefile问题
此问题主要是由于自己粗心大意造成，但也贴出来以免大家也犯同样的错误，其实也很简单，就是忘记将publish项的$(PUBLISHDIR)替换成$(CONFFILE)了，后果就是.git文件夹被破坏。
4.5 Code block 红框问题
在提交blog时，markdown语法中的code块对中文出现红框问题，主要是因为因为Pelican是使用pygment处理代码高亮的，而pygment的高亮颜色定义就在当前使用的主题目录中的pygment.css这个文件里，要修改代码高亮的配色就要通过修改这个文件来实现。现在打开它，可以看到里面是对代码的各种类型的内容的风格定义，其中有一行如下：
.highlight .err { border: 1px solid #FF0000 } / Error /
根据内容可以看出这是规定书写错误的代码的文本样式，可是平时代码中有的字符也会被识别成错误的代码,所以就造成了代码块中时不时出现恼人的红框的问题，原因清楚了，现在要解决它就很容易了，直接删掉那行中的border样式就可以了。如果你跟我一样完全不需要给这类代码规定特殊样式的话，直接删掉那行即可。
五、总结
写了几个小时，终于把这篇博文写完了，主要是对markdown语法还不了解，边学边写，好得完成了，还有些部分是对pelican主页进行布置，这块自己也没有很多经验，以后会逐步深入，希望此篇blog能对初学者有所帮助。
备注：搭建好的博客如链接所示： www.zendwind.com