Pelican使用经验总结

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

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

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

目前我知道两种方式来指定主题，一种是用"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

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

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

详细的配置参考　pelican-docs

目前我遇到的有，在配置文件中指定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 很热心地帮助我排查并发现了问题，他人很好:) !