2
0

README.rst 3.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. .. image:: https://travis-ci.org/torchbox/wagtail.png?branch=master
  2. :target: https://travis-ci.org/torchbox/wagtail
  3. .. image:: https://coveralls.io/repos/torchbox/wagtail/badge.png?branch=master&zxcv1
  4. :target: https://coveralls.io/r/torchbox/wagtail?branch=master
  5. .. image:: https://pypip.in/v/wagtail/badge.png?zxcv
  6. :target: https://crate.io/packages/wagtail/
  7. Wagtail CMS
  8. ===========
  9. .. image:: http://i.imgur.com/4pbWQ35.png
  10. Wagtail is a Django content management system built originally for the `Royal College of Art <http://www.rca.ac.uk/>`_ and focused on flexibility and user experience. Its features include:
  11. * A fast, attractive editor interface
  12. * Complete control over design with standard Django templates
  13. * Configure content types through standard Django models
  14. * Tightly integrated search (with an `Elasticsearch <http://www.elasticsearch.org/>`_ backend for production)
  15. * Strong document and image management
  16. * Wide support for embedded content
  17. * Simple, configurable permissions
  18. * Support for tree-based content organisation
  19. * Optional preview->submit->approve workflow
  20. * Fast out of the box. `Varnish <https://www.varnish-cache.org/>`_-friendly if you need it
  21. * A simple `form builder <http://docs.wagtail.io/en/latest/core_components/form_builder.html>`_
  22. * Optional `static site generation <http://docs.wagtail.io/en/latest/contrib_components/static_site_generation.html>`_
  23. * Excellent `test coverage <https://coveralls.io/r/torchbox/wagtail?branch=master>`_
  24. Find out more at `wagtail.io <http://wagtail.io/>`_.
  25. Got a question? Ask it on our `Google Group <https://groups.google.com/forum/#!forum/wagtail>`_.
  26. Who's using it?
  27. ~~~~~~~~~~~~~~~
  28. We've a list of public Wagtail sites here: https://github.com/torchbox/wagtail/wiki/Public-Wagtail-sites
  29. Got one of your own? Feel free to add it!
  30. Getting started
  31. ~~~~~~~~~~~~~~~
  32. * To get you up and running quickly, we've provided a demonstration site with all the configuration in place, at `github.com/torchbox/wagtaildemo <https://github.com/torchbox/wagtaildemo/>`_; see the `README <https://github.com/torchbox/wagtaildemo/blob/master/README.md>`_ for installation instructions.
  33. * See the `Getting Started <http://wagtail.readthedocs.org/en/latest/getting_started/installation.html>`_ docs for installation (with the demo app) on a fresh Debian/Ubuntu box with production-ready dependencies, on OS X and on a Vagrant box.
  34. * `Serafeim Papastefanos <https://github.com/spapas>`_ has written a `tutorial <http://spapas.github.io/2014/02/13/wagtail-tutorial/>`_ with all the steps to build a simple Wagtail site from scratch.
  35. * We've also provided a skeletal django-template to get started on a blank site: https://github.com/torchbox/wagtail-template
  36. Documentation
  37. ~~~~~~~~~~~~~
  38. Available at `wagtail.readthedocs.org <http://wagtail.readthedocs.org/>`_ and always being updated.
  39. Compatibility
  40. ~~~~~~~~~~~~~
  41. Wagtail supports Django 1.6.2+ and 1.7.0+ on Python 2.6, 2.7, 3.2, 3.3 and 3.4.
  42. Wagtail's dependencies are summarised at `requirements.io <https://requires.io/github/torchbox/wagtail/requirements>`_.
  43. Contributing
  44. ~~~~~~~~~~~~
  45. If you're a Python or Django developer, fork the repo and get stuck in!
  46. We suggest you start by checking the `Help develop me! <https://github.com/torchbox/wagtail/issues?labels=Help+develop+me%21>`_ label and the `coding guidelines <http://wagtail.readthedocs.org/en/latest/howto/contributing.html#coding-guidelines>`_.
  47. Send us a useful pull request and we'll post you a `t-shirt <https://twitter.com/WagtailCMS/status/432166799464210432/photo/1>`_.
  48. We also welcome `translations <http://wagtail.readthedocs.org/en/latest/howto/contributing.html#translations>`_ for Wagtail's interface.