Re:从零开始搭建静态网站——使用pelican生成静态网页

发布于 2016-10-09  324 次阅读


Pelican是Python开发的一个开源静态网页生成器,代码托管在Github。

[gt href='https://github.com/getpelican/pelican']Pelican[/gt]

搭建Pelican环境

首先安装Python和pip,Linux系统自带,Windows到Python官网下载个即可,推荐用Py3。

最好使用virtualenv或者其他工具创建一个虚拟环境并且进入虚拟环境,当然也可以不创建。

我这里是创建了虚拟环境的,以下命令都是在虚拟环境下执行。

安装Pelican

pip install pelican

安装markdown

pip install Markdown

创建网站项目

在虚拟环境创建一个文件夹,然后cd进去这个文件夹执行:

pelican-quickstart

将会出现多个没啥卵用的配置提示,可以根据实际情况填写,也可以使用默认,反正后面可以在pelicanconf.py改。

执行成功之后,会在这个文件夹下生成一堆文件,类似于:

yoursite/
├── content # 存放输入的markdown或RST源文件
│ └── (pages) # 存放手工创建的静态页面,可选
│ └── (posts) # 存放手工创建的文章,可选
├── output # 存放最终生成的静态博客
├── develop_server.sh # 测试服务器
├── Makefile # 管理博客的Makefile
├── pelicanconf.py # 配置文件
└── publishconf.py # 发布文件,可删除

选择博客主题

pelican主题随便选个喜欢的下载下来放到你网站项目下除了默认生成的文件夹以外,其他任何你喜欢的地方,我自己就新建了一个themes文件夹,将主题扔进去。

然后修改pelicanconf.py文件,添加上你的主题路径,类似于:

THEME = 'themes/YourThemesName'

添加评论系统

到Disqus申请一个Shortname,然后添加到pelicanconf.py文件,类似于:

DISQUS_SITENAME = Shortname

添加文章内容

使用markdown语法写一个.md的文件,Windows用户注意编码是utf-8,放到content文件夹下面,最好在这里建一个posts和pages文件夹以便区分。

生成静态网页

pelican content

或者

pelican content -s publishconf.py

将会在output文件夹生成一堆文件。

预览一下

cd进output文件夹执行:

python -m http.server

打开127.0.0.1:8000看看OK了没。

上传静态文件

将output文件夹内的文件上传到Github之类的玩意,这个就不用废话了吧……

至此大功告成,一个所谓极简的Geek静态网站就这样完成了,其他细节方面的问题就有待使用时细细研究了。

本来想将执行过程中的全部命令复制上来的,可惜这巨硬自信推出的垃圾Windows10时不时会出现无法唤醒的问题,强制关机了,没法了。

过两天后源码再扔到这里:

[dm href='https://chiasg.github.io/']Re:从零开始的魔法禁书目录[/dm]