Tento repozitář slouží jako zdroj pro materiály datového kurzu, který najdeš (ve vydání roku 2024) na adrese https://naucse.python.cz/2024/pydata-praha-podzim/.
Chceš-li server spustit na svém počítači, např. proto, že se chceš zapojit do vývoje, je potřeba ho nejdřív nainstalovat:
Nemáš-li uv, nainstaluj si jej. Na to je několik způsobů:
- podle návodu
Přepni se do adresáře s projektem a spusť:
uv syncChceš-li si kurz prohlédnout, přepni se do adresáře s projektem a spusť:
uv run python -m naucse serve- Program vypíše adresu (např.
http://0.0.0.0:8003/).- Buď adresu navštiv v prohlížeči a doklikej se na kurz, nebo
- na konec adresy přidej
/course/local/a navštiv kurz přímo.
Poznámka @janpipek: ve windows ani linuxu mi to nefunguje :-( Ale tím asi netřeba se trápit.
Balíček ZIP se všemi materiály lze vytvořit použitím skriptu:
uv run cli.py export <id-hodiny>Ten se posílá účastnicím přes slack těsně před hodinou.
-
Aby se vůbec něco nahrálo na web, kurz musí být definován v repozitáři https://github.com/pyvec/naucse.python.cz, konkrétně v souboru
courses.yaml -
Soubor
.github/workflows/main.ymlv tomto repozitáři musí definovat odpovídající jméno větve, do které se mají materiály kompilovat (aktuálně tedycompiled2024) -
Potom by mělo stačit mergovat cokoliv do větve
main, aby se vše automaticky propsalo na web. -
⚠️ Nicméně ono se sice vyplodí, co se vyplodit má, ale na web nenahraje. Je potřeba to prošťouchnout pomocí akce v hlavním repozitáři: https://github.com/pyvec/naucse.python.cz/actions/workflows/main.yml . Ta se spustí tlačítkem "Run workflow" vpravo nahoře. Pokud by chyběla práva, @janpipek či @coobas by právo mít měli.
Do několika minut je hotovo 🎉
- naucse nemá rádo javascript ve stránkách, předvším pak plotly výstup. Ten koliduje s šablonovacím systémem a stránka se prostě nerenderuje. Je potřeba z notebooků toto odstranit.