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文件更改配置。
以下是生成的目录结构:
├── content # 存放输入的源文件
│ └── (pages) # 存放手工创建的静态页面
├── output # 生成的输出文件
├── develop_server.sh # 方便开启测试服务器
├── Makefile # 方便管理博客的Makefile
├── pelicanconf.py # 主配置文件
└── publishconf.py # 发布时使用的配置文件
撰写文章
在 content 目录下用 Markdown 语法来写一篇文章
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做了一些修改。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
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 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。
1
2
3
4
5
6
|
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
|
现在可以通过 xxx.github.io 或者 xxx.github.com 来访问您的博客了。
域名绑定
在repo的根目录下面,新建一个名为CNAME的文本文件,里面写入你要绑定的域名,比如*域名 example.com 或者二级域名 xxx.example.com。
如果绑定的是*域名,则DNS要新建一条A记录,指向 204.232.175.78。
如果绑定的是二级域名,则DNS要新建一条CNAME记录,指向 xxx.github.io 或者 xxx.github.com 。
以我的为例:
CNAME文件
www.dongxf.com
DNSPod上设置
在浏览器地址栏中输入以下链接,都将跳转指向 http://www.dongxf.com/
http://dongxf.com/
http://www.dongxf.com/
http://blog.dongxf.com/
http://dongdxf.github.io/
http://dongdxf.github.com/
未尽事宜
其他内容请参考 Pelican官方文档 。我正在翻译这个文档,才刚开始,进展缓慢。请点击 Pelican文档中文版 访问,欢迎提出宝贵意见和建议。