上手使用pelican

这应该是我第一次真的把自己写的memo整理成blog. 记录一下pelican的安装和使用.

先牢骚一句: 文档不太行

安装pelican¶

我的环境

• Manjaro Linux
• python 3.9
• pipenv

pipenv install "pelican[markdown]"  # 即安装pelican和对应mardown插件, 默认是支持rst的

使用¶

下面记录一下如何get started, 不过在此之前, 先大致过一遍基于pelican的博客结构

一个基于pelican的博客的主要组件包括:

• pelican程序本身
• 模板/主题(theme, template则是theme的一部分, 毕竟是jinja2模板)
• 文档(content)
• 项目配置文件(perlicanconf.py, publishconf.py)
• 插件(如果有)

其中直接影响博客观感的是模板,项目配置文件,以及插件.

下面开始

按官方文档来, 装好pelican后, 执行pelican-quickstart, 回答一系列问题(对生成的文件影响不大, 修改起来也很容易).

然后执行make devserver或者pelican -lr就能启动自动重载文件的测试服务器了.

注意点是:

• perlicanconf.py里的SITEURL写本地测试服务器地址, 而publishconf.py写待部署服务器域名地址(记得加上https)
• 配置文件控制的并不多, 实际上全看博客主题怎么写的
• 配置文件里的变量对整个主题来说, 是全局变量
• pelican官方文档里有一些缺漏, 比如缺少某个配置变量的说明
• 很多主题/插件都很老, 可能有不少问题.

pelican优劣分析¶

好处¶

• python实现
• 静态
• 支持md
• 支持tag, category, archive, 等等
• 适合博客

坏处¶

• 更新没那么频繁
• 主题没那么丰富, 甚至有点坑(很老)

暂时先这样