Posodobi uvod

git-intro.typ

@@ -1,19 +1,83 @@
 #set page("a4", margin: 20mm)
 #set text(lang: "sl")
+#show link: set text(blue)
 #import "@preview/fletcher:0.5.8" as fletcher: diagram, node, edge
 #import fletcher.shapes: house, chevron, pill
 
-#align(center)[
+#let note(content) = rect(stroke: 0.5pt, width: 100%, fill: green.lighten(50%), content)
-= Git kot usmerjen aciklični graf
-]
 
-// Končna delna ureditev ()
+#align(center)[
-- #link("https://git-scm.com/")[Git] je sistem za nadzor različic.
+= Git za gike
-- *Spremembe* beležimo z *vnosi* (angl. *commit*).
+]
-- Vnosi predstavljajo *usmerjen acikličen graf (DAG)*. 
+Dokument opiše delovanje sistema za nadzor različic #link("https://git-scm.com/")[Git] za nekoga, ki želi vedeti,
-- Vsak *vnos* predstavlja *vozlišče* v grafu. 
+kako stvari delujejo.
-- Vnosi imajo lahko enaga ali več *starševskih* vnosov iz katerih izhajajo.
+
-- *Povezave* v acikličnem grafu povezujejo vnose z njihovimi starši.
+== Kaj je Git?
+
+#link("https://git-scm.com/")[Git] je sistem za upravljanje različic. Kaj to pomeni?
+#note[Git hrani vsebino direktorija z datotekami in celotno zgodovino sprememb.
+Zgodovina sprememb se hrani v obliki posnetkov celotne vsebine v določenih trenutkih.]
+
+== Za neučakane
+Samostalniki:
+- *Vnos* (angl. *commit*) je posnetek trenutnega stanja projekta, shranjen kot vozlišče v zgodovinskem grafu (DAG), ki vsebuje spremembe datotek ter metapodatke (avtor, čas, sporočilo).
+- *Zgoščena vrednost vnosa* (angl. *commit hash*) je 40-mestna heksadecimalna vrednost, izračunana s SHA-1, ki enolično identificira vnos na podlagi njegove vsebine.
+- *Veja* (angl. *branch*) je premična oznaka, ki kaže na določen vnos v zgodovini in se samodejno premakne naprej, ko dodajamo nove vnose. Veje omogočajo vzporedne razvojne linije z različnimi spremembami.
+- *Oznaka* (angl. *tag*) je statična oznaka, ki trajno kaže na določen vnos. Za razliko od veje se oznaka, nikoli ne premika samodejno, zato se uporablja predvsem za označevanje pomembnih točk v zgodovini, kot so izdaje ali stabilne verzije.
+
+Glagoli (akcije):
+- *Commit* ustvari nov vnos: `git commit -m 'Sporočilo'`
+- *Add* doda vsebino, ki bo v naslednjem vnosu: `git add dodaj_me.txt`
+- *Pull* poberi vsebino iz oddaljenega repozitorija in uskladi lokalno vejo z oddaljeno: `git pull`
+- *Push* potisni lokalne vnose na oddaljeni repozitorij in uskladi oddaljeno vejo z lokalno: `git push`
+- *Fetch* pobere nove vnose, veje in oznake iz oddaljenega repozitorija: `git fetch`
+- *Reset* spremeni kam kaže trenutno izbrana veja: `git reset a239f9e91`
+- *Merge* ustvari nov vnos, ki združi dve ločeni veji v eno: `git merge main`
+- *Rebase* prestavi vnose v trenutno izbrani veji na izbran vnos: `git rebase main`
+
+== Vnosi: posnetki stanja
+Osnovna enota v Gitu je  *Vnos* (angl. *commit*). Vnos je posnetek stanja zabeleženih datotek v trenutku,
+ko je bil ustvarjen. Poleg vsebine datotek vsak vnos vsebuje še metapodatke o avtorju, datumu vnosa in opisom
+sprememb. Vsakemu vnosu je prirejena *zgoščena vrednost vnosa*, ki je 40-mestna heksadecimalna vrednost,
+izračunana s SHA-1, in je natanko določena z vsebino shranjenih datotek in metapodatkov vnosa. 
+Vnose in vsebino datotek hrani Git v #link("https://git-scm.com/book/en/v2/Git-Internals-Git-Objects")[skladišču objektov].
+Do objektov v skladišču lahko dostopamo, če poznamo njihovo _zgoščeno vrednost_. Objekti, ki jih Git hrani v skladišču 
+so *vnosi*, *posnetki direktorijev* in *posnetki posameznih datotek*. 
+#figure(
+  table(columns: 1, [*zgoščena vrednost*: 8dd6d4bdaeff93016bd49474b54a911131759648],
+```
+tree 65c47feec7465e80492620a48206793e078702e0
+parent 16f2994757f1213935b8edb9ae7fee3a8e9ec98d
+author MV <mv@example.com> 1765235698 +0100
+committer MV <mv@example.com> 1765235698 +0100
+  
+Dodaj bla
+```,
+stroke: 1pt, align: left),  
+  caption: [Primer vnosa v Gitu. Vnos vsebuje zgoščeno vrednost posnetka direktorija(`tree`), zgoščeno vrednost
+  starševskega vnosa (`parent`) in metapodatke. Tudi sam vnos je natančno določen z zgoščeno vrednostjo.],
+)
+Posnetki direktorijev so v Gitu posebne vrste objekti tipa `tree`. Vsebujejo zgoščene vrednosti in metapodatke o
+datotekah in direktorijih, ki jih vsebuje.
+#figure(table(columns: 1, stroke:1pt, [*zgoščena vrednost*: `d934342ca420dd0d9828782c7103103f2922d2a6`],
+```
+100644 blob 76018072e09c5d31c8c6e3113b8aa0fe625195ca    bar.txt
+100644 blob ba0e162e1c47469e3fe4b393a8bf8c569f302116    foo.txt
+040000 tree 3b8bfca88b2cc4127ce5909eb3a7395e8b5f2b6a    podmapa
+```
+), 
+caption: [Primer posnetka direktorija v Gitu (objekt tipa `tree`). Posnetek vsebuje zgoščene vrednosti datotek in direktorija, ki jih vsebuje. Uporaba zgoščenih vrednosti natančno določa vsebino posnetka direktorija.])
+#note[
+Skladišča objektov v Gitu je 
+#link("https://en.wikipedia.org/wiki/Content-addressable_storage")[skladišče vsebinsko naslovljivih objektov]. 
+Dostop do objekta je mogoč, če poznamo *zgoščeno vrednost* njegove vsebine. To pomeni, da je referenca na 
+posamezen objekt v Gitu preprosto zgoščena vrednost(angl. hash) vsebine tega objekta. Po drugi strani je
+vsebina objekta določena z njegovo zgoščeno vrednostjo. To pomeni, da lahko enostavno preverimo verodostojnost vsebine, ki je shranjena v Gitu. 
+] 
+== Zgodovinski graf sprememb  
+Posamezni vnosi so povezani v *usmerjen acikličen graf (DAG)*, ki predstavlja zgodovino sprememb. 
+Vsak *vnos* je *vozlišče* v grafu. Vsak vnos izhaja iz enega ali več starševskih vnosov. Izjema je prvi vnos. 
+*Povezave* v grafu povezujejo vnose z njihovimi starši.
 
 #figure(
   diagram(node-stroke: 1pt, node-shape: pill,
@@ -36,65 +100,17 @@
 
     }
   ),
-  caption: [Vnosi v Git kot usmerjen graf]
+  caption: [Vnosi v Gitu kot usmerjen graf. Vsak vnos(razen prvega) ima povezavo na vnose iz katerih izhaja.]
 )
 
-== Vnosi v Gitu
+== Reference: veje in značke
-
-Vsak vnos v Gitu predstavlja vsebino datotek v določenem trenutku. Obenem je vnos določen s spremembami med vsebino datotek v prejšnjem vnosu in vsebino datotek v trenutnem vnosu. Interno git hrani spremembe kot posebne vrste #link("https://git-scm.com/book/en/v2/Git-Internals-Git-Objects")[git objektov].
-
-#figure(
-  table(columns: 1, [*Zgoščena vrednost*: 7c73a28b50d4aeb094d],
-[*Avtor*: Martin Vuk `<martin@example.com>`],
-[*Datum*:   Thu Sep 4 16:20:18 2025 +0200],
-[*Opis*: Zamenjaj besedi perica in raca!], 
-  [*Spremembe*:
-```diff
---- a/foo.bar
-+++ b/foo.bar
-@@ -1 +1 @@
--Perica reže raci rep.
-+Raca reže perici rep.
-```],
-stroke: 1pt, align: left),  
-  caption: [Primer vnosa v Gitu. V datoteki `foo.bar` zamenjamo besedi `perica` in `raca`.],
-)
-
-== Osnove Gita
-
-- *Vnos* (angl. *commit*): posnetek trenutnega stanja projekta, shranjen kot vozlišče v zgodovinskem grafu (DAG), ki vsebuje spremembe datotek ter metapodatke (avtor, čas, sporočilo).
-- *Zgoščena vrednost vnosa* (angl. *commit hash*): 40-mestna heksadecimalna vrednost, izračunana s SHA-1, ki enolično identificira vnos na podlagi njegove vsebine.
-- *Veja* (angl. *branch*): premična oznaka, ki kaže na določen vnos v zgodovini in se samodejno premakne naprej, ko dodajamo nove vnose. Veje omogočajo vzporedne razvojne linije z različnimi spremembami.
-- *Oznaka* (angl. *tag*): statična oznaka, ki trajno kaže na določen vnos. Za razliko od veje se oznaka, nikoli ne premika samodejno, zato se uporablja predvsem za označevanje pomembnih točk v zgodovini, kot so izdaje ali stabilne verzije.
-
-#figure(
-  diagram(node-stroke: 1pt, node-shape: pill, 
-    {
-      let (A, B, C) = ((0, 0), (1.5, 0), (3, 0))
-      let (T, Br) = ((1, 1), (3, 1))
-      let vnosi = (5, 0)
-      let prvi = (-1, 1)
-      node(prvi, [prvi vnos], stroke: 0pt)
-      node(A, "0af3de")
-      node(B, "11ea3a")
-      node(C, "730a1e")
-      node(vnosi, [vnosi], stroke: 0pt)
-      node(T, "v1.01", stroke: 1pt, fill: green.lighten(50%),  shape: chevron)
-      node(Br, "main", stroke: 1pt, fill: purple.lighten(50%), shape: chevron)
-      edge(prvi, A, "-")
-      edge(B, A, "->", [starš])
-      edge(C, B, "->", [starš])
-      edge(T, B, "-", [oznaka], label-pos: 25%)
-      edge(Br, C, "-", [veja])
-      node(enclose: (A, C), stroke: 0.3pt, shape: rect)
-    }
-  ),
-  caption: [Osnovni pojmi Gita]
-)
 
+V delu!
 
 == Ukazi v git
 
+Za konec so še kratke ilustracije kaj v Gitu počnejo posamezni ukazi.
+
 == Git add
 
 Zabeleži spremembe, ki bodo vključene v naslednji vnos:
@@ -107,16 +123,14 @@ git add foo.bar
   diagram(node-shape: rect, node-stroke: 1pt,
     {
       let (A, B, C) = ((0,0), (1, 0), (2, 0))
-      node(A, [`+baz`])
+      node(A, [`baz`])
       node(B, [
 ```
--baz
+baaz
-+baaz
 ```])
       node(C, [
 ```
--baaz
+zaab
-+zaab
 ```], stroke: (dash: "dashed"))
       edge(B, A, "->")
       edge(C, B, "->", stroke: (dash: "dashed"))
@@ -141,16 +155,14 @@ git commit -m "Spremeni baaz v zaab!"
   diagram(node-shape: rect, node-stroke: 1pt,
     {
       let (A, B, C) = ((0,0), (1, 0), (2, 0))
-      node(A, [`+baz`])
+      node(A, [`baz`])
       node(B, [
 ```
--baz
+baaz
-+baaz
 ```])
       node(C, [
 ```
--baaz
+zaab
-+zaab
 ```], stroke: 2pt + blue)
       edge(B, A, "->")
       edge(C, B, "->", stroke: blue)
@@ -162,71 +174,31 @@ git commit -m "Spremeni baaz v zaab!"
 )
 
 Ustvari novo vozlišče v grafu.
-== Ukazi kot operacije na DAG-u
 
-- *Commit*  
-  - Ustvari novo vozlišče v DAG.  
 
-- *Merge*  
+== Git Rebase  
-  - Novo vozlišče z več starši.  
+Premakne zaporedje vnosov na novo osnovo.  
 
 #figure(
-  diagram(
+  diagram(node-shape: pill, node-stroke: 0.5pt,
-    {
-      let (A, B, C, D, E, M) = ((0, 0), (1, 0), (2, 0), (1, 1), (2, 1), (3, 0))
-      node(A, "A")
-      node(B, "B")
-      node(C, "C")
-      node(D, "D")
-      node(D, "M")
-      edge(B, A, "->")
-      edge(C, B, "->")
-      edge(D, A, "->")
-      edge(E, D, "->")
-      edge(M, E, "->")
-      edge(M, C, "->")
-    }
-  ),
-  caption: [Merge: vnos M ima dva starša (C in E).]
-)
-
-- *Rebase*  
-  - Premakne zaporedje vnosov na novo osnovo.  
-
-#figure(
-  diagram(
     {
       let (A, B, C1, D, C2) = ((0, 0), (1, 0), (1, 1), (2, 0), (3, 0))
       node(A, "A")
       node(B, "B")
-      node(C1, "C (pred rebase)")
+      node(C1, "C (pred rebase)", stroke: (dash: "dashed"))
       node(D, "D")
-      node(C2, "C (po rebase)")
+      node(C2, "C (po rebase)", stroke: blue)
       edge(B, A, "->")
-      edge(C1, B, "->")
+      edge(C1, B, "->", stroke: (dash: "dashed"))
-      edge(D, A, "->")
+      edge(D, B, "->")
-      edge(C2, D, "->")
+      edge(C2, D, "->", stroke: blue)
     }
   ),
   caption: [Rebase: commit C se premakne, da temelji na D.]
 )
 
-- *Reset*  
+== Git Reset  
-  - Premakne oznako veje na drug commit.  
 
-#list[
+Premakne oznako veje na drug commit.  
-- *commit* → novo vozlišče v DAG
-- *merge* → združitev dveh vej
-- *rebase* → prestavi zaporedje na drugo osnovo
-- *reset* → premik oznake (branch)
-]
 
-== Povzetek
+#include "git-figure.typ"
-#table(
-  columns: 2,
-  [Ukaz], [Pomen v kontekstu DAG],
-  [commit], [Novo vozlišče, povezano s staršem],
-  [merge], [Novo vozlišče z več starši],
-  [rebase], [Prepis poti v grafu],
-  [reset], [Premik branch oznake]
-)