快速开始¶
强烈建议将所有文档完整地看一遍,但如果您目前没空,下面的步骤可以帮助您快速开始使用Pelican。
安装¶
在命令行中执行下面的命令以安装Pelican(如果您需要Markdown支持的话,也可以同时安装之)。Pelican需要使用 >=3.11 以上版本的Python。在必要情况下,请在命令前加上 sudo 。
python -m pip install "pelican[markdown]"
创建项目¶
首先,给您的项目想个名字,并以合适的名字创建一个文件夹来存放您的站点。接着,进入这个新创建的文件夹:
mkdir -p ~/projects/yoursite
cd ~/projects/yoursite
通过 pelican-quickstart 命令创建一个项目的框架,执行这个命令后,您需要输入一些站点相关的信息:
pelican-quickstart
对于那些在括号中写了默认值的问题,完全可以直接回车以使用预设值 [1]。在输入站点URL的前缀(prefix)时,请根据提示的格式输入站点的域名(例如 https://example.com)。
创作文章¶
您可以使用喜欢的文本编辑器来创建第一篇文章。下面是一个样例,可以将它作为您的第一篇文章:
Title: My First Review
Date: 2010-12-03 10:20
Category: Review
Following is a review of my favorite mechanical keyboard.
上面这篇文章是以Markdown的格式完成的,一定要将其保存在站点目录的content文件夹下,例如 ~/projects/yoursite/content/keyboard-review.md。
生成站点¶
在项目的根目录下,直接运行命令 pelican 就可以生成您自己的站点了:
pelican content
站点会生成在 output/ 目录下。(此时可能会显示和feeds有关的警告,这和当前的本地开发环境有关,目前可以忽略之)
预览站点¶
打开一个新的命令行,进入刚才项目的根目录,执行下面的命令以运行一个Pelican web服务器:
pelican --listen
打开浏览器,进入 http://localhost:8000/ 就可以看到刚刚生成的站点了。
请继续阅读文档中的其他部分来了解Pelican的更多用法,也可以前往Pelican的wiki 教程 页面获取社区发布的教程。