Giter VIP home page Giter VIP logo

opencommunity's Introduction

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.

opencommunity's People

Contributors

alonbardavid avatar alonp avatar amir99 avatar arimeidan avatar boazchen avatar daonb avatar nonzero avatar ofirr avatar pwalsh avatar yaniv14 avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.