diff --git a/docs/workshop/2_basics.md b/docs/workshop/2_basics.md index 985b94a4cd66f463330d29eafdea23cb64d76369..4c9e0d56d4e30e9ab3ffe1032cf21e7ba8b72476 100644 --- a/docs/workshop/2_basics.md +++ b/docs/workshop/2_basics.md @@ -19,20 +19,21 @@ $ git help config De ha csak egy gyors ĂĄttekintĂŠsre van szĂźksĂŠged: ``` -$ git config -h +\$ git config -h usage: git config [<options>] Config file location - --global use global config file - --system use system config file - --local use repository config file - --worktree use per-worktree config file - -f, --file <file> use given config file - --blob <blob-id> read config from given blob object +--global use global config file +--system use system config file +--local use repository config file +--worktree use per-worktree config file +-f, --file <file> use given config file +--blob <blob-id> read config from given blob object Action - --get get value: name [value-regex] - ... +--get get value: name [value-regex] +... + ``` ### Repository @@ -42,58 +43,69 @@ A Git repository egy olyan mappa, mely Git verziĂłkezelĂŠs alatt PĂŠldĂĄul az a mappa, ahol van egy .git mappa, az egy git repo. ``` -$ ls -al +\$ ls -al total 20 -drwxrwxr-x 4 rlacko rlacko 4096 okt 8 12:59 . -drwxrwxr-x 3 rlacko rlacko 4096 okt 7 12:04 .. -drwxrwxr-x 5 rlacko rlacko 4096 okt 7 12:46 docs -drwxrwxr-x 8 rlacko rlacko 4096 okt 8 16:39 .git --rw-r--r-- 1 rlacko rlacko 17 okt 7 12:09 README.md +drwxrwxr-x 4 rlacko rlacko 4096 okt 8 12:59 . +drwxrwxr-x 3 rlacko rlacko 4096 okt 7 12:04 .. +drwxrwxr-x 5 rlacko rlacko 4096 okt 7 12:46 docs +drwxrwxr-x 8 rlacko rlacko 4096 okt 8 16:39 .git +-rw-r--r-- 1 rlacko rlacko 17 okt 7 12:09 README.md + ``` -MielĹtt mĂŠg nekilĂĄtnĂĄnk a tĂĄvolli repository leszedĂŠsnek, -csinĂĄlunk sajĂĄtot ĂŠs onnan fogunk tovĂĄbb haladni. +CsinĂĄljunk egy sajĂĄtot! Hozzunk lĂŠtre egy tetszĹleges projekt mappĂĄt ĂŠs lĂŠpjĂźnk bele ``` $ mkdir projektem $ cd projektem + ``` -NĂŠzzĂźk meg, hogy mi a helyzet a git-el ezzel a mappĂĄban. +NĂŠzzĂźk meg, hogy mi a helyzet a git-el ezzel a mappĂĄban. Ehhez a `git status` parancsot tudjuk hasznĂĄlni. Ez a parancs a jelenlegi git repo-nkrĂłl kĂŠpes informĂĄciĂłkat kiĂrni. ``` -$ git status +\$ git status fatal: not a git repository (or any of the parent directories): .git + ``` -Ez igaz, ugyanis teljesen Ăźres a mappa. -`ls -al` -el tudod ellenĹrizni +Teljesen Ăźres a mappa, mĂŠg nincs verziĂł kontroll alatt. +`ls -al` -el tudjuk is ellenĹrizni. TegyĂźk verziĂłkontroll alĂĄ a `git init` paranccsal. +Ez beĂĄllĂtja nekĂźnk a `master` branchet ĂŠs mĂĄs alap dolgokat. +A branch-rĹl mĂŠg kĂŠsĹbb beszĂŠlek, de azt jegyezzĂźk meg addig, +hogy ide kerĂźlnek a mentĂŠspontjaink egymĂĄs utĂĄn sorban, mint +egy fa ĂĄga. + +<div style="text-align:center"><img src="workshop/img/basic-branching.png" alt="Git branch" /></div> ``` -$ git init . +\$ git init . Initialized empty Git repository in .../projektem/.git/ + ``` Ha megnĂŠzzĂźk, mostmĂĄr van egy .git mappĂĄnk ``` -$ ls -al +\$ ls -al total 12 -drwxrwxr-x 3 rlacko rlacko 4096 okt 8 16:52 . -drwxrwxr-x 12 rlacko rlacko 4096 okt 8 16:49 .. -drwxrwxr-x 7 rlacko rlacko 4096 okt 8 16:52 .git +drwxrwxr-x 3 rlacko rlacko 4096 okt 8 16:52 . +drwxrwxr-x 12 rlacko rlacko 4096 okt 8 16:49 .. +drwxrwxr-x 7 rlacko rlacko 4096 okt 8 16:52 .git + ``` Ebben van minden adatunk a git repo-val kapcsolatban. -Gyakorlatilag ha bĂĄrmely projektbĹl kivesszĂźk ezt a mappĂĄt, -akkor teljes egĂŠszĂŠben visszaĂĄllĂthatĂł belĹle minden fĂĄjl. +Gyakorlatilag mikor egy tĂĄvoli git repo-t leszedĂźnk, akkor +ezt a mappĂĄt kapjuk meg. EbbĹl ezutĂĄn a git alkalmazĂĄsunk +elĹĂĄllĂtja nekĂźnk a master ĂĄg legutĂłbbi mentĂŠspontjĂĄt. #### VĂĄltoztatĂĄsok mentĂŠse @@ -116,71 +128,71 @@ NĂŠzzĂźk meg ezen az ĂĄbrĂĄn ĂŠs egy pĂŠlda projekten keresztĂźl: Mi a jelenlegi helyzet a repo-ban, miutĂĄn inicializĂĄltuk? ``` -$ git status -... +\$ git status +On branch master No commits yet nothing to commit (create/copy files and use "git add" to track) ``` LĂĄthatjuk, hogy mĂŠg nincsenek mentĂŠspontjaink ĂŠs nincs mit -elmentenĂźnk. - -``` -$ git status -On branch master -... -``` - -A branch-rĹl kĂŠsĹbb rĂŠszletesebben beszĂŠlek, de a lĂŠnyeg -egyenlĹre, hogy ez az a a dolog, ahol a mentĂŠspontokat -sorban egymĂĄs utĂĄn feltudjuk venni. +elmentenĂźnk ĂŠs egyben a git prĂłbĂĄl segĂteni, hogy hogyan +tudunk stagelni valamit. +Ezt tĂśbb helyen is megfigyelhetjĂźk a git-ben. +PrĂłbĂĄl segĂteni ahol csak tud, minĂŠl kĂŠnyelmesebbĂŠ tĂŠve +a munkĂĄnkat. -VegyĂźnk fel egy Ăşj fĂĄjlt: +VegyĂźnk fel egy Ăşj fĂĄjlt. ``` echo 'alma' > gyumolcskosar ``` -Ăjra megvizsgĂĄlva a status-t: +_Itt az `echo` egy olyan parancs volt, mely kiĂrta nekĂźnk a +terminĂĄlra azt, hogy "alma", de ĂĄtirĂĄnyĂtottuk egy fĂĄjlba +a `>` operĂĄtorral ĂŠs mivel nem lĂŠtezett a fĂĄjl, azt lĂŠtre is +hozta._ + +Ăjra megvizsgĂĄlva a status-t, lĂĄtni fogjuk, hogy megjelent, de +mĂŠg nincs verziĂłkontroll alatt. ``` -$ git status +\$ git status ... Untracked files: - (use "git add <file>..." to include in what will be committed) - gyumolcskosar +(use "git add <file>..." to include in what will be committed) +gyumolcskosar nothing added to commit but untracked files present (use "git add" to track) ``` -A fĂĄjlunk mĂŠg nincs git-el kĂśvetve, ahogy az ĂĄbrĂĄn is -lĂĄthatjuk. -`git add <fĂĄjl>` segĂtsĂŠgĂŠvel adjuk hozzĂĄ a repo-hoz. +Ahhoz, hogy git alĂĄ helyezzĂźk, a `git add <fĂĄjl>` parancsot +fogjuk kiadni. +_Ezek a parancsok mind kĂŠpesek rĂĄ, hogy +Unix-os mĂłdon tĂśbb fĂĄjlra is kiadhatĂłak legyenek. +PĂŠldĂĄul a `<fĂĄjl>` lehet `*.jpg`amivel minden .jpg fĂĄjlt kijelĂślĂźnk a jelenlegi mappĂĄban"_ ``` -$ git add gyumolcskosar +\$ git add gyumolcskosar ``` -Ezt kĂśvetĹen +EzutĂĄn megjelenik, mint Ăşj fĂĄjl a git adatbĂĄzisĂĄban. ``` -$ git status +\$ git status ... Changes to be committed: - (use "git rm --cached <file>..." to unstage) - new file: gyumolcskosar +(use "git rm --cached <file>..." to unstage) +new file: gyumolcskosar ``` A fĂĄjlunk ĂĄtkerĂźlt staged mĂłdba ĂŠs ezt akĂĄr mostmĂĄr el is -tudjuk menteni. +tudjuk menteni. A mentĂŠshez a `git commit` parancsot tudjuk hasznĂĄlni. -`$ git commit` -Kiadva megnyilik a beĂĄllĂtott szĂśvegszerkesztĹnk ĂŠs nĂŠmi +`$ git commit`-ot kiadva megnyilik a beĂĄllĂtott szĂśvegszerkesztĹnk ĂŠs nĂŠmi informĂĄciĂł a leendĹ mentĂŠspontrĂłl. ``` - # Please enter the commit message for your changes. Lines starting # with '#' will be ignored, and an empty message aborts the commit. # @@ -189,33 +201,33 @@ informĂĄciĂł a leendĹ mentĂŠspontrĂłl. # Initial commit # # Changes to be committed: -# new file: gyumolcskosar +# new file: gyumolcskosar ``` LĂĄthatjuk amit a `git status` parancs Ărna ki ĂŠs pĂĄr extra -infĂłt. +segĂtsĂŠget a git-tĹl. A # -el kezdĹdĹ sorok kommentek, ezek nem fognak a commit Ăźzenetbe belekerĂźlni. Ărjuk be az elsĹ sorba, hogy `KĂŠszĂtettem egy gyĂźmĂślcskosarat`, majd mentsĂźk el a fĂĄjlt ĂŠs zĂĄrjuk be a szĂśvegszerkesztĹt. ``` -$ git commit +\$ git commit [master (root-commit) c45abc3] KĂŠszĂtettem egy gyĂźmĂślcskosarat - 1 file changed, 1 insertion(+) - create mode 100644 gyumolcskosar +1 file changed, 1 insertion(+) +create mode 100644 gyumolcskosar ``` A git mikor ĂŠrzĂŠkelte, hogy bezĂĄrtuk a fĂĄjlt, akkor abbĂłl -kiolvasta a sorokat ĂŠs hozzĂĄadta a mentĂŠspontunkhoz, mint -Ăźzenet. -Ezt lĂĄthatjuk is visszajelzĂŠsben. +kiolvasta a sorokat, ignorĂĄlva a #-el kezdĹdĹket ĂŠs hozzĂĄadta +a mentĂŠspontunkhoz, mint Ăźzenet. +Ezt lĂĄthatjuk is a visszajelzĂŠsben. TovĂĄbbĂĄ megjelent pĂĄr tovĂĄbbi hasznos informĂĄciĂł is. IsmĂŠtelten nĂŠzzĂźk meg mi a helyzet a reponkban: ``` -$ git status +\$ git status On branch master nothing to commit, working tree clean ``` @@ -225,7 +237,7 @@ azt is Ărja, hogy mĂŠg semmin nem vĂĄltoztattunk, nem tudunk mit elmenteni. NĂŠzzĂźk meg a tovĂĄbbi kĂŠt ĂĄllapotot is amiben lehet egy fĂĄjl. -Ărjuk bele a gyumolcskosar fĂĄjlba, hogy `korte`: +Ărjuk bele a gyumolcskosar fĂĄjlba, hogy `korte` ```gyumolcskosar alma @@ -251,10 +263,14 @@ parancsnak ĂĄttudunk adni Ăşgynevezett kapcsolĂłkat. PĂŠldĂĄul `git commit -m <message>`. Ez annyit spĂłrol meg nekĂźnk, hogy nem kell szĂśvegszerkesztĹt megnyitnia a git-nek mikor Ăşj commit-ot kĂŠszĂtĂźnk, -hanem kĂśzvetlen megadhatjuk az Ăźzenetet, **m**esage-et - -Ne felejtsĂźk el elĹszĂśr staged mĂłdba rakni a fĂĄjlt, -kĂźlĂśnben nem tĂśrtĂŠnik mentĂŠs. +hanem ĂĄtraktuk a parancsot olyan mĂłdba, +hogy vĂĄrjon egy szĂśveget, mint mentĂŠshez kapcsolĂłdĂł Ăźzenet. +ĂltalĂĄban logikusak az egy betĹąs rĂśvidĂtĂŠsek: +`-m: message, -a: all`, de tudunk hosszabb verziĂłkat is +hasznĂĄlni, mint `--message, --all`. + +> Ne felejtsĂźk el elĹszĂśr stagelni a mentendĹ fĂĄjljaink egy +> `git add <fĂĄjl>` parancs kiadĂĄsĂĄval. ``` $ git add gyumolcskosar diff --git a/docs/workshop/img/basic-branching.png b/docs/workshop/img/basic-branching.png new file mode 100644 index 0000000000000000000000000000000000000000..cbfd438b23d6d53e068a9e951b8f1d7b8f743ab2 Binary files /dev/null and b/docs/workshop/img/basic-branching.png differ