# 安装

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

您可以通过好几种不同的办法来安装 Pelican 。其中最简单的就是使用 [pip](http://pip-installer.org/) ：

```
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](http://pypi.python.org/pypi/Markdown) 作为标记语言，你需要安装 Markdown 库：

```
pip install Markdown
```

在设置中可以开启排版增强，但是首先需要安装依赖 [Typogrify](http://pypi.python.org/pypi/typogrify) 库：

```
pip install typogrify
```

## 依赖

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

* [feedgenerator](http://pypi.python.org/pypi/feedgenerator) 来生成 Atom feeds 。
* [jinja2](http://pypi.python.org/pypi/Jinja2) 来提供模版支持。
* [pygments](http://pypi.python.org/pypi/Pygments) 提供语法高亮。
* [docutils](http://pypi.python.org/pypi/docutils) 提供 reStructuredText 作为输入格式的支持。
* [pytz](http://pypi.python.org/pypi/pytz) 来定义时区。
* [blinker](http://pypi.python.org/pypi/blinkr) 一个对象到对象的广播信号系统。
* [unidecode](http://pypi.python.org/pypi/unidecode) 提供 ASCII 到 Unicode 文本的转换。
* [six](http://pypi.python.org/pypi/six) 来提供 Python 2 和 3 之间的兼容。
* [MarkupSafe](http://pypi.python.org/pypi/MarkupSafe) 一个安全的字符串实现。
* [python-dateutil](http://pypi.python.org/pypi/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* 文件夹添加内容来充实网站。
