Django-Sveetchies is a Django website project, its main goal is to demonstrate some Django apps I made while publishing their documentation.

• Django >= 1.4;
• autobreadcrumbs;
• djangocodemirror;
• Sveetchies-accounts;
• Sveetchies-documents;
• django-assets;
• argparse (For production environment);

This is not an application but a website project, so you don't have to install it like a Python module, just put it where you want, configure it and start it.

To test it, just use the django-admin runserver command. To use it in production you will have to configure your webserver to serve it as a website.

The project is shipped with a settings.py file that is the default project settings and you should not edit it if you need different settings. It is highly recommended that you create a new settings file where you import the default settings and that you edit those needed.

By example, for a development environnment you will copy it to a dev_settings.py file that you will use like this with django-admin : :

django-admin YOURCOMMAND --settings=dev_settings

For a production environnment, you will create a prod_settings.py file where you import the default settings and overwrite the required settings like this :

# -*- coding: utf-8 -*-
"""
Django settings for Sveetchies demo

For production environnment, using the default project settings
"""
from settings import *

# Disable all debug mode
DEBUG = False
TEMPLATE_DEBUG = DEBUG
UNIFORM_FAIL_SILENTLY = not DEBUG

# Database access
DATABASES = {
    'default': {
        'NAME': 'your_database',
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'USER': 'username',
        'PASSWORD': 'password',
    }
}

# Make this unique, and don't share it with anyone.
SECRET_KEY = 'long_key'

# SMTP Settings to send Applications error, uncomment to active mail sending
#EMAIL_HOST = 'localhost'
#EMAIL_SUBJECT_PREFIX = '[Sveetchies] '
#SERVER_EMAIL = 'Sveetchies errors <your@email>'
#DEFAULT_FROM_EMAIL = 'Sveetchies <your@email>'

# Emails receiver for errors if SMTP settings are actived
#ADMINS = (
    #('YourName', 'your@email'),
#)

# Another site ID than default
#SITE_ID = 2

STATIC_DIRNAME = '_statics'
STATIC_ROOT = os.path.join(PROJECT_DIR, STATIC_DIRNAME)
STATIC_URL = '/{0}/'.format(STATIC_DIRNAME)
ASSETS_ROOT = os.path.join(PROJECT_DIR, STATIC_DIRNAME)

# Disable the DebugToolbar in production
MIDDLEWARE_CLASSES = tuple([item for item in list(MIDDLEWARE_CLASSES) if item != 'debug_toolbar.middleware.DebugToolbarMiddleware'])
INSTALLED_APPS = tuple([item for item in list(INSTALLED_APPS) if item != 'debug_toolbar'])

Generally the settings you will need to edit will be :

• PROJECT_DIR is the absolute path to the project that is allready defined in the default settings file;
• DATABASES if you use a different database than the default one (This example use the Django database backend for PostgreSQL, for a different database type you should see Django database backends;
• SECRET_KEY is a unique string used to encrypt some data like sessions, for safety reasons this must not be the same as the default one;
• Settings about email sending, this is used for account registration and to send error emails. See documentation Sending email with Django for more details;
• SITE_ID if you want to use a different host than the default one or than the development environnment;

The static directory configured in this example is _statics/ you will have to create it first, you can name it as you want but keep in mind that it must different from the development version.

You will need to synchronize the database structure with the project's database models with the following command line : :

django-admin syncdb

The command will ask you if you want to create a superuser, do it only if you don't plan to use the demonstration data.

If you want to use the demonstration data, use the following command line : :

django-admin loaddata demo_data.json

You have to copy all the static files in your static directory to publish : :

django-admin collectstatic --settings=prod_settings

For more details see documentation on Django collectstatic.

Then compute asset bundles : :

django-admin assets build --settings=prod_settings

And finally you will have to configure your webserver to serve the project, see the documentation on Django deployment.

DjangoSveetchies is shipped with a dispatcher_sample.fcgi file, it is a dispatcher to use with FastCGI that is probably the most easy to configure.

This application make usage of the Django internationalization system, see the Django documentation about this if you want to add a new language translation.