-
Notifications
You must be signed in to change notification settings - Fork 0
Home
fossacademy is the software that supports fossacademy.org . It is based on Django, and licensed under MPL 1.1/GPL 2.0/LGPL 2.1. Thanks to all the people who have/are/will contribute code into fossacademy.
There are certain external dependencies install them first these steps are for Ubuntu
-
sudo apt-get install python-dev python-setuptools python-lxml libssl-dev python-imaging python-m2crypto python-iso8601 make swig sqlite3 python-pysqlite2
-
pip install virtualenv
-
In order to configure virtualenvwrapper add the following lines to the ~/.bashrc file in your home directory:
export WORKON_HOME=$HOME/.virtualenvs export PIP_VIRTUALENV_BASE=$WORKON_HOME export PIP_RESPECT_VIRTUALENV=true source /usr/local/bin/virtualenvwrapper.sh
then reload .bashrc by typing bash in the shell
- mkvirtualenv fossacademy --system-site-packages
- git clone https://github.com/fossacademy/fossacademy.git
- pip install -r fossacademy/lernanta/requirements/dev.txt
- workon fossacademy
- cd /fossacademy/lernanta
- cp settings_local.dist.py settings.py
- python manage syncdb
- python manage runserver
- pop up a web browser and check site running on localhost:8000
We have several resources for those of you that want to dive into the code as soon as possible!
- Then we have a quick overview of what's going on inside the code and how that relates to a running instance of Lernanta.
- Main communications are on the fossacdemy mailing list
- We can also arrange hangouts at the Internet Relay Chat (IRC) channel #fossacademy in irc.freenode.net (How to use IRC). Please join us!
- A development roadmap shows major milestones and an overview of planned features for each bi-weekly release.
- If you want to submit a bug you can create an issue right here on github. Please ensure that the bug is valid or that a feature is implementation ready.
- We also have a less tech place for users to ask us questions and report problems at help.fossacademy.org.
- We try to keep a shorter list of issues marked as 'easy-contribution' so new contributors have a good place to get their feet wet with our code base! If you don't find a task just for you, let us know at the mailing list and we will prepare one.
- We have a page for people interested in translating fossacademy into other languages.
- You can find other development documentation on this github wiki.
- Receive daily summary of commit notifications to fossacademy:master by email, twitter, or RSS.
If you want to adopt a task, that's great! Even if you're relatively new to programming, this is a friendly community and we encourage you to dive in! (DON'T FORGET TO TAKE A LOOK AT THE CHEAT SHEET) The general process we're following is:
- Find an issue on github that you're interested in, maybe one labeled as 'easy contribution'.
- Let us know with a comment on the task that you can help with it, so we don't duplicate efforts and help you get up to speed.
- Fork the code on github.
- Make your changes. Commit. Update your fork on github.
- Send us a pull request. Note that all the code contributed/committed into our repository is licensed under the terms expressed in LICENSE.txt
To do all this, you need to have a github account. If you really don't want to use github, please feel free to send a manual pull request of submit a patch.