Skip to content

hasadna/OpenCommunity

 
 

Repository files navigation

Installing OpenCommunity

OpenCommunity is an open source project from Hasadna. Its aim is to help communities thrive in the Cloud. Our first step is to support setting the agenda sork for the managment committee. Join the conversation in our google group (English and Hebrew).

Prerequisites for Developer Machines

  • git

  • python 2.7 (Windows users can install from http://www.ninite.com/ )

  • On ubuntu 13.04:

    # Pillow build requirements:
    sudo apt-get install python-dev libjpeg-dev libjpeg8 zlib1g-dev libfreetype6 libfreetype6-dev
    

(Quick) Setup

  • Fork the repo and clone it to your computer using git clone

  • cd into the cloned project

  • You will need virtualenv. Either install it or download virtualenv.py from here: https://raw.github.com/pypa/virtualenv/master/virtualenv.py

  • Now create a virtualenv. Use either:

    virtualenv .
    

    Or:

    python virtualenv.py .
    
  • Good! to activate the env use this on OSX or linux:

    source bin/activate
    

    On windows:

    scripts\activate
    
  • Your prompt should start with (OpenCommunity).

  • On windows install some binary packages first:

    windows-setup.cmd
    
  • Now install all other requirements (This can take some time):

    pip install -r requirements.txt
    
  • Create a local settings file from the example file. On linux/OSX:

    cp src/ocd/local_settings.py.example src/ocd/local_settings.py
    

    On windows:

    copy src\ocd\local_settings.py.example src\ocd\local_settings.py
    
  • Now create a directory for your sqlite db:

    mkdir db
    
  • It's time to get closer to our code:

    cd src
    
  • ... and create the database:

    python manage.py syncdb
    python manage.py migrate
    

    (When asked, create a user for the admin interface)

  • To start the dev web server:

    python manage.py runserver
    
  • Profit: http://localhost:8000/

Collaborating

  • Setup your git repo to get upstream changes:

    git remote add upstream git://github.com/hasadna/OpenCommunity.git
    git pull upstream master
    
  • Now go and get them:

    git pull upstream master
    pip install -r requirements.txt
    python manage.py syncdb
    python manage.py migrate
    

Common Problems and Solutions

  • If the following message appear when running python manage.py:

    Django - "no module named django.core.management"
    

    You probably have not activated your virtualenv, or did not install the requirements.

Packages

No packages published

Languages

  • JavaScript 51.6%
  • Python 29.2%
  • CSS 13.8%
  • HTML 5.4%