入门

Wagtail 是构建于 Django web 框架 之上的，因此本文档假定已经安装好了必要的软件包。如尚未安装这些软件包，那么就要安装以下必要的软件/程序：

• Python
• pip（请注意 pip 已默认包含在Python 3.4及以后的发布中）

同时建议使用 Virtualenv, 其提供了隔离的Python环境：

• Virtualenv

要点 在安装 Wagtail 之前，有必要安装 libjpeg 与 zlib 两个库，他们提供了处理 JPEG、PNG 与 GIF 图像的支持（通过 Python 的Pillow库）。而安装这两个库的方式，则根据平台的不同而有所区别 — 请参阅 Pillow 的 特定平台安装说明。

在安装了上述库之后，安装Wagtail的最快方式就是：

若使用了 Virtualenv, 那么请运行

$python3 -m venv .venv

$ mkdir wagtail-demo && cd wagtail-demo
$. ~/.venv/bin/activate
$ pip install wagtail

在安装完毕后，Wagtail提供了一个类似于 Django 的 django-admin startproject命令，用于生成一个新的站点/项目（stubs out a new site/project）：

$ wagtail start demo

这将基于一个包含了满足起步所有需要的模板，而建立一个新的文件夹 demo。更多有关该模板的信息，请移步 这里。

此时在 demo 文件夹中，只要运行一下对于所有Django项目来说都需要的必要几步：

$ pip install -r requirements.txt
$ ./manage.py migrate
$ ./manage.py createsuperuser
$ ./manage.py runserver

现在就可以在http://localhost:8000访问到该站点了，同时在http://localhost:8000/admin出可以访问到管理后端。

这些步骤建立起来一个新的单机化的Wagtail项目。如要将Wagtail加入到某个既有的Django项目，则请参阅将Wagtail集成到Django项目中。

有一些可选pip包没有包含到默认安装，但推荐使用他们来提高性能或赋予Wagtail某些特性，包括：

• Elasticsearch
• 特性发现