在GitHub Pages上使用Pelican搭建博客的教程_Python

Pelican 介绍

首先看看 Pelican 的一些主要特性：

Python实现，开放源码
输出静态页面，方便托管
支持主题，采用Jajin2模板引擎
支持代码语法高亮
支持reStructuredText、Markdown、AsciiDoc格式
支持Disqus评论
支持Atom和RSS输出

这些特性都是大爱，完全满足我对博客系统的基本需求，再配合免费无限制的GitHub Pages，一切近乎完美了。
安装 Pelican

开始前请自行安装Python环境，支持2.7.X和3.3+，为方便，再顺手装上distribute、pip、virtualenv。(注：我的操作系统是：Windows 7)

创建Pelican虚拟环境

1 2	`virtualenv PelicanEnv --distribute` `PelicanEnv\Scripts\activate`

安装 Pelican

1	`pip` `install` `pelican`

如果您使用Markdown来写文章的话，还需要安装Markdown库

1	`pip` `install` `Markdown`

创建 Blog

创建一个 Blog 目录

1 2	`mkdir` `myblog` `cd` `myblog`

快速创建 Blog

1	`pelican-quickstart`

根据提示一步步输入相应的配置项，不知道如何设置的接受默认即可，后续可以通过编辑pelicanconf.py文件更改配置。

以下是生成的目录结构：

复制代码代码如下:

	myblog/

	├── content              # 存放输入的源文件

	│   └── (pages)          # 存放手工创建的静态页面

	├── output               # 生成的输出文件

	├── develop_server.sh    # 方便开启测试服务器

	├── Makefile             # 方便管理博客的Makefile

	├── pelicanconf.py       # 主配置文件

	└── publishconf.py       # 发布时使用的配置文件

撰写文章

在 content 目录下用 Markdown 语法来写一篇文章

复制代码代码如下:

Title: My super title
Date: 2010-12-03 10:20
Category: Python
Tags: pelican, publishing
Slug: my-super-post
Author: Alexis Metaireau
Summary: Short version for index and feeds

This is the content of my super blog post.

生成页面

1	`make` `html`

现在就可以在output目录查看生成的html文件了。

由于我的操作系统是Windows，我对Makefile做了一些修改。

									PY=python

									PELICAN=pelican

									PELICANOPTS=

									BASEDIR=$(CURDIR)

									INPUTDIR=$(BASEDIR)/content

									OUTPUTDIR=$(BASEDIR)/output

									GITHUBDIR=$(BASEDIR)/togithub

									CONFFILE=$(BASEDIR)/pelicanconf.py

									PUBLISHCONF=$(BASEDIR)/publishconf.py

									help:

									 @echo '               '

									 @echo 'Makefile for a pelican Web site       '

									 @echo '               '

									 @echo 'Usage:             '

									 @echo ' make help   print help information    '

									 @echo ' make all   (re)generate the web site   '

									 @echo ' make html   (re)generate the web site   '

									 @echo ' make clean   remove the generated files   '

									 @echo ' make cptogithub copy output files to GITHUBDIR  '

									 @echo ' make regenerate regenerate files upon modification '

									 @echo ' make serve   serve site at http://localhost:8000'

									 @echo ' make devserver  start/restart develop_server.sh '

									 @echo ' make stopserver stop local server     '

									 @echo ' make publish  generate using production settings '

									 @echo '               '

									all: html

									html: clean $(OUTPUTDIR)/index.html cptogithub

									clean:

									 @echo -n 'Cleaning............................'

									 @rm -fr $(OUTPUTDIR)

									 @mkdir $(OUTPUTDIR)

									 @echo 'Done'

									$(OUTPUTDIR)/%.html:

									 $(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)

									cptogithub:

									 @echo -n 'Copying.............................'

									 @cp -fR $(OUTPUTDIR)/* $(GITHUBDIR)

									 @echo 'Done'

									regenerate: clean

									 $(PELICAN) -r $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)

									serve:

									 cd $(OUTPUTDIR) && $(PY) -m pelican.server

									devserver:

									 $(BASEDIR)/develop_server.sh restart

									stopserver:

									 kill -9 `cat pelican.pid`

									 kill -9 `cat srv.pid`

									 @echo 'Stopped Pelican and SimpleHTTPServer processes running in background.'

									publish:

									 $(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(PUBLISHCONF) $(PELICANOPTS)

									.PHONY: help all html clean cptogithub regenerate serve devserver stopserver publish

创建 GitHub Pages

GitHub Pages分两种，一种是项目页面，可创建多个；另一种是用户页面，每个用户ID只能创建一个。两种都可以用来托管Pelican博客，这里以用户页面为例。

点击这里，新建一个Repository，Repository名字可以是 xxx.github.io 或者 xxx.github.com，其中 xxx 是您的用户ID。

创建成功以后，便可以把生成的页面push到github。

									cd output

									git init

									git add .

									git commit -m "first commit"

									git remote add origin https://github.com/xxx/xxx.github.io.git

									git push -u origin master