robholt / hfoss

Content Repository for Humanitarian/Free Open Source Software Development. Powered by Ofcourse.

hfoss

This is the content repository for the RIT Department of Interactive Games and Media Humanitarian Free/Open Source Software Course. This course is a required course that is part of the RIT Academic Minor in Free/Open Source Software and FreeCulture (a first at any University in the United States!) It contains course specific static content, and should be used in conjunction with the ofCourse courseware, distributed at https://pypi.python.org/pypi/ofcourse

INSTALLATION

Start by forking the repository on Github. Point your browser to http://github.com/decause/hfoss and then click the "Fork" button in the top right corner of the page.

Setting up your environment

Before you can do anything with this (run the webserver locally, or any of the scripts) you'll need to setup and activate a python virtualenv. Run the following at the command prompt...

On Linux/Mac OS X

If you don't have virtualenv installed yet, try::

$ sudo easy_install virtualenv virtualenvwrapper

If you're using a distro like Fedora or Ubuntu, you should try this instead::

Fedora: $ sudo yum install python-virtualenv

Ubuntu/Debian: $ sudo apt-get install python-virtualenv

Once you have virtualenv installed, you will install be able to run::

$ cd code

$ git clone [email protected]:YOUR_USERNAME/hfoss.git

$ virtualenv --no-site-packages -p python2 hfossenv

$ . hfossenv/bin/activate

On Windows

At the windows command prompt::

$ virtualenv --no-site-packages -p python2 hfossenv

$ hfossenv/Scripts/activate.bat

In msysGit or git-bash::

$ git clone [email protected]:YOUR_USERNAME/hfoss.git

Back in the windows command prompt::

$ cd hfoss

Installing Ofcourse

Once you've forked the repo, and activated your virual environment, you can pip install the courseware that serves up the content of the course. Simply run::

$ pip install ofcourse

Running Ofcourse

Once you've pip installed Ofcourse, you can then type::

$ ofcourse run

Which should run the courseware at http://127.0.0.1:5000

LICENSES

Unless otherwise noted, original lectures and course materials created by the Instructor within this repository are licensed Creative Commons Attribution-Share Alike 4.0 International.

Unless otherwise noted, original source code created by the Instructor within this repository is licensed Apache 2.0.