kopia lustrzana https://github.com/wagtail/wagtail
109 wiersze
3.7 KiB
ReStructuredText
109 wiersze
3.7 KiB
ReStructuredText
Getting Started
|
|
---------------
|
|
|
|
On Ubuntu
|
|
~~~~~~~~~
|
|
|
|
If you have a fresh instance of Ubuntu 13.04 or 13.10, you can install Wagtail,
|
|
along with a demonstration site containing a set of standard templates and page
|
|
types, in one step. As the root user::
|
|
|
|
curl -O https://wagtail.io/ubuntu.sh; bash ubuntu.sh
|
|
|
|
This script installs all the dependencies for a production-ready Wagtail site,
|
|
including PostgreSQL, Redis, Elasticsearch, Nginx and uwsgi. We
|
|
recommend you check through the script before running it, and adapt it according
|
|
to your deployment preferences. The canonical version is at
|
|
`github.com/torchbox/wagtail/blob/master/scripts/install/ubuntu.sh
|
|
<https://github.com/torchbox/wagtail/blob/master/scripts/install/ubuntu.sh>`_.
|
|
|
|
On Debian
|
|
~~~~~~~~~
|
|
|
|
If you have a fresh instance of Debian 7, you can install Wagtail, along with a
|
|
demonstration site containing a set of standard templates and page types, in one
|
|
step. As the root user::
|
|
|
|
curl -O https://wagtail.io/debian.sh; bash debian.sh
|
|
|
|
This script installs all the dependencies for a production-ready Wagtail site,
|
|
including PostgreSQL, Redis, Elasticsearch, Nginx and uwsgi. We
|
|
recommend you check through the script before running it, and adapt it according
|
|
to your deployment preferences. The canonical version is at
|
|
`github.com/torchbox/wagtail/blob/master/scripts/install/debian.sh
|
|
<https://github.com/torchbox/wagtail/blob/master/scripts/install/debian.sh>`_.
|
|
|
|
Using Vagrant
|
|
~~~~~~~~~~~~~
|
|
|
|
We provide a Vagrant box which includes all the dependencies for a fully-fledged
|
|
Wagtail environment, bundled with a demonstration site containing a set of
|
|
standard templates and page types. If you have a good internet connection we recommend
|
|
the following steps, which will download the 650MB Vagrant box and make a running
|
|
Wagtail instance available as the basis for your new site:
|
|
|
|
- Install `Vagrant <http://www.vagrantup.com/>`_ 1.1+
|
|
- Clone the demonstration site, create the Vagrant box and initialise Wagtail::
|
|
|
|
git clone git@github.com:torchbox/wagtaildemo.git
|
|
cd wagtaildemo
|
|
vagrant up
|
|
vagrant ssh
|
|
# within the SSH session
|
|
./manage.py createsuperuser
|
|
./manage.py update_index
|
|
./manage.py runserver 0.0.0.0:8000
|
|
|
|
- This will make the app accessible on the host machine as
|
|
`localhost:8111 <http://localhost:8111>`_ - you can access the Wagtail admin
|
|
interface at `localhost:8111/admin <http://localhost:8111/admin>`_. The codebase
|
|
is located on the host machine, exported to the VM as a shared folder; code
|
|
editing and Git operations will generally be done on the host.
|
|
|
|
Other platforms
|
|
~~~~~~~~~~~~~~~
|
|
|
|
If you're not using Ubuntu or Debian, or if you prefer to install Wagtail manually,
|
|
use the following steps:
|
|
|
|
Required dependencies
|
|
=====================
|
|
|
|
- `pip`_
|
|
|
|
Optional dependencies
|
|
=====================
|
|
|
|
- `PostgreSQL`_
|
|
- `Elasticsearch`_
|
|
|
|
Installation
|
|
============
|
|
|
|
With PostgreSQL running (and configured to allow you to connect as the
|
|
'postgres' user - if not, you'll need to adjust the ``createdb`` line
|
|
and the database settings in wagtaildemo/settings/base.py accordingly),
|
|
run the following commands::
|
|
|
|
git clone https://github.com/torchbox/wagtaildemo.git
|
|
cd wagtaildemo
|
|
pip install -r requirements/dev.txt
|
|
createdb -Upostgres wagtaildemo
|
|
./manage.py syncdb
|
|
./manage.py migrate
|
|
./manage.py runserver
|
|
|
|
SQLite support
|
|
==============
|
|
|
|
SQLite is supported as an alternative to PostgreSQL - update the DATABASES setting
|
|
in wagtaildemo/settings/base.py to use 'django.db.backends.sqlite3', as you would
|
|
with a regular Django project.
|
|
|
|
.. _Wagtail: http://wagtail.io
|
|
.. _VirtualBox: https://www.virtualbox.org/
|
|
.. _the Wagtail codebase: https://github.com/torchbox/wagtail
|
|
.. _PostgreSQL: http://www.postgresql.org
|
|
.. _Elasticsearch: http://www.elasticsearch.org
|
|
.. _Pip: https://github.com/pypa/pip
|