Sam's Django Project Template

Note: The master branch contains a template for Django 1.9. If you wish to use a previous version, please check out the appropriate branch:

• django-1.8 branch
• django-1.7 branch
• django-1.6 branch

This Django project template sets up a new project with the following features:

• PostgreSQL for database connections.
• Sensible time zone and defaults for Brisbane, Australia.
  • Note that internationalization and time zone-aware datetimes are disabled!
• settings app to store site-specific settings by providing settings/dev.py and settings/prod.py files.
• Enables the admin interface with the Grappelli skin.
• Enables the following apps by default:
  • django-debug-toolbar
  • django-grappelli
• Flat project structure (no sub-directory called project_name).
• Serves static and media files when using the development server.
• Uses default Django template configuration.

Installation

Note: This will install the latest stable version of Django (at the time of writing, 1.9). If this is undesirable, manually download requirements.txt and edit accordingly.

1. Create a new virtualenv and activate it.

2. Install the requirements:

    $ pip install -r https://raw.github.com/sjkingo/django-project-template/master/requirements.txt
    $ pip install -r https://raw.github.com/sjkingo/django-project-template/master/requirements-dev.txt
   

3. Create a new project using the template:

    $ export PROJECT_NAME=foo
    $ django-admin.py startproject --template https://github.com/sjkingo/django-project-template/archive/master.zip $PROJECT_NAME
   

4. Run the following to clean up the template directory and update requirements.txt:

    $ cd $PROJECT_NAME
    $ pip freeze > requirements.txt
    $ rm -f README.md
    $ chmod +x manage.py
   

5. By default, settings.dev is used in manage.py. To switch to the production settings, set the environment variable DJANGO_SETTINGS_MODULE:

    $ DJANGO_SETTINGS_MODULE=settings.prod ./manage.py ...
   

It is based on the project_template shipped with stable/1.5.x and modified for Django 1.9.