Sam's Django Project Template

Note: The master branch contains a template for Django 1.7. If you wish to use Django 1.6, please check out the 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!
• local_settings.py file to store site-specific settings. This allows settings.py to be committed to version control without exposing passwords or keys.
• 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.

Installation

Note: This will install the latest stable version of Django (at the time of writing, 1.7). 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/django-1.7/requirements.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/1.7.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
   

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