Beta402 or DocHub is a website, written in django. It's main goal is to provide a space for students (for now form the ULB univeristy) to collaborate, help each other and distribute old exams and exercices.
There is a live instance of DocHub hosted by UrLab and the Cercle Informatique.
You can run a dev instance in a Vagrant box with the following steps or read further for manual installation instructions.
Download and install vagrant (and probably virtualbox with it), then
vagrant up
vagrant ssh
cd /vagrant
source ve/bin/activate
honcho start
Dochub should be accessible on your host machine at http://127.0.0.1:8000/.
The files in the repo on your host machine are shared and available from within the vagrantbox (in /vagrant
).
Make sure you have python3
.
# Ubuntu
sudo apt-get install graphicsmagick unoconv python3-dev nodejs ruby npm libtiff5-dev libjpeg62-turbo-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev tcl8.6-dev tk8.6-dev python-tk python3-pip libffi-dev
# Fedora
sudo dnf install GraphicsMagick unoconv python-devel nodejs ruby npm
# Arch linux
sudo pacman -S graphicsmagick unoconv nodejs ruby python npm
# Next, for any distibution
pip3 install virtualenv
virtualenv ve
source ve/bin/activate
gem install sass
sudo npm install -g yuglify
make install database
If you don't want to run npm as root (we could understand), just run npm install yuglify
and add the yuglify
binary to your path. (it might be /usr/local/bin/yuglify
or ./node_modules/.bin/yuglify
depending on your distro)
source ve/bin/activate
honcho start
Then go to http://127.0.0.1:8000/
There will already be 2 users in the database, both with test
as a password:
- $(USER) : your username on your machine
- blabevue
Add another user to the db
./manage.py createuser
Run only fast tests (total time < 2 sec) : not testing actual file conversions
py.test -k "not slow"
Run all tests (~20 sec)
py.test
Come by #urlab on freenode or just fork this repo and send a patch !
Copyright 2012 - 2015, Cercle Informatique ASBL. All rights reserved.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This software was made by hast, C4, ititou and rom1 at UrLab (http://urlab.be): ULB's hackerspace