【Python】pelican+git建立博客
世界Skill
概述
本博客搭建于github上，github官方推荐的搭建环境是ruby下的jekyll，但由于博主用python有些经验，所以最终还是选择了python下的pelican作为搭建环境。
本博客的搭建实在许多教程的指导下完成的，也饶了一些路子，这里就把搭建的过程简单描述一下。
观看此文章要求：掌握基本的git操作，已经了解Python的基本操作，但并不需要了解Python的具体编程实现。
博主在写技术类文章比较喜欢条条框框，因为这种表达形式可以用较为简洁的方式让逻辑显得比较清晰。
搭建步骤
按照下列步骤操作前，请先安装python2.7以上的版本以及git.
1.Git远端：
首先，我们需要在Github上创建一个repository,建议将其名称命名为username.github.com（username为你的用户名），并按照项目指引，在下一个页面选择自动生成一个模板。这些操作结束后，便可以在地址栏输入你的工程名来预览你的博客了。Git远端准备完毕后，便可以在本地开始博客的搭建了。
2.pip安装：
首先，为了之后的使用方便，建议先安装pip,可以在这里下载。下载解压后，用管理员身份打开cmd，cd到pip的解压目录，输入指令：
python setup.py install
安装完成后就可以使用pip来简单地安装python的插件了，这里建议在环境变量里加入./python/script的绝对路劲。
3.安装环境必要插件：
同样以管理员身份打开cmd，输入指令安装pelican：
pip install pelican
等待安装完毕，再输入指令安装Markdown：
pip install Markdown
等待安装完毕，至此插件安装完成。
4.建立Blog目录：
首先在任意路径创立一个文件夹，用于存放你Blog的本地数据，然后cd到这个文件夹的目录，执行指令：
pelican -quickstart
这个指令是快速创建博客的指令，按照它的指示一步一步选择即可。
选择结束后，目录下便会出现如下文件或者文件夹：
myblog
├── content # 存放输入的源文件
│ └── (pages) # 存放手工创建的静态页面
├── output # 生成的输出文件
├── develop_server.sh # 方便开启测试服务器
├── Makefile # 方便管理博客的Makefile
├── pelicanconf.py # 主配置文件
└── publishconf.py # 发布时使用的配置文件
其中我们一般最常用的目录是content，它用来存放我们的md文件（也就是每一篇博客文件）。其次，我们主要还会用到pelicanconf.py来配置我们的博客主题等等内容。
5.pelicanconf.py常用配置：
以下记录了博主用到过的一些自定义配置：
AUTHOR = u'dtysky' #博客作者
SITENAME = u'一瞬之光，漫寂之暗' #博客标题
SITESUBTITLE = u'自由地看待世界，自由地看待自己。' #博客子标题
SITEURL = 'http://dtysky.github.io/' #主页地址
DEFAULT_DATE='fs'#快速获取本地时间作为文章发表时间
DEFAULT_DATE_FORMAT = '%Y %B %d %a' #使用“年月日时”的时间显示方式
TIMEZONE = 'Asia/Shanghai' #默认时区，亚洲上海，其他时区可查看国际标准
DEFAULT_LANG = u'zh' #默认语言为中文
USE_FOLDER_AS_CATEGORY = True #将**content**下的文件夹作为分类，博主目前测试仅可为md文件的所在目录，不支持子分类
PLUGIN_PATH = "D:\Poetic_Being\MyBlog\MyPlugins" #插件路径声明
PLUGINS = ["assets"] #插件使用列表
THEME = 'gum' #使用主题
主题的安装方法：
pelican-themes -i 主题路径
可以使用以下指令检查安装的主题:
pelican-themes -l
也可以直接给THEME赋一个主题文件夹路径。
5.博客文件编写：
我们使用的是Markdown语言来编写博客文件，所以需要了解一些基本的语法，不过由于Markdown语言本身就是为了书写而创造的，所以非常简单。
在这之前，我们先来了解一下pelican中md文件的特殊语句：
Title: My super title #文章标题
Date: 2010-12-03 10:20 #文章时间，如果前面设定过可忽略
Tags: thats, awesome #文章标签
Category: yeah #文章分类
Authors: Alexis Metaireau #文章作者，缺省为博客作者
Summary: Short version for index and feeds #文章概括
Markdown的具体语法可以自己慢慢学习，以下列出常用的几个符号：
'===' #加在大标题下面
'---' #加在小标题下面
'* ' #强调一
'* **' #强调二
'>' #标注
'>>' #二级标注
'[name]+(link)'(去掉'+') #插入连接
'![name]+(link)'(去掉'+') #插入图片
一些html的标记
6.生成Html和上传到github：
首先打开博客目录下的output文件夹，初始化git。
然后打开Git Bash,输入指令清空所有文件：
git -rm -r *
git add .
而后将改动push到Git远端的master分支下（默认分支，必须）。
接下来，继续打开管理员模式下的cmd，cd到博客目录下执行：
pelican content
等待执行完成，html文件就生成成功了。接下来只要进入output目录，将方才的改动缓存，然后push到远端即可。
7.更多：
如果要求不高，按照以上操作便可以生成一个简单的博客了，需要更多自定义内容的，可以参考官方的文档。