diff --git a/tutoriel-git.html b/tutoriel-git.html index 5b0ef86..b8e3c86 100644 --- a/tutoriel-git.html +++ b/tutoriel-git.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + Tutoriel Git et GitHub @@ -243,38 +243,38 @@ for the JavaScript code in this tag.

Table des matières

@@ -282,13 +282,14 @@ for the JavaScript code in this tag.

-
Tout d’abord, si tu veux la version PDF du bouzin, c’est par là.
+
 :exports (when (eq org-export-current-backend 'xelatex) "none")
+Tout d’abord, si tu veux la version PDF du bouzin, c’est par là.
 
-Et pour le code source de cette page, c’est là, sur GitHub.
+Et pour le code source de cette page, c’est là, sur GitHub.
-
-

1 Git ? Qu’est-ce donc ?

+
+

1 Git ? Qu’est-ce donc ?

Git est un logiciel de version de fichiers permettant de garder une trace de toutes les modifications apportées au fichiers suivis dans un répertoire (un dépôt) et ses sous-répertoires –sous couvert qu’ils n’aient pas été ignorés explicitement. Il permet également de conserver plusieurs versions parallèles du projet, comme par exemple une version stable et une version de développement, et permet l’ajout de modifications d’une de ces versions parallèles à une autre via des fusions partielles ou totales de branches, avec une automatisation des fusions de fichiers lorsqu’il n’y a pas de conflit entre ces derniers. @@ -303,12 +304,12 @@ Toujours là ? Tu auras été prévenu·e.

-
-

2 Ça a l’air cool, comment ça s’obtient ?

+
+

2 Ça a l’air cool, comment ça s’obtient ?

-
-

2.1 Et surtout, comment ça s’installe ?

+
+

2.1 Et surtout, comment ça s’installe ?

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. @@ -322,11 +323,13 @@ $ emerge --ask --verbose dec-vcs/git # Gentoo

- -
-

install_gentoo.jpg -

-

Figure 1 : >install gentoo

+
+

+ install_gentoo.jpg +

+

+ Figure 1 : >install gentoo +

@@ -343,8 +346,8 @@ Si tu es sous Windows… Bonne chance. Toutes les commandes seront en synta

-
-

2.2 Ok c’est bon, et il y a une configuration à faire ?

+
+

2.2 Ok c’est 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 : @@ -373,8 +376,8 @@ Il y a encore pas mal de paramètres que tu peux gérer avec ce fichier, je repa

-
-

3 Ok très bien, comment on l’utilise maintenant ?

+
+

3 Ok très bien, comment on l’utilise maintenant ?

Du calme Jean-Kévin, ralentis un peu. Comme le dit ce vieux dicton Chinois : @@ -388,8 +391,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.

-
-

3.1 Je commence comment ?

+
+

3.1 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. @@ -397,7 +400,7 @@ Si tu souhaites créer un dépôt git, rien de plus simple : créé ton répert 

$ mkdir monsuperprojet
 $ cd monsuperprojet
-$ git init .
+$ git init
 Initialized empty Git repository in /tmp/monsuperprojet/.git/
@@ -418,18 +421,18 @@ Parfait !

-
-

3.2 Et pour ajouter des fichiers ?

+
+

3.2 Et pour ajouter des fichiers ?

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>
-int main(int argc, char *argv[]) {
-  printf("Hello World!\n");
-  return 0;
-}
+
#include <stdio.h>
+int main(int argc, char *argv[]) {
+  printf("Hello World!\n");
+  return 0;
+}

@@ -480,18 +483,18 @@ Parfait ! Certains éléments peuvent être un peu différent chez toi, comme

-
-

3.3 Cool, mais j’ai accidentellement mis un fichier en staging

+
+

3.3 Cool, mais j’ai accidentellement mis un fichier en staging

-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() : +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 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 -- nomdufichier, et tu peux aussi mettre plusieurs noms de fichiers. Par exemple, si j’ai modifié mon main.c en modifiant ainsi les arguments du main() :

-
#include <stdio.h>
-int main(void) {
-  printf("Hello World!\n");
-  return 0;
-}
+
#include <stdio.h>
+int main(void) {
+  printf("Hello World!\n");
+  return 0;
+}

@@ -512,8 +515,8 @@ Si je fait un cat du fichier, je vois qu’il est revenu à son ét

-
-

3.4 En fait, j’ai juste oublié un truc dans mon commit précédent

+
+

3.4 En fait, j’ai juste oublié un truc dans mon commit précédent

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é. @@ -537,8 +540,8 @@ En gros, le commit que tu viens de faire a remplacé le précédent en conservan

-
-

3.5 Euh, j’ai oublié ce que j’ai changé lors du dernier commit

+
+

3.5 Euh, j’ai oublié ce que j’ai 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 d’un certain fichier, tu peux ajouter le nom de ton fichier à la fin de la commande. @@ -611,8 +614,8 @@ index 03b0f20..b93413f 100644

-
-

3.6 Il y a des fichiers dont je me fiche dans mon dépôt

+
+

3.6 Il y a des fichiers dont je me fiche dans mon dépôt

Dans ce cas, il est grand temps de te présenter le fichier .gitignore. Comme son nom l’indique, il permet au dépôt d’ignorer des fichiers selon ce que tu lui indiqueras. Par exemple, si tu veux ignorer tous les fichiers qui se terminent en .out (ou .exe sous Windows), tu peux éditer (ou créer) ton .gitignore et entrer ces lignes : @@ -627,8 +630,8 @@ Maintenant, si tu créés un fichier en .out ou .exe,

-
-

3.7 On est plusieurs dessus en fait…

+
+

3.7 On est plusieurs dessus en fait…

Pas de panique ! Git dispose d’une fonctionnalité de brachange permettant d’avoir plusieurs versions coexistantes d’un même fichier. Cela peut être très utile pour avoir soit plusieurs personnes travaillant sur un même projet, soit pour une même personne travaillant sur plusieurs fonctionnalités différentes, soit les deux. Ainsi, on a plusieurs version idépendantes que l’on pourra fusionner plus tard. @@ -675,15 +678,15 @@ Rappelle-toi que la commande merge ramène les commits de la branch

-
-

4 J’ai entendu parler de GitHub…

+
+

4 J’ai entendu parler de GitHub…

Tu commences à me plaire Enzo ! GitHub est un site web sur lequel tu peux héberger des projets libres ou open-source (si tu ne connais pas la différence, voici un article pour t’aider à comprendre, et un autre pour la route). C’est en particulier orienté pour les projets gérés par git, ce qui tombe bien car c’est ce qu’on utilise. Cela a pour avantage de pouvoir aisément partager ton code et d’assurer qu’il est bien sauvegardé quelque part d’autre que ton disque dur (un rm -rf est si vite arrivé). Et surtout, ça peut te permettre de collaborer avec d’autres personnes sur le même projet sans te casser la tête.

-
-

4.1 J’ai téléchargé un projet en zip

+
+

4.1 J’ai téléchargé un projet en zip

Ou bien, tu peux télécharger le projet directement via git. Eh oui ! git permet de gérer les dépôts dits distants, c’est à dire ceux qui sont hébergés sur un serveur en ligne, comme par exemple sur GitHub. Pour cela, il te faut te munir du lien vers le dépôt git, et le passer en argument de git clone. Par exemple, si tu veux télécharger de dépôt du petit logiciel de chat en réseau que j’ai codé durant ma L2 d’informatique, tu peux exécuter ceci : @@ -702,8 +705,8 @@ Et c’est bon, tu as accès au répertoire chat-reseau-P8 et au co

-
-

4.2 Et si je veux créer mon propre dépôt sur GitHub

+
+

4.2 Et si je veux créer mon propre dépôt sur GitHub

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. @@ -721,8 +724,8 @@ Et voilà, ton dépôt est lié au dépôt distant. Oui, juste comme ça.

-
-

4.3 Et du coup, comment je met tout ça en ligne ?

+
+

4.3 Et du coup, comment je met 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. @@ -751,8 +754,8 @@ Bon, là en nom d’utilisateur y’a le mien, faudra remplacer avec le tiens. E

-
-

4.4 Quelqu’un a fait des modifications depuis mon dernier commit, je récupère ça comment ?

+
+

4.4 Quelqu’un a fait des modifications depuis mon dernier commit, je récupère ça comment ?

Pour faire un exemple, je viens de créer un README.md sur GitHub directement. Ce type de fichiers est assez standard afin de présenter plus ou moins en détails le dépôt et le projet qui y est lié, et son contenu apparaîtra 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. @@ -775,24 +778,24 @@ Fast-forward

-
-

4.5 Je suis en train de travailler sur le même fichier que Ginette

+
+

4.5 Je suis en train de travailler sur le même fichier que Ginette

Là, c’est un problème qui aurait pu être évité avec l’usage des branches dont je t’avais parlé plus haut, mais visiblement, vous êtes sur la même branche. Pas bien. Dans ce cas-là, met-toi d’accord avec Ginette pour savoir qui fait ses push en premier. Si le choix tombe sur Ginette, ou si elle a imposé sa vision des choses et a fait son push avant toi, GitHub va râler car tu n’es pas à jour. Dans ce cas ne panique pas, si tu n’as pas fait tes commits, lance la commande git stash ; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications.

-
-

4.6 GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !

+
+

4.6 GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !

Du calme Jean-Célestin. Cela veut tout simplement dire que tu n’as tout simplement pas les droits d’écriture sur son dépôt. Du coup, soit tu peux lui demander directement à ce qu’elle te donne les droits d’écriture si elle a confiance en toi, soit tu peux créer un fork puis une pull-request sur GitHub depuis ton fork où tu auras fait tes modifications.

-
-

4.7 Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?

+
+

4.7 Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?

Ouhlà Billy, il va falloir remettre les choses au clair. Là il s’agit de quelque chose de spécifique à GitHub qu’à Git (d’où le fait qu’on en discute dans ce chapitre que le précédent). @@ -807,8 +810,8 @@ Si jamais il y a une modification dont tu es particulièrement fier, tu peux la

-
-

4.8 J’ai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même

+
+

4.8 J’ai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même

Eh bien dans ce cas-là, ouvre une issue Bernadette ; issue qui en français veut dire problème. Il s’agit d’un système de GitHub te permettant de signaler quelque chose aux propriétaires du dépôt, il peut s’agir d’un bug, d’une demande de fonctionnalité ou de proposition de modification d’autres fonctionnalités. Cela peut donner lieu à des discussions menant à la compréhension du bug, ou à une amélioration de ta proposition. @@ -820,8 +823,8 @@ Si tu soumets un bug, avant d’ouvrir une nouvelle issue, assure-toi de

-
-

5 Les raccourcis et paramètres de Git

+
+

5 Les raccourcis et paramètres de Git

Comme j’en avais parlé plus haut, il est possible de configurer git de façon un peu plus poussée que simplement déclarer notre nom et notre adresse 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. @@ -875,8 +878,8 @@ Comme j’en avais parlé plus haut, il est possible de configurer git de façon

-
-

6 Et c’est tout ?

+
+

6 Et c’est tout ?

C’est déjà pas mal ! Mais non, ce n’est certainement pas tout. Cependant, ce tutoriel n’a pour but de t’apprendre que les bases de Git et de GitHub, pas de tout t’apprendre ! Si tu souhaites aller plus loin, connaitre plus de commandes (comme git blame ou git reset), ou bien connaître plus d’options, je ne peux que t’inviter à aller te documenter par toi-même sur le site de Git qui se trouve 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 d’union). @@ -890,7 +893,7 @@ Si jamais tu as une question, n’hésite pas à m’envoyer un mail à

diff --git a/tutoriel-git.org b/tutoriel-git.org index 59e31b7..e0ada28 100644 --- a/tutoriel-git.org +++ b/tutoriel-git.org @@ -1,7 +1,8 @@ #+INCLUDE: "headers.org" #+TITLE: Tutoriel Git et GitHub -#+begin_src org :exports (when (eq org-export-current-backend 'xelatex) "none") +#+begin_src org + :exports (when (eq org-export-current-backend 'xelatex) "none") Tout d’abord, si tu veux la version PDF du bouzin, [[https://phundrak.fr/git/tutoriel-git.pdf][c’est par là]]. Et pour le code source de cette page, c’est [[https://github.com/Phundrak/tutoriel-git][là]], sur GitHub. @@ -23,10 +24,16 @@ Très bonne question Kévin. Tout d’abord, il faut t’assurer que git soit in $ emerge --ask --verbose dec-vcs/git # Gentoo #+END_SRC -#+CAPTION: >install gentoo -#+NAME: >install gentoo -#+ATTR_HTML: :style display: block; margin: auto; -[[./install_gentoo.jpg]] +#+BEGIN_EXPORT html +
+

+ install_gentoo.jpg +

+

+ Figure 1 : >install gentoo +

+
+#+END_EXPORT Si tu n’es 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 @@ -61,7 +68,7 @@ Si tu souhaites créer un dépôt git, rien de plus simple : créé ton répert #+BEGIN_SRC text $ mkdir monsuperprojet $ cd monsuperprojet - $ git init . + $ 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 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= @@ -119,7 +126,7 @@ Super, maintenant git va surveiller les changements du fichier, mais attention, #+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, c’est 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 j’ai accidentellement mis un fichier en staging -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()= : +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 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 -- nomdufichier=, et tu peux aussi mettre plusieurs noms de fichiers. Par exemple, si j’ai modifié mon =main.c= en modifiant ainsi les arguments du =main()= : #+BEGIN_SRC C #include int main(void) { diff --git a/tutoriel-git.pdf b/tutoriel-git.pdf index 1ae0f79..30515dd 100644 Binary files a/tutoriel-git.pdf and b/tutoriel-git.pdf differ