This repository serves the website of PyCon TW 2016. This project is open source and the license can be found in LICENSE.

• Git 1.8+
• Python 3.4+

At first, you should make sure you have virtualenv installed.

then, create your virtualenv:

python3 -m venv venv

Second, you need to enable the virtualenv by

source venv/bin/activate

If you are using virtualenvwrapper, then you should assign your python path:

which python3 # Output: /usr/local/bin/python3
mkvirtualenv --python=/usr/local/bin/python3 pycontw2016

Install all dependencies:

pip install -r requirements.txt

Settings are stored in environment variables via django-environ. The quickiest way to start is to rename local.sample.env into local.env:

cp src/pycontw2016/settings/local.sample.env src/pycontw2016/settings/local.env

Then edit the SECRET_KEY in local.env file, replace {{ secret_key }} into any Django Secret Key, for example:

SECRET_KEY=twvg)o_=u&@6^*cbi9nfswwh=(&hd$bhxh9iq&h-kn-pff0&&3

After that, just cd to src folder:

cd src

And run migrate and http server:

python manage.py migrate
python manage.py runserver

Tests are managed with pytest-django. To run tests:

py.test

To run tests with coverage report:

py.test --cov=.

Follow the GitHub Flow, please DO NOT push the commits into master directly. Always create branch by the feature you want to update. You are encouraged to submit a pull request for reviewing before merging things into master.

Translations are hosted on Transifex.