Pelican是一个基于Python开发的静态网站生成程序,你可以将自己的精力集中在网站内容的创作上,然后用它来自动化生成静态网页,或者是借助特定的主题进行美化。最终可以通过FTP或是Git的方式来发布站点。这个文章翻译自Pelican官方文档,旨在提供一个上手Pelican的快速入门教程。
安装Pelican
Install Pelican (and optionally Markdown if you intend to use it) on Python 2.7.x or Python 3.3+ by running the following command in your preferred terminal, prefixing with sudo
if permissions warrant:
Pilican支持rt和markdown两种内容创作格式,同时支持Python 2.7.x和Python 3.3+两个分支,如果你在安装Python时同时选择安装pip,可以用以下命令快速进行Pelican安装。
pip install pelican markdown
创建项目
首先可以选择一个创建网站项目的路径,在命令行下进入此目录,然后输入以下命令:
mkdir -p ~/projects/yoursite
cd ~/projects/yoursite
pelican-quickstart
接下去,Pelican的向导会出现一系列的问题,让你选择站点的一些基本属性,例如站点名称、初始网址,等等。
创建文件
接着可以在Pelican创建的目录结构中创建markdown文件,一般在默认的content目录下,文件的格式如下:
Title: My First Review
Date: 2010-12-03 10:20
Category: Review
Following is a review of my favorite mechanical keyboard.
生成站点
保存好markdown文件后,再回到Pelican项目的存储根目录,输入以下命令:
pelican content
此时程序会将markdown的格式源文件生成为html文件,并复制到output目录下。
预览站点
一旦在output目录生成网站,可以进入此目录用python -m pelican.server
进行预览。默认的端口为8000,所以接下去可以在浏览器中用http://localhost:8000
进行查看。