Published: 2015-10-13

Pelican使用经验总结

Table of Contents

1 概述

之前一段时间折腾了用pelican生成这个github博客,总结下经验和遇到的问题

环境 : pelican3.6, virtualwrapper, python 2.7.6, ubuntu 14.04

首先我在 pelicanthemes.com 上挑选了喜欢的主题,喜欢上了 jesuislibreiris. 试用"jesuislibre"时, 发现 "tags"页面没法正确生成,而且行内code样式不是很好,而iris 如果标题过长会是排版错乱,代码块的代码会溢出等问题,只能放弃选择了另外一个主题tuxlitetbs ,用起来还不错。

2 pelican 主题安装

目前我知道两种方式来指定主题,一种是用"pelican-themes"命令来安装并且指定,如下:

(pelican3.6)nisen@R428:~/test $ pelican-themes -vi ../pelican-themes/elegant
Installing themes...
Copying `../pelican-themes/elegant' to `/home/nisen/.virtualenvs/pelican3.6/local/lib/python2.7/site-packages/pelican/themes/elegant' ...

这种安装方式,把"elegent"主题复制到系统环境(我这儿为虚拟环境)下的python下的pelican主题里。这样只要在pelicanconf.py里直接指定就可以,比如 THEME = "elegant' pelican就能找到该主题了。

另外一种方式是直接在"pelicanconf.py"里指定主题路径,如: THEME = '/home/nisen/path/to/elegant' ,这样pelican也可以找到该主题。

更详细的可以参考 : pelican-themes

3 pelican 一些命令

通常,刚开始创建pelican项目时,可以用 pelican-quickstart ,然后在提示下选择你想要的配置(当然,配置可以后来在文件中更改)。创建好项目后,在content里创建内容,我用的是"Markdown"语法写的,markdown语法可以参考这篇文章 markdown语法说明

内容创建好后在project目录下运行 pelican content ,即可在"output"目录下生成内容。当然也可以在命令行指定配置文件或者内容目录等。 想查看生成的页面,可以到"output/"目录下,运行 python -m pelican.server ,然后打开浏览器访问 http://localhost:8000/ 即可

详细的配置参考 pelican-docs

4 pelican 3.3和pelican 3.6的差别

目前我遇到的有,在配置文件中指定plugin时有差别:

#pelican version 3.3
PLUGIN_PATH = 'pelican-plugins'
PLUGINS = ['summary','sitemap']


#pelican version 3.6
PLUGIN_PATHS = ['pelican-plugins']
PLUGINS = ['summary','sitemap']

Pelican 3.6里可以指定多个 PLUGIN_PATH,所以加了复数,并且值变成了列表类型

ps:某些主题对不同版本效果可能不一样,这点你可能需要额外注意。之前我遇到的 jesuislibre  主题在pelican 3.3,3.4,3.5都可以正确生成"tags.html",而在pelican3.6就是不行。虽然我很喜欢jesuislibre 的风格,但当代码太长没有自动换行或添加滑动栏以及行内的code字体过大影响视觉效果(因为我行内嵌入了很多代码)等问题没有使用。但是我很是要非常感谢jesuislibre 作者 BrunoAdele 很热心地帮助我排查并发现了问题,他人很好:) !

Author: Nisen

Email: imnisenATgmailDOTcom

Emacs 25.2.1 (Org mode 8.2.10)