Nadlogar

Nadlogar je spletna storitev za generiranje naključnih nalog ter njihovih rešitev. Učitelj izbere seznam tipskih nalog in vzorčno izhodno datoteko ter naloži seznam učencev, storitev pa za vsakega učenca ustvari posamezne datoteke z nalogami ter skupno datoteko z rešitvami. Naloge niso čisto naključne, saj storitev za istega učenca vedno vrne enako nalogo, kar omogoča, da naloge naknadno popravljate, ne da bi se vam pri tem v celoti spremenile.

Nadlogar je projekt, ki nastaja v okviru programerskega kluba Fakultete za matematiko in fiziko, Univerza v Ljubljani. Poleg vseh članov kluba, ki k razvoju prispevajo vse od idej do kode, so k razvoju bistveno pomagali oziroma še pomagajo:

Gregor Šega, ki je napisal prvo skripto za generiranje nalog v Mathematici in s tem dal idejo za splošen program,
Matija Pretnar, ki je na osnovi te skripte v Mathematici napisal splošen program,
Urša Pertot, ki je na osnovi tega programa napisala program v Pythonu,
podjetje EBA d.o.o., Ljubljana, ki je velikodušno prevzelo sponzorstvo programerskega kluba.

Navodila za namestitev

Na začetku klonirajte repozitorij ter ustvarite virtualno okolje:

git clone git@github.com:ul-fmf/nadlogar.git
cd nadlogar
python3 -m venv venv

Dobiti bi morali sledečo strukturo datotek:

nadlogar/
    nadlogar/
        config/
        documents/
        ...
        manage.py
    ...
    venv/
        ...

Po prvi namestitvi, pa tudi na vsake toliko časa, greste v mapo nadlogar/nadlogar/ ter s sledečimi ukazi kodo posodobite, aktivirate virtualno okolje, namestite potrebne pakete in posodobite bazo:

git pull
source venv/bin/activate
pip install -r requirements/local.txt
python manage.py migrate

Če uporabljate Windowse, je drugi ukaz drugačen

git pull
venv\Scripts\activate
pip install -r requirements\local.txt
python manage.py migrate

Strežnik nato poženete z

python manage.py runserver

Teste poženete z

python manage.py test

Po namestitvi je koristno pognati

python manage.py loaddata documents/fixtures/initial.json

Tako naložite nekaj koristnih LaTeX predlog.

Kako poženete Nadlogarja?

Če poženete ukaz

python manage.py runserver

vam na lokalnem strežniku požene spletno stran. Vendar se morate za njeno uporabo najprej prijaviti. Zato ustvarite adminskega uporabnika, kar storite z ukazom

python manage.py createsuperuser

Ko to storite, vam je dostopen tudi adminski vmesnik, kjer med drugim lahko dodajate nova besedila nalog (vsaj zaenkrat, saj se bo shranjevanje besedil kmalu spremenilo).

Za navodila glede dodajanja funkcionalnosti in popravljanja napak glejte CONTRIBUTING.md.