DocHub
DocHub is a website, written in django. It's main goal is to provide a space for students (for now form the ULB university) 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
DocHub currently (Feb 2022) runs with Python 3.10 and Postgresql 14.
Dependencies
# Ubuntu
sudo apt-get install unoconv python3-dev ruby libtiff5-dev libjpeg-dev zlib1g-dev libfreetype6-dev liblcms2-dev libwebp-dev tcl8.6-dev tk8.6-dev python-tk mupdf-tools redis-server
sudo systemctl enable --now redis-server
# Fedora
sudo dnf install unoconv python-devel ruby mupdf redis
sudo systemctl enable --now redis
# Arch linux
sudo pacman -S unoconv ruby python mupdf-tools redis
sudo systemctl enable --now redis
Installation
To create the virutal environment and install the requirements, run the following command:
make install
To create a database with some dummy data, run the following command:
make database
Run
./manage.py runserver
Then go http://localhost: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
Requirements
To add a requirement, write it in requirements.in
file, and generate the requirements.txt file with the following command
pip-compile
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 submit a PR !
License
Copyright 2012 - 2021, 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 (https://urlab.be): ULB's hackerspace