Metadata-Version: 2.1
Name: wafer
Version: 0.9.3
Summary: A wafer-thin Django library for running small conferences.
Home-page: http://github.com/CTPUG/wafer
Author: CTPUG
Author-email: ctpug@googlegroups.com
License: ISC
Description: wafer
        =====
        
        |wafer-ci-badge| |wafer-docs-badge|
        
        .. |wafer-ci-badge| image:: https://travis-ci.org/CTPUG/wafer.png?branch=master
            :alt: Travis CI build status
            :scale: 100%
            :target: https://travis-ci.org/CTPUG/wafer
        
        .. |wafer-docs-badge| image:: https://readthedocs.org/projects/wafer/badge/?version=latest
            :alt:  Wafer documentation
            :scale: 100%
            :target: http://wafer.readthedocs.org/
        
        A wafer-thin web application for running small conferences. Built using Django.
        
        Licensed under the `ISC License`_.
        
        .. _ISC License: https://github.com/CTPUG/wafer/blob/master/LICENSE
        
        
        Documentation
        =============
        
        Available on `readthedocs.org`_.
        
        .. _readthedocs.org: http://wafer.readthedocs.org/
        
        Supported Django versions
        =========================
        
        Wafer supports Django 2+ and Django 3.0.
        
        Installation
        ============
        
        1. wafer can be installed either from pypi (``pip install wafer``)
           or from the github repository.
        
        2. If installing from github, ``pip install -r requirements.txt``
           should install all the required python and django dependencies.
        
        3. Wafer uses npm to manage front-end dependencies
        
           * Make sure you have a recent version of Node.js installed that
             includes ``npm``.
        
           * Run ``npm install`` to install all dependencies, which also copies
             them to ``wafer/static/vendor``.
        
        4. Install the wafer applications
           ``manage.py migrate``
        
        5. If you don't have one yet, create a superuser with
           ``manage.py createsuperuser``.
        
        6. Examine the ``settings.py`` file and create a
           ``localsettings.py`` file overriding the defaults
           as required.
        
           ``STATIC_FILES``, ``WAFER_MENUS``, ``MARKITUP_FILTER``,
           ``WAFER_TALKS_OPEN``, ``WAFER_REGISTRATION_OPEN`` and
           ``WAFER_PUBLIC_ATTENDEE_LIST`` will probably need to be
           overridden.
        
           If you add extensions to ``MARKITUP_FILTER``, be
           sure to install the appropriate python packages as well.
        
        7. Log in and configure the Site:
        
           * The domain will be used as the base for e-mails sent during
             registration.
        
           * The name will be the conference's name.
        
        8. Wafer uses the Django caching infrastructure in several places, so
           the cache table needs to be created using ``manage.py createcachetable``.
        
        9. Create the default 'Page Editors' and 'Talk Mentors' groups using
           ``manage.py wafer_add_default_groups``.
        
        10. Have a fun conference.
        
        Installing Bootstrap
        ====================
        
        The default templates and css files require jquery and bootstrap to work.
        
        wafer provides a bower.json file to simplify the installation process. This
        requires a working nodejs installation.
        
        1. Install bower
           ``npm install bower``
        
        2. Use bower to install appropriate versions of bootstrap and jquery
           ``$(npm bin)/bower install``
        
        3. Move files to the correct location
           ``manage.py collectstatic``
        
        Features
        ========
        
        * Support for adding and editing sponsors via Django admin.
        * Schedule can be created and updated via Django admin.
        * Pages for static content, news and so forth can be handled via Django admin.
        
          * Can be delegated to the 'Page Editors' group.
          * Pages can be updated via the web interface.
        
        * Talk submissions, review and acceptance.
        * Generate a static version of the site for archival.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Framework :: Django
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP
Description-Content-Type: text/x-rst
