安装

Pelican 当前版本应当运行在 Python 2.7.x 或者 3.4 以上版本中；更早的版本将不再被支持。

您可以通过好几种不同的办法来安装 Pelican 。其中最简单的就是使用 pip ：

pip install pelican

(请记住操作系统通常会要求您在上述命令之间加入 sudo 来系统级别的安装 Pelican。）

尽管上面是最简单的办法，但是推荐的做法是在安装之前，使用 virtualenv 来为 Pelican 创建一个虚拟环境。假设您已经安装了 virtualenv ，你可以打开一个新的终端，然后使用如下命令来为 Pelican 创建一个新的虚拟环境：

virtualenv ~/virtualenvs/pelican
cd ~/virtualenvs/pelican
source bin/activate

如上所述，一旦您创建并激活虚拟环境， Pelican 就可以通过 pip install pelican 命令来安装。或者，如果你已经有了项目的源代码，你可以使用 distutils 的办法来安装：

cd path-to-Pelican-source
python setup.py install

如果您安装了 Git 并且愿意安装最新版本的 Pelican 而非稳定版本，请使用如下命令：

pip install -e "git+https://github.com/getpelican/pelican.git#egg-pelican"

可选包

如果你打算使用 Markdown 作为标记语言，你需要安装 Markdown 库：

pip install Markdown

在设置中可以开启排版增强，但是首先需要安装依赖 Typogrify 库：

pip install typogrify

依赖

当 Pelican 被安装的时候，如下 Python 依赖包将会被自动的安装而无需更多的操作：

• feedgenerator 来生成 Atom feeds 。
• jinja2 来提供模版支持。
• pygments 提供语法高亮。
• docutils 提供 reStructuredText 作为输入格式的支持。
• pytz 来定义时区。
• blinker 一个对象到对象的广播信号系统。
• unidecode 提供 ASCII 到 Unicode 文本的转换。
• six 来提供 Python 2 和 3 之间的兼容。
• MarkupSafe 一个安全的字符串实现。
• python-dateutil 读取时间元信息。

更新

如果您通过 pip 安装了一个稳定的 Pelican 版本，并且想升级到最新的稳定版本，你可以通过添加 --upgrade 选项来做这件事：

pip install --upgrade pelican

如果您通过 distuils 安装了 Pelican 或者是最新的版本的话，请重复安装时的过程来安装最新的版本。

快速生成网站框架

一旦 Pelican 被安装，你就可以通过 pelican-quickstart 命令来构建您的网站。这个命令将会询问您一些信息。

pelican-quickstart

一旦您回答完毕这些问题，你的项目将会包括如下层级结构（ pages 除外，如果你打算创建永久页面，你可以自己创建）：

    yourproject/
    ├── content
    │   └── (pages)
    ├── output
    ├── tasks.py
    ├── Makefile
    ├── pelicanconf.py       # Main settings file
    └── publishconf.py       # Settings to use when ready to publish

下一步就是通过向已经创建了的 content 文件夹添加内容来充实网站。