Merge branch 'ci' into 'master'
[mailman-postorious.git] / README.rst
blobba5c5d5c926261e0a9cfce6f91914fd9909d7fb1
1 ===================================
2 Postorius - Web UI for GNU Mailman
3 ===================================
4 .. image:: https://gitlab.com/mailman/postorius/badges/master/build.svg
5     :target: https://gitlab.com/mailman/postorius/commits/master
7 .. image:: https://readthedocs.org/projects/postorius/badge
8     :target: https://postorius.readthedocs.io
10 .. image:: https://gitlab.com/mailman/postorius/badges/master/coverage.svg?job=coverage
11     :target: https://mailman.gitlab.io/postorius
13 .. image:: http://img.shields.io/pypi/v/postorius.svg
14     :target: https://pypi.python.org/pypi/postorius
16 .. image:: http://img.shields.io/pypi/dm/postorius.svg
17     :target: https://pypi.python.org/pypi/postorius
19 Copyright (C) 1998-2021 by the Free Software Foundation, Inc.
21 The Postorius Django app provides a web user interface to
22 access GNU Mailman.
24 Postorius is free software: you can redistribute it and/or
25 modify it under the terms of the GNU Lesser General Public License as
26 published by the Free Software Foundation, version 3 of the License.
28 Postorius is distributed in the hope that it will be useful,
29 but WITHOUT ANY WARRANTY; without even the implied warranty of
30 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
31 General Public License for more details.
33 You should have received a copy of the GNU Lesser General Public License
34 along with mailman.client. If not, see <http://www.gnu.org/licenses/>.
37 Requirements
38 ============
40 Postorius requires Python 3.7+.
42 The minimum Django version is 3.2.
44 Postorius needs a running version of GNU Mailman version 3.3.5.
47 Installation
48 ============
50 To install GNU Mailman Suite follow the instructions in the documentation:
51 https://docs.mailman3.org/
54 Acknowledgements
55 ================
57 Many thanks go out to Anna Senarclens de Grancy and Benedict Stein for
58 developing the initial versions of this Django app during the Google Summer of
59 Code 2010 and 2011.