起步¶

注解

Wagtail 基于 Django Web 框架开发的，所以 Wagtail 的开发及安装步骤都遵从 Python Django 应用（如果对 Python Django 应用开发过程不熟悉，建议先浏览 Django web framework ）开发过程。学习或搭建一个全新的 Wagtail 网站，可以参考创建第一个 Wagtail 站点。如果需要把 Wagtail 做为一个模块增加到现有的 Django 项目, 请参考在 Django 项目中集成 Wagtail.

安装依赖的操作系统软件包及程序库¶

安装使用 Wagtail 2.x 版本，需要先安装以下依赖的操作系统程序及程序库

Python 3 软件包
Django 的 Pillow 程序库依赖操作系统的 libjpeg 和 zlib 程序库。请参考 Pillow 的各个操作系统安装操作命令.

快速安装¶

在 Python 的虚拟环境执行安装命令：

$ pip install wagtail

(在虚拟环境外的操作系统环境中安装需要在命令前增加 sudo。)

安装成功后, Wagtail 提供类似于 Django 的 django-admin startproject 命令来创建一个新的站点/项目:

$ wagtail start mysite

命令成功运行后会创建 mysite 目录, 目录中提供项目起步开发所需的样板文件。关于这些样板文件的详细说明请参考项目样板文件参考说明.

在 mysite 目录内, 执行 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 项目, 请参考在 Django 项目中集成 Wagtail。

下面几个可选的软件包可以提升网站的运行性能，虽不是必须和缺省安装的，但建议做为产品开发和正式运行时建议安装： There are a few optional packages which are not installed by default but are recommended to improve performance or add features to Wagtail, including:

Elasticsearch.

Feature Detection.