Claremont Humans vs. Zombies Site

This is the website for the Claremont College's biannual HvZ game.

Dev machine setup

Developing for the site will require Django, VirtualEnv, and Compass. If you are familiar with and have (or know how to get) all of these, feel free to skip this section.

First off, install pip using your favorite package manager. If you're developing on a Mac, I recommend installing/using homebrew as your package manager of choice. Then brew install python3 will install pip.

Using pip, you should have an easy time installing virtualenv:

pip3 install virtualenv

Secondly, you'll need to install Compass. You can do this with

sudo gem install compass

If you don't have RubyGems installed, get Compass installed using your favorite package manager or method.

Building the site

Now create a root directory for your site. Mine is ~/programming/claremonthvz.org.

Note that I'm going to refer to ~/programming everywhere. If your root directory is in a different place, use your imagination and substitute accordingly.

Now build a virtualenv in the root directory, which for me was

virtualenv ~/programming/claremonthvz.org

Virtualenv provides a wrapper between your machine and the site. As long as the site only interacts with packages inside this wrapper, we know that we can port the site over to other machines without accidentally relying on some random laptop's quirks.

To actually use the virtualenv, you'll need to activate it:

source ~/programming/claremonthvz.org/bin/activate

This command only affects your current terminal, so you'll need to rerun it every time you want to work on the site. I highly recommend you add an alias to your .bashrc along the lines of

alias hvz="cd ~/programming/claremonthvz.org && source bin/activate && cd hvz"

Clone your forked GitHub repo (you don't have to use the command line for this):

git clone git@github.com:MYUSERNAME/claremontHvZ.git

Now complete the build with

~/programming/claremonthvz.org/hvz/setup.py

If all went well, that should be it!

Running a development version of the server

To run a development version of the server:

python manage.py runserver

You can then access the site by directing your browser to localhost:8000.