Metadata-Version: 2.1
Name: django-assignment-desk
Version: 0.1.4
Summary: A simple app to manage newsroom staff assignments.
Home-page: https://github.com/DallasMorningNews/django-assignment-desk/
Author: Alma Washington and Allan James Vestal, The Dallas Morning News
Author-email: newsapps@dallasnews.com
License: AGPLv3
Download-URL: https://github.com/DallasMorningNews/django-assignment-desk/archive/0.1.4.tar.gz
Description: django-assignment-desk
        =====
        
        `django-assignment-desk` is a simple Django app to store and manage weekly editorial staff assignments.
        
        It depends on a staff list (such as the one provided by [`django-editorial-staff`](https://github.com/DallasMorningNews/django-editorial-staff)), and returns a rich API that can be queried by any number of consumers (we're using it to feed both a read-only web interface and a chatbot).
        
        More detailed documentation will be added at a later date.
        
        
        Quick start
        -----------
        
        1. Install this app:
        
                pip install django-assignment-desk
        
        2.  Add \"assignment_desk\" to your INSTALLED\_APPS setting like this:
        
                INSTALLED_APPS = [
                    ...
                    'assignment_desk',
                ]
        
        3.  Include the assignment_desk URLconf in your project urls.py like this:
        
                url(r'^assignments/', include('assignment_desk.urls')),
        
        4.  Run `python manage.py migrate` to install the data models into your database.
        
        4.  Start the development server and visit
            <http://127.0.0.1:8000/assignments/> to start editing assignments.
        
        5.  Visit <http://127.0.0.1:8000/assignments/api/> to explore the app's REST API.
        
        
        Configuration
        -------------
        
        You can specify the following configuration options in your project's `settings.py` file. All are optional:
        
        | Setting name                 | Intended value(s)          | Purpose |
        |:-----------------------------|:---------------------------|:--------|
        | `ASSIGNMENT_DESK_LOGOUT_URL` | Any reversible URL pattern | If set, includes a "log out" link in the navigation on each `django-assignment-desk` page. |
        |||
        
        
        Front-end development
        ---------------------
        
        `django-assignment-desk` front-end pages are built using ES6 and SCSS, and this app includes a Gulp installation that converts files written in these dialects to plain JavaScript and CSS, respectively.
        
        When developing on the front-end, you'll need to run this Gulp installation yourself. Follow these steps to get started.
        
        1.  Open a terminal window and navigate to the root of this app.
        
        2.  Within the app, navigate to `./assignment_desk/staticapp`.
        
        3.  If this is your first time running Gulp on this project, run `npm install` to install JS dependencies. This may take several minutes.
        
        4.  Once your dependencies are installed, run `gulp` to begin local development.
        
        5.  When your Gulp server says it's up and running, visit <http://127.0.0.1:3000/assignments/> for a live preview of your front-end files.
        
        6.  Proceed to modify your front-end interface by changing files in `./assignment_desk/staticapp/scss/` and `./assignment_desk/staticapp/js/`. Your changes will be applied to the Gulp server URL without the need for to reload the page manually.
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Description-Content-Type: text/markdown
