在GitHub Pages上使用Pelican搭建博客的教程
Pelican介绍
首先看看Pelican的一些主要特性:
- Python实现,开放源码
- 输出静态页面,方便托管
- 支持主题,采用Jajin2模板引擎
- 支持代码语法高亮
- 支持reStructuredText、Markdown、AsciiDoc格式
- 支持Disqus评论
- 支持Atom和RSS输出
这些特性都是大爱,完全满足我对博客系统的基本需求,再配合免费无限制的GitHubPages,一切近乎完美了。
安装Pelican
开始前请自行安装Python环境,支持2.7.X和3.3+,为方便,再顺手装上distribute、pip、virtualenv。(注:我的操作系统是:Windows7)
创建Pelican虚拟环境
virtualenvPelicanEnv--distribute PelicanEnv\Scripts\activate
安装Pelican
pipinstallpelican
如果您使用Markdown来写文章的话,还需要安装Markdown库
pipinstallMarkdown
创建Blog
创建一个Blog目录
mkdirmyblog cdmyblog
快速创建Blog
pelican-quickstart
根据提示一步步输入相应的配置项,不知道如何设置的接受默认即可,后续可以通过编辑pelicanconf.py文件更改配置。
以下是生成的目录结构:
myblog/ ├──content #存放输入的源文件 │ └──(pages) #存放手工创建的静态页面 ├──output #生成的输出文件 ├──develop_server.sh #方便开启测试服务器 ├──Makefile #方便管理博客的Makefile ├──pelicanconf.py #主配置文件 └──publishconf.py #发布时使用的配置文件
撰写文章
在content目录下用Markdown语法来写一篇文章
Title:Mysupertitle Date:2010-12-0310:20 Category:Python Tags:pelican,publishing Slug:my-super-post Author:AlexisMetaireau Summary:Shortversionforindexandfeeds
Thisisthecontentofmysuperblogpost.