diff --git a/tutoriel-git.html b/tutoriel-git.html index af0697c..80e0d34 100644 --- a/tutoriel-git.html +++ b/tutoriel-git.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
- +Git est un logiciel de version de fichiers permettant de garder une trace de toutes les modifications apportées au fichiers suivis dans un répertoire (un dépôt) et ses sous-répertoires –sous couvert qu’ils n’aient pas été ignorés explicitement. Il permet également de conserver plusieurs versions parallèles du projet, comme par exemple une version stable et une version de développement, et permet l’ajout de modifications d’une de ces versions parallèles à une autre via des fusions partielles ou totales de branches, avec une automatisation des fusions de fichiers lorsqu’il n’y a pas de conflit entre ces derniers. @@ -296,15 +297,15 @@ Toujours là ? Tu auras été prévenu·e.
-Très bonne question Kevin. Tout d’abord, il faut t’assurer que git soit installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux, tu peux l’installer via ton gestionnaire de paquet, ce qui rendra la commande accessible directement depuis le terminal. +Très bonne question Kévin. Tout d’abord, il faut t’assurer que git soit installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux, tu peux l’installer via ton gestionnaire de paquet, ce qui rendra la commande accessible directement depuis le terminal.
$ apt install git # Debian, Ubuntu et les distros basées dessus @@ -328,8 +329,8 @@ Si tu es sous Windows… Bonne chance. Toutes les commandes seront en synta
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 : @@ -358,8 +359,8 @@ Il y a encore pas mal de paramètres que tu peux gérer avec ce fichier, je repa
Du calme Jean-Kévin, ralentis un peu. Comme le dit ce vieux dicton Chinois : @@ -373,8 +374,8 @@ Celui qui marche trop vite…… marche…………… trop… vite…? Tu peux Bon, c’est une contrefaçon, donc la qualité de la citation n’est pas extraordinaire. Bref.
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
.
@@ -387,7 +388,7 @@ Initialized empty Git repository in /tmp/monsuperprojet/.git/
-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 l’occurence, j’ai 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
+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 l’occurrence, j’ai 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
$ git status @@ -403,11 +404,11 @@ Parfait !
-Maintenant tu peux commencer à travailler sur ton projet. Mais tout d’abord, on va voir ce qu’il se passe si jamais on créé un fichier dans le dépot. Créé un fichier main.c
dans lequel tu vas entrer ce code :
+Maintenant tu peux commencer à travailler sur ton projet. Mais tout d’abord, on va voir ce qu’il 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 :
#include <stdio.h> @@ -452,7 +453,7 @@ Changes to be committed:
-Super, maintenant git va surveiller les changements du fichier, mais attention, il n’a pas encore enregistré son état. Pour l’instant il sait juste que le fichier est là, dans un certain état, mais rien ne garanti encore qu’on pourra retrouver cet état plus tard. On appelle ça le staging. Pour ce faire, il faut créer ce qu’on appelle un commit. En gros, il s’agit d’un enregistrement des modifications apportées à un ou plusieurs fichers (dans leur globalité ou partiellement, on verra ça plus tard), le tout avec un commentaire. +Super, maintenant git va surveiller les changements du fichier, mais attention, il n’a pas encore enregistré son état. Pour l’instant il sait juste que le fichier est là, dans un certain état, mais rien ne garanti encore qu’on pourra retrouver cet état plus tard. On appelle ça le staging. Pour ce faire, il faut créer ce qu’on appelle un commit. En gros, il s’agit d’un enregistrement des modifications apportées à un ou plusieurs fichiers (dans leur globalité ou partiellement, on verra ça plus tard), le tout avec un commentaire.
$ git commit -m "Un petit pas pour moi, un grand pas pour mon projet" @@ -466,8 +467,8 @@ Parfait ! Certains éléments peuvent être un peu différent chez toi, comme
Si jamais tu as un staging que tu veux annuler, tu peux utiliser la commande git reset HEAD nomdetonfichier voiredautresfichiers
pour annuler le staging. Une fois le fichier qui n’est 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 -- tonfichier voiredautresfichiers
. Par exemple, si j’ai modifié mon main.c
en modifiant ainsi les arguments du main()
:
@@ -499,8 +500,8 @@ Si je fait un cat
du fichier, je vois qu’il est revenu à son ét
Si jamais tu veux à la place ajouter la modification d’un fichier au dernier commit (mettons, tu as oublié d’ajouter également un fichier texte), tu peux utiliser l’option --amend
lors du commit du fichier oublié.
@@ -524,10 +525,9 @@ En gros, le commit que tu viens de faire a remplacé le précédent en conservan
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 d’un certain fichier, tu peux ajouter le nom de ton fichier à la fin de la commande.
Dans ce cas, il est grand temps de te présenter le fichier .gitignore
. Comme son nom l’indique, il permet au dépôt d’ignorer des fichiers selon ce que tu lui indiqueras. Par exemple, si tu veux ignorer tous les fichiers qui se terminent en .out
(ou .exe
sous Windows), tu peux éditer (ou créer) ton .gitignore
et entrer ces lignes :
.out
ou .exe
,
Tu commences à me plaire Enzo ! GitHub est un site web sur lequel tu peux héberger des projets libres ou open-source (si tu ne connais pas la différence, voici un article pour t’aider à comprendre, et un autre pour la route). C’est en particulier orienté pour les projets gérés par git, ce qui tombe bien car c’est ce qu’on utilise. Cela a pour avantage de pouvoir aisément partager ton code et d’assurer qu’il est bien sauvegardé quelque part d’autre que ton disque dur (un rm -rf
est si vite arrivé). Et surtout, ça peut te permettre de collaborer avec d’autres personnes sur le même projet sans te casser la tête.
Ou bien, tu peux télécharger le projet directement via git
. Eh oui ! git permet de gérer les dépôts dits distants, c’est à dire ceux qui sont hébergés sur un serveur en ligne, comme par exemple sur GitHub. Pour cela, il te faut te munir du lien vers le dépôt git, et le passer en argument de git clone
. Par exemple, si tu veux télécharger de dépôt du petit logiciel de chat en réseau que j’ai codé durant ma L2 d’informatique, tu peux exécuter ceci :
chat-reseau-P8
et au co
-Dans ce cas là, c’est 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 l’occurence 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 n’ajoutes rien avant, pas de description, pas de .gitignore
, RIEN.
+Dans ce cas là, c’est 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 l’occurrence 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 n’ajoutes rien avant, pas de description, pas de .gitignore
, RIEN.
@@ -665,12 +662,11 @@ Et voilà, ton dépôt est lié au dépôt distant. Oui, juste comme ça.
-Bon ok, ce n’est 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 l’occasion. Pour ce faire, tu n’as qu’à taper git push
; et la première fois, il faudra que tu indiques à ton dépôt où mettre en ligen 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.
+Bon ok, ce n’est 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 l’occasion. Pour ce faire, tu n’as 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.
$ git push -u origin master @@ -696,12 +692,11 @@ Bon, là en nom d’utilisateur y’a le mien, faudra remplacer avec le tiens. E
-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 apparaitra formatté sur la page du dépôt sur GitHub s’il est au format .md
(Markdown) ou .org
(org-mode, le Markdown d’Emacs avec lequel est écrit ce tutoriel). Mais il n’est pas présent dans mon dépôt local, du coup je vais devoir le récupérer. On va donc entrer git pull
.
+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 s’il est au format .md
(Markdown) ou .org
(org-mode, le Markdown d’Emacs avec lequel est écrit ce tutoriel). Mais il n’est pas présent dans mon dépôt local, du coup je vais devoir le récupérer. On va donc entrer git pull
.
$ git pull @@ -721,11 +716,19 @@ Fast-forward
+Là, c’est un problème qui aurait pu être évité avec l’usage des branches dont je t’avais parlé plus haut, mais visiblement, vous êtes sur la même branche. Pas bien. Dans ce cas-là, met-toi d’accord avec Ginette pour savoir qui fait ses push en premier. Si le choix tombe sur Ginette, ou si elle a imposé sa vision des choses et a fait son push avant toi, GitHub va râler car tu n’es pas à jour. Dans ce cas ne panique pas, si tu n’as pas fait tes commits, lance la commande git stash
; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications
+
Created: 2018-10-05 ven. 14:48
+Created: 2018-10-05 ven. 15:29