使用Pelican打造静态博客

前面有文章介绍本站采用了Python编写的Pelican静态生成博客系统, 之所以没有使用当前很火的Jekyll, 是因为它是Ruby编写, 而我又对Ruby没有啥兴趣, 所以还是选择了使用了我熟悉的Python编写的这套系统, 我用了一段时间,打算将使用经验分享出来

介绍

Pelican是一套开源的使用Python编写的博客静态生成, 可以添加文章和和创建页面, 可以使用MarkDown reStructuredTextAsiiDoc 的格式来抒写, 同时使用 Disqus评论系统, 支持 RSSAtom输出, 插件, 主题, 代码高亮等功能, 采用Jajin2模板引擎, 可以很容易的更改模板

安装

可以从github克隆最新的代码安装, 并且建议在virtualenv下使用:

建立 virtualenv

virtualenv pelican      # 创建
cd pelican
sh bin/activate            # 激活虚拟环境

上面建立了一个Python的虚拟环境(这个命令不是内置可以使用 easy_install virtualenv 安装)

从github克隆最新代码安装Pelican

git clone git://github.com/getpelican/pelican.git            # 代码
cd pelican
python setup.py install

上面步骤完成后就安装了Pelican

开始一个博客

mkdir /path/to/your/blog
cd /path/to/your/blog
pelican-quickstart

在回答一系列问题过后你的博客就建成的, 主要生成下列文件:

.
|-- content                # 所有文章放于此目录
|-- develop_server.sh      # 用于开启测试服务器
|-- Makefile               # 方便管理博客的Makefile
|-- output                 # 静态生成文件
|-- pelicanconf.py         # 配置文件
|-- publishconf.py         # 配置文件

写一篇文章

content 目录新建一个 test.md文件, 填入一下内容:

Title: 文章标题
Date: 2013-04-18
Category: 文章类别
Tag: 标签1, 标签2

这里是内容

然后执行:

make html

用以生成html

然后执行

./develop_server.sh start

开启一个测试服务器, 这会在本地 8000 端口建立一个测试web服务器, 可以使用浏览器打开:http://localhost:8000来访问这个测试服务器, 然后就可以欣赏到你的博客了

创建一个页面

这里以创建 About页面为例

content目录创建pages目录

mkdir content/pages

然后创建About.md并填入下面内容

Title: About Me
Date: 2013-04-18

About me content

执行 make html 生成html, 然后打开 http://localhost:8000查看效果

让Pelican支持评论

Pelican 使用Disqus评论, 可以申请在Disqus上申请一个站点, 然后在pelicanconf.py里添加或修改DISQUS_SITENAME项:

DISQUS_SITENAME = u"linuxzen"

执行

make html

浏览器打开 http://localhost:8000查看效果

更换主题

Pelican本身也提供了一些主题可供选择, 可以从github克隆下来

git clone git://github.com/getpelican/pelican-themes.git     # 主题

然后在里面找到想要的主题, 然后拷到博客项目当前目录, 这里已neat为例

cp -r /path/to/themes/from/github/neat .

然后在 pelicanconf.py 配置文件里添加或修改 THEME项为 neat

THEME = "neat"

重新执行

make html

然后打开 http://localhost:8000 查看效果

使用插件

Pelican 一开始是将插件内置的, 但是新版本 Pelican将插件隔离了出来, 所以我们要到github上 克隆一份新的插件, 在博客目录执行

git clone git://github.com/getpelican/pelican-plugins.git    # 插件

现在我们博客目录就新添了一个 pelican-plugins目录, 我们已配置sitemap插件为例, sitemap插件可以生成 sitemap.xml 供搜索引擎使用

pelicanconf.py配置文件里加上如下项:

PLUGIN_PATH = u"pelican-plugins"

PLUGINS = ["sitemap"]

## 配置sitemap 插件
SITEMAP = {
    "format": "xml",
    "priorities": {
        "articles": 0.7,
        "indexes": 0.5,
        "pages": 0.3,
    },
    "changefreqs": {
        "articles": "monthly",
        "indexes": "daily",
        "pages": "monthly",
    }
}

然后再执行

make html

打开浏览器请求 http://localhost:8000/sitemap.xml即可看到生成的 Sitemap 了

拷贝静态文件

如果我们定义静态的文件, 该如何将它在每次生成的时候拷贝到 output 目录呢, 我们以robots.txt 为例, 在我们的 content/extra 下面我们放了一个定义好的 robots.txt文件, 在pelicanconf.py更改或添加 FILES_TO_COPY项:

FILES_TO_COPY = (
    ("extra/robots.txt", "robots.txt"),
)

这样在每次生成html的时候都会把 content/extra下的 robots.txt 拷贝到 output目录下

拷贝静态目录

如果是一个静目录怎么办? 我们可以在pelicanconf.py里添加或修改 STATIC_PATHS项, 比如我们有个img目录用来放文章所使用的图片, 我们可以在pelicanconf.py添加

STATIC_PATHS = [u"img"]

然后执行

make html

然后 Pelican 就会将 img目录拷贝到 output/static/

部署

上面都弄完之后你就可以得到一个功能健全的博客系统, 接下来就是部署到服务器, 上传到服务器并结合nginx或者apache等web服务器部署这里就不在详述

参考

如果还有其他问题请参考官方手册

Show Comments