• Python 77.6%
  • HTML 14.3%
  • CSS 3.6%
  • Vue 1.8%
  • JavaScript 1%
  • Other 1.6%
Find a file
2026-11-10 18:56:13 +01:00
aesop Choices: sjednocení na TextChoices 2026-11-07 14:42:53 +01:00
api Choices: sjednocení na TextChoices 2026-11-07 14:42:53 +01:00
data Merge branch 'pre-merge-galerie-videjka' into merge-galerie-videjka 2026-03-18 02:27:16 +01:00
deploy_v2 psycopg 3 místo psycopg2 2026-11-07 13:48:30 +01:00
docs psycopg 3 místo psycopg2 2026-11-07 13:48:30 +01:00
galerie Fix odkaz na nedosažitelnou galerii 2026-06-11 22:30:43 +02:00
header_fotky Choices: sjednocení na TextChoices 2026-11-07 14:42:53 +01:00
korektury hotfix korekturovátka 2026-05-29 21:02:20 +02:00
make Make skripty: podpora pro uv 2026-10-06 18:53:41 +02:00
mamweb Merge pull request 'Settings: SecurityMiddleware (z check --deploy)' (!148) from security-middleware into master 2026-11-07 14:09:41 +01:00
novinky Změny white-spaců v importech 2026-02-22 11:50:49 +01:00
odevzdavatko Merge branch 'master' into oprava-detail-reseni-pristup 2026-11-07 15:12:53 +01:00
personalni Merge pull request 'Výsledkovky: zbavit se N+1 dotazů' (!142) from optimalizace-vysledkovky into master 2026-11-07 15:14:28 +01:00
prednasky Změny white-spaců v importech 2026-02-22 11:50:49 +01:00
seminar seminar.models se načítá automaticky, budiž to mamweb.vsechno 2024-11-05 22:25:40 +01:00
setup Správný odkaz na diff (na wiki)? 2024-07-09 19:32:09 +02:00
sifrovacka Změny white-spaců v importech 2026-02-22 11:50:49 +01:00
soustredeni Merge pull request 'Choices: sjednocení na TextChoices' (!143) from choices-enumy into master 2026-11-07 14:48:34 +01:00
split-apps-meta Změny white-spaců v importech 2026-02-22 11:50:49 +01:00
treenode Změny white-spaců v importech 2026-02-22 11:50:49 +01:00
tvorba Úprava počítání ročníků, které ještě neodmaturovaly na exportu 2026-11-10 18:54:18 +01:00
various maillink escapuje text odkazu a kóduje adresy 2026-11-07 22:44:56 +01:00
vue_frontend Přesun vue (zatím) do treenodů 2024-11-01 13:20:28 +01:00
vyroci Změny white-spaců v importech 2026-02-22 11:50:49 +01:00
vysledkovky Výsledkovky: staré body jako kwargs místo tuplu 2026-11-07 15:02:55 +01:00
.editorconfig Komentáře česky 2022-11-16 21:20:09 +01:00
.gitignore Fix .gitignore 2026-01-20 19:36:29 +01:00
.mailmap Jmenuju se LEdo, nechť to web ví :-) 2026-03-18 00:36:16 +01:00
.python-version Upgrade Gimliho 2026-01-02 20:21:29 +01:00
checklinks.sh checklinks: zobrazit i jediný rozbitý odkaz 2021-11-26 05:33:24 +01:00
convert_spaces_to_tabs.sh Změna mezer na tabulátory 2019-05-11 01:15:05 +02:00
diff_db_backup.sh Update diff tool 2015-07-29 12:06:08 +02:00
docker-compose.yml Docker přesvědčen, aby používal Postgres 2023-10-02 13:27:39 +02:00
docker_entrypoint.sh Docker přesvědčen, aby používal Postgres 2023-10-02 13:27:39 +02:00
Dockerfile Fix docker base balíček 2026-01-20 19:36:29 +01:00
fix_json.py Fix sphinx-build: error: argument input: can't open 'html': [Errno 2] No such file or directory: 'html' 2026-03-17 21:01:14 +01:00
Makefile Make: výchozí target se jmenuje default 2022-11-20 04:13:15 +01:00
manage.py Nový Makefile. Bude vyžadovat změny uWSGi configu. 2019-04-23 22:34:05 +02:00
pyproject.toml psycopg 3 místo psycopg2 2026-11-07 13:48:30 +01:00
README.md Předěláno Readme 2022-11-20 15:38:41 +01:00
uv.lock psycopg 3 místo psycopg2 2026-11-07 13:48:30 +01:00

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