Introducció a Git Joan Puigcerver Ibáñez j.puigcerveribanez@edu.gva.es Llicència: CC BY-NC-SA 4.0 (Reconeixement - NoComercial - CompartirIgual) 🅭 Què és Git? Git és un sistema de control de versions lliure i distribuït dissenyat per gestionar projectes xicotets i grans amb rapidesa i eficiència. El seu objectiu principal és controlar i gestionar els canvis realitzats en una gran quantitat de fitxers d'una manera fàcil i eficient. Git va ser dissenyat en 2005 per Linus Torvalds, creador del nucli (kernel) del sistema operatiu Linux. Des d'aleshores, s'ha convertit en una ferramenta imprescindible per a gestionar el codi font dels projectes col·laboratius. Git està basat en repositoris. Un repositori s'inicialitza en un directori concret i conté tota la informació dels canvis realitzats en l'arbre de directoris i fitxers a partir d'aquest directori. Els principals objectius i característiques de Git són: Control de versions: Git fa un seguiment de les modificacions dels fitxers al llarg del temps, la qual cosa permet a l'equip de desenvolupament vore i recuperar versions anteriors del codi. Aquesta característica és essencial per a treballar en equip i per a solucionar errors. Distribuït: cada còpia d'un repositori Git conté tot l'historial de canvis i pot funcionar de manera independent. Això facilita el treball fora de línia i la col·laboració en equips distribuïts. Branques i fusions: Git facilita la creació de branques (branching) per a desenvolupar funcionalitats o solucionar problemes sense afectar la branca principal. Després, les branques es poden fusionar (merge) de nou en la branca principal quan estiguen a punt. Gestió de conflictes: Git ofereix ferramentes per a gestionar els conflictes que apareixen quan dues o més persones han modificat la mateixa part del codi. Aquests conflictes es resolen manualment. Col·laboració: Git permet que moltes persones treballen en el mateix projecte de manera eficient. Plataformes com GitHub, GitLab, Bitbucket i Codeberg s'utilitzen habitualment per a allotjar repositoris Git en línia i col·laborar en projectes. Codi obert i gratuït: qualsevol persona pot utilitzar Git sense cost i contribuir al seu desenvolupament. En aquests apunts s'utilitza Git des de la terminal. Els motius d'aquesta elecció s'expliquen en l'apartat Per què la terminal?. Inicialització d'un repositori (git init) Per a començar a utilitzar Git en un projecte, primer cal inicialitzar un repositori en un directori concret. Per fer-ho, s'utilitza l'ordre: git init [<directory>] [<directory>]: (opcional) directori on es vol inicialitzar el repositori. Si no s'especifica, s'utilitza el directori actual. Aquesta ordre crea un directori ocult anomenat .git, que conté tota la informació relativa al Repositori local. Documentació oficial: git init – Git Tingues en compte els aspectes següents a l'hora d'inicialitzar un repositori amb git init: No cal inicialitzar el repositori cada vegada que vulgues treballar-hi. L'estat del repositori s'emmagatzema de manera persistent en el directori ocult .git. Si inicialitzes un repositori en un directori que ja conté un repositori, es crea un nou repositori i el contingut del directori .git se sobreescriu, de manera que s'elimina tota la informació anterior. Encara que és possible1, no és recomanable inicialitzar un repositori en un directori que ja es troba dins d'un altre repositori. Si no s'ha configurat d'una altra manera, Git anomena master la branca principal. La comunitat de desenvolupament ha recomanat canviar aquest nom a main per a evitar les connotacions històriques negatives associades al terme master2. Per utilitzar main com a nom per defecte de la branca principal en els nous repositoris, es pot executar l'ordre següent: git config --global init.defaultBranch main Exemple: Inicialització d'un repositori Es crea el directori git_introduccio i s'hi inicialitza un repositori. jpuigcerver@fp:~ $ mkdir git_introduccio jpuigcerver@fp:~ $ cd git_introduccio jpuigcerver@fp:~/git_introduccio $ ls -a # (1)! . .. jpuigcerver@fp:~/git_introduccio $ git init hint: Using 'master' as the name for the initial branch. This default branch name hint: is subject to change. To configure the initial branch name to use in all hint: of your new repositories, which will suppress this warning, call: hint: hint: git config --global init.defaultBranch <name> hint: hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and hint: 'development'. The just-created branch can be renamed via this command: hint: hint: git branch -m <name> Initialized empty Git repository in /home/jpuigcerver/git_introduccio/.git/ jpuigcerver@fp:~/git_introduccio (master) $ git branch -m main # (2)! jpuigcerver@fp:~/git_introduccio (main) $ ls -a # (3)! . .. .git/ jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main No commits yet Nothing to commit (create/copy files and use "git add" to track) L'opció -a mostra tots els fitxers, inclosos els ocults, que comencen amb un punt. Es canvia el nom de la branca principal de master a main. S'ha creat el directori ocult .git, que conté tota la informació del repositori. L'ordre git status mostra l'estat actual del repositori. S'observa que la branca actual és main i que encara no s'ha fet cap canvi. Eliminar un repositori Git emmagatzema tota la informació del repositori en el directori ocult .git. Per tant, per a eliminar un repositori, n'hi ha prou amb eliminar aquest directori: rm -rf .git -r: elimina el directori de manera recursiva. -f: força l'eliminació, sense demanar confirmació, dels elements protegits contra escriptura. Sigues molt prudent amb l'ordre rm -rf, ja que elimina tots els fitxers, inclosos els protegits contra escriptura. Exemple: Eliminar un repositori S'elimina el repositori creat en l'exemple anterior. jpuigcerver@fp:~/git_introduccio (main) $ ls -a . .. .git jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main No commits yet Nothing to commit (create/copy files and use "git add" to track) jpuigcerver@fp:~/git_introduccio (main) $ rm -rf .git jpuigcerver@fp:~/git_introduccio $ git status fatal: not a git repository (or any of the parent directories): .git S'observa que, després d'eliminar el directori .git, Git ja no reconeix el directori com a repositori. Estructura d'un repositori de Git Aquesta introducció se centra en el funcionament local dels repositoris de Git, sense connectar encara cap repositori remot. Abans que res, cal conéixer l'estructura d'un repositori. Figura 1. Components d'un repositori de Git. En la Figura 1 es distingeix l'Entorn de desenvolupament (Development Environment). Aquesta part es troba localment en el teu dispositiu, on realitzes els canvis i desenvolupes el projecte. D'una altra banda, hi ha el Repositori remot, que normalment s'allotja en un servidor accessible per a tot l'equip de desenvolupament. Dins de l'Entorn de desenvolupament hi ha els components següents: Directori de treball (Working Directory): directori del sistema on s'emmagatzemen localment els continguts del repositori. Àrea de preparació (Staging Area): àrea que s'utilitza per a indicar quins canvis es volen confirmar. Repositori local (Local Repository): repositori emmagatzemat localment on queden registrades totes les versions i canvis dels fitxers, així com la informació de les branques i les etiquetes. Flux de treball Quan treballes en un projecte de Git, els canvis es fan sobre el Directori de treball. Aquests canvis poden ser: Crear un fitxer nou: el fitxer comença en l'estat Untracked, és a dir, Git no en fa el seguiment. Modificar un fitxer amb seguiment: el fitxer modificat passa a l'estat Modified. Eliminar un fitxer amb seguiment: el fitxer eliminat passa a l'estat Deleted. L'ordre git status mostra l'estat actual dels fitxers, i els tres estats anteriors apareixen de color roig. Aquests canvis encara no formen part del repositori. Primer, cal afegir-los a l'Àrea de preparació amb l'ordre git add, que canvia l'estat dels fitxers a Staged (de color verd en git status). Finalment, tots els canvis de l'Àrea de preparació es confirmen i es fan efectius en el Repositori local amb l'ordre git commit. Figura 2. Flux de treball en un repositori de Git. L'ordre git restore es presenta en l'apartat Descartar canvis. Afegir fitxers a l'Àrea de preparació (git add) Per vore el flux de treball en la pràctica, s'afig el primer fitxer al repositori: un fitxer README.md amb el contingut següent. # 01 - Introducció a Git Estem aprenent a utilitzar Git! Terminal VS Code jpuigcerver@fp:~/git_introduccio (main) $ echo "# 01 - Introducció a Git" > README.md jpuigcerver@fp:~/git_introduccio (main) $ echo "Estem aprenent a utilitzar Git!" >> README.md jpuigcerver@fp:~/git_introduccio (main) $ cat README.md # 01 - Introducció a Git Estem aprenent a utilitzar Git! Crea el fitxer README.md amb el contingut anterior en el directori git_introduccio. Una vegada creat el fitxer, es comprova l'estat del repositori amb git status. Git reconeix el fitxer nou, que ara mateix només es troba en el Directori de treball. Com que encara no se'n fa el seguiment, el fitxer README.md es troba en l'estat Untracked. jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main No commits yet Untracked files: (use "git add <file>..." to include in what will be committed) README.md Nothing added to commit but untracked files present (use "git add" to track) Figura 3. Fitxer sense seguiment (untracked). El pas següent és afegir els canvis a l'Àrea de preparació amb l'ordre git add, que permet especificar quins canvis es volen incloure en el pròxim commit: git add [--all] <path> [--all]: (opcional) afegeix a l'Àrea de preparació tots els fitxers modificats i eliminats. <path>: ruta del fitxer o directori que es vol afegir a l'Àrea de preparació. Documentació oficial: git add – Git jpuigcerver@fp:~/git_introduccio (main) $ git add README.md jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main No commits yet Changes to be committed: (use "git rm --cached <file>..." to unstage) new file: README.md S'observa que el fitxer README.md ha passat a l'estat Staged i ja està preparat per a ser confirmat. Figura 4. Fitxer a l'Àrea de preparació (staged). Confirmar canvis (git commit) Una vegada afegits tots els canvis a l'Àrea de preparació, ja es poden confirmar amb l'ordre git commit: git commit [-a] [-m "<message>"] [-a]: (opcional) afegeix a l'Àrea de preparació tots els fitxers modificats i eliminats, sense necessitat d'utilitzar git add. [-m "<message>"]: (opcional) missatge que descriu el canvi realitzat en el commit. Documentació oficial: git commit – Git Si no s'especifica el missatge amb -m, s'obri l'editor per defecte(1) per a escriure el missatge del commit. Per defecte és ViM, però es pot configurar: git config --global core.editor <editor> Figura 5. Estat del repositori de Git abans de fer un commit. Un commit és una instantània de l'estat dels fitxers del repositori en un moment concret, que conté tota la informació relativa als canvis realitzats. Cada commit conté la informació següent: Autor: persona que ha fet el commit. Correu electrònic: correu electrònic de l'autor. Data: data i hora en què s'ha fet el commit. Missatge: descripció dels canvis realitzats en el commit. Identificador o hash: codi únic generat automàticament que identifica el commit. Canvis: llista de fitxers modificats, afegits o eliminats en el commit i els canvis realitzats en cadascun respecte de la versió anterior. Com que cada commit registra qui l'ha fet, abans del primer commit cal configurar el nom i el correu electrònic de l'autor: git config --global user.name <name> git config --global user.email <email> jpuigcerver@fp:~/git_introduccio (main) $ git config --global user.name "Joan Puigcerver Ibáñez" jpuigcerver@fp:~/git_introduccio (main) $ git config --global user.email "j.puigcerveribanez@edu.gva.es" Amb aquesta informació configurada, ja es pot fer el primer commit. jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main No commits yet Changes to be committed: (use "git rm --cached <file>..." to unstage) new file: README.md jpuigcerver@fp:~/git_introduccio (main) $ git commit -m "Added README.md" [main (root-commit) 8e70293] Added README.md 1 file changed, 2 insertions(+) create mode 100644 README.md jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main nothing to commit, working tree clean S'observa que l'estat del repositori ha canviat i ja no hi ha canvis pendents de confirmar. A més, s'ha creat el primer commit, amb el missatge Added README.md i l'identificador 8e70293. Figura 6. Estat del repositori de Git després de fer un commit. La informació del commit nou es pot consultar amb l'ordre git show: jpuigcerver@fp:~/git_introduccio (main) $ git show 8e70293 commit 8e702933d5dbec9ee71100a1599ae4491085e1aa (HEAD -> main) Author: Joan Puigcerver Ibáñez <j.puigcerveribanez@edu.gva.es> Date: Fri Oct 13 16:06:59 2023 +0200 Added README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..6d747b3 --- /dev/null +++ b/README.md @@ -0,0 +1,2 @@ +# 01 - Introducció a Git +Estem aprenent a utilitzar Git! Diferències entre versions (git diff) L'ordre git diff permet comparar els canvis del Directori de treball o de l'Àrea de preparació respecte del Repositori local. És molt útil per revisar què s'ha modificat abans de confirmar-ho. La sintaxi amb les opcions bàsiques és: git diff [--staged] [<path>] [--staged]: (opcional) mostra les diferències entre l'Àrea de preparació i el Repositori local. Si no s'indica, compara el Directori de treball amb el Repositori local. [<path>]: (opcional) fitxer o directori del qual es volen comparar les diferències. Si no s'indica, es mostren totes les diferències. Documentació oficial: git diff – Git Figura 7. Resum de git diff. Interpretació de l'eixida de git diff jpuigcerver@fp:~/git_introduccio (main) $ git diff diff --git a/README.md b/README.md index 6d747b3..f3b3b3e 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,3 @@ # 01 - Introducció a Git Estem aprenent a utilitzar Git! +Aquesta és una línia nova El format d'un diff és el següent: diff --git a/README.md b/README.md: fitxers comparats. a/README.md: fitxer original. b/README.md: fitxer modificat. index 6d747b3..f3b3b3e 100644: hash dels fitxers comparats i permisos. --- a/README.md: ruta del fitxer original. +++ b/README.md: ruta del fitxer modificat. @@ -1,2 +1,3 @@: posició de les línies modificades. -1,2: en el fitxer original, els canvis comencen en la línia 1 i afecten 2 línies. +1,3: en el fitxer modificat, els canvis comencen en la línia 1 i afecten 3 línies. A continuació, es mostren les línies modificades, precedides d'un símbol: -: línia eliminada. +: línia afegida. En aquest cas, s'ha afegit la línia Aquesta és una línia nova al fitxer README.md. Exemple: Diferències entre el Directori de treball i el Repositori local S'afig una línia al fitxer README.md i es comparen el Directori de treball i el Repositori local. jpuigcerver@fp:~/git_introduccio (main) $ echo "Aquesta és una línia nova" >> README.md jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main Changes not staged for commit: (use "git add <file>..." to update what will be committed) (use "git restore <file>..." to discard changes in working directory) modified: README.md no changes added to commit (use "git add" and/or "git commit -a") jpuigcerver@fp:~/git_introduccio (main) $ git diff diff --git a/README.md b/README.md index 6d747b3..f3b3b3e 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,3 @@ # 01 - Introducció a Git Estem aprenent a utilitzar Git! +Aquesta és una línia nova S'observa la línia afegida, marcada amb el símbol +. Exemple: Diferències entre l'Àrea de preparació i el Repositori local S'afig el fitxer README.md a l'Àrea de preparació i es compara amb el Repositori local. jpuigcerver@fp:~/git_introduccio (main) $ git add README.md jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main Changes to be committed: (use "git restore --staged <file>..." to unstage) modified: README.md jpuigcerver@fp:~/git_introduccio (main) $ git diff --staged diff --git a/README.md b/README.md index 6d747b3..f3b3b3e 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,3 @@ # 01 - Introducció a Git Estem aprenent a utilitzar Git! +Aquesta és una línia nova Com que els canvis ja són en l'Àrea de preparació, cal utilitzar l'opció --staged per a vore'ls. Descartar canvis (git restore) L'ordre git restore permet descartar els canvis realitzats en els fitxers del Directori de treball o de l'Àrea de preparació. És útil quan s'ha fet una modificació que no es vol conservar. La sintaxi amb les opcions bàsiques és: git restore [--staged] <path> [--staged]: (opcional) trau els canvis de l'Àrea de preparació, però els manté en el Directori de treball. Si no s'indica, es descarten els canvis del Directori de treball. <path>: fitxer o directori del qual es volen descartar els canvis. La Figura 2 resumeix el comportament de git restore. Documentació oficial: git restore – Git L'ordre git restore descarta els canvis del Directori de treball sense possibilitat de recuperar-los. Exemple: Descartar canvis en l'Àrea de preparació Continuant amb l'exemple anterior, es trauen de l'Àrea de preparació els canvis del fitxer README.md. jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main Changes to be committed: (use "git restore --staged <file>..." to unstage) modified: README.md jpuigcerver@fp:~/git_introduccio (main) $ git diff --staged diff --git a/README.md b/README.md index 6d747b3..f3b3b3e 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,3 @@ # 01 - Introducció a Git Estem aprenent a utilitzar Git! +Aquesta és una línia nova jpuigcerver@fp:~/git_introduccio (main) $ git restore --staged README.md jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main Changes not staged for commit: (use "git add <file>..." to update what will be committed) (use "git restore <file>..." to discard changes in working directory) modified: README.md S'observa que el fitxer continua modificat, però ara els canvis només són en el Directori de treball. Exemple: Descartar canvis en el Directori de treball Es descarten els canvis realitzats en el fitxer README.md del Directori de treball. Aquesta ordre descarta els canvis definitivament. jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main Changes not staged for commit: (use "git add <file>..." to update what will be committed) (use "git restore <file>..." to discard changes in working directory) modified: README.md no changes added to commit (use "git add" and/or "git commit -a") jpuigcerver@fp:~/git_introduccio (main) $ git diff diff --git a/README.md b/README.md index 6d747b3..f3b3b3e 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,3 @@ # 01 - Introducció a Git Estem aprenent a utilitzar Git! +Aquesta és una línia nova jpuigcerver@fp:~/git_introduccio (main) $ git restore README.md jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main nothing to commit, working tree clean S'observa que el repositori torna a estar net: la línia afegida s'ha perdut. Històric de canvis (git log) Git registra en el Repositori local tots els canvis confirmats (commits). L'històric de canvis es pot consultar amb l'ordre git log: git log [<options>] [<options>]: (opcional) opcions per a personalitzar quins commits es mostren i com. Documentació oficial: git log – Git Exemple: Històric de canvis Es modifica novament el fitxer README.md i es fa un nou commit. jpuigcerver@fp:~/git_introduccio (main) $ echo "Aquesta és una altra línia" >> README.md jpuigcerver@fp:~/git_introduccio (main) $ git commit -a -m "Added another line to README.md" # (1)! [main c9fc6c8] Added another line to README.md 1 file changed, 1 insertions(+) Amb -a s'afigen a l'Àrea de preparació els canvis del fitxer README.md sense necessitat de git add. A continuació, es consulta l'històric de canvis amb git log. jpuigcerver@fp:~/git_introduccio (main) $ git log commit c9fc6c856c2d52744b85a6f8d92feac496e60bd6 (HEAD -> main) Author: Joan Puigcerver Ibáñez <j.puigcerveribanez@edu.gva.es> Date: Mon Oct 16 11:43:20 2023 +0200 Added another line to README.md commit 8e702933d5dbec9ee71100a1599ae4491085e1aa Author: Joan Puigcerver Ibáñez <j.puigcerveribanez@edu.gva.es> Date: Fri Oct 13 16:06:59 2023 +0200 Added README.md S'observa la informació de cada commit: l'autor, la data, el missatge i l'identificador. L'ordre git log admet moltes opcions per a personalitzar com es mostren els commits i la seua informació. Una possible combinació d'opcions per a visualitzar l'històric de manera més compacta i intuïtiva és: git log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(bold yellow)%d%C(reset)' Exemple: Històric de canvis compacte Es mostra l'històric del repositori amb les opcions anteriors. jpuigcerver@fp:~/git_introduccio (main) $ git log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(bold yellow)%d%C(reset)' * c9fc6c8 - (2 minutes ago) Added another line to README.md - Joan Puigcerver (HEAD -> main) * 8e70293 - (3 days ago) Added README.md - Joan Puigcerver S'observa que cada commit ocupa una sola línia. No obstant això, no és pràctic recordar aquesta ordre. Per això, es pot configurar un àlies, és a dir, un nom curt que Git substitueix per l'ordre completa: git config --global alias.lg "log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(bold yellow)%d%C(reset)'" git config --global alias.lga "lg --all" Exemple: Històric de canvis compacte amb àlies Després de configurar l'àlies lg, n'hi ha prou amb executar git lg: jpuigcerver@fp:~/git_introduccio (main) $ git lg * c9fc6c8 - (2 minutes ago) Added another line to README.md - Joan Puigcerver (HEAD -> main) * 8e70293 - (3 days ago) Added README.md - Joan Puigcerver S'observa que el resultat és el mateix que en l'exemple anterior. Configuració (git config) Git permet configurar diferents paràmetres per a personalitzar el seu comportament mitjançant l'ordre git config. La configuració es pot fer en tres nivells. Els paràmetres d'un nivell més específic sobreescriuen els d'un nivell més general: Sistema (--system): configuració per a totes les persones usuàries del sistema. Es guarda en un fitxer gitconfig situat en: Linux Windows /etc/gitconfig Carpeta d'instal·lació de Git: C:\Program Files\Git\gitconfig Usuari (--global): configuració per a una persona usuària concreta. Es guarda en un fitxer .gitconfig situat en la seua carpeta personal: Linux Windows /home/<username>/.gitconfig C:\Users\<username>\.gitconfig Repositori (--local): configuració per a un repositori concret. Es guarda en el fitxer config de la carpeta .git del repositori: <path_to_repository>/.git/config La sintaxi d'aquesta ordre és la següent: git config [--local | --global | --system] <key> [<value>] [--local | --global | --system]: (opcional) nivell de configuració. Per defecte és --local. <key>: clau de configuració que es vol establir o consultar. [<value>]: (opcional) valor de la configuració. Si no s'indica, es mostra el valor actual de la clau. Documentació oficial: git config – Git Aquesta ordre ja s'ha utilitzat per configurar els aspectes següents: El nom (user.name) i el correu electrònic (user.email) de l'autor dels commits. L'editor per defecte (core.editor). Exemple: Consultar el nom i el correu electrònic configurats Es consulten els valors de user.name i user.email en el nivell --global. jpuigcerver@fp:~/git_introduccio (main) $ git config --global user.name Joan Puigcerver Ibáñez jpuigcerver@fp:~/git_introduccio (main) $ git config --global user.email j.puigcerveribanez@edu.gva.es Modificació del fitxer de configuració En lloc de modificar cada clau per separat, també es pot editar directament el fitxer de configuració amb l'ordre git config --edit, que l'obri amb l'editor de text per defecte: git config [--local | --global | --system] --edit [--local | --global | --system]: (opcional) nivell de configuració. Per defecte és --local. Exemple: Fitxer de configuració de l'usuari (--global) S'obri el fitxer de configuració del nivell --global. jpuigcerver@fp:~/git_introduccio (main) $ git config --global --edit ~/.gitconfig [core] editor = code --wait # Editor per defecte [init] defaultBranch = main # Nom de la branca principal per defecte [user] name = Joan Puigcerver Ibáñez email = j.puigcerveribanez@edu.gva.es [alias] lg = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(bold yellow)%d%C(reset)' lga = lg --all S'observa tota la configuració feta fins ara, agrupada per seccions. Ignorar fitxers (.gitignore) En un projecte hi ha fitxers que no s'han d'incloure en el repositori, com ara fitxers temporals, binaris o fitxers de configuració local. Per això, Git permet ignorar fitxers mitjançant el fitxer .gitignore, que conté una llista de patrons de fitxers que Git no ha de tindre en compte. Aquest fitxer pot estar situat en qualsevol directori del repositori. Git ignora tots els fitxers i subdirectoris d'aquest directori que complisquen algun dels patrons especificats. Documentació de .gitignore gitignore – Documentació oficial de Git gitignore - Pattern format – Documentació oficial de Git Git Ignore and .gitignore – W3Schools Exemple: Ignorar fitxers Es crea el fitxer .gitignore amb els patrons següents: .gitignore # Ignora tots els fitxers .log *.log # Ignora tots els fitxers de qualsevol directori anomenat temp temp/ A continuació, es comprova l'efecte d'ignorar el directori temp/. jpuigcerver@fp:~/git_introduccio (main) $ mkdir temp jpuigcerver@fp:~/git_introduccio (main) $ touch temp/file.txt jpuigcerver@fp:~/git_introduccio (main) $ git status On branch main Untracked files: (use "git add <file>..." to include in what will be committed) temp/file.txt nothing added to commit but untracked files present (use "git add" to track) jpuigcerver@fp:~/git_introduccio (main) $ echo "temp/" > .gitignore jpuigcerver@fp:~/git_introduccio (main) $ git status # (1)! On branch main Untracked files: (use "git add <file>..." to include in what will be committed) .gitignore nothing added to commit but untracked files present (use "git add" to track) El fitxer temp/file.txt ja no apareix en l'estat del repositori després de crear el fitxer .gitignore. Recursos addicionals Curs de Git des de zero per Moure Dev Learn git concepts, not commands per @UnseenWizzard Bibliografia Pro Git Book Learn git concepts, not commands per @UnseenWizzard Regarding Git and Branch Naming – Software Freedom Conservancy Why GitHub renamed its master branch to main – TheServerSide How is the Git hash calculated? – StackOverflow diff – Wikipedia Aquests repositoris es coneixen com a submòduls i queden fora de l'abast d'aquest curs. ↩ Regarding Git and Branch Naming – Software Freedom Conservancy ↩ 📌 Aquest document pot quedar desactualitzat després d’imprimir-lo. Pots consultar la versió més recent a la pàgina web. 🌿 Abans d’imprimir aquest document, considera si és realment necessari. Redueix el consum de paper i ajuda a protegir el nostre entorn.

CC BY-NC-SA 4.0 (Reconeixement - NoComercial - CompartirIgual) 🅭 Joan Puigcerver Ibáñez