基于 Python 知名 Web 框架 Django 实现的无头内容管理系统,拥有清爽的 UI 和简洁易用的编辑器。独特的 StreamField 技术,可以让内容排版灵活又不失结构,再加上强大的多语言系统,让它在众多开源 CMS 中脱颖而出。

dependabot[bot] ccf6ec15f7 Bump minimatch from 3.0.4 to 3.1.2 in /client/tests/integration 6 days ago
.circleci 5c1c2c8f53 Enforce the use of a single string formatting mechanism for translation source strings 6 days ago
.github c108de2bb5 Fix logo in README not being visible in high-contrast mode. Fix #8160 2 weeks ago
.tx ab825eeb56 Add wagtailadminjs resource to transifex config 7 months ago
client ccf6ec15f7 Bump minimatch from 3.0.4 to 3.1.2 in /client/tests/integration 4 days ago
docs beab3d4e7f Fixup: remove conflict marker from bf217a54fb 4 days ago
etc dd42d91663 Release note / additional fix for #6339 2 years ago
scripts 1af0815af0 Update latest.txt to reference 4.1.1 3 weeks ago
wagtail 56d0fe8fbc Update translations placeholder names 6 days ago
.coveragerc 314a926f75 Update Python and JS test coverage collection to exclude tests 2 years ago
.editorconfig 6dae6e5d07 Add and configure black 9 months ago
.eslintignore cad419ea9e Prettier linting - clean up ignored file (search promotions) 3 weeks ago
.eslintrc.js 731f96e9a8 Removed no plus plus eslint rule and fixed errors from linting 1 week ago
.git-blame-ignore-revs f16d29e788 Add black reformatting commit SHA to .git-blame-ignore-revs 9 months ago
.gitignore 44fd1852ee Trial browser tests in CircleCI 10 months ago
.nvmrc f362377b04 update node usage to node 18 1 month ago
.pre-commit-config.yaml 5c1c2c8f53 Enforce the use of a single string formatting mechanism for translation source strings 6 days ago
.prettierignore cad419ea9e Prettier linting - clean up ignored file (search promotions) 3 weeks ago
.readthedocs.yml af942a27e4 Reformat codebase with Prettier (#7912) 10 months ago
.semgrep.yml 5c1c2c8f53 Enforce the use of a single string formatting mechanism for translation source strings 6 days ago
.squash.yml f362377b04 update node usage to node 18 1 month ago
.stylelintignore 23bc6b2670 Upgrade to latest Sass and stylelint configuration, with needed refactorings 10 months ago
.stylelintrc.js 4f94c9ea20 Allow all CSS system colors in stylesheets without variables usage (#8945) 4 months ago
CHANGELOG.txt bf217a54fb Use the correct padding for autocomplete block picker 4 days ago
CODE_OF_CONDUCT.md 6d0659333d fix spelling - behaviour vs behavior 6 months ago
CONTRIBUTORS.rst c7a5e9a959 Add missing kwargs to the send_mail helper 1 week ago
LICENSE a3f2748c5d Makes LICENSE recognized by GitHub. 3 years ago
MANIFEST.in f0bb578f68 Wagtail packaging fixes (#8030) 9 months ago
Makefile 5c1c2c8f53 Enforce the use of a single string formatting mechanism for translation source strings 6 days ago
README.md 7705b080a0 Add formal support for Python 3.11 1 month ago
SECURITY.md fbcdf89bc3 Add a security.txt file 2 months ago
SPONSORS.md 0012c344d9 auto-format core markdown files (#8603) 6 months ago
codecov.yml 1f3605b98a chore(ci): add informational Codecov status checks 6 months ago
conftest.py 0fd99886a2 Move tests to test 8 months ago
package-lock.json 95b42745a2 Bump minimatch from 3.0.4 to 3.1.2 4 days ago
package.json c4910fe77b Add jQuery types package dependency 3 weeks ago
prettier.config.js 11ccf30f00 Add Prettier configuration & documentation (#7908) 10 months ago
runtests.py 0fd99886a2 Move tests to test 8 months ago
setup.cfg 6dae6e5d07 Add and configure black 9 months ago
setup.py 5c1c2c8f53 Enforce the use of a single string formatting mechanism for translation source strings 6 days ago
tailwind.config.js a395d9c565 Auto-generate docs for most important design tokens 7 months ago
tox.ini 7705b080a0 Add formal support for Python 3.11 1 month ago
tsconfig.json b884026d08 Move inline panel JS into inline_panel.html 8 months ago

README.md

<img width="343" src=".github/wagtail.svg#gh-light-mode-only" alt="Wagtail">
<img width="343" src=".github/wagtail-inverse.svg#gh-dark-mode-only" alt="Wagtail">

<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://lgtm.com/projects/g/wagtail/wagtail/alerts/">
    <img src="https://img.shields.io/lgtm/alerts/g/wagtail/wagtail.svg?logo=lgtm&logoWidth=18" alt="Total alerts" />
</a>
<a href="https://lgtm.com/projects/g/wagtail/wagtail/context:python">
    <img src="https://img.shields.io/lgtm/grade/python/g/wagtail/wagtail.svg?logo=lgtm&logoWidth=18" alt="Language grade: Python" />
</a>
<a href="https://lgtm.com/projects/g/wagtail/wagtail/context:javascript">
    <img src="https://img.shields.io/lgtm/grade/javascript/g/wagtail/wagtail.svg?logo=lgtm&logoWidth=18" alt="Language grade: JavaScript" />
</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>

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

🔥 Features

  • 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 de-coupled front-end
  • 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

Find out more at wagtail.org.

👉 Getting started

Wagtail works with Python 3, on any platform.

To get started with using Wagtail, run the following in a virtual environment:

Installing Wagtail

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

For detailed installation and setup docs, see the getting started tutorial.

👨‍👩‍👧‍👦 Who’s using it?

Wagtail is used by NASA, Google, Oxfam, the NHS, Mozilla, MIT, the Red Cross, Salesforce, NBC, BMW, and the US and UK governments. Add your own Wagtail site to madewithwagtail.org.

📖 Documentation

docs.wagtail.org is the full reference for Wagtail, and includes guides for developers, designers and editors, alongside release notes and our roadmap.

For those who are new to Wagtail, the Zen of Wagtail 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 will guide you through creating and editing your first page.

Do you have an existing Django project? The Wagtail Integration documentation is the best place to start.

📌 Compatibility

(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 in the Wagtail documentation.)

Wagtail supports:

  • Django 3.2.x, 4.0.x and 4.1.x
  • Python 3.7, 3.8, 3.9, 3.10 and 3.11
  • PostgreSQL, MySQL and SQLite (with JSON1) as database backends

Previous versions of Wagtail additionally supported Python 2.7 and earlier Django versions.


📢 Community Support

There is an active community of Wagtail users and developers responding to questions on Stack Overflow. When posting questions, please read Stack Overflow's advice on how to ask questions and remember to tag your question "wagtail".

For topics and discussions that do not fit Stack Overflow's question and answer format we have a Slack workspace. Please respect the time and effort of volunteers by not asking the same question in multiple places.

Join slack community

Our Github discussion boards are open for sharing ideas and plans for the Wagtail project.

We maintain a curated list of third party packages, articles and other resources at Awesome Wagtail.

🧑‍💼 Commercial Support

Wagtail is sponsored by Torchbox. If you need help implementing or hosting Wagtail, please contact us: hello@torchbox.com. See also 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 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.

🕒 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.

🕛 Nightly releases

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

🙋🏽 Contributing

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.

You might like to start by reviewing the contributing guidelines and checking issues with the good first issue label.

We also welcome translations for Wagtail's interface. Translation work should be submitted through Transifex.

🔓 License

BSD - Free to use and modify for any purpose, including both open and closed-source code.

👏 Thanks

We thank the following organisations for their services used in Wagtail's development:

Browserstack
BrowserStack provides the project with free access to their live web-based browser testing tool, and automated Selenium cloud testing.

squash.io
Squash provides the project with free test environments for reviewing pull requests.

Assistiv Labs
Assistiv Labs provides the project with unlimited access to their remote testing with assistive technologies.