You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Pavel Turinský 502588fd3a Merge pull request 'soucet_bodu' (!70) from soucet_bodu into master 3 weeks ago
aesop Přehlídnutý import seminar.models 3 weeks ago
api Přejmenování URLs 3 weeks ago
data Název url seznamu všech soustředění 3 weeks ago
deploy_v2 odstřel tvorby: relink – post 3 weeks ago
docs Seminar v dokumentaci 3 weeks ago
galerie Částečné řešení #1465 (Podezřelé `seminar`e) 3 weeks ago
header_fotky Tahle moje „dokumentace“ je k ničemu, mažu 4 months ago
korektury Merge branch 'master' into vice_orgu_v_korekturovatku 1 month ago
make Merge remote-tracking branch 'gitea/podezrele-seminare' into bez_treenodu_i_bez_podezrelych_seminaru 3 weeks ago
mamweb seminar.models se načítá automaticky, budiž to mamweb.vsechno 3 weeks ago
novinky Pojmenované URL místo čistého URL 3 weeks ago
odevzdavatko Merge pull request 'soucet_bodu' (!70) from soucet_bodu into master 3 weeks ago
personalni Merge pull request 'Podezřelé semináře (#1465)' (!65) from podezrele-seminare into master 3 weeks ago
prednasky Částečné řešení #1465 (Podezřelé `seminar`e) 3 weeks ago
seminar seminar.models se načítá automaticky, budiž to mamweb.vsechno 3 weeks ago
setup Správný odkaz na diff (na wiki)? 5 months ago
sifrovacka Merge branch 'master' into split 1 month ago
soustredeni mv SeminarModelBase a OverwriteStorage 3 weeks ago
split-apps-meta odstřel tvorby: pre – relink 3 weeks ago
treenode Zapomenutý seminar.models 3 weeks ago
tvorba Merge pull request 'Podezřelé semináře (#1465)' (!65) from podezrele-seminare into master 3 weeks ago
various mv SeminarModelBase a OverwriteStorage 3 weeks ago
vue_frontend Přesun vue (zatím) do treenodů 3 weeks ago
vyroci Částečné řešení #1465 (Podezřelé `seminar`e) 3 weeks ago
vysledkovky Další částečné řešení #1465 (Podezřelé `seminar`e). Záměrně se vyhýbá treenode. 3 weeks ago
.editorconfig Komentáře česky 2 years ago
.gitignore Logy týracího skriptu do .gitignore 4 months ago
Makefile Make: výchozí target se jmenuje `default` 2 years ago
README.md Předěláno Readme 2 years ago
checklinks.sh checklinks: zobrazit i jediný rozbitý odkaz 3 years ago
constraints.txt Constrainty pro nový web nemáme, a staré fakt nechceme :-) 3 years ago
convert_spaces_to_tabs.sh Změna mezer na tabulátory 6 years ago
diff_db_backup.sh Update diff tool 9 years ago
fix_json.py Pridan skript na jednoznacnejsi razeni jsonu. 4 years ago
manage.py Nový Makefile. Bude vyžadovat změny uWSGi configu. 6 years ago
requirements.txt Merge branch 'master' into static-files-upgrade 1 month ago

README.md

Web M&M

Tohle je repozitář s kódem M&Mího webu. Pokud zde hledáte web samotný nebo informace o semináři, najdete je na https://mam.matfyz.cz (a upřímně nechápu, jak jste se dostali k tomuhle textu :-D)

Pokud jste tu zůstali, tak vás beztak zajímá vývoj webu (a jestli ne, tak budeme rádi, když začne :-)).

Co je M&Mweb uvnitř

Celý náš web je napsaný v Pythonu ve frameworku Django. Web běží na serveru zvaném Gimli, jako databázi používá PostgreSQL (pro lokální vývoj naopak SQLite) a všechen náš kód je uložený v Gitu na téhle gitee. Pro dokumentaci používáme Sphinx.

Jak si web pořídit

Prosím přečti si podrobnější návod v <docs/vyvoj.rst> (tady by bylo zbytečné ho duplikovat).

Jak web vyvíjet

Na webu je mnoho věcí k dělání, některé ani nevyžadují kódění (třeba uhánění orgů, aby si psali medailonky, aktualizace fotek, …), některé se naopak týkají infrastruktury pod kódem (Gitea, Gimli, …). Je proto těžké mít na to úplně obecný návod, tak tady je zhruba návod na úpravy kódu a pokud se něco z toho nedá aplikovat, tak to prostě zkus nějak udělat jinak, po svém. (Omlouvám se neinformatikům, ale líp to teď nesepíšu :-))

  1. Nejprve si stáhni repozitář a rozběhni si lokální web u sebe (viz <docs/vyvoj.rst>).
  2. Najdi si problém v Kanboardu (klikni na „Issues“ na Gitee) a/nebo se domluv s webaři, na čem bys tak mohl/a pracovat.
  3. Najdi místo, kde se to dá opravit a zkus to tam opravit. Uznávám, že tenhle bod je otravně obecný, pokud tápeš, zkus se zeptat zkušenějších webařů nebo podívat do dokumentace.
  4. Vyzkoušej, že ti to lokálně funguje tak, jak má.
  5. Zvládneš-li a máš-li čas, zkus to i zdokumentovat a/nebo napsat testy (TODO: chybí návod)
  6. Po dohodě s webaři to vyzkoušej na testwebu
  7. Pošli pull-request a případně zkus reagovat na komentáře
  8. Až se změna začlení do hlavní větve (master) a nasadí se web na produkci, můžeš mít radost, že se web bude používat lépe Tobě i ostatním orgům :-)

Proč pull-requesty?

Účelů pull-requestů je několik. Jednak doufáme, že pomůže webařům se orientovat v kódu, jednak tím umožňujeme dělat experimenty a dávat si zpětnou vazbu. V neposlední řadě pomáhají držet aspoň trochu konzistentní kód, což má pomoci pohodě při programování… (A asi jsem na něco zapomněl :-))