A wafer-thin Django library for running small conferences.
Reason this release was yanked:
Unintended push to pypi - this release has no changes from 0.15.0 yet and so isn't useul as a pre-release
Project description
wafer
=====
|wafer-ci-badge| |wafer-docs-badge| |wafer-weblate-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: https://wafer.readthedocs.org/
.. |wafer-weblate-badge| image:: https://hosted.weblate.org/widgets/wafer/-/svg-badge.png
:alt: Translation status
:scale: 100%
:target: https://hosted.weblate.org/engage/wafer/
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: https://wafer.readthedocs.org/
Supported Django versions
=========================
Wafer supports Django 2.2, Django 3.0 - 3.2 and Django 4.0 - 4.1.
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_PAGE_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`` or
``WAFER_PAGE_MARKITUP_FILTER``, be sure to install the appropriate
python packages as well.
7. Wafer uses the Django caching infrastructure in several places, so
the cache table needs to be created using ``manage.py createcachetable``.
8. Create the default 'Page Editors' and 'Talk Mentors' groups using
``manage.py wafer_add_default_groups``.
9. 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.
10. Have a fun conference.
Running wafer
=============
To run a local server for development and testing, use the standard Django
``manage.py runserver``, after doing the installation.
For running the server in production, please see the `Django documentation`_
on the various possible approaches.
.. _Django documentation: https://docs.djangoproject.com/en/3.0/howto/deployment/
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.
Translation
===========
Translations for wafer are managed at `weblate.org`_
.. _weblate.org: https://hosted.weblate.org/projects/wafer/
=====
|wafer-ci-badge| |wafer-docs-badge| |wafer-weblate-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: https://wafer.readthedocs.org/
.. |wafer-weblate-badge| image:: https://hosted.weblate.org/widgets/wafer/-/svg-badge.png
:alt: Translation status
:scale: 100%
:target: https://hosted.weblate.org/engage/wafer/
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: https://wafer.readthedocs.org/
Supported Django versions
=========================
Wafer supports Django 2.2, Django 3.0 - 3.2 and Django 4.0 - 4.1.
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_PAGE_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`` or
``WAFER_PAGE_MARKITUP_FILTER``, be sure to install the appropriate
python packages as well.
7. Wafer uses the Django caching infrastructure in several places, so
the cache table needs to be created using ``manage.py createcachetable``.
8. Create the default 'Page Editors' and 'Talk Mentors' groups using
``manage.py wafer_add_default_groups``.
9. 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.
10. Have a fun conference.
Running wafer
=============
To run a local server for development and testing, use the standard Django
``manage.py runserver``, after doing the installation.
For running the server in production, please see the `Django documentation`_
on the various possible approaches.
.. _Django documentation: https://docs.djangoproject.com/en/3.0/howto/deployment/
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.
Translation
===========
Translations for wafer are managed at `weblate.org`_
.. _weblate.org: https://hosted.weblate.org/projects/wafer/
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
wafer-0.15.1a0.tar.gz
(330.9 kB
view details)
Built Distribution
wafer-0.15.1a0-py3-none-any.whl
(413.0 kB
view details)
File details
Details for the file wafer-0.15.1a0.tar.gz.
File metadata
- Download URL: wafer-0.15.1a0.tar.gz
- Upload date:
- Size: 330.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.4.2 requests/2.25.1 setuptools/52.0.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6c369c10b7db1ef3ad5b0290940d8924619ea0851e8c6d31af82cdbaf439feb9 |
|
| MD5 | 5963790150d43cfabcacb03be3fbe704 |
|
| BLAKE2b-256 | a7a0bdbc82b46c9bfa379fbf80aca7706bf707b2f2e732b6f5e39c81522fc3c5 |
File details
Details for the file wafer-0.15.1a0-py3-none-any.whl.
File metadata
- Download URL: wafer-0.15.1a0-py3-none-any.whl
- Upload date:
- Size: 413.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.4.2 requests/2.25.1 setuptools/52.0.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 06d82c4c56a903d68f36b9de816c9538efe0cd321203f2178e9a00369562c809 |
|
| MD5 | fbaaf219ed1da227e9218879db3e0344 |
|
| BLAKE2b-256 | 729afb562abaac401c51653ddcda37383aae38b2d058fd84985885113061a52a |
