GitHub prakticky

Z Wikiverzity

GitHub je webová služba podporující vývoj softwaru za pomoci verzovacího nástroje Git, lze ji však použít i jako systém pro verzování souborů nebo místo pro týmovou spolupráci.

Ač je prostředí GitHubu vcelku intuitivní, může anglicky nehovořícím nováčkům činit potíže. Obzvlášť těm je určen tento text.

Založení účtu[editovat]

  • v prohlížeči otevřít domovskou stránku GitHubu
  • vpravo nahoře kliknout na poslední tlačítko "Sign Up" (předchozí "Sing In" je pro ty, co již účet mají)
  • zobrazí se průvodce, kde
    1. v prvím kroku je třeba ve formuláři vyplnit:
      • Uživatelské jméno (Username) - objeví-li se červený vykřičník, je již obsazeno a musíte si zvolit jiné
      • E-mailovou adresu (Email address) - bude na něj zaslána ověřovací zpráva
      • Heslo (Password) - minimálně osm znaků z nichž jedno musí být číslice
      • a kliknout dole na zelené tlačítko "Create an account"
    2. v druhém kroku volíte balíček. Nejsnáze
      • ponechat předvolený bezplatný "Free" ($0)
      • nezaškrtávat položky "Help me set up an organization next" a "Send me updates on GitHub news, offers, and events"
      • a kliknout na zelené "Continue"
    3. v třetím kroku se zjišťují vaše zkušenosti a důvody použití GitHubu. Nejsnáze
      • nic nevyplňovat a kliknout na zelené "Submit"
  • v tuto chvíli je účet vytvořen a vy si pomocí tlačítek můžete z mnoha možností zvolit, co dál. Například:
    • "Read the guide" - provede vás použitím GitHubu
    • "Start a project" - vytvoří nový vámi vlastněný projekt (ovšem až po ověření e-mailu)
    • "Explore GitHub" - umožní vám prohlížet si GitHub, ale již jako příhlášený uživatel
    • nebo stránku zavřít
  • proces registrace končí ověřením e-mailu tzn. otevřít svou e-mailouv schránku a v ní zprávu pojmenovanou "[GitHub] Please verify your email address.". Je potřeba
    • kliknout na modré tlačítko "Verify email address"
    • zobrazí se opět stránka GitHubu, kde vlevo nahoře uvidíte "Your email was verified."
  • Hotovo!

Zadání podnětu[editovat]

se vztahuje vždy k určitému projektu (repozitáři) a používá se pro nahlášení chyby, zapsání podnětu či poskytnutí jiné zpětné vazby. Má tyto kroky:

  • na GitHubu zcela vlevo nahoře zapsat název hledaného projektu, např. "otevrene-formalni-normy" a potvrdit Entrem
  • v sezamu výsledků kliknout na nejlépe odpovídající např. opendata-mvcr/otevrene-formalni-normy
  • v horní části pod názvem projektu (repozitáře) kliknout na kartu "Issues"
  • a nasledně pak na zelené tlačítko "New issue"
  • na zobrazeném formuláři je třeba vyplnit
    • titulek/název požadavku. Měl by být stručný a výstižný podobně jako položka "Předmět" při psaní e-mailů
    • popis požadavku dostatečný pro pochopení vašeho sdělení
      • je dobré myslet na snadnou dohledatelnost pro čtenáře např. doplnit odkaz hlásíte-li chybu na webové stránce
    • kliknout dole na zelené tlačítko "Submit new issue"
  • Hotovo!

Poznámky[editovat]

Odkazy[editovat]