GitHub-SP1 » Historie » Verze 12
Viktor Vorel, 2017-11-15 09:11
1 | 1 | Viktor Vorel | h1. GitHub |
---|---|---|---|
2 | |||
3 | 8 | Viktor Vorel | h2. Co je GitHub a jak funguje? |
4 | 1 | Viktor Vorel | |
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 | 8 | Viktor Vorel | h2. Pro koho je GitHub určen? |
13 | 3 | Viktor Vorel | |
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 | 8 | Viktor Vorel | h2. Jaké informace lze na GitHubu nejlépe zachytit? |
17 | 3 | Viktor Vorel | |
18 | 12 | Viktor Vorel | Jelikož hlavní funkcionalitou je ukládání zdrojových kódů, tak se jedná zejména o sdílení vlastních 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ých komunita spolupracuje. |
||
20 | 3 | Viktor Vorel | |
21 | 8 | Viktor Vorel | h2. Je možné jej propojit (integrovat) s dalšími nástroji? |
22 | 3 | Viktor Vorel | |
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 | 8 | Viktor Vorel | h2. Ukázka vybraného projektu |
29 | 1 | Viktor Vorel | |
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 | 8 | Viktor Vorel | h3. Code |
35 | 1 | Viktor Vorel | |
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 | 8 | Viktor Vorel | h3. Issues |
42 | 1 | Viktor Vorel | |
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 | 8 | Viktor Vorel | h2. 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 | 10 | Viktor Vorel | !{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 | 7 | Viktor Vorel | Následně se otevře stránka pro editaci obsahu : |
60 | 10 | Viktor Vorel | !{height: 6em; margin: 1em}(wiking shadow)changes.jpg!"(wiking button)Plná velikost":https://students.kiv.zcu.cz:3443/attachments/download/1510/changes.JPG |
61 | 11 | Viktor Vorel | V režimu 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 | 10 | Viktor Vorel | !{height: 6em; margin: 1em}(wiking shadow)preview.jpg!"(wiking button)Plná velikost":https://students.kiv.zcu.cz:3443/attachments/download/1511/preview.JPG |
63 | 7 | Viktor Vorel | 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 | 11 | Viktor Vorel | Místo samotného uložení změn do projektu je umožněn 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 | 9 | Viktor Vorel | !{height: 6em; margin: 1em}(wiking shadow)propose_change.JPG!"(wiking button)Plná velikost":https://students.kiv.zcu.cz:3443/attachments/download/1512/propose_change.JPG |
68 | 7 | Viktor Vorel | |
69 | 1 | Viktor Vorel | |
70 | 8 | Viktor Vorel | h2. 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 |