Skip to content

TheoVerhelst/DocHub

 
 

Repository files navigation

Beta402 - DocHub

Build Status Coverage Status License

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.

Screenshots

Tech

Vagrant

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).

Installation

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)

Run

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

Misc

Add another user to the db

./manage.py createuser

Testing

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

Contribute !

Come by #urlab on freenode or just fork this repo and send a patch !

License

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

Woop woop

About

A nextgen student platform for ULB focused on real student collaboration

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 71.5%
  • Python 17.8%
  • HTML 6.2%
  • CSS 4.4%
  • Other 0.1%