From 3d08769c9b942a42fe8dc3a9074a92882fc5f7c9 Mon Sep 17 00:00:00 2001
From: Ekaitz Zarraga <ekaitz@elenq.tech>
Date: Mon, 4 Sep 2023 19:52:41 +0200
Subject: Gitignore

---
 eu/1.md | 606 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 606 insertions(+)
 create mode 100644 eu/1.md

(limited to 'eu/1.md')

diff --git a/eu/1.md b/eu/1.md
new file mode 100644
index 0000000..a33f883
--- /dev/null
+++ b/eu/1.md
@@ -0,0 +1,606 @@
+---
+title: GIT — EITB 2022
+subtitle: Sarrera eta erabilera basikoa
+license: CC-BY-SA 4.0
+author: Ekaitz Zarraga - ElenQ Technology
+links-as-notes: true
+lang: basque
+polyglossia-lang:
+    name: basque
+how-to: pandoc -f markdown+smart -t beamer % -o pdf/1.pdf --pdf-engine=xelatex --template=./template.tex
+...
+
+## Lizentzia
+
+- CC-BY-SA 4.0
+- Dokumentu honen edukiak eta irudiak [**Pro Git (Scott Chacon, Ben
+  Straub)**](https://git-scm.com/book/en/v2) liburutik atera dira.
+
+# Sarrera: Bertsio kontrol sistemak
+
+## Bertsio kontrolerako sistemak
+
+`Document_v3_FINAL.pdf`
+
+---
+
+![Bertsio kontrol sistema zentralizatuak](img/zentralizatuak.png){ height=180px }
+
+---
+
+![Bertsio kontrol sistema banatuak](img/banatuak.png){ height=300px }
+
+
+# Git: Hasiera
+
+## Kontestua
+
+- 2005-ean argitaratu zen
+- Linux garapenerako garatu zen
+    - Milioika garatzaile
+    - *Codebase* handiak kudeatzeko
+- Sistema banatua (*distributed*) da
+- *Snapshot*etan oinarrituta
+- Operazio gehienak lokalak dira eta normalean ez ditu datuak ezabatzen
+- Integritate kontrola egiten du SHA-1 erabiliz
+- Hiru egoera:  
+  `FITXATEGIA — STAGING AREA — REPOSITORIOA`
+
+## Instalazioa
+
+Debian-en oinarritutako distribuzioetan:
+
+```
+apt-get install git
+```
+
+Beste distribuzioetan antzeko komandoren batekin egin daiteke.
+
+
+## Konfigurazio sistema
+
+- Sistema mailakoa: `/etc/gitconfig`
+- Konfigurazio orokorra: `~/.config/git/config` edo `~/.gitconfig`
+- Konfigurazio lokala. Repositorio bakoitzeko: `$REPOSITORIOA/.git/config`
+
+Kaskada moduan dabil, konfigurazio lokalak orokorra zapaltzen du.
+Nondik datorren ikusteko:
+
+```
+git config --list --show-origin
+```
+
+## Konfigurazioa kudeatzea
+
+Komandoek konfigurazio fitxategia irakurri edo idazten dute. Eskuz egin
+daiteke.
+
+Komando orokorra:
+
+```
+git config [--global] atala.klabea [<balioa>]
+```
+
+- `<balioa>` gehitzen ez bada konfigurazioa irakurtzen da idatzi beharrean.
+- `--global` konfigurazio globala kudeatzeko erabiltzen da.
+
+Benetan konplexuagoa da, laguntza begiratu.
+
+
+## Hasierako konfigurazioa
+
+Identitatea definitu (beharrezkoa da commiten egilea nor den jakiteko):
+
+```
+git config --global user.name "John Doe"
+git config --global user.email johndoe@example.com
+```
+
+Editorea aukeratu:
+
+```
+git config --global core.editor vim
+```
+
+
+
+## Laguntza lortzeko
+
+- `git help`
+- `man`
+
+
+# Git basikoa
+
+## Repositorio bat lortzen
+
+Bi aukera:
+
+- Repositorio berri bat hasi: `git init`. Oraingo direktorioan `.git`
+  direktorioa eratuko du, bertan Git-en datuak gordeko dira.
+
+- Repositorio bat klonatu: `git clone <URL>`. Oraingo direktorioan emandako
+  repositorioa kopiatuko du, bere `.git` direktorioa barne. Protokolo
+  ezberdinetan egin daiteke komunikazioa.
+
+## Fitxategien egoerak
+
+![Fitxategien egoera ezberdinak](img/lifecycle.png){ height=180px }
+
+## Repositorioaren egoera ikusteko
+
+- `git status`
+- Fitxategi batzuei jaramonik ez egiteko: `.gitignore` fitxategi bat gehitu.
+  *Glob pattern*ak erabiltzen ditu.
+
+## Egoeraz aldatzeko
+
+- Fitxategi berriak gehitzeko: `git add`
+- Aldaketak *staging area*ra bidaltzeko: `git add`
+
+## Aldaketak ikusteko
+
+- `git diff`
+- `git diff --cached|--staged`
+- `git difftool` (konfiguratuta badago)
+
+`diff` komandoaren irteera fitxategi batean gorde eta gero, beste norbaiti
+pasatu ahal zaio, berak bere repositoriaren kopian `git apply` erabiliz
+aplikatzeko.
+
+## Aldaketak idazteko
+
+- `git commit`
+
+Mezu bat idaztea eskatzen du: `$EDITOR` edo `git config --global core.editor`
+programa exekutatuz.
+
+## Fitxategiak ezabatzeko
+
+- `git rm`
+- `git rm --cached`
+
+## Izenak aldatzeko
+
+- `git mv`
+
+Edo bestela fitxategia eskuz lekuz aldatu eta gero `git rm` + `git add` egin.
+
+
+
+## Commit historia ikusteko
+
+- `git log`
+
+Oso komando konplexua da. Aukera asko ditu.
+
+- `-<N>` azkeneko `<N>` commitak aurkezten ditu. `<N>` zenbaki bat izan behar
+  da.
+- `-p/--patch` commit-en *patch*-a ateratzen du.
+- `--stat` estatistikak aurkezteko.
+- `--pretty` formatua aldatzeko, modu asko dauzka.
+- `--graph` grafiko modua.
+
+Konbinatu daitezke:
+
+`git log --graph --pretty=oneline --decorate --all`
+
+## Commit historia iragazteko
+
+`git log`-en irteera mugatu daiteke, eskaerak eginez:
+
+- `--since` noiztik ikusi nahi diren. Adibidez: `--since=2weeks`.
+- `--author` autorez iragazi.
+- `--grep` commit mezuan *keyword*ak bilatzeko.
+- `-S/-G/...` *pickaxe function* deiturikoak, aldaketetan testua bilatzen dute.
+- `git log -- fitxategia` fitxategi horretan gertatutako aldaketak bakarrik
+  atera.
+- `--no-merges` merge commitak baztertu.
+
+Laguntza ikusi: `git help log`
+
+
+## Aldaketak desegiteko
+
+- `git commit --amend` azkeneko commita berridazten du.
+    - Mezua aldatu
+    - Fitxategiak edo aldaketak gehitu
+    - ...
+
+- `git reset` aldaketak *staging area*tik kentzeko. KONTUZ `--hard`-ekin
+- `git checkout` aldaketak desegiteko eta commiteatutako egoera
+  berreskuratzeko. KONTUZ
+- `git restore` komando berria da (>2.23.0) `reset` eta `checkout`-ek egiten
+  dituzten gauzak egiten dituena, baina intuitiboagoa da.
+
+## Remoteak
+
+Repositorioaren kopiak dira. Remoteak eguneratu daitezke repositorio lokaletik
+aldaketak igotzen (*push*) edo repositorio lokala eguneratu daiteke remotean
+dauden aldaketak ekartzen (*fetch & pull*).
+
+Remoteak beste makinetan egon daitezke, sarearen bidez sarbidea emanda, edota
+makina berdinean, fitxategi sistemaren beste leku batetan.
+
+## Remote-en kudeaketa
+
+- `git remote`
+
+`.git/config` fitxategian daude idatzita. Hortik ere kudeatu daitezke.
+
+
+- `git clone` -k remotea automatikoki gehitzen du konfiguraziora, `origin`
+  izenarekin.
+- `git remote -v`
+- `git remote add <izena> <URLa>`
+- `git remote show <remotearen_izena>`
+- `git remote rename <izena> <izen_berria>`
+- `git remote remove <izena>`
+
+
+## Remotearekin informazioa elkarbanatu
+
+- `git fetch [<remote>]`-ek remotearen informazioa deskargatzen du,
+  repositorioa zapaldu gabe.
+
+- `git pull`-ek informazioa deskargatu eta `merge`atzen du adarrak ondo
+  konfiguratuta badaude:  
+  ```
+  git pull = git fetch + git merge
+  ```
+
+- `git push [<remote> <branch>]`-ek datuak eta commitak igotzen ditu. Norbaitek
+  commitak erdian gehitu baditu ez du uzten (aurrerago azalduko da).
+
+## Tag-ak
+
+Commitei jarri ahal zaizkien izenak dira, normalean *release*ak errezago
+identifikatzeko. Horrela, tag-en izenak erabiltzen dira *commit-id*-ak balira
+moduan baina guk erabakitako izenekin. Adibidez, `v1.0`.
+
+- `git tag -l` tagak bistaratzeko
+
+Bi tag mota dago:
+
+- **Lightweight**: erreferentzia bat dira. Adar finko baten modukoak
+- **Annotated**: Git-en datu basean objektu oso bat dira: Mezu bat daukate,
+  autorea, sinatu daitezke...
+
+## Annotated tags
+
+- `git tag -a <tagaren_izena> [<commit>]`
+
+`git show` -k erakusten ditu.
+
+## Lightweight tags
+
+- `git tag <tagaren_izena> [<commit>]`
+
+`git show`-k ez ditu erakusten, azpitik dagoen commita erakusten du.
+
+
+## Tag-ak partekatzeko
+
+- `git push [<remote>] <taga>`
+- `git push [<remote>] --tags` guztiak bidaltzeko
+
+## Tag-ak ezabatzeko
+
+- `git tag -d <taga>`
+- `git push [<remote>] --delete <taga>`
+
+## Aliasak
+
+Gitek komando berriak eratzea ahalbidetzen du aliasen bitartez. Beste
+konfigurazio balioak bezala idazten eta irakurtzen dira:
+
+- `git config --global alias.co checkout`
+- `git co` => `git checkout`
+
+Nik asko erabiltzen dut:
+
+```
+git config --global alias.lg log --graph \
+  --decorate --all --oneline
+```
+
+
+# Git basikoa: Adarrak
+
+## Adarrak (*branch*)
+
+Adarrek repositorioaren garapenean beste bide bat hartzea ahalbidetzen dute,
+bertan bide nagusian aldaketarik eragin gabe lan egiteko.
+
+Git adarrak erabiltzeko diseinatuta dago eta haien erabilera sustatzen du.
+Beraz, **oso garrantzitsuak** dira.
+
+Beste bertsio kontrol sistema batzuetan adarrak erabiltzea prozesu astuna da,
+errekurtso asko behar dituena. Git-en oso prozesu sinplea da eta ez du ia
+errekurtsorik behar. Git-en bitartez kudeatzen diren proiektuetan ez da arraroa
+ehundaka adar ikustea.
+
+## Git barrutik
+
+- Fitxategiak *Staging Area*ra bidaltzean, Git-ek haien argazkiak gordetzen
+  ditu *blob* objektu moduan eta haien checksuma kalkulatzen du (SHA-1)
+- Commita egiterakoan direktorio bakoitzaren checksuma kalkulatzen du eta
+  *tree* objektu bat gordetzen du direktorio bakoitzeko. *Tree* objektuek
+  *blob* objektuetara apuntatzen duten erreferentziak dituzte. Gainera commitek
+  beste datuak gordetzen dituzte: autorea, mezua, data...
+- Commitek haien gurasoei apuntatzen duten erreferentziak dituzte:
+  lehengo commitek erreferentziarik ez dute, commit normalek erreferentzia
+  bakarra dute eta *merge* commitek erreferentzia asko dituzte.
+
+Adarrak commitetara apuntatzen duten erreferentzia mugikorrak dira.
+
+## Git barrutik
+
+![Git repositorio baten barne datuak](img/commit-and-tree.png)
+
+## Git barrutik
+
+![Git repositorio baten commit estruktura](img/commits-and-parents.png)
+
+## Adarrak eratzeko
+
+- `git branch <branchname>`
+
+Defektuz `master` deitutako adar bat dago. Izena konfiguragarria da, baina
+gutxienez adar bat egon behar da beti, bertan commitak gehitzen direlako.
+
+Git-ek oraingo adarrera apuntatzen duen erreferentzia bat gordetzen du: `HEAD`
+deiturikoa.
+
+## Adarraz aldatzeko
+
+- `git checkout <branchname>`
+- `git checkout -b <branchname>` adarra eratu eta bertara aldatzeko
+
+Bertsio berrietan, `checkout` komandoak gauza gehiegi egiten dituenez, komando
+espezifiko bat eratu zen adarrekin lan egiteko:
+
+- `git switch <branchname>`
+- `git switch -c <branchname>` adarra eratu eta aldatzeko
+- `git switch -` aurreko adarrera bueltatzeko
+
+## Adarrak eta aldaketak — I
+
+![`git branch testing`](img/head-to-master.png)
+
+## Adarrak eta aldaketak — II
+
+![`git checkout testing`](img/head-to-testing.png)
+
+## Adarrak eta aldaketak — III
+
+![`git commit ...`](img/advance-testing.png)
+
+## Adarrak eta aldaketak — IV
+
+![`git checkout master`](img/checkout-master.png)
+
+## Adarrak eta aldaketak — V
+
+![`git commit ...`](img/advance-master.png)
+
+## Adarrak eta aldaketak — VI
+
+Giten interfazetik ikusita:
+
+```
+$ git log --oneline --decorate --graph --all
+* c2b9e (HEAD, master) Made other changes
+| * 87ab2 (testing) Made a change
+|/
+* f30ab Add feature #32
+* 34ac2 Fix bug #1328
+* 98ca9 initial commit
+```
+
+> KONTUZ: Ez bada `--all` egiten ez dira defektuz adar guztiak bistaratzen `git
+> log`-en bitartez.
+
+
+## Adarrak eta mergeak — I
+
+![](img/basic-branching-4.png){ height=180px }
+
+## Adarrak eta mergeak — II
+
+**Fast forward** kasua. Adar bat bestearen barruan dago.
+
+![`git checkout master`  
+`git merge hotfix`](img/basic-branching-5.png){ height=200px }
+
+## Adarrak eta mergeak — III
+
+Beti ez da hain erreza. Demagun:
+
+![](img/basic-branching-6.png){ height=180px }
+
+## Adarrak eta mergeak — IV
+
+Arbaso amankomuna (*common ancestor*) ateratzen saiatzen da eta bi buruekin eta
+arbaso amankomunarekin *three-way merge* bat egiten du.
+
+![`git checkout master`  
+`git merge iss53`](img/basic-merging-1.png){ height=180px }
+
+## Adarrak eta mergeak — V
+
+Commit berri bat gehitzen du, bi adarrak lotzen dituena.
+
+*Merge* commita da: bi guraso (edo gehiago) ditu.
+
+![`git checkout master`  
+`git merge iss53`](img/basic-merging-2.png){ height=180px }
+
+## Konfliktoak — I
+
+Aurreko kasua ez da beti ondo ateratzen, batzuetan konfliktoak egon daitezke
+bi adarretan aldaketak leku berdinetan agertzen direnean:
+
+```
+$ git merge iss53
+Auto-merging index.html
+CONFLICT (content): Merge conflict in index.html
+Automatic merge failed; fix conflicts and then 
+commit the result.
+```
+
+## Konfliktoak — II
+
+```
+$ git status
+On branch master
+You have unmerged paths.
+  (fix conflicts and run "git commit")
+
+Unmerged paths:
+  (use "git add <file>..." to mark resolution)
+
+    both modified:      index.html
+
+no changes added to commit (use "git add" and/or
+"git commit -a")
+```
+
+## Konfliktoak — III
+
+Fitxategia horrela ikusten da:
+
+```
+<<<<<<< HEAD:index.html
+<div id="footer">contact : 
+    email.support@github.com</div>
+=======
+<div id="footer">
+ please contact us at support@github.com
+</div>
+>>>>>>> iss53:index.html
+```
+
+Separadoreak daude `<<<<<<<`, `=======` eta `>>>>>>>`.
+
+Lehenengo zatian `HEAD`-en zegoena dago eta bigarrenean `iss53`-n zegoena.
+
+`git mergetool` erabili daiteke konfliktoak errazago konpontzeko.
+
+## Adarrak kudeatzeko
+
+- `git branch` adarrak listatzeko
+- `git branch --merged | --no-merged` oraingo adarrarekin mergeatuta edo
+  mergeatu gabe dauden adarrak listatzeko
+- `git branch -d <adarra>` adarrak ezabatzeko. Mergeatu gabe dauden adarrak ez
+  ditu zuzenean ezabatzen.
+- `git branch --move <adarra> <izen_berria>` izenez aldatzeko.
+- `git push -u|--set-upstream <remote> <adarra>` remoteari zein adar erabili behar
+  duen esateko
+- `git push <remote> --delete <adarra>` remotean adar bat ezabatzeko
+
+## Adarrekin workflow ezberdinak
+
+- Long running branches: `master`, `testing` eta `development`
+- Topic branches: issue eta feature bakoitzeko adar berri bat eratzen da.
+
+## Adarrak remotetan
+
+Gitek remoten erreferentziak gordetzen ditu remoten egoera ikusi ahal izateko.
+`git ls-remote <remote>` edo `git remote show <remote>` erabiliz remoteen
+egorea ikusi daiteke.
+
+Remoten adarrak lokalean ikusi daitezke `<remote>/<adarra>` izenarekin. Ezin
+dira aldatu. Push egiterakoan aldatzen dira, remotearen egoera aldatu delako.
+
+![Adibidea: repositorio lokalak bi commit berri ditu](img/remote-branches.png)
+
+## Push egitea
+
+- `git push <remote> <adarra>` adarra remotera pusheatzeko. Eskuz egin behar
+  da. Horrela adar lokalak babesten dira eta ez dira automatikoki igotzen.
+
+- `<adar_lokala>:<adar_remotoa>` erabiltzean izen ezberdinak jarri ahal zaizkie
+  adarrei, bata lokalean eta bestea remotean
+
+## Tracking branches
+
+Remoteak jarraitzeko erabiltzen mekanismoa da. Remotearen adar bat (*upstream*)
+adar lokal baten (*tracking*) arteko erlazioa da.
+
+- `git checkout -b <adar_izena> <remote>/<adar>`-k `<remote>/<adar>`
+  `<adar_izena>` izenarekin *track*eatzen du
+- `git checkout --track <remote>/<adar>` oraingo adarra eta remotearena
+  erlazionatu. Sinpleago.
+- `git checkout <adarra>`-k erlazioa eratzen du automatikoki, `<adarra>`
+  lokalean existitzen ez bada. Sinpleago.
+- `git clone` egiterakoan `master` adar lokala eratzen da `origin/master`
+  adarra *track*eatzen.
+- `git branch -u|--set-upstream-to <remote>/<adarra>` zure adarraren upstream-a
+  aldatzeko. Ikusi `git push`-en.
+
+> `@{upstream}` edo `@{u}` idatzi daiteke hortik aurrera remotearen adarraren
+> izen osoa erabili beharrean
+
+## Pull egitea
+
+Tracking adarra aktibatuta badago, `git pull` egiteak zuzenean `git fetch` eta
+`git merge` aldi berean egingo ditu.
+
+Kontuz ibili: batzuetan `git pull`-en magia ulertzeko zaila izan daiteke.
+Proiektua jende askok ukitzen badu, hobe `git fetch` egitea.
+
+## Adarrak eta rebaseak — I
+
+![](img/basic-rebase-1.png)
+
+## Adarrak eta rebaseak — II
+
+![`git merge` egitean gertatzen dena](img/basic-rebase-2.png)
+
+## Adarrak eta rebaseak — II
+
+![`git checkout experiment`  
+`git rebase master`](img/basic-rebase-3.png)
+
+Orain merge-a *fast-forward* izango da eta ez du merge commit-ik gehituko.
+
+## Rebase konplexuago bat — I
+
+![](img/interesting-rebase-1.png)
+
+## Rebase konplexuago bat — II
+
+![`git rebase --onto master server client`](img/interesting-rebase-2.png)
+
+`client`-en dauden aldaketak pasatzen ditu `master`-era `server`-en daudenak
+izan ezik.
+
+Orain `server` `master`-en rebaseatu daiteke eta gero `git merge`
+*fast-forward* bat egin.
+
+## Rebasekin kontuz ibili
+
+Rebaseak egiterakoan commit berriak egiten dira, aurrekoen antzekoak edukiz, ez
+dira berdinak. Remote-an pusheatzerakoan beste lankideek rebaseak egitera
+behartzen ditu:
+
+- `git push --force` remotean historia berridazten du. Git zerbitzuetan adar
+  babestuak existitzen dira hau saihesteko. Kontuz.
+- `git pull --rebase`-k lagundu dezake `pull` egiterakoan, remotean historia
+  berridatzi bada. Pull-en estrategietako bat da, asko daude eta defektuz
+  egiteko konfiguratu daitezke.
+
+## Rebase vs Merge
+
+Filosofiaren arabera bata edo bestea gehiago erabiltzea komeni da:
+
+- Repositorioa historiko moduan ulertuta: rebase egitea txarra izango
+  litzateke, historikoa zapaltzen baitu. (*fossil-ek filosofia hau jarraitzen
+  du, ez dauka rebase egiteko tresnarik*)
+- Repositorioa *making of* modura ikusten bada aproposa da rebase egitea.
+  Historikoa garbiagoa uzten duelako.
+
+Aholkua: lokalean rebase egin commit historikoa garbitzeko baina behin
+zerbitzarira igota historia ez aldatu, lankideen prozesuan eragina baitu.
+
-- 
cgit v1.2.3