起步
========

.. note::
   Wagtail 基于 Django Web 框架开发的，所以 Wagtail 的开发及安装步骤都遵从 Python Django 应用（如果对 Python Django 应用开发过程不熟悉，建议先浏览
   `Django web framework <https://www.djangoproject.com/>`_ ）开发过程。
   学习或搭建一个全新的 Wagtail 网站，可以参考 :doc:`tutorial`。
   如果需要把 Wagtail 做为一个模块增加到现有的 Django 项目, 请参考 :doc:`integrating_into_django`.


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

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

* `Python 3 软件包 <https://www.python.org/downloads/>`_
* Django 的 **Pillow** 程序库依赖操作系统的 **libjpeg** 和 **zlib** 程序库。
  请参考 Pillow 的 `各个操作系统安装操作命令 <https://pillow.readthedocs.org/en/latest/installation.html#external-libraries>`_.


快速安装
-------------

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

.. code-block:: console

    $ pip install wagtail

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

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

.. code-block:: console

    $ wagtail start mysite

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

在 ``mysite`` 目录内, 执行 Django 项目的初始化命令:

.. code-block:: console

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

服务启动并运行成功后，网站前端页面请访问 ``http://localhost:8000``, 网站的后台管理页面请访问 ``http://localhost:8000/admin/``。

能正常访问时就意味着独立的 Wagtail 项目创建成功了。
如果需要把 Wagtail 做为一个模块增加到现有的 Django 项目, 请参考 :doc:`integrating_into_django`。

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

 * :doc:`Elasticsearch </advanced_topics/performance>`.
 * :ref:`image_feature_detection`.


.. toctree::
    :maxdepth: 1

    tutorial
    demo_site
    integrating_into_django
    the_zen_of_wagtail