GJK Cat - Repozitář studijních materiálů
Vítejte na webu GJK Kočky, který slouží jako zdroj studijních materiálů jak od kantorů, tak od studentů. V postranní nabídce si můžete zvolit obor a přesunout se na pod-wiki pro předměty daného oboru. Pokud byste rádi přidali nějaké materiály na tento web, přečtěte si jak přispět.
Vytváření materiálů na gjk.cat vyžaduje znalost Git(hub)u a formátu Markdown. Pokud je neznáte, navštivte sekci návody.
Kontakt
Tuto wiki spravuje Lukáš Hozda. Pro více kontaktních informací viz sekce Kontakt & Podpora.
Obory
V současnosti běží gjk.cat pro několik studijních oborů, které najdete v postraním panelu. Nejdále na tom je samozřejmě informatika, ale i ostatní předměty se budou brzo plnit!
Domnívate-li se, že by měl být do sítě gjk.cat zařazen další obor, napište mi na luk.hozda@gmail.com.
Podmínkou přijetí dalšího oboru je to, že jej buď budete spravovat, nebo máte někoho, kdo by se toho ujmul
Současně vedené obory - rychlý přehled
- Informatika - Lukáš Hozda
- Angličtina - Lukáš Hozda
- Čeština - Lukáš Hozda
- Typesetting/Sazba - Lukáš Hozda
Angličtina
Tento obor je dostupný na adrese https://aj.gjk.cat a spravovaný Lukášem Hozdou (viz karty na stránce).
Zdrojový kód tohoto oboru se nalézá zde:
https://github.com/gjk-cat/aj.gjk.cat
Pro přispívání k tomuto oboru se vztahují standardní procedury.
Biologie
Tento obor je dostupný na adrese https://bi.gjk.cat a spravovaný Lukášem Hozdou (viz karty na stránce).
Zdrojový kód tohoto oboru se nalézá zde:
https://github.com/gjk-cat/bi.gjk.cat
Pro přispívání k tomuto oboru se vztahují standardní procedury.
Čeština
Tento obor je dostupný na adrese https://cj.gjk.cat a spravovaný Lukášem Hozdou (viz karty na stránce).
Zdrojový kód tohoto oboru se nalézá zde:
https://github.com/gjk-cat/cj.gjk.cat
Pro přispívání k tomuto oboru se vztahují standardní procedury.
Fyzika
Tento obor je dostupný na adrese https://fy.gjk.cat a spravovaný Lukášem Hozdou (viz karty na stránce).
Zdrojový kód tohoto oboru se nalézá zde:
https://github.com/gjk-cat/fy.gjk.cat
Pro přispívání k tomuto oboru se vztahují standardní procedury.
Humanitní předměty
Tento obor je dostupný na adrese https://hu.gjk.cat a spravovaný Lukášem Hozdou (viz karty na stránce).
Zdrojový kód tohoto oboru se nalézá zde:
https://github.com/gjk-cat/hu.gjk.cat
Pro přispívání k tomuto oboru se vztahují standardní procedury.
Chemie
Tento obor je dostupný na adrese https://ch.gjk.cat a spravovaný Lukášem Hozdou (viz karty na stránce).
Zdrojový kód tohoto oboru se nalézá zde:
https://github.com/gjk-cat/ch.gjk.cat
Pro přispívání k tomuto oboru se vztahují standardní procedury.
Informatika
Tento obor je dostupný na adrese https://it.gjk.cat a spravovaný Lukášem Hozdou (viz karty na stárnce).
Zdrojový kód tohoto oboru se nalézá zde:
https://github.com/gjk-cat/it.gjk.cat
Pro přispívání k tomuto oboru se vztahují standardní procedury.
Jiné jazyky
Tento obor je dostupný na adrese https://jj.gjk.cat a spravovaný Lukášem Hozdou (viz karty na stránce).
Zdrojový kód tohoto oboru se nalézá zde:
https://github.com/gjk-cat/jj.gjk.cat
Pro přispívání k tomuto oboru se vztahují standardní procedury.
Matematika
Tento obor je dostupný na adrese https://ma.gjk.cat a spravovaný Lukášem Hozdou (viz karty na stránce).
Zdrojový kód tohoto oboru se nalézá zde:
https://github.com/gjk-cat/ma.gjk.cat
Pro přispívání k tomuto oboru se vztahují standardní procedury.
Přispívání
Poznámka: Před přispíváním k tomuto projektu je zapotřebí být obeznámen s gitem a markdownem.
Navštivte sekci "Návody" pro více informací.
Přejete-li si přidat materiály, tak prvním krokem je vytvoření forku daného repozitáře.
Ve vyhledávači existuje mnoho návodů, jak se touto procedurou prokousat.
Poté ve vašem forku provedete změny a otestujete se je.
Pokud se takříkajíc "Nechcete zdržet" nebo vám nebylo
povoleno založit si kartu v teachers.md, tak stačí
pouze přidání nového materiálu. Jinak si založte i kartu.
Své změny důkladně otestujte v lokálním prostředí (Repozitář obsahuje instrukce, jak spouštet stránky lokálně).
Následně vytvořte nový Pull Request a správce daného webu váš obsah buď přijme, odmítne, nebo bude vyžadovat změny.
Dlouhodobí přispěvatelé by měli být přizvání do repozitáře, aby se mohli tomuto vyhnout (používání oddělených pull requestů je ale stále dobrý nápad.)
Návody
Tato sekce obsahuje návody a odkazy na návody týkající se problematiky gjk.cat
Markdown
Git
Přidání nového kantora
Ve složce teachers vytvořte nový soubor tvaru <jmeno>.toml.
Jako obsah na doplňte správné hodnoty do této šablony (viz cat-prep README](https://github.com/gjk-cat/cat-prep)):
jmeno = "Lukáš Hozda" # má odpovídat jménu, které osoba používá v gitu, tj. `user.name`
email = "luk.hozda@gmail.com" # odpovídá email, který osoba používá v gitu, tj. `user.email`
username = "magnusi" # pro kontexty, kde se nevyplatí používat email nebo jméno, např. odkazy
# libovolný popisek, formátován jako markdown, může sloužit na extra informace
# doporučuje se začínat na třetí úrovni nadpisů v zájmu přehlednosti seznamu vyučujících
bio = """
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Sed lacinia hendrerit placerat.
### Mauris posuere libero dui
non feugiat nunc imperdiet non. Ut pharetra sodales mi,
quis __sagittis__ velit __tristique__ tincidunt.[1]
### Sed in tellus tincidunt, molestie libero vel,
semper mi. Praesent lacus felis, `aliquam` in tempor vel,
fringilla eget dui. Quisque *tristique* pulvinar fringilla.
[1]: <https://www.lipsum.com/feed/html>
"""
Přidání nového předmětu
Ve složce src vytvořte podsložku (nebo podpodsložku, dle ustanoveného systému).
Do ní přidejte soubor subject.md s následujícím obsahem (nahraďte za správné hodnoty):
nazev = "Můj první předmět"
zodpovedna_osoba = "Lukáš Hozda"
# ↑ pokud možno, mělo by odpovídat jménu, emailu nebo usernamu některého vyučujícícho
# pokud je autorem někdo jiný, zadejte email.
bio = "krátký popisek předmětu"
+++
## Můj první předmět
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
In varius lacinia risus eu vehicula. Vestibulum consectetur
feugiat dignissim. Mauris sed leo id lectus commodo egestas.
Integer sed ligula quis lorem viverra fringilla lobortis at elit.
Fusce a eros laoreet, dictum enim et, pellentesque erat.
Nezapomeňte tento soubor zmínit v SUMMARY.md,
viz mdbook dokumentace
Od teď všechny soubory, které jsou zmíněné v SUMMARY.md
a nalézají se u nebo v podsložkách vůči souboru subject.md
budou považovány za materiály patřící k tomuto předmětu.
Přidání nového materiálu
Pro přidání nového materiálu k předmětu je zapotřebí vytvořit
nový markdownový soubor na stejné úrovni nebo v podsložce vůči souboru
subject.md patřícího k danému předmětu.
Poté je potřeba tento soubor zmínit kdekoliv v SUMMARY.md.
Kočičí hierarchie je paralelní té mdbookové,
takže materiály nemusí být přímo podprvky svých subject.md souborů.
Tento soubor má identické formátování jako ostatní kapitoly, akorát musí mít nahoře hlavičku s TOML konfigurací.
Mohl by vypadat třeba takto:
nazev = "Můj první článek"
tagy = ["tag1", "tag2", "tag3"]
datum = "20.1.2019" # dobrovolné a libovolné. Jelikož "datum" je singulár od "data", lze použít jakkoliv :^)
+++
# Můj první článek
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
In varius lacinia risus eu vehicula. Vestibulum consectetur
feugiat dignissim. Mauris sed leo id lectus commodo egestas.
Integer sed ligula quis lorem viverra fringilla lobortis at elit.
Fusce a eros laoreet, dictum enim et, pellentesque erat.
Mazání objektů
stačí smazat soubory
Tvorba vlastní cat-wiki a deployment na ZEIT.co
viz cat-prep
Kontakt & Podpora
Tyto stránky spravuji já (Lukáš Hozda). Zde je pár kontaktů na mou osobu:
- email: luk.hozda@gmail.com
- discord: magnusi#7132
- github: https://github.com/luciusmagn
- telegram: @luciusmagn
Dále bude po koronavirové karanténě mě možné zastihnout ve všední dny na Gymnáziu Jana Keplera.
V případě problémů mi buď napište na jedné ze zvolených platforem, nebo otevřete issue na Githubu v příslušném repozitáři.
