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 |