Quadbase is an open homework and test question bank, where questions are written by the community and access is free.
Check it out at http://quadbase.org
To run Quadbase, you must have the following dependencies installed:
JRuby (for questions with logic) -- Needs to be installed through RVM
ImageMagick (for image uploads) -- Additionally, you'll need to set paths in config/initializers/paperclip.rb as well as in config/developer_settings.yml.
See the COPYRIGHT and LICENSING files.
Contributions to Quadbase are definitely welcome.
Note that like a bunch of other orgs (Apache, Sun, etc), we require contributors to sign and submit a Contributor Agreement. The Rice University Contributor Agreement (RCA) gives Rice and you the contributor joint copyright interests in the code or other contribution. The contributor retains copyrights while also granting those rights to Rice as the project sponsor.
The RCA can be submitted for acceptance by emailing a scanned, completed, signed copy to info@[the quadbase domain]. Only scans of physically signed documents will be accepted. No electronically generated 'signatures' will be accepted.
Here's how to contribute to Quadbase:
- Send us a completed Rice Contributor Agreement
- Download it from http://quadbase.org/rice_university_contributor_agreement_v1.pdf
- Complete it (where "Project Name" is "Quadbase" and "Username" is your GitHub username)
- Sign it, scan it, and email it to info@[the quadbase domain]
- Fork the code from github (https://github.com/lml/quadbase)
- Create a thoughtfully named topic branch to contain your change
- Make your changes
- Add tests and make sure everything still passes
- If necessary, rebase your commits into logical chunks, without errors
- Push the branch up to GitHub
- Send a pull request for your branch
Quick Development How-To
We provide a Vagrant box that you can use for development. It has everything you need to get going
- Install vagrant (
gem install vagrant)
vagrant box add quadbase http://dsp.rice.edu/public/quadbase/quadbase.box
- Clone your fork of quadbase, and
cdinto that directory
- At the vagrant VM prompt,
bundle exec rails serveror
be rails s
Bring up http://localhost:3000 in a web browser to see the site. Do development with your native tools.
Install everything yourself
The best way to go is to install RVM on your machine. Install Ruby 1.9.3 (e.g.
rvm install 1.9.3-p194)
and install the bundler gem. You may run into some issues where you need to install some supplemental
libraries first. The question logic capability uses jruby under the covers, so you should also install
jruby through rvm (
rvm install jruby).
When you have RVM and bundler, fork the code and change into the quadbase directory. We have a .rvmrc file in the top-level directory so RVM should setup things to use Ruby 1.9.3 and the quadbase gemset.
bundle --without production bundle exec rake db:migrate bundle exec rails server
To upload images to questions, you'll need to have ImageMagick installed and set the parameters appropriately in config/developer_settings.yml. Check out the developer_settings.yml.example file for help.
That's it. You should then be able to point a web browser to http://localhost:3000.