/django-project-template

My personal Django project template.

Prerequisites

Install pip and virtualenvwrapper:

sudo easy_install pip
pip install virtualenvwrapper
echo "source /usr/local/bin/virtualenvwrapper.sh" >> ~/.bash_profile
source ~/.bash_profile

Create a dedicated virtualenv for Django:

mkvirtualenv django
pip install django

You've done.

Installation

Be sure your current virtualenv is django:

workon django

Create your Django project with the --template argument pointing on the GitHub zipball of the branch you want to grab (and with --extension argument to parse Python and reStructuredText files):

django-admin.py startproject PROJECT_NAME --template=https://github.com/gillesfabio/django-project-template/zipball/BRANCH --extension=py,rst

Deactivate the Django virtualenv:

deactivate

Create a virtualenv for your Django project:

mkvirtualenv PROJECT_NAME

Install requirements:

pip install -r PROJECT_NAME/requirements/development.txt

Rename PROJECT_NAME/settings/local.sample.py:

mv PROJECT_NAME/PROJECT_NAME/settings
mv local.sample.py local.py

Import settings for the given environment:

from PROJECT_NAME.settings.development import *

Override settings if you need.

Sychronize and run the server:

python manage.py syncdb
python manage.py runserver

Celebrate!

Requirements and version numbers

This Django project template does not use explicit version numbers for requirements to get the latest stable version at project creation.

Edit requirement files (in requirements directory) and add version numbers to your requirements. Never ever use requirements without explicit version numbers. This can kill your project.

Use pip freeze to catch version numbers in a second:

pip freeze > freeze.txt

So don't forget to update your requirements.

Branches

master

Only contains this README file.

simple

Stack:

bootstrap

The simple stack +: