在Window环境下用pelican搭建博客

自从不用人人网以来，一直没有一个自己的博客，最近看了wolfsonliu的gihub个人页面，发现居然是使用一种python编写叫'Pelican'的框架搭建的，看起来十分不错，也很便利，刚好自己是python萌新,于是顿时手痒了，觉得自己一定能搭建出来一个'Powerd by Pelican'的博客。

由于Pelican默认在unix类的操作系统下运行，找了找教程，基本上都不是在Windows下搭建的，于是自己琢磨了几天，也劳烦了wolfsonliu不少，总算磕磕碰碰的把博客框架搭建出来，写这篇博客算是个经验的总结

首先需要准备这些：

• Python 2.7.X安装包 - Pelican运行环境
• Pelican包 - 搭建博客的框架
• Markdown包 - 解释编写的MD文件
• Git for Windows - 用于管理自己的博客文件和推送到github
• Make for Windows - 用于在cmd终端里使用make命令，Windows下没有这个
• Markdownpad2 - 用于编写你的blog文章

然后是准备Pelican运行环境：

• 安装Python: Python的安装包很容易在Python的官方网站下载安装，不过我发现Python 3.5似乎和Pelican兼容不好，会导致无法生成HTML文件，因此不推荐使用。这里使用的是Python 2.7.11版本，在安装时一定要勾选安装pip和添加目录到系统变量PATH中以便后续使用。在安装完毕后，进入cmd终端，在命令行里输入python -V， 如果安装配置正确，则会出现当前PATH下的python版本，我显示的版本是Python 2.7.11。
• 安装Pelican包和Markdown包：前面安装了pip, pip是用于安装Python第三方包的脚本，有了它安装包十分方便，只需要在命令行里输入pip install packagename就可以了，这里要安装Pelican和Markdown,就输入pip install pelican， pip install markdown。pip会自动下载配置这两个包，十分简单。
• 安装git for Windows:由于博客文件最终还是要推送到服务器上的，而github免费提供个人域名，因此安装一个推送和管理软件很重要。git for Windows能在github的相关页面找到下载。
• 安装Make for Windows：Make是unix下常用的一个程序，可以按照一定规则构建文件，Pelican十分省心的编制了Makefile文件，能够直接使用make命令完成生成HTML页面、构建测试服务器、发布文章等常用博客维护功能，但是在一般的Windows环境里不集成Make,因此需要另外下载，安装文件可以在这里 找到。安装完成后，一定要在PATH里配置make.exe所在的路径，要不然在cmd终端还是无法使用make。
• 安装Markdownpad2: Markdown是一种简单的文本标记语法，用于在快速编写文章的同时排版文章段落格式，达到‘所想即所见’的效果，这篇文章就是用Markdown语法排版而成。Windows下常用的Markdown编辑器是Markdownpad2，能够即时预览文章，很方便。它可以在官方网站找到下载。

运行环境终于准备妥当，可以开始搭建博客了：

• 首先需要再github上注册账号，并按照指导创建一个自己的仓库，这个仓库的名字是username.github.io，是以后博客的域名。
• 在cmd终端里输入命令：pelican-quickstart,按照提示回答一系列问题，回答完毕后pelican就会告诉你已经完成了博客框架搭建了。

在搭建完毕后，pelican会自动在指定的目录下面生成如下组织的文件夹:

其中content文件夹用来放置博客的内容，如文章和图片等，output则是输出html和css文件的地方。其他几个文件中，publishconf.py和pelicanconf.py是博客的设置文件，Makefile是pelican预先帮助你编写好的make规则文件，fabfile.py也是一种fab规则文件，不过既然有了make就没什么用了。最后develop_server.sh似乎是用来开启测试服务器的配置文件，我基本没有动过这个东西。

• pelican支持套用别人做好的博客主题模板，对我这种对html和css一窍不通的人是最好不过了，在这里可以找到pelican的主题演示，找到合适的后进入相关的github页面，复制链接地址，进入git bash终端clone到本地，使用如下命令：git clone https://github.com/gilsondev/pelican-clean-blog.git来完成。

• 在clone到本地后可以在pelicanconf.py添加如下一行：THEME = 'PATH'就可以用上刚刚的下载的主题了。我由于是在Windows下，所以文件地址由左斜杠要改成右斜杠，就变成了这个样子THEME = 'D:/git-R/blog/pelican-clean-blog'。又看了看这个主题github页面的说明，嘿，居然支持自己定制封面和文章背景，于是赶紧再pelicanconf.py中加上这两行： STATIC_PATHS = ['static', 'images'], HEADER_COVER = 'static/homepage.jpg'。这样以后就能轻松的在content文件夹里直接换文章和主页背景图片了。

博客的框架有了大概，下面就可以写博客了：

• 用Markdownpad2来写博文，可以看看这篇教程来掌握Markdown的语法，十分简单便捷
• pelican要求md文件必须按照一定格式填写filemeta，得按照如下格式来写

Title: 在Window环境下用pelican搭建博客

Date: 2016-7-28 10:20

Category: self

Tags: pelican, publishing

Slug: slug1

Author: rogerclarkgc

Summary: 我在Windows下用pelican搭建了博客

• 写好的md文件放在content文件夹中，也可以建立pages和posts文件夹，把md文件放到这里面。pages里的文件会当做独立的页面处理，posts会当成一般的博文，所以可以在pages里放上自我介绍之类的玩意。

是时候发布自己的博客了！

• 由于有了make，发布博客命令变得十分简单，首先进入博客的主目录，在主目录下运行make html，就会有自动生成的html和css文件到output目录中。
• 希望预览一下博客，那是最好的，同样的输入make serve就可开启本地服务8000端口，在localhost:8000中就可以看到实际的效果。
• 几番修改，终于可以推送到github上了，打开git bash终端，进入output目录，输入如下几条命令：

  git init
  git add *
  git commit -m 'made blog'
  git remote add origin https://github.com/username/username.github.io.git
  git push -u origin master
  

这样就可以推送到github上的服务器，终于有自己博客了，折腾下来还有点麻烦，光是THEME的设置就花了我一天时间去研究，看官方文档，总算没白费心思！