iTeam.org website

See the running instance here.

iTeam is a french association for promoting free softwares at the french engineering school ECE.

Notes :

• commands may need sudo
• python is an alias to the proper version of python 2.x

Dependencies

Python 2.x, its framework Django, the python package installer pip and some dependencies :

apt-get install python2.7 python2.7-dev sqlite3
apt-get install python-pip
pip install -r requirements.txt

If the install of pillow fail (on mac osx for example), try :

sudo su -
export CFLAGS=-Qunused-arguments
pip install pillow

or ubuntu :

export CFLAGS=""
export CPPFLAGS=""
pip install pillow

Ruby, compass (compile the sass/scss to css) and zurb-foundation (css responsive framework) :

Be carrefull with the versions :

• Ruby 1.8(.7)
• Sass 3.4(.5)
• Foundation 4

apt-get install ruby1.8 rubygems
gem install compass zurb-foundation

# if it dont work, try :
# apt-get install ruby-compass
# gem uninstall sass && sudo gem install sass --version 3.4.5

Yuglify (use by django-pipeline, to minify the js)

npm -g install yuglify

Setting up the stuff and run the server

• Compiling the .css stylessheets :

compass compile assets/

• Configuring the database :

python manage.py syncdb

• Running the server :

python manage.py runserver

The server will be available at http://localhost:8000

License and Copyright

ITeam.org is brought to you under GNU Affero General Public Licence version 3+. For further informations please read the LICENSE file.

Special thanks to the open source projects Progdupeu.pl (source code) and zestedesavoir.com (source code). Some code may come from them.

Dev

Require other dependencies : coverage and flake8, install them via pip

• Clearing everything and loading initial datas :

python loadFixtures.py

• launching tests :

python manage.py test

• test coverage :

coverage erase && coverage run ./manage.py test
coverage html && open htmlcov/index.html

• code checking (pep8) :

flake8 . --max-line-length=120

• Do not forget to:

• add tests if needed
• use object.pk instead of object.id
• write css style in css files instead of html template
• not leave the alt attribute of empty
• write pep8 compliant code
• do the migrations (with south because django 1.6): python manage.py schemamigration app_name --initial and python manage.py schemamigration app_name --auto
• add a tag before deploy in production: git tag -a v1.4 -m 'my version 1.4' and git push origin --tags