===================================
Postorius - web ui for GNU Mailman
===================================

Copyright (C) 1998-2016 by the Free Software Foundation, Inc.

The Postorius Django app provides a web user interface to
access GNU Mailman. 

Postorius is free software: you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation, version 3 of the License.

Postorius is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with mailman.client. If not, see <http://www.gnu.org/licenses/>.


Requirements
============

Postorius requires Python 2.6 or newer and mailman.client,
the official Python bindings for GNU Mailman, it also requires
django-social-auth.
The minimum Django version is 1.8.
Postorius needs a running version of GNU Mailman version 3.


NEWS/Changelog
==============

News and the changelog can be found in the package documentation:

src/postorius/doc/news.rst


Installation
============

To install GNU Mailman follow the instructions in the documentation:
http://packages.python.org/mailman/

A description how to run Postorius on Django's dev server or using
Apache/mod_wsgi, can be found in the package documentation: 

src/postorius/doc/setup.rst


Acknowledgements
================

Many thanks go out to Anna Senarclens de Grancy and Benedict Stein for
developing the initial versions of this Django app during the Google Summer of
Code 2010 and 2011. 


Icons
=====

Postorius uses the WPZOOM Developer Icon Set (http://www.wpzoom.com).