A Django content management system focused on flexibility and user experience
Find a file
Matt Westcott bd6a7c768f Use the live database record as the result of get_latest_revision_as_page if there are no draft edits.
This ensures that the live database state will be reflected in the page editor, which provides two benefits:
* any changes made directly at the model / database level (e.g. automated data imports) will be visible in the editor
* inline child objects will be associated with their actual database IDs even if this information is missing from the revision record. This ensures that their IDs will be preserved on next publish, rather than the records being deleted and recreated (#1853)
2015-10-29 17:16:07 +00:00
.tx Added transifex config for wagtailstyleguide 2015-08-26 15:07:39 +01:00
docs Release note for #1718 2015-10-29 00:12:02 +00:00
etc etc: add sample uwsgi and nginx configuration files 2015-05-01 15:02:29 +01:00
gulpfile.js static path for wagtail.contrib.settings should be 'wagtailsettings' to avoid name clashes 2015-10-23 11:33:48 +01:00
scripts Fix typo in fetch-translations.sh 2015-08-26 14:29:26 +01:00
wagtail Use the live database record as the result of get_latest_revision_as_page if there are no draft edits. 2015-10-29 17:16:07 +00:00
.coveragerc Exclude south_migrations from test coverage 2014-08-28 10:33:42 +01:00
.gitignore Add /build to .gitignore 2015-06-19 09:31:07 +01:00
.jscsrc linted 2015-09-01 16:49:03 +01:00
.scss-lint.yml added css guidelines 2015-04-16 17:09:13 +12:00
.travis.yml Use Travis pip cache 2015-10-27 17:19:32 +00:00
CHANGELOG.txt Release note for #1718 2015-10-29 00:12:02 +00:00
CONTRIBUTORS.rst Release note for #1869 2015-10-27 11:19:44 +00:00
LICENSE Add an initially empty django-wagtail package 2014-01-22 12:27:23 +00:00
Makefile add a general test runner for wagtail, accessible by running './runtests.py' or 'make test' from the wagtail repo, or 'manage.py test wagtail' from a django project such as wagtaildemo 2014-02-13 12:44:49 +00:00
MANIFEST.in include new top-level text files in manifest 2014-02-07 15:57:54 +00:00
package.json Update gulp-sass to 2.0.x 2015-10-21 12:19:24 +03:00
README.rst Fixed link to form builder docs 2015-07-09 20:47:46 +02:00
requirements-dev.txt Remove django-sendfile from requirements and test settings 2015-06-04 22:15:01 +01:00
runtests.py Ignore ResourceWarnings 2015-10-29 10:21:56 +00:00
setup.cfg Use universal wheel files 2015-06-03 10:08:21 +01:00
setup.py Fix bug where built assets may not be packaged 2015-10-14 10:58:07 +11:00
tox.ini Use six from Django, remove six from tox.ini 2015-10-27 16:37:05 +11:00

.. image:: https://api.travis-ci.org/torchbox/wagtail.svg?branch=master
    :target: https://travis-ci.org/torchbox/wagtail
.. image:: https://img.shields.io/pypi/l/wagtail.svg
    :target: https://pypi.python.org/pypi/wagtail/
.. image:: https://img.shields.io/pypi/v/wagtail.svg
    :target: https://crate.io/packages/wagtail/
.. image:: https://coveralls.io/repos/torchbox/wagtail/badge.svg?branch=master
    :target: https://coveralls.io/r/torchbox/wagtail?branch=master

Wagtail CMS
===========

Wagtail is a content management system built on Django. It's focused on user experience,
and offers precise control for designers and developers.

.. image:: http://i.imgur.com/U5MDa0l.jpg
   :width: 728 px

Features
~~~~~~~~

* A fast, attractive interface for authors and editors
* Complete control over design with standard Django templates
* Configure content types through standard Django models
* Fast out of the box. Cache-friendly if you need it
* Tightly integrated search
* Strong document and image management
* Wide support for embedded content
* Straightforward integration with existing Django apps
* Simple, configurable permissions
* Workflow support
* An extensible `form builder <http://docs.wagtail.io/en/latest/reference/contrib/forms.html>`_
* Multi-site and multi-language support
* Optional `static site generation <http://docs.wagtail.io/en/latest/reference/contrib/staticsitegen.html>`_
* Excellent `test coverage <https://coveralls.io/r/torchbox/wagtail?branch=master>`_

Find out more at `wagtail.io <http://wagtail.io/>`_.

Getting started
~~~~~~~~~~~~~~~
    .. code-block::

     pip install wagtail
     wagtail start mysite
     cd mysite
     python manage.py migrate
     python manage.py createsuperuser
     python manage.py runserver

then sign in at http://127.0.0.1:8000/admin/

For detailed installation and setup docs, see `docs.wagtail.io <http://docs.wagtail.io/>`_.

Who's using it?
~~~~~~~~~~~~~~~
`madewithwagtail.org <http://madewithwagtail.org>`_ lists some of the public Wagtail sites we know about; please `add your own <http://madewithwagtail.org/submit/>`_.

Documentation
~~~~~~~~~~~~~
`docs.wagtail.io <http://docs.wagtail.io/>`_ is the full reference for Wagtail, and includes guides for developers, designers and editors, alongside release notes and our roadmap.

Community Support
~~~~~~~~~~~~~~~~~
Ask your questions on our `Wagtail support group <https://groups.google.com/forum/#!forum/wagtail>`_.

Commercial Support
~~~~~~~~~~~~~~~~~~
Wagtail is sponsored by `Torchbox <https://torchbox.com/>`_. If you need help implementing or hosting Wagtail, please contact us: hello@torchbox.com.

Compatibility
~~~~~~~~~~~~~
Wagtail supports Django 1.7.1+ on Python 2.7, 3.3 and 3.4. Supported database backends are PostgreSQL, MySQL and SQLite.

Contributing
~~~~~~~~~~~~
If you're a Python or Django developer, fork the repo and get stuck in! We run a separate group for developers of Wagtail itself at https://groups.google.com/forum/#!forum/wagtail-developers (please note that this is not for support requests).

You might like to start by reviewing the `coding guidelines <http://docs.wagtail.io/en/latest/contributing/developing.html#coding-guidelines>`_ and checking issues with the `Ready to develop <https://github.com/torchbox/wagtail/issues?q=is%3Aopen+is%3Aissue+label%3A%22Ready+to+develop%21%22>`_ label.

Send us a particularly useful pull request and we'll post you a `t-shirt <https://twitter.com/WagtailCMS/status/432166799464210432/photo/1>`_.

We also welcome translations for Wagtail's interface. Translation work should be submitted through `Transifex <https://www.transifex.com/projects/p/wagtail/>`_.