1. témakör · Alapok és munkakörnyezet · 4. fejezet
Létrehozzuk a GitHub-fiókot, biztonságossá tesszük kétlépcsős azonosítással, és bejárjuk egy repó oldalát. Megismerjük a nyilvános és a privát repó különbségét, és Markdownban megírjuk az első README-t.
A Git a gépeden, fiók nélkül is működik. A GitHub-fiókkal viszont a repóid a felhőbe is felkerülnek, és ez sok mindent lehetővé tesz:
A GitHub Free csomag ingyenes: korlátlan számú nyilvános és privát repót hozhatsz létre benne. Diákok a
GitHub Education programon keresztül (education.github.com) ingyen kaphatnak
extra szolgáltatásokat is (Student Developer Pack). Ehhez iskolai e-mail címmel vagy diákigazolvánnyal kell
igazolni a diákstátuszt.
github.com oldalt, és kattints a Sign up gombra.A GitHub felhasználási feltételei szerint a fiók létrehozásához legalább 13 évesnek kell lenned.
A felhasználóneved a profilod címe is lesz (github.com/felhasznalonev), és minden
repód címében szerepel. Évekig használni fogod, és munkáltatók is látják, ezért érdemes gondosan választani.
kovacs-anna, annakovacs).xXgamer2009Xx),
és az osztályhoz kötött nevet (anna-10b). Jövőre már nem igaz.Jelszó: legalább 15 karakter, vagy legalább 8 karakter, amelyben van szám és kisbetű is. Ne használd ugyanazt a jelszót máshol!
Próbálj ki néhány nevet! Az ellenőrző a GitHub szabályai szerint vizsgálja, és tanácsot is ad. (Hogy a név szabad-e még, azt csak a GitHub tudja megmondani.)
A kétlépcsős azonosítás (angolul two-factor authentication, 2FA) azt jelenti, hogy belépéskor a jelszó mellé egy második bizonyíték is kell: valami, ami csak nálad van, például a telefonodon egy hitelesítő alkalmazás által 30 másodpercenként generált 6 jegyű kód. Így ha valaki megszerzi a jelszavadat, akkor sem tud belépni.
A GitHub a kódot feltöltő felhasználóktól megköveteli a 2FA-t. A regisztráció után értesítést kapsz, és egy határidőn belül be kell kapcsolnod. Beállítása: avatar → Settings → Password and authentication → Enable two-factor authentication.
| Módszer | Hogyan működik? | Megjegyzés |
|---|---|---|
| Hitelesítő alkalmazás (TOTP) | Egy QR-kód beolvasása után az app (pl. Microsoft Authenticator, Google Authenticator) 30 másodpercenként új kódot mutat. | Ajánlott, internet nélkül is működik. |
| GitHub Mobile | A telefonos GitHub-alkalmazásban kell jóváhagyni a belépést. | Kényelmes kiegészítés. |
| Passkey / biztonsági kulcs | Ujjlenyomat, arcfelismerés, Windows Hello vagy USB-kulcs. | A legbiztonságosabb. |
| SMS | Kód szöveges üzenetben. | Nem minden országban elérhető, és a legkevésbé biztonságos. |
A 2FA bekapcsolásakor a GitHub helyreállító kódokat (recovery codes) ad. Töltsd le őket, és tedd biztonságos helyre (nyomtatva otthon, jelszókezelőben). Ha elveszíted a telefonodat, csak ezekkel tudsz visszajutni a fiókodba. Nélkülük a fiók akár véglegesen is elveszhet.
A commitjaidban szerepel a user.email értéke (2. fejezet). Ha a repó nyilvános, ezt a címet
bárki láthatja, aki megnézi a commitokat. Hogy ne kelljen a valódi címedet közzétenned, a GitHub
egy helyettesítő, úgynevezett noreply címet ad:
12345678+kovacs-anna@users.noreply.github.comPS> git config --global user.email "12345678+kovacs-anna@users.noreply.github.com"
A GitHub a noreply címmel készült commitokat is a profilodhoz kapcsolja: megjelenik mellettük a profilképed, és beszámítanak a zöld négyzetes aktivitási táblázatba (contribution graph).
Mindegy, hogy a valódi címedet vagy a noreply címet használod. A lényeg, hogy a user.email
a GitHub-fiókodhoz tartozó cím legyen. Különben a commitjaid „gazdátlanok” lesznek: szürke ikon
jelenik meg mellettük, és nem számítanak bele a profilodba.
A profiloldalad (github.com/felhasznalonev) a névjegyed. Az avatar → Your profile → Edit
profile menüben állíthatod be:
Ha létrehozol egy nyilvános repót, amelynek a neve pontosan megegyezik a felhasználóneveddel
(pl. kovacs-anna/kovacs-anna), és van benne README.md, akkor a GitHub ennek a
tartalmát a profiloldalad tetején jeleníti meg. Ez egy személyes bemutatkozó oldal.
Egy repó címe mindig github.com/tulajdonos/repónév, például
github.com/kovacs-anna/webshop. Kattints a számokra, és nézd meg, mi mire való!
Iskolai projekt: egyszerű webáruház HTML, CSS és JavaScript alapokon.
A láthatóság később is módosítható: Settings → General → Danger Zone → Change repository visibility.
Jelszó, API-kulcs, adatbázis-hozzáférés akkor sem való a repóba, ha az privát. A privát repót később nyilvánossá
tehetik, és a Git a teljes történetet megőrzi: egy egyszer már commitolt jelszó a későbbi törlés
után is ott marad a korábbi commitokban. (A 9. fejezetben megmutatjuk, hogyan tartsd távol a titkokat a
.gitignore segítségével.)
Melyik láthatóságot választanád az adott projekthez?
A jobb felső sarokban a + menü → New repository. Az űrlap mezői:
| Mező | Mit adj meg? |
|---|---|
| Owner | A tulajdonos: te, vagy egy szervezet (pl. az iskola GitHub-szervezete). |
| Repository name | Rövid, beszédes név: bemutatkozas, webshop. Angol betűk, számok, -, _ és . lehet benne; szóköz helyett kötőjelet használj. |
| Description | Egymondatos leírás (nem kötelező, de hasznos). |
| Visibility | Public vagy Private. |
| Add README | Létrehoz egy README.md fájlt. Így a repó nem üres, és rögtön klónozható. |
| Add .gitignore | Sablon a nyelvhez (pl. Node, VisualStudio); a 9. fejezet témája. |
| Add license | Nyilvános projektnél ez mondja meg, mit tehetnek mások a kódoddal (pl. MIT License). |
A Create repository után a repó oldalára kerülsz. A README-t a ceruza ikonnal (Edit this file) rögtön szerkesztheted a böngészőben.
Ha a GitHub felületén módosítasz egy fájlt, a mentés gombja Commit changes… feliratú. A megjelenő ablakban commitüzenetet kell írni, és a mentés egy valódi commitot hoz létre a repóban, a neveddel. Ugyanaz történik, mint a parancssorban, csak a böngészőből.
A README.md a repó „címlapja”: a GitHub a fájllista alatt automatikusan megjeleníti. Érdemes
leírni benne, mi a projekt, hogyan kell elindítani, és ki készítette.
A .md kiterjesztés a Markdown formátumot jelöli. Ez egyszerű jelölőnyelv, sima
szövegből formázott oldalt készít.
| Ezt írod | Ez lesz belőle |
|---|---|
# Cím · ## Alcím | első és második szintű címsor |
**félkövér** · *dőlt* | félkövér · dőlt |
- elem · 1. elem | felsorolás · számozott lista |
- [x] kész · - [ ] teendő | jelölőnégyzetes lista |
[szöveg](https://…) | hivatkozás |
 | kép |
`kód` | kód a szövegben |
```js … ``` | kódblokk (színezéssel) |
> idézet · --- | idézet · vízszintes vonal |
Írd át a bal oldali szöveget. Jobb oldalon azonnal látod, hogyan jelenítené meg a GitHub. (Egyszerűsített előnézet: a leggyakoribb Markdown-elemeket ismeri.)
A GitHub Desktop ezentúl eléri a GitHubon lévő repóidat: a File → Clone repository ablakban listázza őket. Ezt a 17. fejezetben használjuk.
Óra végén jelentkezz ki: Options → Accounts → Sign out, és a böngészőben is. Részletesen a 2. fejezetben (Közös, iskolai gépen).
⭐ alap · ⭐⭐ haladó · ⭐⭐⭐ kihívás
Hozd létre a GitHub-fiókodat (ha még nincs). Előtte a Felhasználónév-ellenőrzővel próbálj ki legalább három nevet, és indokold, miért azt választottad!
Kapcsold be a kétlépcsős azonosítást egy hitelesítő alkalmazással! Töltsd le a helyreállító kódokat, és mondd el, hol tárolod őket (magát a kódot ne!).
Kapcsold be a Keep my email addresses private beállítást, másold ki a noreply címedet, és állítsd be a Gitben
user.email-ként! Ellenőrizd: git config user.email.
Hozz létre egy nyilvános bemutatkozas repót README-vel! Szerkeszd a README-t a böngészőben:
legyen benne cím, alcím, lista, jelölőnégyzetes lista és egy link. Beszédes commitüzenettel mentsd. Utána nézd
meg a repó commitjait: hány van, és kié?
Készítsd el a profil-README-det (a felhasználóneveddel azonos nevű nyilvános repó), és ellenőrizd, hogy megjelenik-e a profiloldaladon!
Jelentkezz be a GitHub Desktopba! A File → Clone repository ablakban látod-e a bemutatkozas
repót? (Klónozni még ne klónozd.) Utána jelentkezz ki, ha közös gépen vagy.
Nézd meg ezt a három nyilvános repót: git/git, microsoft/vscode,
torvalds/linux. Készíts táblázatot: hány csillaguk, forkjuk és commitjuk van, milyen
licenc alatt érhetők el, és mikor volt az utolsó commit!
Az egyválasztós kérdéseknél kattints a válaszra. A többválasztósaknál jelöld be az összes helyeset, majd nyomd meg az Ellenőrzés gombot.
| Fogalom | Jelentés |
|---|---|
| felhasználónév (username) | a GitHub-azonosítód; a profilod és a repóid címében is szerepel |
| kétlépcsős azonosítás (2FA) | belépés jelszóval + egy második bizonyítékkal (pl. hitelesítő app kódja) |
| helyreállító kódok (recovery codes) | egyszer használatos kódok a fiókba való visszajutáshoz, ha a 2FA eszköz elveszett |
| noreply e-mail cím | a GitHub által adott helyettesítő cím, amely elrejti a valódit, de a commitokat a profilodhoz köti |
| nyilvános (public) repó | bárki láthatja, klónozhatja, forkolhatja; módosítani csak a jogosultak tudják |
| privát (private) repó | csak a tulajdonos és a meghívott közreműködők látják |
| közreműködő (collaborator) | a tulajdonos által meghívott felhasználó, aki írhat a repóba |
| Star · Watch · Fork | csillag (könyvjelző, elismerés) · értesítések követése · másolat a saját fiókodba |
| README.md | a repó leírása, amelyet a GitHub a fájllista alatt megjelenít |
| Markdown (.md) | egyszerű jelölőnyelv: sima szövegből formázott oldal (#, **, - …) |
| profil-README | a felhasználóneveddel azonos nevű nyilvános repó README-je, amely a profilodon jelenik meg |
| licenc | a felhasználási feltételek: mit tehetnek mások a kódoddal (pl. MIT) |
user.email legyen a fiókodhoz tartozó cím. A valódi címed elrejtéséhez használd a
noreply címet.Ezzel kész a munkakörnyezet. A következő témakörben a saját gépeden hozol létre repót, és elkészíted az első commitjaidat.