Skip to content
main
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
www
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

DocHub

License

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

Woop woop