Quick update and clarification on git stash

This commit is contained in:
Phuntsok Drak-pa 2019-03-04 15:27:23 +01:00
parent 36e529f259
commit a2f1e68d58
5 changed files with 1416 additions and 117 deletions

View File

@ -1 +0,0 @@
tutoriel-git.org

379
README.org Normal file
View File

@ -0,0 +1,379 @@
#+INCLUDE: "headers.org"
#+TITLE: Tutoriel Git et GitHub
#+begin_src org :exports (when (eq org-export-current-backend 'xelatex) "none")
Tout dabord, si tu veux la version PDF du bouzin, [[https://phundrak.fr/git/tutoriel-git.pdf][cest par là]].
Et pour le code source de cette page, cest [[https://github.com/Phundrak/tutoriel-git][]], sur GitHub.
#+end_src
* Git ? Quest-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 quils naient 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 lajout de modifications dune de ces versions parallèles à une autre via des fusions partielles ou totales de branches, avec une automatisation des fusions de fichiers lorsquil ny 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 lair cool, comment ça sobtient?
** Et surtout, comment ça sinstalle ?
Très bonne question Kévin. Tout dabord, il faut tassurer que git soit installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux, tu peux linstaller via ton gestionnaire de paquet, ce qui rendra la commande accessible directement depuis le terminal.
#+BEGIN_SRC text
$ 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
$ emerge --ask --verbose dec-vcs/git # Gentoo
#+END_SRC
#+BEGIN_EXPORT html
<div id="org347e458" class="figure">
<p>
<img src="https://cdn.phundrak.fr/img/install_gentoo.jpg" alt="install_gentoo.jpg" style="display: block; margin: auto;" />
</p>
<p>
<span class="figure-number">Figure&nbsp;1&nbsp;: </span>&gt;install gentoo
</p>
</div>
#+END_EXPORT
Si tu nes pas sous GNU/Linux mais que tu as au moins le goût dêtre sous un OS de type Unix, tu peux exécuter la commande correspondante à ton OS suivant :
#+BEGIN_SRC text
$ pkg install git # FreeBSD
$ brew install git # macOS avec brew
$ port install git +svn +doc +bash_completion +gitweb # macOS avec MacPorts
#+END_SRC
Si tu es sous Windows... Bonne chance. Toutes les commandes seront en syntaxe Unix dans ce tutoriel, mais si tu as bien deux neurones, tu devrais pouvoir tout de même suivre le tutoriel.
** Ok cest bon, et il y a une configuration à faire ?
Tu peux configurer Git si tu le souhaites, oui. En général, il est recommandé de paramétrer au moins son nom et son email. Tu peux les paramétrer via la ligne de commande :
#+BEGIN_SRC text
$ git config --global user.name "Ton Nom"
$ git config --global user.email "ton@email.truc"
#+END_SRC
Tu peux aussi éditer le fichier =~/.gitconfig= comme suit :
#+BEGIN_SRC text
[user]
email = ton@email.truc
name = Ton nom
#+END_SRC
Cela permettra dassocier ton nom et ton adresse mail à tes commits. Par défaut, ceux qui sont enregistrés avec ton compte utilisateur de ton PC sont mis par défaut dans ces paramètres, mais on met quasiment tous un nom à la con quand on le créé. Et ça permet davoir les même paramètres si tu es sur un autre ordinateur.
Il y a encore pas mal de paramètres que tu peux gérer avec ce fichier, je reparlerai de certains plus tard, mais pour le reste, la documentation en ligne sur =gitconfig= ne manque pas.
* Ok très bien, comment on lutilise maintenant?
Du calme Jean-Kévin, ralentis un peu. Comme le dit ce vieux dicton Chinois :
#+BEGIN_QUOTE
Celui qui marche trop vite…… marche…………… trop… vite…? Tu peux tomber et te faire mal je suppose.
#+END_QUOTE
Bon, cest une contrefaçon, donc la qualité de la citation nest pas extraordinaire. Bref.
** Je commence comment?
Si tu souhaites créer un dépôt git, rien de plus simple : créé ton répertoire dans lequel tu travailleras, et déplace-y-toi. Ensuite, tu pourra initialiser ton dépôt via la commande =git init=.
#+BEGIN_SRC text
$ mkdir monsuperprojet
$ cd monsuperprojet
$ git init
Initialized empty Git repository in /tmp/monsuperprojet/.git/
#+END_SRC
Si tu obtiens à peu près le même message après la dernière commande, félicitations! Tu viens de créer ton premier dépôt git. En loccurrence, jai créé mon dépôt dans =/tmp=, mais toi tu peux voir un truc du genre =/home/corentin/monsuperprojet= à la place. Tu peux vérifier que tout va bien en rentrant la commande =git status=
#+BEGIN_SRC text
$ git status
On branch master
No commits yet
nothing to commit (create/copy files and use "git add" to track)
#+END_SRC
Parfait!
** Et pour ajouter des fichiers?
Maintenant tu peux commencer à travailler sur ton projet. Mais tout dabord, on va voir ce quil se passe si jamais on créé un fichier dans le dépôt. Créé un fichier =main.c= dans lequel tu vas entrer ce code :
#+BEGIN_SRC C
#include <stdio.h>
int main(int argc, char *argv[]) {
printf("Hello World!\n");
return 0;
}
#+END_SRC
En exécutant à nouveau =git status=, on peut voir la sortie suivante :
#+BEGIN_SRC text
$ git status
On branch master
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
main.c
nothing added to commit but untracked files present (use "git add" to track)
#+END_SRC
Tu commences à comprendre un peu le bail? Git vient de détecter quun nouveau fichier a été créé quil ne connaissait pas avant. Suivons ses bon conseils et ajoutons le fichier au dépôt.
#+BEGIN_SRC text
$ git add main.c
$ git status
On branch master
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: main.c
#+END_SRC
Super, maintenant git va surveiller les changements du fichier, mais attention, il na pas encore enregistré son état. Pour linstant il sait juste que le fichier est là, dans un certain état, mais rien ne garanti encore quon pourra retrouver cet état plus tard. On appelle ça le /staging/. Pour ce faire, il faut créer ce quon appelle un commit. En gros, il sagit dun enregistrement des modifications apportées à un ou plusieurs fichiers (dans leur globalité ou partiellement, on verra ça plus tard), le tout avec un commentaire.
#+BEGIN_SRC text
$ git commit -m "Un petit pas pour moi, un grand pas pour mon projet"
[master (root-commit) 89139ef] Un petit pas pour moi, un grand pas pour mon projet
1 file changed, 6 insertions(+)
create mode 100644 main.c
#+END_SRC
Parfait! Certains éléments peuvent être un peu différent chez toi, comme par exemple la référence du commit juste avant le message. Ça, cest un truc qui est géré automatiquement par git. Et voilà, on a létat de notre répertoire qui est enregistré et qui sera disponible plus tard. Maintenant, tu sais comment enregistrer des état de ton dépôt via les commits.
** Cool, mais jai accidentellement mis un fichier en staging
Si jamais tu as un staging que tu veux annuler, tu peux utiliser la commande =git reset HEAD nomdufichier= (ou plusieurs noms de fichiers) pour annuler le staging. Une fois le fichier qui nest plus dans ton staging, tu peux même annuler toutes les modifications que tu as apporté au fichier depuis ton dernier commit avec la commande =git checkout -- nomdufichier=, et tu peux aussi mettre plusieurs noms de fichiers. Par exemple, si jai modifié mon =main.c= en modifiant ainsi les arguments du =main()= :
#+BEGIN_SRC C
#include <stdio.h>
int main(void) {
printf("Hello World!\n");
return 0;
}
#+END_SRC
Je peux annuler tout ça via ces commandes :
#+BEGIN_SRC text
$ git reset HEAD main.c
Unstaged changes after reset:
M main.c
$ git checkout -- main.c
$ git status
On branch master
nothing to commit, working tree clean
#+END_SRC
Si je fait un =cat= du fichier, je vois quil est revenu à son état initial.
** En fait, jai juste oublié un truc dans mon commit précédent
Si jamais tu veux à la place ajouter la modification dun fichier au dernier commit (mettons, tu as oublié dajouter également un fichier texte), tu peux utiliser loption =--amend= lors du commit du fichier oublié.
#+BEGIN_SRC text
$ git add main.c # Jai refait les modifications annulées plus tôt
$ git commit -m "second commit"
[master 97f698a] second commit
1 file changed, 1 insertion(+), 1 deletion(-)
$ echo "Cest un super projet !" > projet.txt
$ git add projet.txt
$ git commit --amend -m "second commit + oubli"
[master 9aff4c0] second commit + oubli
Date: Fri Oct 5 11:10:56 2018 +0200
2 files changed, 2 insertions(+), 1 deletion(-)
create mode 100644 projet.txt
#+END_SRC
En gros, le commit que tu viens de faire a remplacé le précédent en conservant les informations du commit précédent, mis à part son commentaire. Si tu ne met pas loption =-m "ton texte"= lors de lamendement du commit, ton éditeur texte par défaut va souvrir pour que tu puisses modifier le texte du commit précédent si tu le souhaite. Si jamais vi ou vim souvre et que tu nas aucune idée de comment sortir de cet enfant du démon, tu as juste à appuyer sur la touche Échap (au cas où), puis à taper =:wq= (=w= pour écrire le fichier, =q= pour quitter), puis tu appuye sur la touche Entrée. Si tu as Nano qui sest ouvert, alors il faut taper Ctrl-X.
** Euh, jai oublié ce que jai changé lors du dernier commit
Pas de panique! Tu peux entrer la commande =git diff= afin de voir ce que tout ce que tu as modifié lors de ton dernier commit. Et si tu ne souhaite voir les modifications que dun certain fichier, tu peux ajouter le nom de ton fichier à la fin de la commande.
#+BEGIN_SRC text
$ echo "Cest un super projet !" > projet.txt
$ git diff
diff --git a/projet.txt b/projet.txt
index 03b0f20..b93413f 100644
--- a/projet.txt
+++ b/projet.txt
@@ -1 +1 @@
-projet
+Cest un super projet !
#+END_SRC
Tu peux également voir les différences de fichiers entre deux commits en entrant leur référence. Pour avoir la référence, tu peux rentrer la commande =git log= pour avoir un petit historique des commits.
#+BEGIN_SRC text
$ git log
commit 4380d8717261644b81a1858920406645cf409028 (HEAD -> master)
Author: Phuntsok Drak-pa <phundrak@phundrak.fr>
Date: Fri Oct 5 11:59:40 2018 +0200
new commit
commit 59c21c6aa7e3ec7edd229f81b87becbc7ec13596
Author: Phuntsok Drak-pa <phundrak@phundrak.fr>
Date: Fri Oct 5 11:10:56 2018 +0200
nouveau texte
commit 89139ef233d07a64d3025de47f8b6e8ce7470318
Author: Phuntsok Drak-pa <phundrak@phundrak.fr>
Date: Fri Oct 5 10:56:58 2018 +0200
Un petit pas pour moi, un grand pas pour mon projet
#+END_SRC
Bon, cest un peu long et un peu trop dinfos dun coup, généralement je préfère taper =git log --oneline --graph --decorate= afin davoir un affichage comme suit :
#+BEGIN_SRC 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
#+END_SRC
Plus propre, non? Et les références sont plus courtes, ce qui est plus agréable à taper. Allez, comparons les deux derniers commits.
#+BEGIN_SRC 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
+Cest un super projet !
#+END_SRC
** 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 lindique, il permet au dépôt dignorer 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 :
#+BEGIN_SRC text
,*.out
,*.exe
#+END_SRC
Maintenant, si tu créés un fichier en =.out= ou =.exe=, il sera complètement ignoré par git et ne sera pas stocké dans lhistorique des versions.
** On est plusieurs dessus en fait…
Pas de panique ! Git dispose dune fonctionnalité de brachange permettant davoir plusieurs versions coexistantes dun 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 idépendantes que lon pourra fusionner plus tard.
Par défaut une brache est créée lors de la création dun dépôt qui sappelle =master=. Pour créer une nouvelle branche, on peut donc utiliser la commande =git checkout -b nomdelanouvellebranche=.
#+BEGIN_SRC text
$ git checkout -b nouvelle-branche
Switched to a new branch 'nouvelle-branche'
#+END_SRC
À partir dici, toute modification apportée aux fichiers du dépôt naffecteront que la brache courante, =nouvelle-branche= donc, et les fichiers de la brache =master= resteront inchangés. Si jamais tu veux retourner pour une quelconque raison sur la branche =master=, il te suffira dutiliser la commande =git checkout master=.
Si tu souhaites avoir une liste des braches du dépôt, tu peux taper =git branch --list=. La branche active sera marquée dune étoile à côté de son nom.
#+BEGIN_SRC text
$ git branch --list
master
,* nouvelle-branche
#+END_SRC
Au bout dun moment, tu vas sans doute vouloir fusionner deux braches, par exemple tu as finis de développer une nouvelle fonctionnalité sur la branche =nouvelle-branche= et tu souhaites lajouter à la version stable de ton code qui se situe sur =master=. Dans ce cas, ce que tu peux faire, cest retourner sur ta branche =master=, puis tu vas effectuer ce quon 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.
#+BEGIN_SRC 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
#+END_SRC
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 brache =gisianne= et que tu effectues un =git merge roger=, tu vas rammener tous les commits de =roger= vers la branche =gisianne=. Ce peut être intéressant à faire si jamais un bug a été corrigé dans une autre branche ou quune fonctionnalité a été ajoutée et que tu veux en bénéficier dans ta branche active. Noublie juste pas de tout bien commit avant de faire ton /merge/.
* Jai 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 [[https://www.gnu.org/philosophy/open-source-misses-the-point.fr.html][un article]] pour taider à comprendre, et [[https://www.gnu.org/philosophy/free-software-for-freedom.fr.html][un autre]] pour la route). Cest en particulier orienté pour les projets gérés par git, ce qui tombe bien car cest ce quon utilise. Cela a pour avantage de pouvoir aisément partager ton code et dassurer quil est bien sauvegardé quelque part dautre que ton disque dur (un =rm -rf= est si vite arrivé). Et surtout, ça peut te permettre de collaborer avec dautres personnes sur le même projet sans te casser la tête.
** Jai 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, cest à 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 jai codé durant ma L2 dinformatique, tu peux exécuter ceci :
#+BEGIN_SRC text
$ git clone https://github.com/Phundrak/chat-reseau-P8.git
Cloning into 'chat-reseau-P8'...
remote: Enumerating objects: 345, done.
remote: Total 345 (delta 0), reused 0 (delta 0), pack-reused 345
Receiving objects: 100% (345/345), 63.91 KiB | 39.00 KiB/s, done.
Resolving deltas: 100% (107/107), done.
#+END_SRC
Et cest bon, tu as accès au répertoire =chat-reseau-P8= et au code source du projet.
** Et si je veux créer mon propre dépôt sur GitHub
Dans ce cas là, cest simple Brigitte. Il faut que tu te créés un compte sur GitHub, puis tu cliques sur le bouton =+= et =New Repository=. Tu lui donnes le nom que tu souhaites (en loccurrence je le nomme =temporary-repo= car je vais le supprimer cinq minutes après lécriture de ces lignes), et tu cliques sur =Create Repository=. Tu najoutes rien avant, pas de description, pas de =.gitignore=, RIEN.
Et là, magie ! GitHub indique comment ajouter le dépôt distant à ton dépôt local.
#+BEGIN_SRC text
$ git remote add origin https://github.com/Phundrak/temporary-repo.git
#+END_SRC
Et voilà, ton dépôt est lié au dépôt distant. Oui, juste comme ça.
** Et du coup, comment je met tout ça en ligne ?
Bon ok, ce nest pas aussi simple que ça. Une fois que tu as lié ton dépôt au dépôt distant, il faudra que tu mettes en ligne tes commits quand tu en auras loccasion. Pour ce faire, tu nas quà taper =git push= ; et la première fois, il faudra que tu indiques à ton dépôt où mettre en ligne précisément dans le dépôt distant, auquel cas tu ajoutes =-u origin master= pour cette première fois. Git te demandera donc tes identifiants GitHub pour pouvoir mettre tout ça en ligne.
#+BEGIN_SRC text
$ git push -u origin master
Username for 'https://github.com': phundrak
Password for 'https://phundrak@github.com':
Enumerating objects: 10, done.
Counting objects: 100% (10/10), done.
Delta compression using up to 8 threads
Compressing objects: 100% (7/7), done.
Writing objects: 100% (10/10), 940 bytes | 313.00 KiB/s, done.
Total 10 (delta 0), reused 0 (delta 0)
remote:
remote: Create a pull request for 'master' on GitHub by visiting:
remote: https://github.com/Phundrak/temporary-repo/pull/new/master
remote:
To https://github.com/Phundrak/temporary-repo.git
,* [new branch] master -> master
Branch 'master' set up to track remote branch 'master' from 'origin'.
#+END_SRC
Bon, là en nom dutilisateur ya le mien, faudra remplacer avec le tiens. Et ouais, ma vitesse de mise en ligne nest pas fameuse, je suis sur une connexion 3G+ à lheure 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 laurai supprimé au moment où tu liras ces lignes.
** Quelquun 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 formatté sur la page du dépôt sur GitHub sil est au format =.md= (Markdown) ou =.org= (org-mode, le Markdown dEmacs avec lequel est écrit ce tutoriel). Mais il nest pas présent dans mon dépôt local, du coup je vais devoir le récupérer. On va donc entrer =git pull=.
#+BEGIN_SRC text
$ git pull
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), done.
From https://github.com/Phundrak/temporary-repo
4380d87..8bd4896 master -> origin/master
Updating 4380d87..8bd4896
Fast-forward
README.md | 2 ++
1 file changed, 2 insertions(+)
create mode 100644 README.md
#+END_SRC
** Je suis en train de travailler sur le même fichier que Ginette
Là, cest un problème qui aurait pu être évité avec lusage des branches dont je tavais parlé plus haut, mais visiblement, vous êtes sur la même branche. Pas bien. Dans ce cas-là, met-toi daccord 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 nes pas à jour. Dans ce cas ne panique pas, si tu nas 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 !
Du calme Jean-Célestin. Cela veut tout simplement dire que tu nas tout simplement pas les droits décriture sur son dépôt. Du coup, soit tu peux lui demander directement à ce quelle 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 ?
Ouhlà Billy, il va falloir remettre les choses au clair. Là il sagit de quelque chose de spécifique à GitHub quà Git (doù le fait quon 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 quelquun dautre 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 tengueuler 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 sil y en a) via ce quon appelle une pull-request. Cela signifie donc que tu demandes lautorisation dajouter 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 quil a été refusé.
** Jai 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 sagit dun système de GitHub te permettant de signaler quelque chose aux propriétaires du dépôt, il peut sagir dun bug, dune demande de fonctionnalité ou de proposition de modification dautres 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 douvrir 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 dune 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 dinformation 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
Comme jen 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 email 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 mal de mes alias.
#+BEGIN_SRC text
[core]
editor = vim
whitespace = fix,-indent-with-non-tab,trailing-space
[web]
browser = chromium
[color]
ui = auto
[alias]
a = add --all
c = commit
cm = commit -m
cam = commit -am
co = checkout
cob = checkout -b
cl = clone
l = log --oneline --graph --decorate
ps = push
pl = pull
re = reset
s = status
staged = diff --cached
st = stash
sc = stash clear
sp = stash pop
sw = stash show
#+END_SRC
- =a= :: Permet dajouter dun coup tout nouveau fichier dun dépôt en préparation au commit. On peut faire la même chose avec =git add .= si on est à la racine du dépôt.
- =c= :: Un raccourci pour =commit=, ça permet déviter quelques frappes de clavier décrire =git c= plutôt que =git commit=
- =cm= :: De même pour =cm= qui évite de devoir écrire =commit -m=. On na plus quà écrire directement le message de commit après =cm=.
- =cam= :: Non, ce nest pas un plan, cest le même alias que =cm= mais qui en plus met automatiquement tous les fichiers modifiés ou supprimés, donc sil ny a pas de nouveau fichier à ajouter, même pas besoin de passer par un =git a= avant le =git cam "jaime les pâtes"=.
- =co= :: Pour aller plus vite quand on veut écrire =checkout=.
- =cob= :: Et pour en plus rajouter le flag =-b= pour la création dune nouvelle branche.
- =cl= :: Pour quand tu voudras télécharger ce tutoriel en tapant =git cl https://github.com/Phundrak/tutoriel-git.git= plutôt que =git clone https://github.com/Phundrak/tutoriel-git.git=.
- =l= :: Te permet davoir le log un peu plus sympa et compact dont javais parlé plus haut.
- =ps= :: Pour faire un push plus rapidement.
- =pl= :: Et pour télécharger les derniers commits sur le dépôt plus rapidement.
- =re= :: Pour réinitialiser plus rapidement.
- =s= :: Pour rapidement savoir où tu en es dans ton dépôt, savoir ce qui a été modifié, ajouté, supprimé, déplacé, tout ça...
- =staged= :: Eh oui, Git na pas de fonction dédiée pour lister les fichiers en staging, du coup la voilà.
- =st= :: Pour sauvegarder tes modifications sur le stash plus rapidement.
- =sc= :: Pour supprimer ton stash plus rapidement.
- =sp= :: Pour rétablir le stash sur la branche courante plus rapidement.
- =sw= :: Pour rapidement savoir ce quil y a sur le stash.
* Et cest tout ?
Cest déjà pas mal ! Mais non, ce nest certainement pas tout. Cependant, ce tutoriel na pour but de tapprendre que les bases de Git et de GitHub, pas de tout tapprendre ! Si tu souhaites aller plus loin, connaitre plus de commandes (comme =git blame= ou =git reset=), ou bien connaître plus doptions, je ne peux que tinviter à aller te documenter par toi-même sur le site de Git qui se trouve [[https://git-scm.com/][ici]], ou bien à consulter des pages de manuel dans ton terminal via =man git=, =man git-apply= ou =man-cherry-pick= (oui, il faut lier =git= et le nom de la commande par un tiret dunion).
Si jamais tu as une question, nhésite pas à menvoyer un mail à [[mailto://phundrak@phundrak.fr][phundrak@phundrak.fr]]. Si jamais tu trouves une erreur dans ce que je viens de dire dans ce tutoriel, ou si tu as une suggestion, cest justement le moment de mettre en pratique ce que tu as lu un peu plus haut et douvrir une /issue/ sur GitHub sur [[https://github.com/Phundrak/tutoriel-git][le dépôt de ce tutoriel]].
# LocalWords: Jean-Kévin staging Ctrl-X déplace-y-toi push

View File

@ -1 +0,0 @@
tutoriel-git.html

899
index.html Normal file
View File

@ -0,0 +1,899 @@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head>
<!-- 2019-01-21 lun. 20:21 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Tutoriel Git et GitHub</title>
<meta name="generator" content="Org mode" />
<meta name="author" content="Lucien Cartier-Tilet" />
<style type="text/css">
<!--/*--><![CDATA[/*><!--*/
.title { text-align: center;
margin-bottom: .2em; }
.subtitle { text-align: center;
font-size: medium;
font-weight: bold;
margin-top:0; }
.todo { font-family: monospace; color: red; }
.done { font-family: monospace; color: green; }
.priority { font-family: monospace; color: orange; }
.tag { background-color: #eee; font-family: monospace;
padding: 2px; font-size: 80%; font-weight: normal; }
.timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; }
.org-right { margin-left: auto; margin-right: 0px; text-align: right; }
.org-left { margin-left: 0px; margin-right: auto; text-align: left; }
.org-center { margin-left: auto; margin-right: auto; text-align: center; }
.underline { text-decoration: underline; }
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
p.verse { margin-left: 3%; }
pre {
border: 1px solid #ccc;
box-shadow: 3px 3px 3px #eee;
padding: 8pt;
font-family: monospace;
overflow: auto;
margin: 1.2em;
}
pre.src {
position: relative;
overflow: visible;
padding-top: 1.2em;
}
pre.src:before {
display: none;
position: absolute;
background-color: white;
top: -10px;
right: 10px;
padding: 3px;
border: 1px solid black;
}
pre.src:hover:before { display: inline;}
/* Languages per Org manual */
pre.src-asymptote:before { content: 'Asymptote'; }
pre.src-awk:before { content: 'Awk'; }
pre.src-C:before { content: 'C'; }
/* pre.src-C++ doesn't work in CSS */
pre.src-clojure:before { content: 'Clojure'; }
pre.src-css:before { content: 'CSS'; }
pre.src-D:before { content: 'D'; }
pre.src-ditaa:before { content: 'ditaa'; }
pre.src-dot:before { content: 'Graphviz'; }
pre.src-calc:before { content: 'Emacs Calc'; }
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
pre.src-fortran:before { content: 'Fortran'; }
pre.src-gnuplot:before { content: 'gnuplot'; }
pre.src-haskell:before { content: 'Haskell'; }
pre.src-hledger:before { content: 'hledger'; }
pre.src-java:before { content: 'Java'; }
pre.src-js:before { content: 'Javascript'; }
pre.src-latex:before { content: 'LaTeX'; }
pre.src-ledger:before { content: 'Ledger'; }
pre.src-lisp:before { content: 'Lisp'; }
pre.src-lilypond:before { content: 'Lilypond'; }
pre.src-lua:before { content: 'Lua'; }
pre.src-matlab:before { content: 'MATLAB'; }
pre.src-mscgen:before { content: 'Mscgen'; }
pre.src-ocaml:before { content: 'Objective Caml'; }
pre.src-octave:before { content: 'Octave'; }
pre.src-org:before { content: 'Org mode'; }
pre.src-oz:before { content: 'OZ'; }
pre.src-plantuml:before { content: 'Plantuml'; }
pre.src-processing:before { content: 'Processing.js'; }
pre.src-python:before { content: 'Python'; }
pre.src-R:before { content: 'R'; }
pre.src-ruby:before { content: 'Ruby'; }
pre.src-sass:before { content: 'Sass'; }
pre.src-scheme:before { content: 'Scheme'; }
pre.src-screen:before { content: 'Gnu Screen'; }
pre.src-sed:before { content: 'Sed'; }
pre.src-sh:before { content: 'shell'; }
pre.src-sql:before { content: 'SQL'; }
pre.src-sqlite:before { content: 'SQLite'; }
/* additional languages in org.el's org-babel-load-languages alist */
pre.src-forth:before { content: 'Forth'; }
pre.src-io:before { content: 'IO'; }
pre.src-J:before { content: 'J'; }
pre.src-makefile:before { content: 'Makefile'; }
pre.src-maxima:before { content: 'Maxima'; }
pre.src-perl:before { content: 'Perl'; }
pre.src-picolisp:before { content: 'Pico Lisp'; }
pre.src-scala:before { content: 'Scala'; }
pre.src-shell:before { content: 'Shell Script'; }
pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
/* additional language identifiers per "defun org-babel-execute"
in ob-*.el */
pre.src-cpp:before { content: 'C++'; }
pre.src-abc:before { content: 'ABC'; }
pre.src-coq:before { content: 'Coq'; }
pre.src-groovy:before { content: 'Groovy'; }
/* additional language identifiers from org-babel-shell-names in
ob-shell.el: ob-shell is the only babel language using a lambda to put
the execution function name together. */
pre.src-bash:before { content: 'bash'; }
pre.src-csh:before { content: 'csh'; }
pre.src-ash:before { content: 'ash'; }
pre.src-dash:before { content: 'dash'; }
pre.src-ksh:before { content: 'ksh'; }
pre.src-mksh:before { content: 'mksh'; }
pre.src-posh:before { content: 'posh'; }
/* Additional Emacs modes also supported by the LaTeX listings package */
pre.src-ada:before { content: 'Ada'; }
pre.src-asm:before { content: 'Assembler'; }
pre.src-caml:before { content: 'Caml'; }
pre.src-delphi:before { content: 'Delphi'; }
pre.src-html:before { content: 'HTML'; }
pre.src-idl:before { content: 'IDL'; }
pre.src-mercury:before { content: 'Mercury'; }
pre.src-metapost:before { content: 'MetaPost'; }
pre.src-modula-2:before { content: 'Modula-2'; }
pre.src-pascal:before { content: 'Pascal'; }
pre.src-ps:before { content: 'PostScript'; }
pre.src-prolog:before { content: 'Prolog'; }
pre.src-simula:before { content: 'Simula'; }
pre.src-tcl:before { content: 'tcl'; }
pre.src-tex:before { content: 'TeX'; }
pre.src-plain-tex:before { content: 'Plain TeX'; }
pre.src-verilog:before { content: 'Verilog'; }
pre.src-vhdl:before { content: 'VHDL'; }
pre.src-xml:before { content: 'XML'; }
pre.src-nxml:before { content: 'XML'; }
/* add a generic configuration mode; LaTeX export needs an additional
(add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
pre.src-conf:before { content: 'Configuration File'; }
table { border-collapse:collapse; }
caption.t-above { caption-side: top; }
caption.t-bottom { caption-side: bottom; }
td, th { vertical-align:top; }
th.org-right { text-align: center; }
th.org-left { text-align: center; }
th.org-center { text-align: center; }
td.org-right { text-align: right; }
td.org-left { text-align: left; }
td.org-center { text-align: center; }
dt { font-weight: bold; }
.footpara { display: inline; }
.footdef { margin-bottom: 1em; }
.figure { padding: 1em; }
.figure p { text-align: center; }
.inlinetask {
padding: 10px;
border: 2px solid gray;
margin: 10px;
background: #ffffcc;
}
#org-div-home-and-up
{ text-align: right; font-size: 70%; white-space: nowrap; }
textarea { overflow-x: auto; }
.linenr { font-size: smaller }
.code-highlighted { background-color: #ffff00; }
.org-info-js_info-navigation { border-style: none; }
#org-info-js_console-label
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
.org-info-js_search-highlight
{ background-color: #ffff00; color: #000000; font-weight: bold; }
.org-svg { width: 90%; }
/*]]>*/-->
</style>
<link rel="stylesheet" type="text/css" href="https://langue.phundrak.fr/css/htmlize.css"/>
<link rel="stylesheet" type="text/css" href="https://langue.phundrak.fr/css/readtheorg.css"/>
<script src="https://phundrak.fr/js/jquery.min.js"></script>
<script src="https://phundrak.fr/js/bootstrap.min.js"></script>
<script type="text/javascript" src="https://phundrak.fr/js/jquery.stickytableheaders.min.js"></script>
<script type="text/javascript" src="https://phundrak.fr/js/readtheorg.js"></script>
<script type="text/javascript">
/*
@licstart The following is the entire license notice for the
JavaScript code in this tag.
Copyright (C) 2012-2018 Free Software Foundation, Inc.
The JavaScript code in this tag is free software: you can
redistribute it and/or modify it under the terms of the GNU
General Public License (GNU GPL) as published by the Free Software
Foundation, either version 3 of the License, or (at your option)
any later version. The code is distributed WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.
As additional permission under GNU GPL version 3 section 7, you
may distribute non-source (e.g., minimized or compacted) forms of
that code without the copy of the GNU GPL normally required by
section 4, provided you include this license notice and a URL
through which recipients can access the Corresponding Source.
@licend The above is the entire license notice
for the JavaScript code in this tag.
*/
<!--/*--><![CDATA[/*><!--*/
function CodeHighlightOn(elem, id)
{
var target = document.getElementById(id);
if(null != target) {
elem.cacheClassElem = elem.className;
elem.cacheClassTarget = target.className;
target.className = "code-highlighted";
elem.className = "code-highlighted";
}
}
function CodeHighlightOff(elem, id)
{
var target = document.getElementById(id);
if(elem.cacheClassElem)
elem.className = elem.cacheClassElem;
if(elem.cacheClassTarget)
target.className = elem.cacheClassTarget;
}
/*]]>*///-->
</script>
</head>
<body>
<div id="content">
<h1 class="title">Tutoriel Git et GitHub</h1>
<p>
</p>
<div id="table-of-contents">
<h2>Table des matières</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#orgd5dc8f7">1. Git ? Quest-ce donc ?</a></li>
<li><a href="#org9702fca">2. Ça a lair cool, comment ça sobtient?</a>
<ul>
<li><a href="#org333d2ea">2.1. Et surtout, comment ça sinstalle ?</a></li>
<li><a href="#orgf5f99ae">2.2. Ok cest bon, et il y a une configuration à faire ?</a></li>
</ul>
</li>
<li><a href="#orgd81deb9">3. Ok très bien, comment on lutilise maintenant?</a>
<ul>
<li><a href="#org45af36f">3.1. Je commence comment?</a></li>
<li><a href="#org10dda73">3.2. Et pour ajouter des fichiers?</a></li>
<li><a href="#org41d5117">3.3. Cool, mais jai accidentellement mis un fichier en staging</a></li>
<li><a href="#org38bcd9c">3.4. En fait, jai juste oublié un truc dans mon commit précédent</a></li>
<li><a href="#org9a93b6a">3.5. Euh, jai oublié ce que jai changé lors du dernier commit</a></li>
<li><a href="#orga1259b0">3.6. Il y a des fichiers dont je me fiche dans mon dépôt</a></li>
<li><a href="#org4aca8c0">3.7. On est plusieurs dessus en fait…</a></li>
</ul>
</li>
<li><a href="#org3ce705c">4. Jai entendu parler de GitHub…</a>
<ul>
<li><a href="#org1e943ba">4.1. Jai téléchargé un projet en zip</a></li>
<li><a href="#org12b50dd">4.2. Et si je veux créer mon propre dépôt sur GitHub</a></li>
<li><a href="#org3780760">4.3. Et du coup, comment je met tout ça en ligne ?</a></li>
<li><a href="#org4e0b939">4.4. Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?</a></li>
<li><a href="#orgafeb18d">4.5. Je suis en train de travailler sur le même fichier que Ginette</a></li>
<li><a href="#org1936e87">4.6. GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !</a></li>
<li><a href="#orgd44543c">4.7. Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?</a></li>
<li><a href="#org4a2bb3f">4.8. Jai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même</a></li>
</ul>
</li>
<li><a href="#orgf953051">5. Les raccourcis et paramètres de Git</a></li>
<li><a href="#orgc1ca16e">6. Et cest tout ?</a></li>
</ul>
</div>
</div>
<p>
</p>
<div class="org-src-container">
<pre class="src src-org">Tout d&#8217;abord, si tu veux la version PDF du bouzin, <span style="color: #899597; text-decoration: underline;"><a href="https://phundrak.fr/git/tutoriel-git.pdf">c&#8217;est par l&#224;</a></span>.
Et pour le code source de cette page, c&#8217;est <span style="color: #899597; text-decoration: underline;"><a href="https://github.com/Phundrak/tutoriel-git">l&#224;</a></span>, sur GitHub.
</pre>
</div>
<div id="outline-container-orgd5dc8f7" class="outline-2">
<h2 id="orgd5dc8f7"><span class="section-number-2">1</span> Git ? Quest-ce donc ?</h2>
<div class="outline-text-2" id="text-1">
<p>
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 quils naient 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 lajout de modifications dune de ces versions parallèles à une autre via des fusions partielles ou totales de branches, avec une automatisation des fusions de fichiers lorsquil ny a pas de conflit entre ces derniers.
</p>
<p>
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.
</p>
<p>
Toujours là? Tu auras été prévenu·e.
</p>
</div>
</div>
<div id="outline-container-org9702fca" class="outline-2">
<h2 id="org9702fca"><span class="section-number-2">2</span> Ça a lair cool, comment ça sobtient?</h2>
<div class="outline-text-2" id="text-2">
</div>
<div id="outline-container-org333d2ea" class="outline-3">
<h3 id="org333d2ea"><span class="section-number-3">2.1</span> Et surtout, comment ça sinstalle ?</h3>
<div class="outline-text-3" id="text-2-1">
<p>
Très bonne question Kévin. Tout dabord, il faut tassurer que git soit installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux, tu peux linstaller via ton gestionnaire de paquet, ce qui rendra la commande accessible directement depuis le terminal.
</p>
<div class="org-src-container">
<pre class="src src-text">$ apt install git # Debian, Ubuntu et les distros bas&#233;es dessus
$ yum install git # CentOS
$ dnf -y install git # Fedora
$ pacman -S git # ArchLinux et les distros bas&#233;es dessus
$ emerge --ask --verbose dec-vcs/git # Gentoo
</pre>
</div>
<div id="org347e458" class="figure">
<p>
<img src="https://cdn.phundrak.fr/img/install_gentoo.jpg" alt="install_gentoo.jpg" style="display: block; margin: auto;" />
</p>
<p>
<span class="figure-number">Figure&nbsp;1&nbsp;: </span>&gt;install gentoo
</p>
</div>
<p>
Si tu nes pas sous GNU/Linux mais que tu as au moins le goût dêtre sous un OS de type Unix, tu peux exécuter la commande correspondante à ton OS suivant :
</p>
<div class="org-src-container">
<pre class="src src-text">$ pkg install git # FreeBSD
$ brew install git # macOS avec brew
$ port install git +svn +doc +bash_completion +gitweb # macOS avec MacPorts
</pre>
</div>
<p>
Si tu es sous Windows&#x2026; Bonne chance. Toutes les commandes seront en syntaxe Unix dans ce tutoriel, mais si tu as bien deux neurones, tu devrais pouvoir tout de même suivre le tutoriel.
</p>
</div>
</div>
<div id="outline-container-orgf5f99ae" class="outline-3">
<h3 id="orgf5f99ae"><span class="section-number-3">2.2</span> Ok cest bon, et il y a une configuration à faire ?</h3>
<div class="outline-text-3" id="text-2-2">
<p>
Tu peux configurer Git si tu le souhaites, oui. En général, il est recommandé de paramétrer au moins son nom et son email. Tu peux les paramétrer via la ligne de commande :
</p>
<div class="org-src-container">
<pre class="src src-text">$ git config --global user.name "Ton Nom"
$ git config --global user.email "ton@email.truc"
</pre>
</div>
<p>
Tu peux aussi éditer le fichier <code>~/.gitconfig</code> comme suit :
</p>
<div class="org-src-container">
<pre class="src src-text">[user]
email = ton@email.truc
name = Ton nom
</pre>
</div>
<p>
Cela permettra dassocier ton nom et ton adresse mail à tes commits. Par défaut, ceux qui sont enregistrés avec ton compte utilisateur de ton PC sont mis par défaut dans ces paramètres, mais on met quasiment tous un nom à la con quand on le créé. Et ça permet davoir les même paramètres si tu es sur un autre ordinateur.
</p>
<p>
Il y a encore pas mal de paramètres que tu peux gérer avec ce fichier, je reparlerai de certains plus tard, mais pour le reste, la documentation en ligne sur <code>gitconfig</code> ne manque pas.
</p>
</div>
</div>
</div>
<div id="outline-container-orgd81deb9" class="outline-2">
<h2 id="orgd81deb9"><span class="section-number-2">3</span> Ok très bien, comment on lutilise maintenant?</h2>
<div class="outline-text-2" id="text-3">
<p>
Du calme Jean-Kévin, ralentis un peu. Comme le dit ce vieux dicton Chinois :
</p>
<blockquote>
<p>
Celui qui marche trop vite…… marche…………… trop… vite…? Tu peux tomber et te faire mal je suppose.
</p>
</blockquote>
<p>
Bon, cest une contrefaçon, donc la qualité de la citation nest pas extraordinaire. Bref.
</p>
</div>
<div id="outline-container-org45af36f" class="outline-3">
<h3 id="org45af36f"><span class="section-number-3">3.1</span> Je commence comment?</h3>
<div class="outline-text-3" id="text-3-1">
<p>
Si tu souhaites créer un dépôt git, rien de plus simple : créé ton répertoire dans lequel tu travailleras, et déplace-y-toi. Ensuite, tu pourra initialiser ton dépôt via la commande <code>git init</code>.
</p>
<div class="org-src-container">
<pre class="src src-text">$ mkdir monsuperprojet
$ cd monsuperprojet
$ git init
Initialized empty Git repository in /tmp/monsuperprojet/.git/
</pre>
</div>
<p>
Si tu obtiens à peu près le même message après la dernière commande, félicitations! Tu viens de créer ton premier dépôt git. En loccurrence, jai créé mon dépôt dans <code>/tmp</code>, mais toi tu peux voir un truc du genre <code>/home/corentin/monsuperprojet</code> à la place. Tu peux vérifier que tout va bien en rentrant la commande <code>git status</code>
</p>
<div class="org-src-container">
<pre class="src src-text">$ git status
On branch master
No commits yet
nothing to commit (create/copy files and use "git add" to track)
</pre>
</div>
<p>
Parfait!
</p>
</div>
</div>
<div id="outline-container-org10dda73" class="outline-3">
<h3 id="org10dda73"><span class="section-number-3">3.2</span> Et pour ajouter des fichiers?</h3>
<div class="outline-text-3" id="text-3-2">
<p>
Maintenant tu peux commencer à travailler sur ton projet. Mais tout dabord, on va voir ce quil se passe si jamais on créé un fichier dans le dépôt. Créé un fichier <code>main.c</code> dans lequel tu vas entrer ce code :
</p>
<div class="org-src-container">
<pre class="src src-C"><span style="color: #929EA1;">#include</span> <span style="color: #d1dadb;">&lt;</span><span style="color: #727F80;">stdio.h</span><span style="color: #d1dadb;">&gt;</span>
<span style="color: #929EA1;">int</span> <span style="color: #A6B6B8;">main</span><span style="color: #d1dadb;">(</span><span style="color: #929EA1;">int</span> <span style="color: #727F80;">argc</span>, <span style="color: #929EA1;">char</span> *<span style="color: #727F80;">argv</span><span style="color: #798787;">[]</span><span style="color: #d1dadb;">)</span> <span style="color: #d1dadb;">{</span>
printf<span style="color: #798787;">(</span><span style="color: #727F80;">"Hello World!\n"</span><span style="color: #798787;">)</span>;
<span style="color: #899597; font-weight: bold;">return</span> <span style="color: #798787;">0</span>;
<span style="color: #d1dadb;">}</span>
</pre>
</div>
<p>
En exécutant à nouveau <code>git status</code>, on peut voir la sortie suivante :
</p>
<div class="org-src-container">
<pre class="src src-text">$ git status
On branch master
No commits yet
Untracked files:
(use "git add &lt;file&gt;..." to include in what will be committed)
main.c
nothing added to commit but untracked files present (use "git add" to track)
</pre>
</div>
<p>
Tu commences à comprendre un peu le bail? Git vient de détecter quun nouveau fichier a été créé quil ne connaissait pas avant. Suivons ses bon conseils et ajoutons le fichier au dépôt.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git add main.c
$ git status
On branch master
No commits yet
Changes to be committed:
(use "git rm --cached &lt;file&gt;..." to unstage)
new file: main.c
</pre>
</div>
<p>
Super, maintenant git va surveiller les changements du fichier, mais attention, il na pas encore enregistré son état. Pour linstant il sait juste que le fichier est là, dans un certain état, mais rien ne garanti encore quon pourra retrouver cet état plus tard. On appelle ça le <i>staging</i>. Pour ce faire, il faut créer ce quon appelle un commit. En gros, il sagit dun enregistrement des modifications apportées à un ou plusieurs fichiers (dans leur globalité ou partiellement, on verra ça plus tard), le tout avec un commentaire.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git commit -m "Un petit pas pour moi, un grand pas pour mon projet"
[master (root-commit) 89139ef] Un petit pas pour moi, un grand pas pour mon projet
1 file changed, 6 insertions(+)
create mode 100644 main.c
</pre>
</div>
<p>
Parfait! Certains éléments peuvent être un peu différent chez toi, comme par exemple la référence du commit juste avant le message. Ça, cest un truc qui est géré automatiquement par git. Et voilà, on a létat de notre répertoire qui est enregistré et qui sera disponible plus tard. Maintenant, tu sais comment enregistrer des état de ton dépôt via les commits.
</p>
</div>
</div>
<div id="outline-container-org41d5117" class="outline-3">
<h3 id="org41d5117"><span class="section-number-3">3.3</span> Cool, mais jai accidentellement mis un fichier en staging</h3>
<div class="outline-text-3" id="text-3-3">
<p>
Si jamais tu as un staging que tu veux annuler, tu peux utiliser la commande <code>git reset HEAD nomdufichier</code> (ou plusieurs noms de fichiers) pour annuler le staging. Une fois le fichier qui nest plus dans ton staging, tu peux même annuler toutes les modifications que tu as apporté au fichier depuis ton dernier commit avec la commande <code>git checkout -- nomdufichier</code>, et tu peux aussi mettre plusieurs noms de fichiers. Par exemple, si jai modifié mon <code>main.c</code> en modifiant ainsi les arguments du <code>main()</code> :
</p>
<div class="org-src-container">
<pre class="src src-C"><span style="color: #929EA1;">#include</span> <span style="color: #d1dadb;">&lt;</span><span style="color: #727F80;">stdio.h</span><span style="color: #d1dadb;">&gt;</span>
<span style="color: #929EA1;">int</span> <span style="color: #A6B6B8;">main</span><span style="color: #d1dadb;">(</span><span style="color: #929EA1;">void</span><span style="color: #d1dadb;">)</span> <span style="color: #d1dadb;">{</span>
printf<span style="color: #798787;">(</span><span style="color: #727F80;">"Hello World!\n"</span><span style="color: #798787;">)</span>;
<span style="color: #899597; font-weight: bold;">return</span> <span style="color: #798787;">0</span>;
<span style="color: #d1dadb;">}</span>
</pre>
</div>
<p>
Je peux annuler tout ça via ces commandes :
</p>
<div class="org-src-container">
<pre class="src src-text">$ git reset HEAD main.c
Unstaged changes after reset:
M main.c
$ git checkout -- main.c
$ git status
On branch master
nothing to commit, working tree clean
</pre>
</div>
<p>
Si je fait un <code>cat</code> du fichier, je vois quil est revenu à son état initial.
</p>
</div>
</div>
<div id="outline-container-org38bcd9c" class="outline-3">
<h3 id="org38bcd9c"><span class="section-number-3">3.4</span> En fait, jai juste oublié un truc dans mon commit précédent</h3>
<div class="outline-text-3" id="text-3-4">
<p>
Si jamais tu veux à la place ajouter la modification dun fichier au dernier commit (mettons, tu as oublié dajouter également un fichier texte), tu peux utiliser loption <code>--amend</code> lors du commit du fichier oublié.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git add main.c # J&#8217;ai refait les modifications annul&#233;es plus t&#244;t
$ git commit -m "second commit"
[master 97f698a] second commit
1 file changed, 1 insertion(+), 1 deletion(-)
$ echo "C&#8217;est un super projet !" &gt; projet.txt
$ git add projet.txt
$ git commit --amend -m "second commit + oubli"
[master 9aff4c0] second commit + oubli
Date: Fri Oct 5 11:10:56 2018 +0200
2 files changed, 2 insertions(+), 1 deletion(-)
create mode 100644 projet.txt
</pre>
</div>
<p>
En gros, le commit que tu viens de faire a remplacé le précédent en conservant les informations du commit précédent, mis à part son commentaire. Si tu ne met pas loption <code>-m "ton texte"</code> lors de lamendement du commit, ton éditeur texte par défaut va souvrir pour que tu puisses modifier le texte du commit précédent si tu le souhaite. Si jamais vi ou vim souvre et que tu nas aucune idée de comment sortir de cet enfant du démon, tu as juste à appuyer sur la touche Échap (au cas où), puis à taper <code>:wq</code> (<code>w</code> pour écrire le fichier, <code>q</code> pour quitter), puis tu appuye sur la touche Entrée. Si tu as Nano qui sest ouvert, alors il faut taper Ctrl-X.
</p>
</div>
</div>
<div id="outline-container-org9a93b6a" class="outline-3">
<h3 id="org9a93b6a"><span class="section-number-3">3.5</span> Euh, jai oublié ce que jai changé lors du dernier commit</h3>
<div class="outline-text-3" id="text-3-5">
<p>
Pas de panique! Tu peux entrer la commande <code>git diff</code> afin de voir ce que tout ce que tu as modifié lors de ton dernier commit. Et si tu ne souhaite voir les modifications que dun certain fichier, tu peux ajouter le nom de ton fichier à la fin de la commande.
</p>
<div class="org-src-container">
<pre class="src src-text">$ echo "C&#8217;est un super projet !" &gt; projet.txt
$ git diff
diff --git a/projet.txt b/projet.txt
index 03b0f20..b93413f 100644
--- a/projet.txt
+++ b/projet.txt
@@ -1 +1 @@
-projet
+C&#8217;est un super projet !
</pre>
</div>
<p>
Tu peux également voir les différences de fichiers entre deux commits en entrant leur référence. Pour avoir la référence, tu peux rentrer la commande <code>git log</code> pour avoir un petit historique des commits.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git log
commit 4380d8717261644b81a1858920406645cf409028 (HEAD -&gt; master)
Author: Phuntsok Drak-pa <a href="mailto:phundrak%40phundrak.fr">&lt;phundrak@phundrak.fr&gt;</a>
Date: Fri Oct 5 11:59:40 2018 +0200
new commit
commit 59c21c6aa7e3ec7edd229f81b87becbc7ec13596
Author: Phuntsok Drak-pa <a href="mailto:phundrak%40phundrak.fr">&lt;phundrak@phundrak.fr&gt;</a>
Date: Fri Oct 5 11:10:56 2018 +0200
nouveau texte
commit 89139ef233d07a64d3025de47f8b6e8ce7470318
Author: Phuntsok Drak-pa <a href="mailto:phundrak%40phundrak.fr">&lt;phundrak@phundrak.fr&gt;</a>
Date: Fri Oct 5 10:56:58 2018 +0200
Un petit pas pour moi, un grand pas pour mon projet
</pre>
</div>
<p>
Bon, cest un peu long et un peu trop dinfos dun coup, généralement je préfère taper <code>git log --oneline --graph --decorate</code> afin davoir un affichage comme suit :
</p>
<div class="org-src-container">
<pre class="src src-text">$ git log --oneline --graph --decorate
* 4380d87 (HEAD -&gt; master) new commit
* 59c21c6 nouveau texte
* 89139ef Un petit pas pour moi, un grand pas pour mon projet
</pre>
</div>
<p>
Plus propre, non? Et les références sont plus courtes, ce qui est plus agréable à taper. Allez, comparons les deux derniers commits.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git add .
$ git commit -m "new commit"
$ git log --oneline --graph --decorate
* 4380d87 (HEAD -&gt; 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&#8217;est un super projet !
</pre>
</div>
</div>
</div>
<div id="outline-container-orga1259b0" class="outline-3">
<h3 id="orga1259b0"><span class="section-number-3">3.6</span> Il y a des fichiers dont je me fiche dans mon dépôt</h3>
<div class="outline-text-3" id="text-3-6">
<p>
Dans ce cas, il est grand temps de te présenter le fichier <code>.gitignore</code>. Comme son nom lindique, il permet au dépôt dignorer des fichiers selon ce que tu lui indiqueras. Par exemple, si tu veux ignorer tous les fichiers qui se terminent en <code>.out</code> (ou <code>.exe</code> sous Windows), tu peux éditer (ou créer) ton <code>.gitignore</code> et entrer ces lignes :
</p>
<div class="org-src-container">
<pre class="src src-text">*.out
*.exe
</pre>
</div>
<p>
Maintenant, si tu créés un fichier en <code>.out</code> ou <code>.exe</code>, il sera complètement ignoré par git et ne sera pas stocké dans lhistorique des versions.
</p>
</div>
</div>
<div id="outline-container-org4aca8c0" class="outline-3">
<h3 id="org4aca8c0"><span class="section-number-3">3.7</span> On est plusieurs dessus en fait…</h3>
<div class="outline-text-3" id="text-3-7">
<p>
Pas de panique ! Git dispose dune fonctionnalité de brachange permettant davoir plusieurs versions coexistantes dun 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 idépendantes que lon pourra fusionner plus tard.
</p>
<p>
Par défaut une brache est créée lors de la création dun dépôt qui sappelle <code>master</code>. Pour créer une nouvelle branche, on peut donc utiliser la commande <code>git checkout -b nomdelanouvellebranche</code>.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git checkout -b nouvelle-branche
Switched to a new branch 'nouvelle-branche'
</pre>
</div>
<p>
À partir dici, toute modification apportée aux fichiers du dépôt naffecteront que la brache courante, <code>nouvelle-branche</code> donc, et les fichiers de la brache <code>master</code> resteront inchangés. Si jamais tu veux retourner pour une quelconque raison sur la branche <code>master</code>, il te suffira dutiliser la commande <code>git checkout master</code>.
</p>
<p>
Si tu souhaites avoir une liste des braches du dépôt, tu peux taper <code>git branch --list</code>. La branche active sera marquée dune étoile à côté de son nom.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git branch --list
master
* nouvelle-branche
</pre>
</div>
<p>
Au bout dun moment, tu vas sans doute vouloir fusionner deux braches, par exemple tu as finis de développer une nouvelle fonctionnalité sur la branche <code>nouvelle-branche</code> et tu souhaites lajouter à la version stable de ton code qui se situe sur <code>master</code>. Dans ce cas, ce que tu peux faire, cest retourner sur ta branche <code>master</code>, puis tu vas effectuer ce quon appelle un <i>merge</i> ; en gros, pour faire simple, tu vas appliquer les modifications de la branche que tu souhaites fusionner avec ta branche <code>master</code> sur cette dernière.
</p>
<div class="org-src-container">
<pre class="src src-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
</pre>
</div>
<p>
Rappelle-toi que la commande <code>merge</code> ramène les commits de la branche spécifiée vers ta branche active, et pas forcément vers le <code>master</code>. Du coup, si tu est sur une brache <code>gisianne</code> et que tu effectues un <code>git merge roger</code>, tu vas rammener tous les commits de <code>roger</code> vers la branche <code>gisianne</code>. Ce peut être intéressant à faire si jamais un bug a été corrigé dans une autre branche ou quune fonctionnalité a été ajoutée et que tu veux en bénéficier dans ta branche active. Noublie juste pas de tout bien commit avant de faire ton <i>merge</i>.
</p>
</div>
</div>
</div>
<div id="outline-container-org3ce705c" class="outline-2">
<h2 id="org3ce705c"><span class="section-number-2">4</span> Jai entendu parler de GitHub…</h2>
<div class="outline-text-2" id="text-4">
<p>
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 <a href="https://www.gnu.org/philosophy/open-source-misses-the-point.fr.html">un article</a> pour taider à comprendre, et <a href="https://www.gnu.org/philosophy/free-software-for-freedom.fr.html">un autre</a> pour la route). Cest en particulier orienté pour les projets gérés par git, ce qui tombe bien car cest ce quon utilise. Cela a pour avantage de pouvoir aisément partager ton code et dassurer quil est bien sauvegardé quelque part dautre que ton disque dur (un <code>rm -rf</code> est si vite arrivé). Et surtout, ça peut te permettre de collaborer avec dautres personnes sur le même projet sans te casser la tête.
</p>
</div>
<div id="outline-container-org1e943ba" class="outline-3">
<h3 id="org1e943ba"><span class="section-number-3">4.1</span> Jai téléchargé un projet en zip</h3>
<div class="outline-text-3" id="text-4-1">
<p>
Ou bien, tu peux télécharger le projet directement via <code>git</code>. Eh oui! git permet de gérer les dépôts dits distants, cest à 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 <code>git clone</code>. Par exemple, si tu veux télécharger de dépôt du petit logiciel de chat en réseau que jai codé durant ma L2 dinformatique, tu peux exécuter ceci :
</p>
<div class="org-src-container">
<pre class="src src-text">$ git clone https://github.com/Phundrak/chat-reseau-P8.git
Cloning into 'chat-reseau-P8'...
remote: Enumerating objects: 345, done.
remote: Total 345 (delta 0), reused 0 (delta 0), pack-reused 345
Receiving objects: 100% (345/345), 63.91 KiB | 39.00 KiB/s, done.
Resolving deltas: 100% (107/107), done.
</pre>
</div>
<p>
Et cest bon, tu as accès au répertoire <code>chat-reseau-P8</code> et au code source du projet.
</p>
</div>
</div>
<div id="outline-container-org12b50dd" class="outline-3">
<h3 id="org12b50dd"><span class="section-number-3">4.2</span> Et si je veux créer mon propre dépôt sur GitHub</h3>
<div class="outline-text-3" id="text-4-2">
<p>
Dans ce cas là, cest simple Brigitte. Il faut que tu te créés un compte sur GitHub, puis tu cliques sur le bouton <code>+</code> et <code>New Repository</code>. Tu lui donnes le nom que tu souhaites (en loccurrence je le nomme <code>temporary-repo</code> car je vais le supprimer cinq minutes après lécriture de ces lignes), et tu cliques sur <code>Create Repository</code>. Tu najoutes rien avant, pas de description, pas de <code>.gitignore</code>, RIEN.
</p>
<p>
Et là, magie ! GitHub indique comment ajouter le dépôt distant à ton dépôt local.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git remote add origin https://github.com/Phundrak/temporary-repo.git
</pre>
</div>
<p>
Et voilà, ton dépôt est lié au dépôt distant. Oui, juste comme ça.
</p>
</div>
</div>
<div id="outline-container-org3780760" class="outline-3">
<h3 id="org3780760"><span class="section-number-3">4.3</span> Et du coup, comment je met tout ça en ligne ?</h3>
<div class="outline-text-3" id="text-4-3">
<p>
Bon ok, ce nest pas aussi simple que ça. Une fois que tu as lié ton dépôt au dépôt distant, il faudra que tu mettes en ligne tes commits quand tu en auras loccasion. Pour ce faire, tu nas quà taper <code>git push</code> ; et la première fois, il faudra que tu indiques à ton dépôt où mettre en ligne précisément dans le dépôt distant, auquel cas tu ajoutes <code>-u origin master</code> pour cette première fois. Git te demandera donc tes identifiants GitHub pour pouvoir mettre tout ça en ligne.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git push -u origin master
Username for 'https://github.com': phundrak
Password for 'https://phundrak@github.com':
Enumerating objects: 10, done.
Counting objects: 100% (10/10), done.
Delta compression using up to 8 threads
Compressing objects: 100% (7/7), done.
Writing objects: 100% (10/10), 940 bytes | 313.00 KiB/s, done.
Total 10 (delta 0), reused 0 (delta 0)
remote:
remote: Create a pull request for 'master' on GitHub by visiting:
remote: https://github.com/Phundrak/temporary-repo/pull/new/master
remote:
To https://github.com/Phundrak/temporary-repo.git
* [new branch] master -&gt; master
Branch 'master' set up to track remote branch 'master' from 'origin'.
</pre>
</div>
<p>
Bon, là en nom dutilisateur ya le mien, faudra remplacer avec le tiens. Et ouais, ma vitesse de mise en ligne nest pas fameuse, je suis sur une connexion 3G+ à lheure 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 laurai supprimé au moment où tu liras ces lignes.
</p>
</div>
</div>
<div id="outline-container-org4e0b939" class="outline-3">
<h3 id="org4e0b939"><span class="section-number-3">4.4</span> Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?</h3>
<div class="outline-text-3" id="text-4-4">
<p>
Pour faire un exemple, je viens de créer un <code>README.md</code> 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 formatté sur la page du dépôt sur GitHub sil est au format <code>.md</code> (Markdown) ou <code>.org</code> (org-mode, le Markdown dEmacs avec lequel est écrit ce tutoriel). Mais il nest pas présent dans mon dépôt local, du coup je vais devoir le récupérer. On va donc entrer <code>git pull</code>.
</p>
<div class="org-src-container">
<pre class="src src-text">$ git pull
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), done.
From https://github.com/Phundrak/temporary-repo
4380d87..8bd4896 master -&gt; origin/master
Updating 4380d87..8bd4896
Fast-forward
README.md | 2 ++
1 file changed, 2 insertions(+)
create mode 100644 README.md
</pre>
</div>
</div>
</div>
<div id="outline-container-orgafeb18d" class="outline-3">
<h3 id="orgafeb18d"><span class="section-number-3">4.5</span> Je suis en train de travailler sur le même fichier que Ginette</h3>
<div class="outline-text-3" id="text-4-5">
<p>
Là, cest un problème qui aurait pu être évité avec lusage des branches dont je tavais parlé plus haut, mais visiblement, vous êtes sur la même branche. Pas bien. Dans ce cas-là, met-toi daccord 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 nes pas à jour. Dans ce cas ne panique pas, si tu nas pas fait tes commits, lance la commande <code>git stash</code> ; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications.
</p>
</div>
</div>
<div id="outline-container-org1936e87" class="outline-3">
<h3 id="org1936e87"><span class="section-number-3">4.6</span> GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !</h3>
<div class="outline-text-3" id="text-4-6">
<p>
Du calme Jean-Célestin. Cela veut tout simplement dire que tu nas tout simplement pas les droits décriture sur son dépôt. Du coup, soit tu peux lui demander directement à ce quelle 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.
</p>
</div>
</div>
<div id="outline-container-orgd44543c" class="outline-3">
<h3 id="orgd44543c"><span class="section-number-3">4.7</span> Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?</h3>
<div class="outline-text-3" id="text-4-7">
<p>
Ouhlà Billy, il va falloir remettre les choses au clair. Là il sagit de quelque chose de spécifique à GitHub quà Git (doù le fait quon en discute dans ce chapitre que le précédent).
</p>
<p>
Sur GitHub, il est possible de copier vers ton profil le dépôt de quelquun dautre dans létat où il est au moment du fork. Cela inclus les fichiers du <code>master</code>, 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 tengueuler car tu es en train de polluer sa base de code.
</p>
<p>
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 sil y en a) via ce quon appelle une pull-request. Cela signifie donc que tu demandes lautorisation dajouter 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 quil a été refusé.
</p>
</div>
</div>
<div id="outline-container-org4a2bb3f" class="outline-3">
<h3 id="org4a2bb3f"><span class="section-number-3">4.8</span> Jai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même</h3>
<div class="outline-text-3" id="text-4-8">
<p>
Eh bien dans ce cas-là, ouvre une <i>issue</i> Bernadette ; <i>issue</i> qui en français veut dire <i>problème</i>. Il sagit dun système de GitHub te permettant de signaler quelque chose aux propriétaires du dépôt, il peut sagir dun bug, dune demande de fonctionnalité ou de proposition de modification dautres fonctionnalités. Cela peut donner lieu à des discussions menant à la compréhension du bug, ou à une amélioration de ta proposition.
</p>
<p>
Si tu soumets un bug, avant douvrir une nouvelle <i>issue</i>, 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 dune 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 dinformation et tout ce que tu sais sur ce bug, en particulier les étapes et conditions pour le reproduire.
</p>
</div>
</div>
</div>
<div id="outline-container-orgf953051" class="outline-2">
<h2 id="orgf953051"><span class="section-number-2">5</span> Les raccourcis et paramètres de Git</h2>
<div class="outline-text-2" id="text-5">
<p>
Comme jen 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 email dans notre <code>~/.gitconfig</code>. 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 mal de mes alias.
</p>
<div class="org-src-container">
<pre class="src src-text">[core]
editor = vim
whitespace = fix,-indent-with-non-tab,trailing-space
[web]
browser = chromium
[color]
ui = auto
[alias]
a = add --all
c = commit
cm = commit -m
cam = commit -am
co = checkout
cob = checkout -b
cl = clone
l = log --oneline --graph --decorate
ps = push
pl = pull
re = reset
s = status
staged = diff --cached
st = stash
sc = stash clear
sp = stash pop
sw = stash show
</pre>
</div>
<dl class="org-dl">
<dt><code>a</code></dt><dd>Permet dajouter dun coup tout nouveau fichier dun dépôt en préparation au commit. On peut faire la même chose avec <code>git add .</code> si on est à la racine du dépôt.</dd>
<dt><code>c</code></dt><dd>Un raccourci pour <code>commit</code>, ça permet déviter quelques frappes de clavier décrire <code>git c</code> plutôt que <code>git commit</code></dd>
<dt><code>cm</code></dt><dd>De même pour <code>cm</code> qui évite de devoir écrire <code>commit -m</code>. On na plus quà écrire directement le message de commit après <code>cm</code>.</dd>
<dt><code>cam</code></dt><dd>Non, ce nest pas un plan, cest le même alias que <code>cm</code> mais qui en plus met automatiquement tous les fichiers modifiés ou supprimés, donc sil ny a pas de nouveau fichier à ajouter, même pas besoin de passer par un <code>git a</code> avant le <code>git cam "jaime les pâtes"</code>.</dd>
<dt><code>co</code></dt><dd>Pour aller plus vite quand on veut écrire <code>checkout</code>.</dd>
<dt><code>cob</code></dt><dd>Et pour en plus rajouter le flag <code>-b</code> pour la création dune nouvelle branche.</dd>
<dt><code>cl</code></dt><dd>Pour quand tu voudras télécharger ce tutoriel en tapant <code>git cl https://github.com/Phundrak/tutoriel-git.git</code> plutôt que <code>git clone https://github.com/Phundrak/tutoriel-git.git</code>.</dd>
<dt><code>l</code></dt><dd>Te permet davoir le log un peu plus sympa et compact dont javais parlé plus haut.</dd>
<dt><code>ps</code></dt><dd>Pour faire un push plus rapidement.</dd>
<dt><code>pl</code></dt><dd>Et pour télécharger les derniers commits sur le dépôt plus rapidement.</dd>
<dt><code>re</code></dt><dd>Pour réinitialiser plus rapidement.</dd>
<dt><code>s</code></dt><dd>Pour rapidement savoir où tu en es dans ton dépôt, savoir ce qui a été modifié, ajouté, supprimé, déplacé, tout ça&#x2026;</dd>
<dt><code>staged</code></dt><dd>Eh oui, Git na pas de fonction dédiée pour lister les fichiers en staging, du coup la voilà.</dd>
<dt><code>st</code></dt><dd>Pour sauvegarder tes modifications sur le stash plus rapidement.</dd>
<dt><code>sc</code></dt><dd>Pour supprimer ton stash plus rapidement.</dd>
<dt><code>sp</code></dt><dd>Pour rétablir le stash sur la branche courante plus rapidement.</dd>
<dt><code>sw</code></dt><dd>Pour rapidement savoir ce quil y a sur le stash.</dd>
</dl>
</div>
</div>
<div id="outline-container-orgc1ca16e" class="outline-2">
<h2 id="orgc1ca16e"><span class="section-number-2">6</span> Et cest tout ?</h2>
<div class="outline-text-2" id="text-6">
<p>
Cest déjà pas mal ! Mais non, ce nest certainement pas tout. Cependant, ce tutoriel na pour but de tapprendre que les bases de Git et de GitHub, pas de tout tapprendre ! Si tu souhaites aller plus loin, connaitre plus de commandes (comme <code>git blame</code> ou <code>git reset</code>), ou bien connaître plus doptions, je ne peux que tinviter à aller te documenter par toi-même sur le site de Git qui se trouve <a href="https://git-scm.com/">ici</a>, ou bien à consulter des pages de manuel dans ton terminal via <code>man git</code>, <code>man git-apply</code> ou <code>man-cherry-pick</code> (oui, il faut lier <code>git</code> et le nom de la commande par un tiret dunion).
</p>
<p>
Si jamais tu as une question, nhésite pas à menvoyer un mail à <a href="mailto://phundrak@phundrak.fr">phundrak@phundrak.fr</a>. Si jamais tu trouves une erreur dans ce que je viens de dire dans ce tutoriel, ou si tu as une suggestion, cest justement le moment de mettre en pratique ce que tu as lu un peu plus haut et douvrir une <i>issue</i> sur GitHub sur <a href="https://github.com/Phundrak/tutoriel-git">le dépôt de ce tutoriel</a>.
</p>
</div>
</div>
</div>
<div id="postamble" class="status">
<p class="author">Auteur: Lucien Cartier-Tilet</p>
<p class="date">Created: 2019-01-21 lun. 20:21</p>
<p class="validation"></p>
</div>
</body>
</html>

View File

@ -3,7 +3,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"> <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head> <head>
<!-- 2019-01-21 lun. 20:21 --> <!-- 2019-03-04 lun. 15:24 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Tutoriel Git et GitHub</title> <title>Tutoriel Git et GitHub</title>
@ -161,6 +161,19 @@
.footdef { margin-bottom: 1em; } .footdef { margin-bottom: 1em; }
.figure { padding: 1em; } .figure { padding: 1em; }
.figure p { text-align: center; } .figure p { text-align: center; }
.equation-container {
display: table;
text-align: center;
width: 100%;
}
.equation {
vertical-align: middle;
}
.equation-label {
display: table-cell;
text-align: right;
vertical-align: middle;
}
.inlinetask { .inlinetask {
padding: 10px; padding: 10px;
border: 2px solid gray; border: 2px solid gray;
@ -191,7 +204,7 @@
@licstart The following is the entire license notice for the @licstart The following is the entire license notice for the
JavaScript code in this tag. JavaScript code in this tag.
Copyright (C) 2012-2018 Free Software Foundation, Inc. Copyright (C) 2012-2019 Free Software Foundation, Inc.
The JavaScript code in this tag is free software: you can The JavaScript code in this tag is free software: you can
redistribute it and/or modify it under the terms of the GNU redistribute it and/or modify it under the terms of the GNU
@ -243,54 +256,63 @@ for the JavaScript code in this tag.
<h2>Table des matières</h2> <h2>Table des matières</h2>
<div id="text-table-of-contents"> <div id="text-table-of-contents">
<ul> <ul>
<li><a href="#orgd5dc8f7">1. Git ? Quest-ce donc ?</a></li> <li><a href="#org87cac80">1. Avant-propos</a></li>
<li><a href="#org9702fca">2. Ça a lair cool, comment ça sobtient?</a> <li><a href="#orge120ef2">2. Git ? Quest-ce donc ?</a></li>
<li><a href="#orgede3b11">3. Ça a lair cool, comment ça sobtient?</a>
<ul> <ul>
<li><a href="#org333d2ea">2.1. Et surtout, comment ça sinstalle ?</a></li> <li><a href="#org13ddd7b">3.1. Et surtout, comment ça sinstalle ?</a></li>
<li><a href="#orgf5f99ae">2.2. Ok cest bon, et il y a une configuration à faire ?</a></li> <li><a href="#orgafb9fd1">3.2. Ok cest bon, et il y a une configuration à faire ?</a></li>
</ul> </ul>
</li> </li>
<li><a href="#orgd81deb9">3. Ok très bien, comment on lutilise maintenant?</a> <li><a href="#orga1b1230">4. Ok très bien, comment on lutilise maintenant?</a>
<ul> <ul>
<li><a href="#org45af36f">3.1. Je commence comment?</a></li> <li><a href="#org9716307">4.1. Je commence comment?</a></li>
<li><a href="#org10dda73">3.2. Et pour ajouter des fichiers?</a></li> <li><a href="#org9516ccc">4.2. Et pour ajouter des fichiers?</a></li>
<li><a href="#org41d5117">3.3. Cool, mais jai accidentellement mis un fichier en staging</a></li> <li><a href="#org331618e">4.3. Cool, mais jai accidentellement mis un fichier en staging</a></li>
<li><a href="#org38bcd9c">3.4. En fait, jai juste oublié un truc dans mon commit précédent</a></li> <li><a href="#org7939e24">4.4. En fait, jai juste oublié un truc dans mon commit précédent</a></li>
<li><a href="#org9a93b6a">3.5. Euh, jai oublié ce que jai changé lors du dernier commit</a></li> <li><a href="#org9a4f30e">4.5. Euh, jai oublié ce que jai changé lors du dernier commit</a></li>
<li><a href="#orga1259b0">3.6. Il y a des fichiers dont je me fiche dans mon dépôt</a></li> <li><a href="#org82ae757">4.6. Il y a des fichiers dont je me fiche dans mon dépôt</a></li>
<li><a href="#org4aca8c0">3.7. On est plusieurs dessus en fait…</a></li> <li><a href="#orgcf77752">4.7. On est plusieurs dessus en fait…</a></li>
</ul> </ul>
</li> </li>
<li><a href="#org3ce705c">4. Jai entendu parler de GitHub…</a> <li><a href="#orgd6e3ca9">5. Jai entendu parler de GitHub…</a>
<ul> <ul>
<li><a href="#org1e943ba">4.1. Jai téléchargé un projet en zip</a></li> <li><a href="#org567803c">5.1. Jai téléchargé un projet en zip</a></li>
<li><a href="#org12b50dd">4.2. Et si je veux créer mon propre dépôt sur GitHub</a></li> <li><a href="#org364f435">5.2. Et si je veux créer mon propre dépôt sur GitHub</a></li>
<li><a href="#org3780760">4.3. Et du coup, comment je met tout ça en ligne ?</a></li> <li><a href="#orgc386736">5.3. Et du coup, comment je met tout ça en ligne ?</a></li>
<li><a href="#org4e0b939">4.4. Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?</a></li> <li><a href="#orgb488b58">5.4. Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?</a></li>
<li><a href="#orgafeb18d">4.5. Je suis en train de travailler sur le même fichier que Ginette</a></li> <li><a href="#orgb017de4">5.5. Je suis en train de travailler sur le même fichier que Ginette</a></li>
<li><a href="#org1936e87">4.6. GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !</a></li> <li><a href="#orgf4d641b">5.6. GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !</a></li>
<li><a href="#orgd44543c">4.7. Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?</a></li> <li><a href="#org60979ea">5.7. Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?</a></li>
<li><a href="#org4a2bb3f">4.8. Jai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même</a></li> <li><a href="#org30468eb">5.8. Jai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même</a></li>
</ul> </ul>
</li> </li>
<li><a href="#orgf953051">5. Les raccourcis et paramètres de Git</a></li> <li><a href="#org41de57a">6. Les raccourcis et paramètres de Git</a></li>
<li><a href="#orgc1ca16e">6. Et cest tout ?</a></li> <li><a href="#org23fb4ba">7. Et cest tout ?</a></li>
</ul> </ul>
</div> </div>
</div> </div>
<p> <p>
</p> </p>
<div class="org-src-container">
<pre class="src src-org">Tout d&#8217;abord, si tu veux la version PDF du bouzin, <span style="color: #899597; text-decoration: underline;"><a href="https://phundrak.fr/git/tutoriel-git.pdf">c&#8217;est par l&#224;</a></span>.
Et pour le code source de cette page, c&#8217;est <span style="color: #899597; text-decoration: underline;"><a href="https://github.com/Phundrak/tutoriel-git">l&#224;</a></span>, sur GitHub. <div id="outline-container-org87cac80" class="outline-2">
</pre> <h2 id="org87cac80"><span class="section-number-2">1</span> Avant-propos</h2>
</div>
<div id="outline-container-orgd5dc8f7" class="outline-2">
<h2 id="orgd5dc8f7"><span class="section-number-2">1</span> Git ? Quest-ce donc ?</h2>
<div class="outline-text-2" id="text-1"> <div class="outline-text-2" id="text-1">
<p> <p>
Car oui, jai quand même un fond sérieux, même si le reste du tuto ne maide pas à confirmer ces dires. Tout dabord, si tu veux la version PDF du bouzin, cest par là : <a href="https://phundrak.fr/git/tutoriel-git.pdf">https://phundrak.fr/git/tutoriel-git.pdf</a>. Et si tu lis déjà le PDF, la version web est par là : <a href="https://phundrak.fr/git">https://phundrak.fr/git</a>. Et pour le code source de cette page, cest sur GitHub (<a href="https://github.com/Phundrak/tutoriel-git">https://github.com/Phundrak/tutoriel-git</a>) et mon Gitlab perso (<a href="https://labs.phundrak.fr/phundrak/tutoriel-git">https://labs.phundrak.fr/phundrak/tutoriel-git</a>).
</p>
<p>
Bon, cétait court. Prêt pour le tuto? Cest parti!
</p>
</div>
</div>
<div id="outline-container-orge120ef2" class="outline-2">
<h2 id="orge120ef2"><span class="section-number-2">2</span> Git ? Quest-ce donc ?</h2>
<div class="outline-text-2" id="text-2">
<p>
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 quils naient 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 lajout de modifications dune de ces versions parallèles à une autre via des fusions partielles ou totales de branches, avec une automatisation des fusions de fichiers lorsquil ny a pas de conflit entre ces derniers. 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 quils naient 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 lajout de modifications dune de ces versions parallèles à une autre via des fusions partielles ou totales de branches, avec une automatisation des fusions de fichiers lorsquil ny a pas de conflit entre ces derniers.
</p> </p>
@ -303,13 +325,13 @@ Toujours là? Tu auras été prévenu·e.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org9702fca" class="outline-2"> <div id="outline-container-orgede3b11" class="outline-2">
<h2 id="org9702fca"><span class="section-number-2">2</span> Ça a lair cool, comment ça sobtient?</h2> <h2 id="orgede3b11"><span class="section-number-2">3</span> Ça a lair cool, comment ça sobtient?</h2>
<div class="outline-text-2" id="text-2"> <div class="outline-text-2" id="text-3">
</div> </div>
<div id="outline-container-org333d2ea" class="outline-3"> <div id="outline-container-org13ddd7b" class="outline-3">
<h3 id="org333d2ea"><span class="section-number-3">2.1</span> Et surtout, comment ça sinstalle ?</h3> <h3 id="org13ddd7b"><span class="section-number-3">3.1</span> Et surtout, comment ça sinstalle ?</h3>
<div class="outline-text-3" id="text-2-1"> <div class="outline-text-3" id="text-3-1">
<p> <p>
Très bonne question Kévin. Tout dabord, il faut tassurer que git soit installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux, tu peux linstaller via ton gestionnaire de paquet, ce qui rendra la commande accessible directement depuis le terminal. Très bonne question Kévin. Tout dabord, il faut tassurer que git soit installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux, tu peux linstaller via ton gestionnaire de paquet, ce qui rendra la commande accessible directement depuis le terminal.
</p> </p>
@ -345,9 +367,9 @@ Si tu es sous Windows&#x2026; Bonne chance. Toutes les commandes seront en synta
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-orgf5f99ae" class="outline-3"> <div id="outline-container-orgafb9fd1" class="outline-3">
<h3 id="orgf5f99ae"><span class="section-number-3">2.2</span> Ok cest bon, et il y a une configuration à faire ?</h3> <h3 id="orgafb9fd1"><span class="section-number-3">3.2</span> Ok cest bon, et il y a une configuration à faire ?</h3>
<div class="outline-text-3" id="text-2-2"> <div class="outline-text-3" id="text-3-2">
<p> <p>
Tu peux configurer Git si tu le souhaites, oui. En général, il est recommandé de paramétrer au moins son nom et son email. Tu peux les paramétrer via la ligne de commande : Tu peux configurer Git si tu le souhaites, oui. En général, il est recommandé de paramétrer au moins son nom et son email. Tu peux les paramétrer via la ligne de commande :
</p> </p>
@ -375,9 +397,9 @@ Il y a encore pas mal de paramètres que tu peux gérer avec ce fichier, je repa
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgd81deb9" class="outline-2"> <div id="outline-container-orga1b1230" class="outline-2">
<h2 id="orgd81deb9"><span class="section-number-2">3</span> Ok très bien, comment on lutilise maintenant?</h2> <h2 id="orga1b1230"><span class="section-number-2">4</span> Ok très bien, comment on lutilise maintenant?</h2>
<div class="outline-text-2" id="text-3"> <div class="outline-text-2" id="text-4">
<p> <p>
Du calme Jean-Kévin, ralentis un peu. Comme le dit ce vieux dicton Chinois : Du calme Jean-Kévin, ralentis un peu. Comme le dit ce vieux dicton Chinois :
</p> </p>
@ -390,9 +412,9 @@ Celui qui marche trop vite…… marche…………… trop… vite…? Tu peux
Bon, cest une contrefaçon, donc la qualité de la citation nest pas extraordinaire. Bref. Bon, cest une contrefaçon, donc la qualité de la citation nest pas extraordinaire. Bref.
</p> </p>
</div> </div>
<div id="outline-container-org45af36f" class="outline-3"> <div id="outline-container-org9716307" class="outline-3">
<h3 id="org45af36f"><span class="section-number-3">3.1</span> Je commence comment?</h3> <h3 id="org9716307"><span class="section-number-3">4.1</span> Je commence comment?</h3>
<div class="outline-text-3" id="text-3-1"> <div class="outline-text-3" id="text-4-1">
<p> <p>
Si tu souhaites créer un dépôt git, rien de plus simple : créé ton répertoire dans lequel tu travailleras, et déplace-y-toi. Ensuite, tu pourra initialiser ton dépôt via la commande <code>git init</code>. Si tu souhaites créer un dépôt git, rien de plus simple : créé ton répertoire dans lequel tu travailleras, et déplace-y-toi. Ensuite, tu pourra initialiser ton dépôt via la commande <code>git init</code>.
</p> </p>
@ -420,18 +442,18 @@ Parfait!
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org10dda73" class="outline-3"> <div id="outline-container-org9516ccc" class="outline-3">
<h3 id="org10dda73"><span class="section-number-3">3.2</span> Et pour ajouter des fichiers?</h3> <h3 id="org9516ccc"><span class="section-number-3">4.2</span> Et pour ajouter des fichiers?</h3>
<div class="outline-text-3" id="text-3-2"> <div class="outline-text-3" id="text-4-2">
<p> <p>
Maintenant tu peux commencer à travailler sur ton projet. Mais tout dabord, on va voir ce quil se passe si jamais on créé un fichier dans le dépôt. Créé un fichier <code>main.c</code> dans lequel tu vas entrer ce code : Maintenant tu peux commencer à travailler sur ton projet. Mais tout dabord, on va voir ce quil se passe si jamais on créé un fichier dans le dépôt. Créé un fichier <code>main.c</code> dans lequel tu vas entrer ce code :
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-C"><span style="color: #929EA1;">#include</span> <span style="color: #d1dadb;">&lt;</span><span style="color: #727F80;">stdio.h</span><span style="color: #d1dadb;">&gt;</span> <pre class="src src-C"><span style="color: #9BAEAC;">#include</span> <span style="color: #d0dbda;">&lt;</span><span style="color: #6E8F98;">stdio.h</span><span style="color: #d0dbda;">&gt;</span>
<span style="color: #929EA1;">int</span> <span style="color: #A6B6B8;">main</span><span style="color: #d1dadb;">(</span><span style="color: #929EA1;">int</span> <span style="color: #727F80;">argc</span>, <span style="color: #929EA1;">char</span> *<span style="color: #727F80;">argv</span><span style="color: #798787;">[]</span><span style="color: #d1dadb;">)</span> <span style="color: #d1dadb;">{</span> <span style="color: #9BAEAC;">int</span> <span style="color: #9FC1C2;">main</span><span style="color: #d0dbda;">(</span><span style="color: #9BAEAC;">int</span> <span style="color: #6E8F98;">argc</span>, <span style="color: #9BAEAC;">char</span> *<span style="color: #6E8F98;">argv</span><span style="color: #69959F;">[]</span><span style="color: #d0dbda;">)</span> <span style="color: #d0dbda;">{</span>
printf<span style="color: #798787;">(</span><span style="color: #727F80;">"Hello World!\n"</span><span style="color: #798787;">)</span>; printf<span style="color: #69959F;">(</span><span style="color: #6E8F98;">"Hello World!\n"</span><span style="color: #69959F;">)</span>;
<span style="color: #899597; font-weight: bold;">return</span> <span style="color: #798787;">0</span>; <span style="color: #91ADAF; font-weight: bold;">return</span> <span style="color: #69959F;">0</span>;
<span style="color: #d1dadb;">}</span> <span style="color: #d0dbda;">}</span>
</pre> </pre>
</div> </div>
<p> <p>
@ -482,18 +504,18 @@ Parfait! Certains éléments peuvent être un peu différent chez toi, comme
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org41d5117" class="outline-3"> <div id="outline-container-org331618e" class="outline-3">
<h3 id="org41d5117"><span class="section-number-3">3.3</span> Cool, mais jai accidentellement mis un fichier en staging</h3> <h3 id="org331618e"><span class="section-number-3">4.3</span> Cool, mais jai accidentellement mis un fichier en staging</h3>
<div class="outline-text-3" id="text-3-3"> <div class="outline-text-3" id="text-4-3">
<p> <p>
Si jamais tu as un staging que tu veux annuler, tu peux utiliser la commande <code>git reset HEAD nomdufichier</code> (ou plusieurs noms de fichiers) pour annuler le staging. Une fois le fichier qui nest plus dans ton staging, tu peux même annuler toutes les modifications que tu as apporté au fichier depuis ton dernier commit avec la commande <code>git checkout -- nomdufichier</code>, et tu peux aussi mettre plusieurs noms de fichiers. Par exemple, si jai modifié mon <code>main.c</code> en modifiant ainsi les arguments du <code>main()</code> : Si jamais tu as un staging que tu veux annuler, tu peux utiliser la commande <code>git reset HEAD nomdufichier</code> (ou plusieurs noms de fichiers) pour annuler le staging. Une fois le fichier qui nest plus dans ton staging, tu peux même annuler toutes les modifications que tu as apporté au fichier depuis ton dernier commit avec la commande <code>git checkout -- nomdufichier</code>, et tu peux aussi mettre plusieurs noms de fichiers. Par exemple, si jai modifié mon <code>main.c</code> en modifiant ainsi les arguments du <code>main()</code> :
</p> </p>
<div class="org-src-container"> <div class="org-src-container">
<pre class="src src-C"><span style="color: #929EA1;">#include</span> <span style="color: #d1dadb;">&lt;</span><span style="color: #727F80;">stdio.h</span><span style="color: #d1dadb;">&gt;</span> <pre class="src src-C"><span style="color: #9BAEAC;">#include</span> <span style="color: #d0dbda;">&lt;</span><span style="color: #6E8F98;">stdio.h</span><span style="color: #d0dbda;">&gt;</span>
<span style="color: #929EA1;">int</span> <span style="color: #A6B6B8;">main</span><span style="color: #d1dadb;">(</span><span style="color: #929EA1;">void</span><span style="color: #d1dadb;">)</span> <span style="color: #d1dadb;">{</span> <span style="color: #9BAEAC;">int</span> <span style="color: #9FC1C2;">main</span><span style="color: #d0dbda;">(</span><span style="color: #9BAEAC;">void</span><span style="color: #d0dbda;">)</span> <span style="color: #d0dbda;">{</span>
printf<span style="color: #798787;">(</span><span style="color: #727F80;">"Hello World!\n"</span><span style="color: #798787;">)</span>; printf<span style="color: #69959F;">(</span><span style="color: #6E8F98;">"Hello World!\n"</span><span style="color: #69959F;">)</span>;
<span style="color: #899597; font-weight: bold;">return</span> <span style="color: #798787;">0</span>; <span style="color: #91ADAF; font-weight: bold;">return</span> <span style="color: #69959F;">0</span>;
<span style="color: #d1dadb;">}</span> <span style="color: #d0dbda;">}</span>
</pre> </pre>
</div> </div>
<p> <p>
@ -514,9 +536,9 @@ Si je fait un <code>cat</code> du fichier, je vois quil est revenu à son ét
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org38bcd9c" class="outline-3"> <div id="outline-container-org7939e24" class="outline-3">
<h3 id="org38bcd9c"><span class="section-number-3">3.4</span> En fait, jai juste oublié un truc dans mon commit précédent</h3> <h3 id="org7939e24"><span class="section-number-3">4.4</span> En fait, jai juste oublié un truc dans mon commit précédent</h3>
<div class="outline-text-3" id="text-3-4"> <div class="outline-text-3" id="text-4-4">
<p> <p>
Si jamais tu veux à la place ajouter la modification dun fichier au dernier commit (mettons, tu as oublié dajouter également un fichier texte), tu peux utiliser loption <code>--amend</code> lors du commit du fichier oublié. Si jamais tu veux à la place ajouter la modification dun fichier au dernier commit (mettons, tu as oublié dajouter également un fichier texte), tu peux utiliser loption <code>--amend</code> lors du commit du fichier oublié.
</p> </p>
@ -539,9 +561,9 @@ En gros, le commit que tu viens de faire a remplacé le précédent en conservan
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org9a93b6a" class="outline-3"> <div id="outline-container-org9a4f30e" class="outline-3">
<h3 id="org9a93b6a"><span class="section-number-3">3.5</span> Euh, jai oublié ce que jai changé lors du dernier commit</h3> <h3 id="org9a4f30e"><span class="section-number-3">4.5</span> Euh, jai oublié ce que jai changé lors du dernier commit</h3>
<div class="outline-text-3" id="text-3-5"> <div class="outline-text-3" id="text-4-5">
<p> <p>
Pas de panique! Tu peux entrer la commande <code>git diff</code> afin de voir ce que tout ce que tu as modifié lors de ton dernier commit. Et si tu ne souhaite voir les modifications que dun certain fichier, tu peux ajouter le nom de ton fichier à la fin de la commande. Pas de panique! Tu peux entrer la commande <code>git diff</code> afin de voir ce que tout ce que tu as modifié lors de ton dernier commit. Et si tu ne souhaite voir les modifications que dun certain fichier, tu peux ajouter le nom de ton fichier à la fin de la commande.
</p> </p>
@ -613,9 +635,9 @@ index 03b0f20..b93413f 100644
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orga1259b0" class="outline-3"> <div id="outline-container-org82ae757" class="outline-3">
<h3 id="orga1259b0"><span class="section-number-3">3.6</span> Il y a des fichiers dont je me fiche dans mon dépôt</h3> <h3 id="org82ae757"><span class="section-number-3">4.6</span> Il y a des fichiers dont je me fiche dans mon dépôt</h3>
<div class="outline-text-3" id="text-3-6"> <div class="outline-text-3" id="text-4-6">
<p> <p>
Dans ce cas, il est grand temps de te présenter le fichier <code>.gitignore</code>. Comme son nom lindique, il permet au dépôt dignorer des fichiers selon ce que tu lui indiqueras. Par exemple, si tu veux ignorer tous les fichiers qui se terminent en <code>.out</code> (ou <code>.exe</code> sous Windows), tu peux éditer (ou créer) ton <code>.gitignore</code> et entrer ces lignes : Dans ce cas, il est grand temps de te présenter le fichier <code>.gitignore</code>. Comme son nom lindique, il permet au dépôt dignorer des fichiers selon ce que tu lui indiqueras. Par exemple, si tu veux ignorer tous les fichiers qui se terminent en <code>.out</code> (ou <code>.exe</code> sous Windows), tu peux éditer (ou créer) ton <code>.gitignore</code> et entrer ces lignes :
</p> </p>
@ -629,9 +651,9 @@ Maintenant, si tu créés un fichier en <code>.out</code> ou <code>.exe</code>,
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org4aca8c0" class="outline-3"> <div id="outline-container-orgcf77752" class="outline-3">
<h3 id="org4aca8c0"><span class="section-number-3">3.7</span> On est plusieurs dessus en fait…</h3> <h3 id="orgcf77752"><span class="section-number-3">4.7</span> On est plusieurs dessus en fait…</h3>
<div class="outline-text-3" id="text-3-7"> <div class="outline-text-3" id="text-4-7">
<p> <p>
Pas de panique ! Git dispose dune fonctionnalité de brachange permettant davoir plusieurs versions coexistantes dun 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 idépendantes que lon pourra fusionner plus tard. Pas de panique ! Git dispose dune fonctionnalité de brachange permettant davoir plusieurs versions coexistantes dun 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 idépendantes que lon pourra fusionner plus tard.
</p> </p>
@ -677,16 +699,16 @@ Rappelle-toi que la commande <code>merge</code> ramène les commits de la branch
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-org3ce705c" class="outline-2"> <div id="outline-container-orgd6e3ca9" class="outline-2">
<h2 id="org3ce705c"><span class="section-number-2">4</span> Jai entendu parler de GitHub…</h2> <h2 id="orgd6e3ca9"><span class="section-number-2">5</span> Jai entendu parler de GitHub…</h2>
<div class="outline-text-2" id="text-4"> <div class="outline-text-2" id="text-5">
<p> <p>
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 <a href="https://www.gnu.org/philosophy/open-source-misses-the-point.fr.html">un article</a> pour taider à comprendre, et <a href="https://www.gnu.org/philosophy/free-software-for-freedom.fr.html">un autre</a> pour la route). Cest en particulier orienté pour les projets gérés par git, ce qui tombe bien car cest ce quon utilise. Cela a pour avantage de pouvoir aisément partager ton code et dassurer quil est bien sauvegardé quelque part dautre que ton disque dur (un <code>rm -rf</code> est si vite arrivé). Et surtout, ça peut te permettre de collaborer avec dautres personnes sur le même projet sans te casser la tête. 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 <a href="https://www.gnu.org/philosophy/open-source-misses-the-point.fr.html">un article</a> pour taider à comprendre, et <a href="https://www.gnu.org/philosophy/free-software-for-freedom.fr.html">un autre</a> pour la route). Cest en particulier orienté pour les projets gérés par git, ce qui tombe bien car cest ce quon utilise. Cela a pour avantage de pouvoir aisément partager ton code et dassurer quil est bien sauvegardé quelque part dautre que ton disque dur (un <code>rm -rf</code> est si vite arrivé). Et surtout, ça peut te permettre de collaborer avec dautres personnes sur le même projet sans te casser la tête.
</p> </p>
</div> </div>
<div id="outline-container-org1e943ba" class="outline-3"> <div id="outline-container-org567803c" class="outline-3">
<h3 id="org1e943ba"><span class="section-number-3">4.1</span> Jai téléchargé un projet en zip</h3> <h3 id="org567803c"><span class="section-number-3">5.1</span> Jai téléchargé un projet en zip</h3>
<div class="outline-text-3" id="text-4-1"> <div class="outline-text-3" id="text-5-1">
<p> <p>
Ou bien, tu peux télécharger le projet directement via <code>git</code>. Eh oui! git permet de gérer les dépôts dits distants, cest à 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 <code>git clone</code>. Par exemple, si tu veux télécharger de dépôt du petit logiciel de chat en réseau que jai codé durant ma L2 dinformatique, tu peux exécuter ceci : Ou bien, tu peux télécharger le projet directement via <code>git</code>. Eh oui! git permet de gérer les dépôts dits distants, cest à 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 <code>git clone</code>. Par exemple, si tu veux télécharger de dépôt du petit logiciel de chat en réseau que jai codé durant ma L2 dinformatique, tu peux exécuter ceci :
</p> </p>
@ -704,9 +726,9 @@ Et cest bon, tu as accès au répertoire <code>chat-reseau-P8</code> et au co
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org12b50dd" class="outline-3"> <div id="outline-container-org364f435" class="outline-3">
<h3 id="org12b50dd"><span class="section-number-3">4.2</span> Et si je veux créer mon propre dépôt sur GitHub</h3> <h3 id="org364f435"><span class="section-number-3">5.2</span> Et si je veux créer mon propre dépôt sur GitHub</h3>
<div class="outline-text-3" id="text-4-2"> <div class="outline-text-3" id="text-5-2">
<p> <p>
Dans ce cas là, cest simple Brigitte. Il faut que tu te créés un compte sur GitHub, puis tu cliques sur le bouton <code>+</code> et <code>New Repository</code>. Tu lui donnes le nom que tu souhaites (en loccurrence je le nomme <code>temporary-repo</code> car je vais le supprimer cinq minutes après lécriture de ces lignes), et tu cliques sur <code>Create Repository</code>. Tu najoutes rien avant, pas de description, pas de <code>.gitignore</code>, RIEN. Dans ce cas là, cest simple Brigitte. Il faut que tu te créés un compte sur GitHub, puis tu cliques sur le bouton <code>+</code> et <code>New Repository</code>. Tu lui donnes le nom que tu souhaites (en loccurrence je le nomme <code>temporary-repo</code> car je vais le supprimer cinq minutes après lécriture de ces lignes), et tu cliques sur <code>Create Repository</code>. Tu najoutes rien avant, pas de description, pas de <code>.gitignore</code>, RIEN.
</p> </p>
@ -723,9 +745,9 @@ Et voilà, ton dépôt est lié au dépôt distant. Oui, juste comme ça.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org3780760" class="outline-3"> <div id="outline-container-orgc386736" class="outline-3">
<h3 id="org3780760"><span class="section-number-3">4.3</span> Et du coup, comment je met tout ça en ligne ?</h3> <h3 id="orgc386736"><span class="section-number-3">5.3</span> Et du coup, comment je met tout ça en ligne ?</h3>
<div class="outline-text-3" id="text-4-3"> <div class="outline-text-3" id="text-5-3">
<p> <p>
Bon ok, ce nest pas aussi simple que ça. Une fois que tu as lié ton dépôt au dépôt distant, il faudra que tu mettes en ligne tes commits quand tu en auras loccasion. Pour ce faire, tu nas quà taper <code>git push</code> ; et la première fois, il faudra que tu indiques à ton dépôt où mettre en ligne précisément dans le dépôt distant, auquel cas tu ajoutes <code>-u origin master</code> pour cette première fois. Git te demandera donc tes identifiants GitHub pour pouvoir mettre tout ça en ligne. Bon ok, ce nest pas aussi simple que ça. Une fois que tu as lié ton dépôt au dépôt distant, il faudra que tu mettes en ligne tes commits quand tu en auras loccasion. Pour ce faire, tu nas quà taper <code>git push</code> ; et la première fois, il faudra que tu indiques à ton dépôt où mettre en ligne précisément dans le dépôt distant, auquel cas tu ajoutes <code>-u origin master</code> pour cette première fois. Git te demandera donc tes identifiants GitHub pour pouvoir mettre tout ça en ligne.
</p> </p>
@ -753,9 +775,9 @@ Bon, là en nom dutilisateur ya le mien, faudra remplacer avec le tiens. E
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org4e0b939" class="outline-3"> <div id="outline-container-orgb488b58" class="outline-3">
<h3 id="org4e0b939"><span class="section-number-3">4.4</span> Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?</h3> <h3 id="orgb488b58"><span class="section-number-3">5.4</span> Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?</h3>
<div class="outline-text-3" id="text-4-4"> <div class="outline-text-3" id="text-5-4">
<p> <p>
Pour faire un exemple, je viens de créer un <code>README.md</code> 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 formatté sur la page du dépôt sur GitHub sil est au format <code>.md</code> (Markdown) ou <code>.org</code> (org-mode, le Markdown dEmacs avec lequel est écrit ce tutoriel). Mais il nest pas présent dans mon dépôt local, du coup je vais devoir le récupérer. On va donc entrer <code>git pull</code>. Pour faire un exemple, je viens de créer un <code>README.md</code> 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 formatté sur la page du dépôt sur GitHub sil est au format <code>.md</code> (Markdown) ou <code>.org</code> (org-mode, le Markdown dEmacs avec lequel est écrit ce tutoriel). Mais il nest pas présent dans mon dépôt local, du coup je vais devoir le récupérer. On va donc entrer <code>git pull</code>.
</p> </p>
@ -777,25 +799,25 @@ Fast-forward
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgafeb18d" class="outline-3"> <div id="outline-container-orgb017de4" class="outline-3">
<h3 id="orgafeb18d"><span class="section-number-3">4.5</span> Je suis en train de travailler sur le même fichier que Ginette</h3> <h3 id="orgb017de4"><span class="section-number-3">5.5</span> Je suis en train de travailler sur le même fichier que Ginette</h3>
<div class="outline-text-3" id="text-4-5"> <div class="outline-text-3" id="text-5-5">
<p> <p>
Là, cest un problème qui aurait pu être évité avec lusage des branches dont je tavais parlé plus haut, mais visiblement, vous êtes sur la même branche. Pas bien. Dans ce cas-là, met-toi daccord 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 nes pas à jour. Dans ce cas ne panique pas, si tu nas pas fait tes commits, lance la commande <code>git stash</code> ; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications. Là, cest un problème qui aurait pu être évité avec lusage des branches dont je tavais parlé plus haut, mais visiblement, vous êtes sur la même branche. Pas bien. Dans ce cas-là, met-toi daccord 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 nes pas à jour. Dans ce cas ne panique pas, si tu nas pas fait tes commits, lance la commande <code>git stash</code> ; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications. Va sur <i>ta</i> branche sur laquelle Ginette nest pas en train de travailler, voire créé-en une nouvelle avec <code>git checkout -b tanouvellebranche</code>, et exécute <code>git stash pop</code> pour rétablir tes modifications sur cette branche.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org1936e87" class="outline-3"> <div id="outline-container-orgf4d641b" class="outline-3">
<h3 id="org1936e87"><span class="section-number-3">4.6</span> GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !</h3> <h3 id="orgf4d641b"><span class="section-number-3">5.6</span> GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !</h3>
<div class="outline-text-3" id="text-4-6"> <div class="outline-text-3" id="text-5-6">
<p> <p>
Du calme Jean-Célestin. Cela veut tout simplement dire que tu nas tout simplement pas les droits décriture sur son dépôt. Du coup, soit tu peux lui demander directement à ce quelle 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. Du calme Jean-Célestin. Cela veut tout simplement dire que tu nas tout simplement pas les droits décriture sur son dépôt. Du coup, soit tu peux lui demander directement à ce quelle 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.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-orgd44543c" class="outline-3"> <div id="outline-container-org60979ea" class="outline-3">
<h3 id="orgd44543c"><span class="section-number-3">4.7</span> Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?</h3> <h3 id="org60979ea"><span class="section-number-3">5.7</span> Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?</h3>
<div class="outline-text-3" id="text-4-7"> <div class="outline-text-3" id="text-5-7">
<p> <p>
Ouhlà Billy, il va falloir remettre les choses au clair. Là il sagit de quelque chose de spécifique à GitHub quà Git (doù le fait quon en discute dans ce chapitre que le précédent). Ouhlà Billy, il va falloir remettre les choses au clair. Là il sagit de quelque chose de spécifique à GitHub quà Git (doù le fait quon en discute dans ce chapitre que le précédent).
</p> </p>
@ -809,9 +831,9 @@ Si jamais il y a une modification dont tu es particulièrement fier, tu peux la
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org4a2bb3f" class="outline-3"> <div id="outline-container-org30468eb" class="outline-3">
<h3 id="org4a2bb3f"><span class="section-number-3">4.8</span> Jai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même</h3> <h3 id="org30468eb"><span class="section-number-3">5.8</span> Jai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même</h3>
<div class="outline-text-3" id="text-4-8"> <div class="outline-text-3" id="text-5-8">
<p> <p>
Eh bien dans ce cas-là, ouvre une <i>issue</i> Bernadette ; <i>issue</i> qui en français veut dire <i>problème</i>. Il sagit dun système de GitHub te permettant de signaler quelque chose aux propriétaires du dépôt, il peut sagir dun bug, dune demande de fonctionnalité ou de proposition de modification dautres fonctionnalités. Cela peut donner lieu à des discussions menant à la compréhension du bug, ou à une amélioration de ta proposition. Eh bien dans ce cas-là, ouvre une <i>issue</i> Bernadette ; <i>issue</i> qui en français veut dire <i>problème</i>. Il sagit dun système de GitHub te permettant de signaler quelque chose aux propriétaires du dépôt, il peut sagir dun bug, dune demande de fonctionnalité ou de proposition de modification dautres fonctionnalités. Cela peut donner lieu à des discussions menant à la compréhension du bug, ou à une amélioration de ta proposition.
</p> </p>
@ -822,9 +844,9 @@ Si tu soumets un bug, avant douvrir une nouvelle <i>issue</i>, assure-toi de
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgf953051" class="outline-2"> <div id="outline-container-org41de57a" class="outline-2">
<h2 id="orgf953051"><span class="section-number-2">5</span> Les raccourcis et paramètres de Git</h2> <h2 id="org41de57a"><span class="section-number-2">6</span> Les raccourcis et paramètres de Git</h2>
<div class="outline-text-2" id="text-5"> <div class="outline-text-2" id="text-6">
<p> <p>
Comme jen 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 email dans notre <code>~/.gitconfig</code>. 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 mal de mes alias. Comme jen 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 email dans notre <code>~/.gitconfig</code>. 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 mal de mes alias.
</p> </p>
@ -877,9 +899,9 @@ Comme jen avais parlé plus haut, il est possible de configurer git de façon
</dl> </dl>
</div> </div>
</div> </div>
<div id="outline-container-orgc1ca16e" class="outline-2"> <div id="outline-container-org23fb4ba" class="outline-2">
<h2 id="orgc1ca16e"><span class="section-number-2">6</span> Et cest tout ?</h2> <h2 id="org23fb4ba"><span class="section-number-2">7</span> Et cest tout ?</h2>
<div class="outline-text-2" id="text-6"> <div class="outline-text-2" id="text-7">
<p> <p>
Cest déjà pas mal ! Mais non, ce nest certainement pas tout. Cependant, ce tutoriel na pour but de tapprendre que les bases de Git et de GitHub, pas de tout tapprendre ! Si tu souhaites aller plus loin, connaitre plus de commandes (comme <code>git blame</code> ou <code>git reset</code>), ou bien connaître plus doptions, je ne peux que tinviter à aller te documenter par toi-même sur le site de Git qui se trouve <a href="https://git-scm.com/">ici</a>, ou bien à consulter des pages de manuel dans ton terminal via <code>man git</code>, <code>man git-apply</code> ou <code>man-cherry-pick</code> (oui, il faut lier <code>git</code> et le nom de la commande par un tiret dunion). Cest déjà pas mal ! Mais non, ce nest certainement pas tout. Cependant, ce tutoriel na pour but de tapprendre que les bases de Git et de GitHub, pas de tout tapprendre ! Si tu souhaites aller plus loin, connaitre plus de commandes (comme <code>git blame</code> ou <code>git reset</code>), ou bien connaître plus doptions, je ne peux que tinviter à aller te documenter par toi-même sur le site de Git qui se trouve <a href="https://git-scm.com/">ici</a>, ou bien à consulter des pages de manuel dans ton terminal via <code>man git</code>, <code>man git-apply</code> ou <code>man-cherry-pick</code> (oui, il faut lier <code>git</code> et le nom de la commande par un tiret dunion).
</p> </p>
@ -892,7 +914,7 @@ Si jamais tu as une question, nhésite pas à menvoyer un mail à <a href=
</div> </div>
<div id="postamble" class="status"> <div id="postamble" class="status">
<p class="author">Auteur: Lucien Cartier-Tilet</p> <p class="author">Auteur: Lucien Cartier-Tilet</p>
<p class="date">Created: 2019-01-21 lun. 20:21</p> <p class="date">Created: 2019-03-04 lun. 15:24</p>
<p class="validation"></p> <p class="validation"></p>
</div> </div>
</body> </body>

View File

@ -1,11 +1,12 @@
#+INCLUDE: "headers.org" #+INCLUDE: "headers.org"
#+MACRO: if-latex-else (eval (if (org-export-derived-backend-p org-export-current-backend 'latex) "$1" "$2"))
#+TITLE: Tutoriel Git et GitHub #+TITLE: Tutoriel Git et GitHub
#+begin_src org :exports (when (eq org-export-current-backend 'xelatex) "none") * Avant-propos
Tout dabord, si tu veux la version PDF du bouzin, [[https://phundrak.fr/git/tutoriel-git.pdf][cest par là]]. Car oui, jai quand même un fond sérieux, même si le reste du tuto ne maide pas à confirmer ces dires. Tout dabord, si tu veux la version PDF du bouzin, cest par là : [[https://phundrak.fr/git/tutoriel-git.pdf]]. Et si tu lis déjà le PDF, la version web est par là : [[https://phundrak.fr/git]]. Et pour le code source de cette page, cest sur GitHub (https://github.com/Phundrak/tutoriel-git) et mon Gitlab perso ([[https://labs.phundrak.fr/phundrak/tutoriel-git]]).
Bon, cétait court. Prêt pour le tuto? Cest parti!
Et pour le code source de cette page, cest [[https://github.com/Phundrak/tutoriel-git][]], sur GitHub.
#+end_src
* Git ? Quest-ce donc ? * Git ? Quest-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 quils naient 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 lajout de modifications dune de ces versions parallèles à une autre via des fusions partielles ou totales de branches, avec une automatisation des fusions de fichiers lorsquil ny a pas de conflit entre ces derniers. 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 quils naient 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 lajout de modifications dune de ces versions parallèles à une autre via des fusions partielles ou totales de branches, avec une automatisation des fusions de fichiers lorsquil ny a pas de conflit entre ces derniers.
@ -313,7 +314,7 @@ Pour faire un exemple, je viens de créer un =README.md= sur GitHub directement.
create mode 100644 README.md create mode 100644 README.md
#+END_SRC #+END_SRC
** 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à, cest un problème qui aurait pu être évité avec lusage des branches dont je tavais parlé plus haut, mais visiblement, vous êtes sur la même branche. Pas bien. Dans ce cas-là, met-toi daccord 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 nes pas à jour. Dans ce cas ne panique pas, si tu nas pas fait tes commits, lance la commande =git stash= ; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications. Là, cest un problème qui aurait pu être évité avec lusage des branches dont je tavais parlé plus haut, mais visiblement, vous êtes sur la même branche. Pas bien. Dans ce cas-là, met-toi daccord 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 nes pas à jour. Dans ce cas ne panique pas, si tu nas pas fait tes commits, lance la commande =git stash= ; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications. Va sur /ta/ branche sur laquelle Ginette nest pas en train de travailler, voire créé-en une nouvelle avec ~git checkout -b tanouvellebranche~, et exécute ~git stash pop~ pour rétablir tes modifications sur cette branche.
** 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 nas tout simplement pas les droits décriture sur son dépôt. Du coup, soit tu peux lui demander directement à ce quelle 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. Du calme Jean-Célestin. Cela veut tout simplement dire que tu nas tout simplement pas les droits décriture sur son dépôt. Du coup, soit tu peux lui demander directement à ce quelle 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 ?

Binary file not shown.