A barebones default layout for organised Django development. Inspired a little by Ruby on Rails and 'Django Project Conventions by Zachary Voase (link below).

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

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

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.

• 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.

Much of the layout is taken from a great post by Zachary Voase.

• Scotty Vernon: django-compressor integration, included modernizr, boilerplate markup in base.html, and organised javascripts folder.