mtaube.com

For an overview of the project architecture and tools used, check out my blog post about it.

Installation

Prerequisites

• Python
• pip
• virtualenv
• virtualenvwrapper

Main

Using virtualenv and virtualenvwrapper is highly recommended. The virtualenv can be named anything (VIRTUALENV_NAME).

1. Create new virtualenv

   mkproject VIRTUALENV_NAME
   

2. Clone the repo into the new virtualenv dir

   git clone git@github.com:mtaube/mtaube.com.git .
   

3. Install the Python required packages and Node required packages

   pip install -r requirements.txt
   
   nodeenv --python-virtualenv --requirements=requirements--node.txt
   npm install
   

4. Configure Django settings

   Settings can be configured on a per-environment basis. Check out my blog post about it to see how this project's setting package works.

   See Django's settings documentation for all possible configurations.

5. Initialize the database tables (make sure database exists and Django database settings are correct)

   python manage.py migrate
   

Development

• Run Django's development server

  python manage.py runserver
  

• Automatically compile LESS files on save

  grunt watch
  

Deployment

All deployment-related tasks are handled using Fabric. See the fabfile for the predefined commands.

• To deploy an update to the staging or production environments

  fab -R staging deploy