上手使用pelican

Last updated: 2021-10-23

这应该是我第一次真的把自己写的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, 等等
  • 适合博客

坏处

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

暂时先这样