Django Boilerplate (CH's fork)

A barebones default layout for organised Django development.

Usage

This assumes you have pip and django installed (if not, try $ sudo easy_install pip)

$ django-admin.py startproject --template http://github.com/calbach/django-boilerplate/zipball/master project_name
$ cd project_name
$ pip install -r REQUIREMENTS
$ python manage.py syncdb --migrate

Settings

There is a separate file for each environment inside config/environments (development, staging, production). These import the django default settings from config.settings and are intended to be used directly, e.g. python manage.py validate --settings=config.environments.production or export PYTHONPATH=config.environments.development.

Any settings added in environments/local.py will be picked up and override any previously defined settings. This is useful for sensitive information such as database credentials or the SECRET_KEY etc. By default this file will NOT be checked into git.

Preinstalled Apps

• path.py: A module wrapper for os.path
• South: Intelligent database migrations
• django-grappelli: A jazzy skin for the Django admin interface.
• django-command-extensions: A a collection of custom extensions
• fabric: Application deployment and systems administration tasks.
• django-compressor: Compresses linked and inline javascript or CSS into a single cached file.