用Pelican搭建一个极简静态博客系统

By 刘志军 , 2019-07-18, 分类: python技术

pelican

我一直建议每个开发者都要有写博客记笔记的习惯,一来可以沉淀知识,二来可以帮助别人,我使用过很多博客平台,也用Python开发过博客系统,就这么个东西折腾好几年,一直找不到理想的产品,直到我用Pelican之前。

Pelican 是基于Python实现的开源静态博客系统,所谓静态博客系统就是无需数据库,每一篇文章会事先渲染成HTML静态文件,访问速度非常快。所以今天给大家介绍下怎么使用Pelican。

使用Pelican 你需要了解一点git,熟悉基本的Linux shell 命令,懂一点Python知识,如果都不懂,没关系,只要确保你已经安装了Python环境,跟着我的步骤来

安装 pelican

pip install "pelican[markdown]"

创建项目

D:\my>mkdir blog  # 创建项目目录

D:\my>cd blog # 进入项目目录

D:\my\blog>pelican-quickstart  # 生成pelican骨架
Welcome to pelican-quickstart v3.7.1.

This script will help you create a new Pelican-based website.

Please answer the following questions so this script can generate the files
needed by Pelican.
...
Done. Your new project is available at D:\my\blog

安装过程过,会有很多需要你输入的配置项,如果不知道怎么填就直接忽略或者选择n,因为这些配置项在后面可以自己手动再添加的。

创建完成后生成的目录结构如下:

.
├── Makefile
├── content/
├── develop_server.sh
├── fabfile.py
├── output/
├── pelicanconf.py
└── publishconf.py

你的文章需要保存在content目录下,通常情况我们写文章采用markdown语法,所以,现在我们在content目录创建一篇文章,文章内容:

Title: 这是我的第一篇技术博客
Date: 2019-04-24 13:47:06
Category: 技术
Tags: python
Slug: hello-world
Summary: 这是我的第一篇技术博客欢迎捧场


这是我的第一篇技术博客欢迎捧场第一次写文章还没想好怎么写所有就随便写了一点儿

将文章保存在 D:\my\blog\content\hello_world.md

生成静态文件

上面编写的内容只是我们的原始文章,最终需要经过 Pelican 的处理生成一个html格式的静态文件对外提供访问。

pelican content

执行完成后,output 目录会多出一些文件,markdown文件最终也会转换成html文件放到该目录下。

启动服务

Pelican 自己内置了一个HTTP Server,所以即使不需要Nginx也可以将程序运行起来。

pelican --listen

启动 http 服务,默认端口是8000,访问:http://localhost:8000/

微信截图_20190428120554.png

文档地址:


关注公众号「Python之禅」,回复「1024」免费获取Python资源

python之禅