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.

Koťátka

Pro roztomilá koťátka navštivte stránku Kočky

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

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.

Č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.

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.

Typesetting/Sazba

Tento obor je dostupný na adrese https://tr.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/tr.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.

THE CATTO KNOWS ALL