0
0
mirror of https://github.com/wagtail/wagtail.git synced 2024-11-29 01:22:07 +01:00
wagtail/README.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

149 lines
8.9 KiB
Markdown
Raw Normal View History

2018-03-14 14:59:02 +01:00
<h1 align="center">
<picture>
<source media="(prefers-color-scheme: light)" srcset=".github/wagtail.svg">
<source media="(prefers-color-scheme: dark)" srcset=".github/wagtail-inverse.svg">
<img width="343" src=".github/wagtail.svg" alt="Wagtail">
</picture>
2018-03-14 14:59:02 +01:00
</h1>
<p align="center">
<br>
<a href="https://github.com/wagtail/wagtail/actions">
<img src="https://github.com/wagtail/wagtail/workflows/Wagtail%20CI/badge.svg" alt="Build Status" />
</a>
<a href="https://opensource.org/licenses/BSD-3-Clause">
<img src="https://img.shields.io/badge/license-BSD-blue.svg" alt="License" />
</a>
<a href="https://pypi.python.org/pypi/wagtail/">
<img src="https://img.shields.io/pypi/v/wagtail.svg" alt="Version" />
</a>
<a href="https://pypi.python.org/pypi/wagtail/">
<img src="https://img.shields.io/pypi/dm/wagtail?logo=Downloads" alt="Monthly downloads" />
</a>
<a href="https://twitter.com/WagtailCMS">
<img src="https://img.shields.io/twitter/follow/WagtailCMS?style=social&logo=twitter" alt="follow on Twitter">
</a>
</p>
2018-03-14 14:59:02 +01:00
Wagtail is an open source content management system built on Django, with a strong community and commercial support. It's focused on user experience, and offers precise control for designers and developers.
![Wagtail screenshot](https://cdn.jsdelivr.net/gh/wagtail/wagtail@main/.github/wagtail-screenshot-with-browser.png)
2018-03-14 14:59:02 +01:00
### 🔥 Features
2018-03-14 14:59:02 +01:00
2022-03-16 23:04:49 +01:00
- A fast, attractive interface for authors
- Complete control over front-end design and structure
- Scales to millions of pages and thousands of editors
- Fast out of the box, cache-friendly when you need it
- Content API for 'headless' sites with decoupled front-end
2022-03-16 23:04:49 +01:00
- Runs on a Raspberry Pi or a multi-datacenter cloud platform
- StreamField encourages flexible content without compromising structure
- Powerful, integrated search, using Elasticsearch or PostgreSQL
- Excellent support for images and embedded content
- Multi-site and multi-language ready
- Embraces and extends Django
2018-03-14 14:59:02 +01:00
Find out more at [wagtail.org](https://wagtail.org/).
2018-03-14 14:59:02 +01:00
### 👉 Getting started
2018-03-14 14:59:02 +01:00
Wagtail works with [Python 3](https://www.python.org/downloads/), on any platform.
To get started with using Wagtail, run the following in a [virtual environment](https://docs.python.org/3/tutorial/venv.html):
![Installing Wagtail](.github/install-animation.gif)
```sh
pip install wagtail
wagtail start mysite
cd mysite
pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver
2018-03-14 14:59:02 +01:00
```
For detailed installation and setup docs, see [the getting started tutorial](https://docs.wagtail.org/en/stable/getting_started/tutorial.html).
2018-03-14 14:59:02 +01:00
### 👨‍👩‍👧‍👦 Whos using it?
2018-03-14 14:59:02 +01:00
Wagtail is used by [NASA](https://www.nasa.gov/), [Google](https://www.google.com/), [Oxfam](https://www.oxfam.org/en), the [NHS](https://www.nhs.uk/), [Mozilla](https://www.mozilla.org/en-US/), [MIT](https://www.mit.edu/), the [Red Cross](https://www.icrc.org/en), [Salesforce](https://www.salesforce.com/), [NBC](https://www.nbc.com/), [BMW](https://www.bmw.com/en/index.html), and the US and UK governments. Add your own Wagtail site to [madewithwagtail.org](https://madewithwagtail.org).
2018-03-14 14:59:02 +01:00
### 📖 Documentation
2018-03-14 14:59:02 +01:00
[docs.wagtail.org](https://docs.wagtail.org/) is the full reference for Wagtail, and includes guides for developers, designers and editors, alongside release notes and our roadmap.
2018-03-14 14:59:02 +01:00
For those who are **new to Wagtail**, the [Zen of Wagtail](https://docs.wagtail.org/en/stable/getting_started/the_zen_of_wagtail.html) will help you understand what Wagtail is, and what Wagtail is _not_.
**For developers** who are ready to jump in to their first Wagtail website the [Getting Started Tutorial](https://docs.wagtail.org/en/stable/getting_started/tutorial.html) will guide you through creating and editing your first page.
**Do you have an existing Django project?** The [Wagtail Integration documentation](https://docs.wagtail.org/en/stable/getting_started/integrating_into_django.html) is the best place to start.
### 📌 Compatibility
2018-03-14 14:59:02 +01:00
_(If you are reading this on GitHub, the details here may not be indicative of the current released version - please see [Compatible Django / Python versions](https://docs.wagtail.org/en/stable/releases/upgrading.html#compatible-django-python-versions) in the Wagtail documentation.)_
2018-03-14 14:59:02 +01:00
Wagtail supports:
- Django 4.2.x and 5.0.x
2023-10-04 12:36:44 +02:00
- Python 3.8, 3.9, 3.10, 3.11 and 3.12
- PostgreSQL, MySQL and SQLite (with JSON1) as database backends
2018-03-14 14:59:02 +01:00
2023-07-13 21:02:20 +02:00
[Previous versions of Wagtail](https://docs.wagtail.org/en/stable/releases/upgrading.html#compatible-django-python-versions) additionally supported Python 2.7, 3.7 and earlier Django versions.
2018-03-14 14:59:02 +01:00
---
### 📢 Community Support
2018-03-14 14:59:02 +01:00
There is an active community of Wagtail users and developers responding to questions on [Stack Overflow](https://stackoverflow.com/questions/tagged/wagtail). When posting questions, please read Stack Overflow's advice on [how to ask questions](https://stackoverflow.com/help/how-to-ask) and remember to tag your question "wagtail".
2018-03-14 14:59:02 +01:00
For topics and discussions that do not fit Stack Overflow's question and answer format we have a [Slack workspace](https://github.com/wagtail/wagtail/wiki/Slack). Please respect the time and effort of volunteers by not asking the same question in multiple places.
2018-03-14 14:59:02 +01:00
[![Join slack community](.github/join-slack-community.png)](https://github.com/wagtail/wagtail/wiki/Slack)
Our [GitHub discussion boards](https://github.com/wagtail/wagtail/discussions) are open for sharing ideas and plans for the Wagtail project.
2021-09-29 17:14:53 +02:00
2018-03-14 14:59:02 +01:00
We maintain a curated list of third party packages, articles and other resources at [Awesome Wagtail](https://github.com/springload/awesome-wagtail).
### 🧑‍💼 Commercial Support
2018-03-14 14:59:02 +01:00
Wagtail is sponsored by [Torchbox](https://torchbox.com/). If you need help implementing or hosting Wagtail, please contact us: hello@torchbox.com. See also [madewithwagtail.org/developers/](https://madewithwagtail.org/developers/) for expert Wagtail developers around the world.
### 🔐 Security
We take the security of Wagtail, and related packages we maintain, seriously. If you have found a security issue with any of our projects please email us at [security@wagtail.org](mailto:security@wagtail.org) so we can work together to find and patch the issue. We appreciate responsible disclosure with any security related issues, so please contact us first before creating a GitHub issue.
If you want to send an encrypted email (optional), the public key ID for security@wagtail.org is 0xbed227b4daf93ff9, and this public key is available from most commonly-used keyservers.
2019-04-12 16:23:25 +02:00
### 🕒 Release schedule
Feature releases of Wagtail are released every three months. Selected releases are designated as Long Term Support (LTS) releases, and will receive maintenance updates for an extended period to address any security and data-loss related issues. For dates of past and upcoming releases and support periods, see [Release Schedule](https://github.com/wagtail/wagtail/wiki/Release-schedule).
#### 🕛 Nightly releases
2019-08-28 10:40:58 +02:00
To try out the latest features before a release, we also create builds from `main` every night. You can find instructions on how to install the latest nightly release at https://releases.wagtail.org/nightly/index.html
2019-08-28 10:40:58 +02:00
### 🙋🏽 Contributing
2018-03-14 14:59:02 +01:00
If you're a Python or Django developer, fork the repo and get stuck in! We have several developer focused channels on the [Slack workspace](https://github.com/wagtail/wagtail/wiki/Slack).
2018-03-14 14:59:02 +01:00
You might like to start by reviewing the [contributing guidelines](https://docs.wagtail.org/en/latest/contributing/index.html) and checking issues with the [good first issue](https://github.com/wagtail/wagtail/labels/good%20first%20issue) label.
2018-03-14 14:59:02 +01:00
We also welcome translations for Wagtail's interface. Translation work should be submitted through [Transifex](https://explore.transifex.com/torchbox/wagtail/).
2018-03-14 14:59:02 +01:00
### 🔓 License
2022-03-16 23:04:49 +01:00
[BSD](https://github.com/wagtail/wagtail/blob/main/LICENSE) - Free to use and modify for any purpose, including both open and closed-source code.
2019-06-05 13:49:47 +02:00
### 👏 Thanks
2018-03-14 14:59:02 +01:00
2019-10-15 13:40:07 +02:00
We thank the following organisations for their services used in Wagtail's development:
[![Browserstack](https://cdn.jsdelivr.net/gh/wagtail/wagtail@main/.github/browserstack-logo.svg)](https://www.browserstack.com/)<br>
2019-10-15 13:40:07 +02:00
[BrowserStack](https://www.browserstack.com/) provides the project with free access to their live web-based browser testing tool, and automated Selenium cloud testing.
[![squash.io](https://cdn.jsdelivr.net/gh/wagtail/wagtail@main/.github/squash-logo.svg)](https://www.squash.io/)<br>
2019-10-15 13:40:07 +02:00
[Squash](https://www.squash.io/) provides the project with free test environments for reviewing pull requests.
2018-03-14 14:59:02 +01:00
[![Assistiv Labs](https://cdn.jsdelivr.net/gh/wagtail/wagtail@main/.github/assistivlabs-logo.png)](https://assistivlabs.com/)<br>
[Assistiv Labs](https://assistivlabs.com/) provides the project with unlimited access to their remote testing with assistive technologies.