Projekt

Obecné

Profil

GitHub-SP1 » Historie » Verze 7

Viktor Vorel, 2017-11-14 15:56

1 1 Viktor Vorel
h1. GitHub
2
3
h1. Co je GitHub a jak funguje?
4
5
GitHub je úložný prostor pro zdrojové kódy projektů. Je možné ukládat jak open-source, tak i soukromé projekty. Soukromé projekty ovšem většinou bývají za menší poplatek.
6
Github zároveň podporuje verzování, tedy ukládání změn v kódu a možnost kdykoliv se vrátit ke starší verzi.
7
8
Kromě samotného úložiště je GitHub využíván k práci více vývojářů na jednom projektu. Vývojáři mohou upravit zdrojový kód komunitního projektu (například psaní knihy s postupy a návody v Javascriptu) a pomocí Pull request zažádat o přidání změny do projektu.
9
10 7 Viktor Vorel
Zvláštností GitHubu oproti jiným nástrojům pro sdílení informací je možnost zapojení celé komunity do projektu (pokud není projekt nastaven jako soukromý).
11
12 3 Viktor Vorel
h1. Pro koho je GitHub určen?
13
14
Hlavní cílovou skupinou jsou programátoři. Může se jednat jak o nováčky, tak i o experty. Pro nováčky je GitHub vhodný, protože obsahuje mnoho tutoriálů a zdrojových kódů k velkému množství open-source projektů, ze kterých se mohou učit. Pro zkušenější programátory je GitHub určen také k přispívání do open-source projektů. Hlavní funkcionalitou, kterou využívají téměř všichni programátoři na GitHubu je samozřejmě možnost ukládání svých kódů do externího, verzovaného systému.
15
16
h1. Jaké informace lze na GitHubu nejlépe zachytit?
17
18 6 Viktor Vorel
Jelikož hlavní funkcionalitou je ukládání zdrojových kódů, tak se jedná zejména o sdílení vlastní zdrojových kódů s komunitou. 
19
Na GitHubu se ovšem vyskytuje i velké množství různých tutoriálů a knih, na kterém komunita spolupracuje.
20 3 Viktor Vorel
21
h1. Je možné jej propojit (integrovat) s dalšími nástroji?
22
23
GitHub je možné propojit například s komunikačním programem Slack, vývojářskými nástroji Visual Studio, Eclipse apod.
24
Zde je ukázka návodu integrace GitHubu se Slackem:
25 4 Viktor Vorel
26 3 Viktor Vorel
!slack.jpg!
27 4 Viktor Vorel
28 1 Viktor Vorel
h1. Ukázka vybraného projektu
29
30
!javascript.jpg!
31
32
V horní části projektu je menu. Nejdůležitějšími částmi menu projektu jsou tlačítka Code, Issues a Pull requests.
33
34
h2. Code
35
36
V této části je možné vidět veškeré schválené příspěvky do projektu. Běžně se zde nachází také Readme.md soubor s informacemi o projektu. Samozřejmostí jsou také zdrojové kódy projektu (nebo texty knihy, kterou komunita píše apod.)
37
V této sekci jsou také možné nejdůležitější funkce při práci na komunitním projektu, přispívat vlastními znalostmi a projekt tak rozšiřovat. Je možné vytvořit nový soubor v projektu (nebo ho nahrát), projekt stáhnout nebo ho naklonovat do svého GitHub účtu. Pomocí funkce New pull request je možné porovnávat dvě různé verze projektu a projekt aktualizovat a zažádat o přidání vaší aktualizace do projektu.
38
39
Dále se zde nachází tagy projektu pro přehlednější vyhledávání, počet příspěvků do projektu, počet vydání a počet přispěvatelů. Na tomto projektu se podílí celkem 363 lidí.
40
41
h2. Issues
42
43
!Javascript_issues.jpg!
44
45
Issues projektu složí přispěvatelům nebo jen čtenářům k popsání různých problémů, které se v knize vyskytují.
46
Většinou se jedná o drobné chyby v projektu, nebo jiné problémy s jejím obsahem. Například část knihy pojednávající o možném kódu pro řešení určité situace uživateli nefunguje, jak by měl. Místo opravení samotné knihy tedy založí vlákno v Issues s popisem problému, jelikož většinou bude chyba na straně uživatele.
47
48
h3. Pull requests
49
50 2 Viktor Vorel
!Javascript_pull.jpg!
51 1 Viktor Vorel
52
V sekci Pull requests jsou zobrazeny aktuální návrhy na aktualizaci projektu.
53
K jednotlivým příspěvkům je možné přidávat komentáře a když dojde ke shodě na návrhu, bude přiřazen k oficiální verzi projektu.
54
55 6 Viktor Vorel
h3. Příklad využití
56 1 Viktor Vorel
57 7 Viktor Vorel
Při zobrazení zdrojového textu projektu je možné kliknout na editaci:
58
 !{height: 6em; margin: 1em}(wiking shadow)new_fork.jpg!"(wiking button)Plná velikost":https://students.kiv.zcu.cz:3443/attachments/download/1504/new_fork.jpg
59
Následně se otevře stránka pro editaci obsahu :
60
 !{height: 6em; margin: 1em}(wiking shadow)changes.jpg!"(wiking button)Plná velikost":https://students.kiv.zcu.cz:3443/attachments/download/1506/changes.jpg
61
V režimu je editace je možné upravit nebo přidat další obsah. Po přidání změn do projektu je možné nechat web zobrazit změny oproti originálnímu souboru:
62
!{height: 6em; margin: 1em}(wiking shadow)preview.jpg!"(wiking button)Plná velikost":https://students.kiv.zcu.cz:3443/attachments/download/1507/preview.jpg
63
Původní řádek se zabarví červeně a přeškrtne se, pod ním se objeví zeleně změna, kterou jsme do projektu zapracovali.
64
65
Aby projekt nemohl kdokoliv měnit, přidávat do něj (i nezáměrně) chyby, nebo zcela projekt smazat, po uložení se změny v projektu vůbec neprojeví.
66
Místo samotného uložení změn do projektu je umožněno pouze návrh změny. Tento návrh se poté zobrazí ostatním členům komunity mezi ostatními Pull requests, kde dané změny mohou diskutovat a následné je změna schválena, zamítnuta nebo jsou požadovány dodatečné úpravy změny.
67
!{height: 6em; margin: 1em}(wiking shadow)propose_change.JPG!"(wiking button)Plná velikost":https://students.kiv.zcu.cz:3443/attachments/download/1508/propose_change.JPG
68
69 1 Viktor Vorel
70 4 Viktor Vorel
h1. Zdroje
71 5 Viktor Vorel
72 4 Viktor Vorel
https://get.slack.help/hc/en-us/articles/232289568-Use-GitHub-with-Slack
73
https://github.com/airbnb/javascript