快速启动

强烈建议您通读所有文档,但对于真正不耐烦的人,下面是一些快速入门的步骤。

安装

在python3.6+上安装Pelican(如果您想使用它,还可以选择Markdown),方法是在首选终端中运行以下命令,前缀为 sudo 如果权限许可:

python -m pip install "pelican[markdown]"

创建项目

首先,为项目选择一个名称,为站点创建一个适当命名的目录,然后切换到该目录:

mkdir -p ~/projects/yoursite
cd ~/projects/yoursite

通过 pelican-quickstart 命令,从询问有关站点的一些问题开始:

pelican-quickstart

对于在括号中有默认值的问题,可以使用Return键接受这些默认值 1. 当要求输入您的URL前缀时,请按指示输入您的域名(例如。, https://example.com

创作一篇文章

你不能运行Pelican,除非你已经创建了一些内容。使用首选文本编辑器创建第一篇文章,内容如下:

Title: My First Review
Date: 2010-12-03 10:20
Category: Review

Following is a review of my favorite mechanical keyboard.

假设本示例文章采用降价格式,请将其另存为 ~/projects/yoursite/content/keyboard-review.md .

生成网站

在项目根目录中,运行 pelican 生成站点的命令:

pelican content

你的站点现在已经在 output/ 目录。(您可能会看到与feed相关的警告,但在本地开发时这是正常的,暂时可以忽略它。)

预览网站

打开新的终端会话,导航到项目根目录,然后运行以下命令以启动Pelican的web服务器:

pelican --listen

通过导航到预览网站 http://localhost:8000/ 在您的浏览器中。

继续阅读其他文档部分以获取更多详细信息,并查看Pelican wiki的 Tutorials 指向社区发布教程的链接的页面。

脚注

1

您可以通过安装可选的 tzlocal 模块。