/sk/sprievodca

GitHub pre čitateľov zákonov

GitHub je web, na ktorom sa zdieľajú súbory a stráži sa každá ich zmena. Programátori tam majú programy, my tam máme zákony s výkladom. Tento sprievodca vás naučí všetko, čo na čítanie potrebujete — bez účtu a bez jediného riadku kódu.

  1. Otvorte repozitár zákona

    V katalógu kliknite na zákon, ktorý vás zaujíma. Otvorí sa repozitár — priečinok projektu na GitHube. Hore vidíte zoznam súborov, pod ním sa automaticky zobrazí README: úvodná stránka, ktorá uvádza dátum, ku ktorému je znenie zákona konsolidované, a odkaz na zdrojové znenie na Slov-Lexe. Súbory sú uložené na jednej úrovni, bez podpriečinkov. Takto vyzerá jeden z repozitárov — komentár k Trestnému zákonu; názvy súborov s kapitolami sa medzi zákonmi líšia, zoznam nájdete vždy v INDEX.md.

  2. Čítajte kapitoly ako webové stránky

    Súbory s príponou .md („markdown" — prostý text s jednoduchým formátovaním) GitHub zobrazí naformátované: s nadpismi, citáciami a tabuľkami. Stačí kliknúť na názov súboru a čítať. Späť sa vrátite šípkou prehliadača.

    Tip: vľavo nad textom je ikona osnovy (tri čiarky) — rozbalí obsah kapitoly a z neho sa dostanete priamo na jednotlivé paragrafy.

  3. Nájdite svoj paragraf

    Hore na stránke repozitára je pole s lupou („Go to file" / hľadanie). Kliknite do neho a napíšte, čo hľadáte — GitHub ponúkne súbory aj miesta v texte. Hľadať môžete číslo paragrafu aj slová z výkladu. Ak chcete najprv vidieť, v ktorej kapitole váš paragraf leží, otvorte INDEX.md: pri každej kapitole je uvedený rozsah paragrafov.

    Tip: klávesa T na stránke repozitára otvorí rýchle hľadanie súborov; Ctrl+F hľadá v otvorenej kapitole.

  4. Pozrite sa, čo a kedy sa zmenilo

    Právo sa mení — a tu je vidieť ako. Tlačidlo History (pri každom súbore vpravo hore) ukáže zoznam všetkých úprav: kedy prebehli a čo presne sa zmenilo, riadok po riadku. Žiadne tiché prepisovanie; každá verzia textu zostáva dohľadateľná.

  5. Stiahnite si, čo potrebujete

    Celý komentár: zelené tlačidlo CodeDownload ZIP. Jednotlivú kapitolu: tlačidlo Raw zobrazí čistý text, ktorý uložíte klávesami Ctrl+S, prípadne ho priamo vytlačíte z prehliadača.

  6. Zapojte sa (jediný krok, ktorý vyžaduje účet)

    S bezplatným účtom na GitHube môžete v záložke Issues nahlásiť chybu alebo položiť otázku k výkladu — verejne, takže odpoveď poslúži aj ďalším. Hviezdička (Star) uloží repozitár medzi obľúbené, Watch vám pošle upozornenie na každú zmenu.

/slovnicek

Slovníček pojmov

repozitár
Priečinok projektu na GitHube. Tu: jeden zákon = jeden repozitár.
markdown (.md)
Prostý text s jednoduchým značením nadpisov a citácií. GitHub ho zobrazí naformátovaný.
README
Úvodný súbor repozitára — dátum konsolidácie znenia a odkaz na zdroj na Slov-Lexe.
INDEX.md
Prehľad všetkých kapitol komentára s rozsahom paragrafov v každej z nich.
commit
Jedna uložená zmena textu, s dátumom a popisom. Z commitov sa skladá história.
Issue
Verejný podnet: hlásenie chyby alebo otázka k výkladu. Vyžaduje bezplatný účet.
Raw
Zobrazenie čistého textu súboru — vhodné na uloženie alebo tlač.

Späť do katalógu — vybrať zákon