{% if False %}

Django 1.4 with HTML5★Boilerplate Project Template

About

This is a starting template for Django 1.4 projects using (a slightly modified version of) HTML5 Boilerplate.

Features

• Global assets, web, templates and fixtures directory.
• Collects static and media into public/{static,media} respectively.
• Django admin activated by default.
• Django timezone setting changed to UTC for sanity.
• HTML 5 base template with simple 404 and 500 error templates.
• Discourages storing credentials and secrets in the repository.
• Encourages the use of developer/machine specific settings.py file.
• Encourages the use of virtualenv and virtualenvwrapper.
• Encourages the use of pip and requirements.txt.
• Encourages the use of git.
• Includes a .gitignore for the usual junk.
• Automatically builds a README with installation notes.

How to use this template to create your project

• Install Django 1.4

• Run the following command specifying your project name.

    django-admin.py startproject --template https://github.com/jacobrpg/django-h5bp-template/zipball/master --extension py,md,gitignore,dist yourprojectname
  

{% endif %}

{{ project_name|title }} Django Project

About

Describe {{ project_name }} here.

Prerequisites

• Python >= 2.5
• pip
• virtualenv (virtualenvwrapper is recommended for use during development)

Installation

Creating the environment

Create a virtual python environment for the project. If you're not using virtualenv or virtualenvwrapper you may skip this step.

For virtualenvwrapper

    mkvirtualenv --no-site-packages {{ project_name }}-env

For virtualenv

    virtualenv --no-site-packages {{ project_name }}-env
    source {{ project_name }}-env/bin/activate

Clone the code

Obtain the url to your git repository.

    git clone <URL_TO_GIT_RESPOSITORY> {{ project_name }}

Install requirements

    cd {{ project_name }}
    pip install -r requirements.txt

Configure project

When you're finished installing requirements, you'll need to set up your local settings.py file:

    cp {{ project_name }}/settings.py.dist {{ project_name }}/settings.py
    vim {{ project_name }}/settings.py

Sync database

After you configure your local settings (database, etc.) you're ready to run syncdb:

    python manage.py syncdb

Running

Once that's completed you can boot up the dev server:

    python manage.py runserver

Open browser to http://127.0.0.1:8000 -- if all went well you should see the "It works!" page.