- [Ça a l’air cool, comment ça s’obtient?](#ça-a-l-air-cool-comment-ça-s-obtient)
- [Ok très bien, comment on l’utilise maintenant?](#ok-très-bien-comment-on-l-utilise-maintenant)
- [J’ai entendu parler de Github…](#j-ai-entendu-parler-de-github)
- [J’ai téléchargé un projet en zip](#j-ai-téléchargé-un-projet-en-zip)
- [Et si je veux créer mon propre dépôt sur Github](#et-si-je-veux-créer-mon-propre-dépôt-sur-github)
- [Et du coup, comment je met tout ça en ligne ?](#et-du-coup-comment-je-met-tout-ça-en-ligne)
- [Quelqu’un a fait des modifications depuis mon dernier commit, je récupère ça comment?](#quelqu-un-a-fait-des-modifications-depuis-mon-dernier-commit-je-récupère-ça-comment)
- [Je suis en train de travailler sur le même fichier que Ginette](#je-suis-en-train-de-travailler-sur-le-même-fichier-que-ginette)
- [Github ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !](#github-ne-veut-pas-de-mes-pushs-sur-le-dépôt-de-gilberte-oskour)
- [Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?](#fork-pull-request-que-font-des-fourchettes-et-des-pulls-dans-ce-tuto)
- [J’ai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même](#j-ai-remarqué-un-bug-ou-une-erreur-mais-je-ne-peux-pas-corriger-ça-moi-même)
- [Les raccourcis et paramètres de Git](#les-raccourcis-et-paramètres-de-git)
- [Et c’est tout?](#et-c-est-tout)
</div>
<!--endtoc-->
## Git? Qu'est-ce donc? {#git-qu-est-ce-donc}
Git est un logiciel de version de fichiers permettant de garder une trace de
toutes les modifications apportées au fichiers suivis dans un répertoire (un
dépôt) et ses sous-répertoires –sous couvert qu’ils n’aient pas été ignorés
explicitement. Il permet également de conserver plusieurs versions
parallèles du projet, comme par exemple une version stable et une version de
développement, et permet l’ajout de modifications d’une de ces versions
parallèles à une autre via des fusions partielles ou totales de branches,
avec une automatisation des fusions de fichiers lorsqu’il n’y a pas de
conflit entre ces derniers.
Avant de continuer, sache que je suis bilingue français-sarcasme, si tu es
du genre à t’énerver pour un rien, cette page est à haut risque pour toi.
Toujours là ? Tu auras été prévenu·e.
## Ça a l’air cool, comment ça s’obtient? {#ça-a-l-air-cool-comment-ça-s-obtient}
### Et surtout, comment ça s’installe? {#et-surtout-comment-ça-s-installe}
Très bonne question Kevin. Tout d’abord, il faut t’assurer que git soit
installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux,
tu peux l’installer via ton gestionnaire de paquet, ce qui rendra la
commande accessible directement depuis le terminal. Tu auras sans doute
besoin de préfixer la commande avec `sudo`. Si tu n’as pas les droits pour
utiliser `sudo`, demande à celui qui a les droits (ton administrateur
système ou ton papa).
```sh
$ apt install git # Debian, Ubuntu et les distros basées dessus
$ yum install git # CentOS
$ dnf -y install git # Fedora
$ pacman -S git # ArchLinux et les distros basées dessus
Un petit pas pour moi, un grand pas pour mon projet
```
Bon, c’est un peu long et un peu trop d’infos d’un coup, généralement je
préfère taper `git log --oneline --graph --decorate` afin d’avoir un
affichage comme suit:
```text
$ git log --oneline --graph --decorate
* 4380d87 (HEAD -> master) new commit
* 59c21c6 nouveau texte
* 89139ef Un petit pas pour moi, un grand pas pour mon projet
```
Plus propre, non? Et les références sont plus courtes, ce qui est plus
agréable à taper. Allez, comparons les deux derniers commits.
```text
$ git add .
$ git commit -m "new commit"
$ git log --oneline --graph --decorate
* 4380d87 (HEAD -> master) new commit
* 59c21c6 nouveau texte
* 89139ef Un petit pas pour moi, un grand pas pour mon projet
$ git diff 59c21c6 4380d87
diff --git a/projet.txt b/projet.txt
index 03b0f20..b93413f 100644
--- a/projet.txt
+++ b/projet.txt
@@ -1 +1 @@
-projet
+C’est un super projet !
```
### Il y a des fichiers dont je me fiche dans mon dépôt {#il-y-a-des-fichiers-dont-je-me-fiche-dans-mon-dépôt}
Dans ce cas, il est grand temps de te présenter le fichier `.gitignore`.
Comme son nom l’indique, il permet au dépôt d’ignorer des fichiers selon ce
que tu lui indiqueras. Par exemple, si tu veux ignorer tous les fichiers
qui se terminent en `.out` (ou `.exe` sous Windows), tu peux éditer (ou
créer) ton `.gitignore` et entrer ces lignes :
```gitignore
*.out
*.exe
```
Maintenant, si tu créés un fichier en `.out` ou `.exe`, il sera
complètement ignoré par git et ne sera pas stocké dans l’historique des
versions. Il s’agit de ce qu’on appelle du globbing. En gros, l’étoile
indique que tu t’en fiches de ce qu’il y a devant `.out` ou `.exe` dans cet
exemple, si quelque chose se termine par ça, c’est ignoré. Pour ignorer
quelque chose dans un dossier, tu pourrais avoir quelque chose du genre
`mondossier/*` et POUF, tous les fichiers de `mondossier/` sont ignorés. En
gros, le globbing va fonctionner comme le globbing de ton shell (Bash, Zsh,
Fish,…)
Par exemple, [voici un dépôt](https://labs.phundrak.com/phundrak/langue-phundrak-com/commit/f8ec1936f839e9e95a6badf4480589f5bc9d00a0) un peu plus complexe que ce qu’on est en train
de faire (figé lors d’un commit fixé). Tu peux voir dans mon `.gitignore`
qu’il y a pas mal d’extensions de fichiers qui sont ignorées, mais j’ai
aussi `_minted*` et `auto-generated*` qui sont des dossiers ignorés, et pas
juste leur contenu qui est ignoré (l’étoile est là pour ignorer tous les
dossiers dont le nom commence par ce qui précède l’étoile). J’ai aussi
ignoré le dossier `.dart_tool/` qui lui pour le coup n’a pas de globbing,
ainsi que le fichier `pubspec.lock`, sans globbing non plus.
### On est plusieurs dessus en fait… {#on-est-plusieurs-dessus-en-fait}
Pas de panique! Git a été créé pour ça, et il dispose d’une fonctionnalité
de branchage permettant d’avoir plusieurs versions coexistantes d’un même
fichier. Cela peut être très utile pour avoir soit plusieurs personnes
travaillant sur un même projet, soit pour une même personne travaillant sur
plusieurs fonctionnalités différentes, soit les deux. Ainsi, on a plusieurs
version indépendantes que l’on pourra fusionner plus tard.
Par défaut une branche est créée lors de la création d’un dépôt qui
s’appelle `master`. Pour créer une nouvelle branche, on peut donc utiliser
la commande git checkout -b nomdelanouvellebranche.
```text
$ git checkout -b nouvelle-branche
Switched to a new branch 'nouvelle-branche'
```
À partir d’ici, toute modification apportée aux fichiers du dépôt
n’affecteront que la branche courante, `nouvelle-branche` donc, et les
fichiers de la branche `master` resteront inchangés. Si jamais tu veux
retourner pour une quelconque raison sur la branche `master`, il te suffira
d’utiliser la commande `git checkout master`.
Si tu souhaites avoir une liste des branches du dépôt, tu peux taper `git
branch --list`. La branche active sera marquée d’une étoile à côté de son
nom.
```text
$ git branch --list
master
* nouvelle-branche
```
### J’ai accidentellement modifié des fichiers sur la mauvaise branche, mais je n’ai pas encore fait de commits. {#j-ai-accidentellement-modifié-des-fichiers-sur-la-mauvaise-branche-mais-je-n-ai-pas-encore-fait-de-commits-dot}
Tout va bien alors! Tu vas simplement exécuter cette commande:
```text
$ git stash
```
Ça va déplacer toutes tes modifications que tu n’as pas encore commit dans
le stash, qui est une sorte d’emplacement temporaire, en dehors des
branches. Normalement, ça va réinitialiser tes fichiers tels qu’ils étaient
lors du dernier commit. Maintenant, change la branche sur laquelle tu
travailles, par exemple tu si tu es sur la branche `kevin`, tu exécutes
ceci:
```text
$ git checkout kevin
```
Tes modifications sont toujours dans ton stack, et pour les restaurer, tu
n’as plus qu’à exécuter
```text
$ git stash pop
```
Et voilà, tu viens de déplacer tes modifications sur la bonne branche. Pour
information, si tu as créé un nouveau fichier ou un nouveau dossier avec
des fichiers, ils ne seront pas déplacés dans le stash, mais ils ne seront
pas supprimés lors de la première commande. Tu auras juste à les commit sur
ta nouvelle branche pour qu’ils cessent de se déplacer de branche en
branche.
### Du coup, Mathilde a bien avancé sur son code, et moi aussi, chacun sur notre branche. On fait comment maintenant? {#du-coup-mathilde-a-bien-avancé-sur-son-code-et-moi-aussi-chacun-sur-notre-branche-dot-on-fait-comment-maintenant}
Au bout d’un moment, tu vas sans doute vouloir fusionner deux branches, par
exemple tu as finis de développer une nouvelle fonctionnalité sur la
branche `nouvelle-branche` et tu souhaites l’ajouter à la version stable de
ton code qui se situe sur `master`. Dans ce cas, ce que tu peux faire,
c’est retourner sur ta branche `master`, puis tu vas effectuer ce qu’on
appelle un merge ; en gros, pour faire simple, tu vas appliquer les
modifications de la branche que tu souhaites fusionner avec ta branche
`master` sur cette dernière.
```text
$ git checkout master
Switched to branch 'master'
$ git merge nouvelle-branche
Updating 133c5b6..2668937
Fast-forward
projet.txt | 1 +
1 file changed, 1 insertion(+)
create mode 100644 projet.txt
```
Rappelle-toi que la commande `merge` ramène les commits de la branche
spécifiée vers ta branche active, et pas forcément vers le `master`. Du
coup, si tu est sur une branche `mathilde` et que tu effectues un `git
merge leon`, tu vas ramener tous les commits de leon vers la branche
mathilde. Ça peut être intéressant à faire si jamais un bug a été corrigé
dans une autre branche ou qu’une fonctionnalité a été ajoutée et que tu
veux en bénéficier dans ta branche active. N’oublie juste pas de tout bien
commit avant de faire ton merge.
## J’ai entendu parler de Github… {#j-ai-entendu-parler-de-github}
Tu commences à me plaire Enzo! Github est un site web sur lequel tu peux
héberger des projets libres ou open-source (si tu ne connais pas la
différence, voici un article pour t’aider à comprendre, et un autre pour la
route). C’est en particulier orienté pour les projets gérés par git, ce qui
tombe bien car c’est ce qu’on utilise. Cela a pour avantage de pouvoir
aisément partager ton code et d’assurer qu’il est bien sauvegardé quelque
part d’autre que ton disque dur (un `rm -rf` est si vite arrivé). Et
surtout, ça peut te permettre de collaborer avec d’autres personnes sur le
même projet sans te casser la tête.
> Git est à Github ce que le porn est à Pornhub.
J’aimerais tout de même te mettre au courant que Github n’est largement pas
le seul site de ce genre à exister. Le concurrent le plus célèbre de Github
est [Gitlab](https://about.gitlab.com/), et personnellement j’utilise [Gitea](https://gitea.io/en-us/). Ces deux derniers peuvent
même être hébergés en instances personnelles, comme [ce que je fais avec
Gitea](https://labs.phundrak.com/phundrak/langue-phundrak-com/commit/f8ec1936f839e9e95a6badf4480589f5bc9d00a0) (qui est beaucoup plus léger que Gitlab, mais avec quelques
fonctionnalités en moins), et il existe encore [plein d’autres alternatives](https://labs.phundrak.com/phundrak/langue-phundrak-com/commit/f8ec1936f839e9e95a6badf4480589f5bc9d00a0),
à toi de trouver les autres.
## J’ai téléchargé un projet en zip {#j-ai-téléchargé-un-projet-en-zip}
Ou bien, tu peux télécharger le projet directement via git. Eh oui! git
permet de gérer les dépôts dits distants, c’est à dire ceux qui sont
hébergés sur un serveur en ligne, comme par exemple sur Github. Pour cela,
il te faut te munir du lien vers le dépôt git, et le passer en argument de
git clone. Par exemple, si tu veux télécharger de dépôt du petit logiciel de
chat en réseau que j’ai codé durant ma L2 d’informatique, tu peux exécuter
Branch 'master' set up to track remote branch 'master' from 'origin'.
```
Bon, là en nom d’utilisateur il y a le mien, faudra remplacer avec le tiens.
Et ouais, ma vitesse de mise en ligne n’est pas fameuse, je suis sur une
connexion 3G+ à l’heure où j’écris ces lignes, ne me juge pas. Bref,
toujours est-il que je viens de mettre en ligne les fichiers du dépôt sur
Github. Pas la peine de chercher le mien sur Github par contre, ça fera un
bail que je l’aurai supprimé au moment où tu liras ces lignes.
Pour info, tu peux éviter d’avoir à taper ton identifiant et ton mot de
passe à chaque fois que tu fais un push sur ton dépôt si tu indiques à
Github ta clef SSH. Tu auras plus d’informations là (c’est à peu près la
même merde pour Gitlab, Gitea et Cie).
## Quelqu’un a fait des modifications depuis mon dernier commit, je récupère ça comment? {#quelqu-un-a-fait-des-modifications-depuis-mon-dernier-commit-je-récupère-ça-comment}
Pour faire un exemple, je viens de créer un `README.md` sur Github
directement. Ce type de fichiers est assez standard afin de présenter plus
ou moins en détails le dépôt et le projet qui y est lié, et son contenu
apparaîtra formaté sur la page du dépôt sur Github s’il est au format `.md`
(Markdown) ou `.org` (org-mode, le Markdown d’Emacs avec lequel est écrit ce
tutoriel, et qui est clairement supérieur à Markdown). Mais il n’est pas
présent dans mon dépôt local, du coup je vais devoir le récupérer. On va
## Je suis en train de travailler sur le même fichier que Ginette {#je-suis-en-train-de-travailler-sur-le-même-fichier-que-ginette}
Là, c’est un problème qui aurait pu être évité avec l’usage des branches
dont je t’avais parlé plus haut, mais visiblement, vous êtes sur la même
branche. Pas bien. Dans ce cas-là, met-toi d’accord avec Ginette pour savoir
qui fait ses push en premier. Si le choix tombe sur Ginette, ou si elle a
imposé sa vision des choses et a fait son push avant toi, Github va râler
car tu n’es pas à jour. Dans ce cas ne panique pas, si tu n’as pas fait tes
commits, lance la commande `git stash` ; ça va sauvegarder tes modifications
dans un coin à part et va annuler tes modifications.
## Github ne veut pas de mes pushs sur le dépôt de Gilberte, oskour ! {#github-ne-veut-pas-de-mes-pushs-sur-le-dépôt-de-gilberte-oskour}
Du calme Jean-Célestin. Cela veut tout simplement dire que tu n’as tout
simplement pas les droits d’écriture sur son dépôt. Du coup, soit tu peux
lui demander directement à ce qu’elle te donne les droits d’écriture si elle
a confiance en toi, soit tu peux créer un fork puis une pull-request sur
Github depuis ton fork où tu auras fait tes modifications.
## Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ? {#fork-pull-request-que-font-des-fourchettes-et-des-pulls-dans-ce-tuto}
Ouhlà Billy, il va falloir remettre les choses au clair. Là il s’agit de
quelque chose de spécifique à Github qu’à Git (d’où le fait qu’on en discute
dans ce chapitre que le précédent).
Sur Github, il est possible de copier vers ton profil le dépôt de quelqu’un
d’autre dans l’état où il est au moment du fork. Cela inclus les fichiers du
`master`, mais également de toutes les branches du dépôt. Tu peux y penser
en terme de super-branche dont tu deviens le propriétaire. Tu peux ainsi
travailler comme bon te semble sur le code source sans que son propriétaire
ne vienne t’engueuler car tu es en train de polluer sa base de code.
Si jamais il y a une modification dont tu es particulièrement fier, tu peux
la soumettre au propriétaire du dépôt original (et à ses modérateurs et
contributeurs s’il y en a) via ce qu’on appelle une pull-request. Cela
signifie donc que tu demandes l’autorisation d’ajouter des commits à la base
de code, et ces commits peuvent être lus et commentés par le propriétaire ou
les modérateurs. Il peut y avoir une discussion entre toi et les autres
personnes qui ont leur mot à dire, le code peut être temporairement refusé,
auquel cas tu peux reproposer de nouveau commits sur la même pull-request
jusqu’à ce que ton code soit définitivement accepté ou refusé. Dans tous les
cas, cela mènera à la fermeture de ta pull-request, et tu pourras fièrement
annoncer que tu as participé à un projet sur Github, ou bien avouer avec
toute la honte du monde qu’il a été refusé.
## J’ai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même {#j-ai-remarqué-un-bug-ou-une-erreur-mais-je-ne-peux-pas-corriger-ça-moi-même}
Eh bien dans ce cas-là, ouvre une _issue_ Bernadette ; _issue_ qui en
français veut dire _problème_. Il s’agit d’un système de Github te
permettant de signaler quelque chose aux propriétaires du dépôt, il peut
s’agir d’un bug, d’une demande de fonctionnalité ou de proposition de
modification d’autres fonctionnalités. Cela peut donner lieu à des
discussions menant à la compréhension du bug, ou à une amélioration de ta
proposition.
Si tu soumets un bug, avant d’ouvrir une nouvelle issue, assure-toi de bien
savoir comment le bug se produit et peut se reproduire. Est-ce que le bug
apparaît si tu utilise ou ouvre le logiciel d’une autre façon ? Est-ce que
le bug apparaît ailleurs ? Est-tu sûr que le bug soit un bug ? Et si tu
décides de le partager, assure-toi de partager un maximum d’information et
tout ce que tu sais sur ce bug, en particulier les étapes et conditions pour
le reproduire.
## Les raccourcis et paramètres de Git {#les-raccourcis-et-paramètres-de-git}
Comme j’en avais parlé plus haut, il est possible de configurer git de façon
un peu plus poussée que simplement déclarer notre nom et notre adresse
e-mail dans notre `~/.gitconfig`. Il est par exemple possible de déclarer
notre éditeur texte préféré, notre navigateur par défaut ou bien même des
raccourcis qui pourront t’être bien utile. Ci dessous je te met une partie
de mon fichier de configuration avec quelques-unes de mes préférences et pas
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
