注意
这些指导假设你熟悉虚拟环境和 Django web 框架。有关更详细的说明,请参阅你的第一个 Wagtail 网站。要将 Wagtail 添加到现有的 Django 项目中,请参阅将 Wagtail 集成到 Django 项目中

安装所需的依赖项

安装 Wagtail

在您选择的虚拟环境中运行以下命令:

pip install wagtail

安装后,Wagtail 提供了一个 Wagtail start 命令来生成一个新项目:

wagtail start mysite

运行该命令将创建一个新文件夹 mysite,该文件夹是一个模板,包含开始项目所需的所有内容。有关此模板的更多信息,请参见项目模板参考。

在你的 mysite 文件夹中,运行 Django 项目所需的设置步骤:

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

您的站点现在可以通过 http://localhost:8000 访问,管理端可以通过 http://localhost:8000/admin/ 访问。

这将为您创建一个新的独立 Wagtail 项目。如果你想将 Wagtail 添加到现有的 Django 项目中,请参见将 Wagtail 集成到 Django 项目中

有一些可选的软件包默认是不安装的。您可以安装它们以提高性能或为 Wagtail 添加功能。这些可选软件包包括:

  • Elasticsearch
  • Feature Detection

常见的快速安装问题

Python在 path 中不可用

python
> command not found: python

有关详细指导,请参阅如何将 Python 添加到您的路径的指南。

Python3 不可用

python3 -m pip install --upgrade pip
> command not found: python3

如果发生此错误,可以将 python3 替换为 py