phundrak/tutoriel-git
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

First version of the tutorial: DONE

Browse Source
This commit is contained in:
Phuntsok Drak-pa 2018-10-05 21:27:56 +02:00
parent e8f28eefe4
commit b29b80428e
4 changed files with 326 additions and 74 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
install_gentoo.jpg Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 15 KiB

303
tutoriel-git.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>
<!-- 2018-10-05 ven. 17:29 --> <!-- 2018-10-05 ven. 21:27 -->
<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>
@ -243,33 +243,38 @@ 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="#org167823d">1. Git ? Qu’est-ce donc ?</a></li> <li><a href="#org1bf79aa">1. Git ? Qu’est-ce donc ?</a></li>
<li><a href="#org1ef4a45">2. Ça a l’air cool, comment ça s’obtient ?</a> <li><a href="#org079df00">2. Ça a l’air cool, comment ça s’obtient ?</a>
<ul> <ul>
<li><a href="#org6275a66">2.1. Et surtout, comment ça s’installe ?</a></li> <li><a href="#org9b88d16">2.1. Et surtout, comment ça s’installe ?</a></li>
<li><a href="#org1835c4a">2.2. Ok c’est bon, et il y a une configuration à faire ?</a></li> <li><a href="#orgbf73df9">2.2. Ok c’est bon, et il y a une configuration à faire ?</a></li>
</ul> </ul>
</li> </li>
<li><a href="#org6661951">3. Ok très bien, comment on l’utilise maintenant ?</a> <li><a href="#org03ee882">3. Ok très bien, comment on l’utilise maintenant ?</a>
<ul> <ul>
<li><a href="#orgbf9afb0">3.1. Je commence comment ?</a></li> <li><a href="#org742f1c1">3.1. Je commence comment ?</a></li>
<li><a href="#orga10309e">3.2. Et pour ajouter des fichiers ?</a></li> <li><a href="#org8c1a312">3.2. Et pour ajouter des fichiers ?</a></li>
<li><a href="#org1afde69">3.3. Cool, mais j’ai accidentellement mis un fichier en staging</a></li> <li><a href="#orgc793ace">3.3. Cool, mais j’ai accidentellement mis un fichier en staging</a></li>
<li><a href="#org1cbf786">3.4. En fait, j’ai juste oublié un truc dans mon commit précédent</a></li> <li><a href="#org19a7bfc">3.4. En fait, j’ai juste oublié un truc dans mon commit précédent</a></li>
<li><a href="#org34269dc">3.5. Euh, j’ai oublié ce que j’ai changé lors du dernier commit</a></li> <li><a href="#org340b887">3.5. Euh, j’ai oublié ce que j’ai changé lors du dernier commit</a></li>
<li><a href="#orgdd70cdb">3.6. Il y a des fichiers dont je me fiche dans mon dépôt</a></li> <li><a href="#org59a1c99">3.6. Il y a des fichiers dont je me fiche dans mon dépôt</a></li>
<li><a href="#org5431226">3.7. On est plusieurs dessus en fait…</a></li> <li><a href="#org3d08f4d">3.7. On est plusieurs dessus en fait…</a></li>
</ul> </ul>
</li> </li>
<li><a href="#org48fc6e5">4. J’ai entendu parler de GitHub…</a> <li><a href="#orgb2feded">4. J’ai entendu parler de GitHub…</a>
<ul> <ul>
<li><a href="#org4e0ecdc">4.1. J’ai téléchargé un projet en zip</a></li> <li><a href="#orge7a5178">4.1. J’ai téléchargé un projet en zip</a></li>
<li><a href="#org02b150c">4.2. Et si je veux créer mon propre dépôt sur GitHub</a></li> <li><a href="#orga340c99">4.2. Et si je veux créer mon propre dépôt sur GitHub</a></li>
<li><a href="#orgc632920">4.3. Et du coup, comment je met tout ça en ligne ?</a></li> <li><a href="#org8c4f62b">4.3. Et du coup, comment je met tout ça en ligne ?</a></li>
<li><a href="#org17d0484">4.4. Quelqu’un a fait des modifications depuis mon dernier commit, je récupère ça comment ?</a></li> <li><a href="#org18e8aec">4.4. Quelqu’un a fait des modifications depuis mon dernier commit, je récupère ça comment ?</a></li>
<li><a href="#org3baac47">4.5. Je suis en train de travailler sur le même fichier que Ginette</a></li> <li><a href="#org5b8b5cf">4.5. Je suis en train de travailler sur le même fichier que Ginette</a></li>
<li><a href="#org9eb8760">4.6. GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !</a></li>
<li><a href="#orga9e1259">4.7. Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?</a></li>
<li><a href="#org4be47d9">4.8. J’ai 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="#orge9a66ca">5. Les raccourcis et paramètres de Git</a></li>
<li><a href="#orge8dc58a">6. Et c’est tout ?</a></li>
</ul> </ul>
</div> </div>
</div> </div>
@ -277,13 +282,13 @@ for the JavaScript code in this tag.
</p> </p>
<div class="org-src-container"> <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: #975D4A; text-decoration: underline;"><a href="https://phundrak.fr/git/tutoriel-git.pdf">c&#8217;est par l&#224;</a></span>. <pre class="src src-org">Tout d&#8217;abord, si tu veux la version PDF du bouzin, <span style="color: #2aa1ae; 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: #975D4A; text-decoration: underline;"><a href="https://github.com/Phundrak/tutoriel-git">l&#224;</a></span>, sur GitHub. Et pour le code source de cette page, c&#8217;est <span style="color: #2aa1ae; text-decoration: underline;"><a href="https://github.com/Phundrak/tutoriel-git">l&#224;</a></span>, sur GitHub.
</pre> </pre>
</div> </div>
<div id="outline-container-org167823d" class="outline-2"> <div id="outline-container-org1bf79aa" class="outline-2">
<h2 id="org167823d"><span class="section-number-2">1</span> Git ? Qu’est-ce donc ?</h2> <h2 id="org1bf79aa"><span class="section-number-2">1</span> Git ? Qu’est-ce donc ?</h2>
<div class="outline-text-2" id="text-1"> <div class="outline-text-2" id="text-1">
<p> <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 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. 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.
@ -298,12 +303,12 @@ Toujours là ? Tu auras été prévenu·e.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org1ef4a45" class="outline-2"> <div id="outline-container-org079df00" class="outline-2">
<h2 id="org1ef4a45"><span class="section-number-2">2</span> Ça a l’air cool, comment ça s’obtient ?</h2> <h2 id="org079df00"><span class="section-number-2">2</span> Ça a l’air cool, comment ça s’obtient ?</h2>
<div class="outline-text-2" id="text-2"> <div class="outline-text-2" id="text-2">
</div> </div>
<div id="outline-container-org6275a66" class="outline-3"> <div id="outline-container-org9b88d16" class="outline-3">
<h3 id="org6275a66"><span class="section-number-3">2.1</span> Et surtout, comment ça s’installe ?</h3> <h3 id="org9b88d16"><span class="section-number-3">2.1</span> Et surtout, comment ça s’installe ?</h3>
<div class="outline-text-3" id="text-2-1"> <div class="outline-text-3" id="text-2-1">
<p> <p>
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. 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.
@ -313,9 +318,17 @@ Très bonne question Kévin. Tout d’abord, il faut t’assurer que git soit in
$ yum install git # CentOS $ yum install git # CentOS
$ dnf -y install git # Fedora $ dnf -y install git # Fedora
$ pacman -S git # ArchLinux et les distros bas&#233;es dessus $ pacman -S git # ArchLinux et les distros bas&#233;es dessus
$ emerge --ask --verbose dec-vcs/git # &gt;install Gentoo $ emerge --ask --verbose dec-vcs/git # Gentoo
</pre> </pre>
</div> </div>
<div id="org5986879" class="figure">
<p><img src="./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> <p>
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 : 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 :
</p> </p>
@ -330,8 +343,8 @@ Si tu es sous Windows&#x2026; Bonne chance. Toutes les commandes seront en synta
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org1835c4a" class="outline-3"> <div id="outline-container-orgbf73df9" class="outline-3">
<h3 id="org1835c4a"><span class="section-number-3">2.2</span> Ok c’est bon, et il y a une configuration à faire ?</h3> <h3 id="orgbf73df9"><span class="section-number-3">2.2</span> Ok c’est 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-2-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 :
@ -360,8 +373,8 @@ 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-org6661951" class="outline-2"> <div id="outline-container-org03ee882" class="outline-2">
<h2 id="org6661951"><span class="section-number-2">3</span> Ok très bien, comment on l’utilise maintenant ?</h2> <h2 id="org03ee882"><span class="section-number-2">3</span> Ok très bien, comment on l’utilise maintenant ?</h2>
<div class="outline-text-2" id="text-3"> <div class="outline-text-2" id="text-3">
<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 :
@ -375,8 +388,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. Bon, c’est une contrefaçon, donc la qualité de la citation n’est pas extraordinaire. Bref.
</p> </p>
</div> </div>
<div id="outline-container-orgbf9afb0" class="outline-3"> <div id="outline-container-org742f1c1" class="outline-3">
<h3 id="orgbf9afb0"><span class="section-number-3">3.1</span> Je commence comment ?</h3> <h3 id="org742f1c1"><span class="section-number-3">3.1</span> Je commence comment ?</h3>
<div class="outline-text-3" id="text-3-1"> <div class="outline-text-3" id="text-3-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>.
@ -405,18 +418,18 @@ Parfait !
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-orga10309e" class="outline-3"> <div id="outline-container-org8c1a312" class="outline-3">
<h3 id="orga10309e"><span class="section-number-3">3.2</span> Et pour ajouter des fichiers ?</h3> <h3 id="org8c1a312"><span class="section-number-3">3.2</span> Et pour ajouter des fichiers ?</h3>
<div class="outline-text-3" id="text-3-2"> <div class="outline-text-3" id="text-3-2">
<p> <p>
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 <code>main.c</code> 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 <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: #AF6F55;">#include</span> <span style="color: #e2c6ac;">&lt;</span><span style="color: #7A5343;">stdio.h</span><span style="color: #e2c6ac;">&gt;</span> <pre class="src src-C"><span style="color: #bc6ec5;">#include</span> <span style="color: #4f97d7;">&lt;</span><span style="color: #2d9574;">stdio.h</span><span style="color: #4f97d7;">&gt;</span>
<span style="color: #AF6F55;">int</span> <span style="color: #B58C65;">main</span><span style="color: #e2c6ac;">(</span><span style="color: #AF6F55;">int</span> <span style="color: #7A5343;">argc</span>, <span style="color: #AF6F55;">char</span> *<span style="color: #7A5343;">argv</span><span style="color: #8D5039;">[]</span><span style="color: #e2c6ac;">)</span> <span style="color: #e2c6ac;">{</span> <span style="color: #ce537a; font-weight: bold;">int</span> <span style="color: #bc6ec5; font-weight: bold;">main</span><span style="color: #4f97d7;">(</span><span style="color: #ce537a; font-weight: bold;">int</span> <span style="color: #7590db;">argc</span>, <span style="color: #ce537a; font-weight: bold;">char</span> *<span style="color: #7590db;">argv</span><span style="color: #bc6ec5;">[]</span><span style="color: #4f97d7;">)</span> <span style="color: #4f97d7;">{</span>
printf<span style="color: #8D5039;">(</span><span style="color: #7A5343;">"Hello World!\n"</span><span style="color: #8D5039;">)</span>; printf<span style="color: #bc6ec5;">(</span><span style="color: #2d9574;">"Hello World!\n"</span><span style="color: #bc6ec5;">)</span>;
<span style="color: #975D4A; font-weight: bold;">return</span> <span style="color: #8D5039;">0</span>; <span style="color: #4f97d7; font-weight: bold;">return</span> <span style="color: #a45bad;">0</span>;
<span style="color: #e2c6ac;">}</span> <span style="color: #4f97d7;">}</span>
</pre> </pre>
</div> </div>
<p> <p>
@ -467,18 +480,18 @@ Parfait ! Certains éléments peuvent être un peu différent chez toi, comme
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org1afde69" class="outline-3"> <div id="outline-container-orgc793ace" class="outline-3">
<h3 id="org1afde69"><span class="section-number-3">3.3</span> Cool, mais j’ai accidentellement mis un fichier en staging</h3> <h3 id="orgc793ace"><span class="section-number-3">3.3</span> Cool, mais j’ai accidentellement mis un fichier en staging</h3>
<div class="outline-text-3" id="text-3-3"> <div class="outline-text-3" id="text-3-3">
<p> <p>
Si jamais tu as un staging que tu veux annuler, tu peux utiliser la commande <code>git reset HEAD nomdetonfichier voiredautresfichiers</code> 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 <code>git checkout -- tonfichier voiredautresfichiers</code>. Par exemple, si j’ai 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 nomdetonfichier voiredautresfichiers</code> 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 <code>git checkout -- tonfichier voiredautresfichiers</code>. Par exemple, si j’ai 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: #AF6F55;">#include</span> <span style="color: #e2c6ac;">&lt;</span><span style="color: #7A5343;">stdio.h</span><span style="color: #e2c6ac;">&gt;</span> <pre class="src src-C"><span style="color: #bc6ec5;">#include</span> <span style="color: #4f97d7;">&lt;</span><span style="color: #2d9574;">stdio.h</span><span style="color: #4f97d7;">&gt;</span>
<span style="color: #AF6F55;">int</span> <span style="color: #B58C65;">main</span><span style="color: #e2c6ac;">(</span><span style="color: #AF6F55;">void</span><span style="color: #e2c6ac;">)</span> <span style="color: #e2c6ac;">{</span> <span style="color: #ce537a; font-weight: bold;">int</span> <span style="color: #bc6ec5; font-weight: bold;">main</span><span style="color: #4f97d7;">(</span><span style="color: #ce537a; font-weight: bold;">void</span><span style="color: #4f97d7;">)</span> <span style="color: #4f97d7;">{</span>
printf<span style="color: #8D5039;">(</span><span style="color: #7A5343;">"Hello World!\n"</span><span style="color: #8D5039;">)</span>; printf<span style="color: #bc6ec5;">(</span><span style="color: #2d9574;">"Hello World!\n"</span><span style="color: #bc6ec5;">)</span>;
<span style="color: #975D4A; font-weight: bold;">return</span> <span style="color: #8D5039;">0</span>; <span style="color: #4f97d7; font-weight: bold;">return</span> <span style="color: #a45bad;">0</span>;
<span style="color: #e2c6ac;">}</span> <span style="color: #4f97d7;">}</span>
</pre> </pre>
</div> </div>
<p> <p>
@ -499,8 +512,8 @@ Si je fait un <code>cat</code> du fichier, je vois qu’il est revenu à son ét
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org1cbf786" class="outline-3"> <div id="outline-container-org19a7bfc" class="outline-3">
<h3 id="org1cbf786"><span class="section-number-3">3.4</span> En fait, j’ai juste oublié un truc dans mon commit précédent</h3> <h3 id="org19a7bfc"><span class="section-number-3">3.4</span> En fait, j’ai 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-3-4">
<p> <p>
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 <code>--amend</code> lors du commit du fichier oublié. 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 <code>--amend</code> lors du commit du fichier oublié.
@ -524,8 +537,8 @@ 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-org34269dc" class="outline-3"> <div id="outline-container-org340b887" class="outline-3">
<h3 id="org34269dc"><span class="section-number-3">3.5</span> Euh, j’ai oublié ce que j’ai changé lors du dernier commit</h3> <h3 id="org340b887"><span class="section-number-3">3.5</span> Euh, j’ai oublié ce que j’ai changé lors du dernier commit</h3>
<div class="outline-text-3" id="text-3-5"> <div class="outline-text-3" id="text-3-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 d’un 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 d’un certain fichier, tu peux ajouter le nom de ton fichier à la fin de la commande.
@ -598,8 +611,8 @@ index 03b0f20..b93413f 100644
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-orgdd70cdb" class="outline-3"> <div id="outline-container-org59a1c99" class="outline-3">
<h3 id="orgdd70cdb"><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="org59a1c99"><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"> <div class="outline-text-3" id="text-3-6">
<p> <p>
Dans ce cas, il est grand temps de te présenter le fichier <code>.gitignore</code>. 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 <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 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 <code>.out</code> (ou <code>.exe</code> sous Windows), tu peux éditer (ou créer) ton <code>.gitignore</code> et entrer ces lignes :
@ -614,20 +627,63 @@ 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-org5431226" class="outline-3"> <div id="outline-container-org3d08f4d" class="outline-3">
<h3 id="org5431226"><span class="section-number-3">3.7</span> On est plusieurs dessus en fait…</h3> <h3 id="org3d08f4d"><span class="section-number-3">3.7</span> On est plusieurs dessus en fait…</h3>
</div> <div class="outline-text-3" id="text-3-7">
</div> <p>
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.
</p>
<div id="outline-container-org48fc6e5" class="outline-2"> <p>
<h2 id="org48fc6e5"><span class="section-number-2">4</span> J’ai entendu parler de GitHub…</h2> Par défaut une brache est créée lors de la création d’un dépôt qui s’appelle <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 d’ici, toute modification apportée aux fichiers du dépôt n’affecteront 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 d’utiliser 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 d’une é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 d’un 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 l’ajouter à la version stable de ton code qui se situe sur <code>master</code>. Dans ce cas, ce que tu peux faire, c’est retourner sur ta branche <code>master</code>, puis tu vas effectuer ce qu’on 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 qu’une fonctionnalité a été ajoutée et que tu veux en bénéficier dans ta branche active. N’oublie juste pas de tout bien commit avant de faire ton <i>merge</i>.
</p>
</div>
</div>
</div>
<div id="outline-container-orgb2feded" class="outline-2">
<h2 id="orgb2feded"><span class="section-number-2">4</span> J’ai entendu parler de GitHub…</h2>
<div class="outline-text-2" id="text-4"> <div class="outline-text-2" id="text-4">
<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 t’aider à comprendre, et <a href="https://www.gnu.org/philosophy/free-software-for-freedom.fr.html">un autre</a> 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 <code>rm -rf</code> 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. 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 t’aider à comprendre, et <a href="https://www.gnu.org/philosophy/free-software-for-freedom.fr.html">un autre</a> 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 <code>rm -rf</code> 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.
</p> </p>
</div> </div>
<div id="outline-container-org4e0ecdc" class="outline-3"> <div id="outline-container-orge7a5178" class="outline-3">
<h3 id="org4e0ecdc"><span class="section-number-3">4.1</span> J’ai téléchargé un projet en zip</h3> <h3 id="orge7a5178"><span class="section-number-3">4.1</span> J’ai téléchargé un projet en zip</h3>
<div class="outline-text-3" id="text-4-1"> <div class="outline-text-3" id="text-4-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, 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 <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 j’ai codé durant ma L2 d’informatique, 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, 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 <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 j’ai codé durant ma L2 d’informatique, tu peux exécuter ceci :
@ -646,8 +702,8 @@ Et c’est 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-org02b150c" class="outline-3"> <div id="outline-container-orga340c99" class="outline-3">
<h3 id="org02b150c"><span class="section-number-3">4.2</span> Et si je veux créer mon propre dépôt sur GitHub</h3> <h3 id="orga340c99"><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"> <div class="outline-text-3" id="text-4-2">
<p> <p>
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 <code>+</code> et <code>New Repository</code>. Tu lui donnes le nom que tu souhaites (en l’occurrence 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 n’ajoutes rien avant, pas de description, pas de <code>.gitignore</code>, 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 <code>+</code> et <code>New Repository</code>. Tu lui donnes le nom que tu souhaites (en l’occurrence 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 n’ajoutes rien avant, pas de description, pas de <code>.gitignore</code>, RIEN.
@ -665,8 +721,8 @@ 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-orgc632920" class="outline-3"> <div id="outline-container-org8c4f62b" class="outline-3">
<h3 id="orgc632920"><span class="section-number-3">4.3</span> Et du coup, comment je met tout ça en ligne ?</h3> <h3 id="org8c4f62b"><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"> <div class="outline-text-3" id="text-4-3">
<p> <p>
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 <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 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 <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.
@ -695,8 +751,8 @@ Bon, là en nom d’utilisateur y’a le mien, faudra remplacer avec le tiens. E
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org17d0484" class="outline-3"> <div id="outline-container-org18e8aec" class="outline-3">
<h3 id="org17d0484"><span class="section-number-3">4.4</span> Quelqu’un a fait des modifications depuis mon dernier commit, je récupère ça comment ?</h3> <h3 id="org18e8aec"><span class="section-number-3">4.4</span> Quelqu’un 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-4-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 s’il est au format <code>.md</code> (Markdown) ou <code>.org</code> (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 <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 s’il est au format <code>.md</code> (Markdown) ou <code>.org</code> (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 <code>git pull</code>.
@ -719,19 +775,122 @@ Fast-forward
</div> </div>
</div> </div>
</div> </div>
<div id="outline-container-org3baac47" class="outline-3"> <div id="outline-container-org5b8b5cf" class="outline-3">
<h3 id="org3baac47"><span class="section-number-3">4.5</span> Je suis en train de travailler sur le même fichier que Ginette</h3> <h3 id="org5b8b5cf"><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"> <div class="outline-text-3" id="text-4-5">
<p> <p>
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 <code>git stash</code> ; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications 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 <code>git stash</code> ; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications.
</p> </p>
</div> </div>
</div> </div>
<div id="outline-container-org9eb8760" class="outline-3">
<h3 id="org9eb8760"><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 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.
</p>
</div>
</div>
<div id="outline-container-orga9e1259" class="outline-3">
<h3 id="orga9e1259"><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 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).
</p>
<p>
Sur GitHub, il est possible de copier vers ton profil le dépôt de quelqu’un d’autre dans l’état où il est au moment du fork. Cela inclus les fichiers du <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 t’engueuler 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 s’il y en a) via ce qu’on appelle une pull-request. Cela signifie donc que tu demandes l’autorisation d’ajouter des commits à la base de code, et ces commits peuvent être lus et commentés par le propriétaire ou les modérateurs. Il peut y avoir une discussion entre toi et les autres personnes qui ont leur mot à dire, le code peut être temporairement refusé, auquel cas tu peux reproposer de nouveau commits sur la même pull-request jusqu’à ce que ton code soit définitivement accepté ou refusé. Dans tous les cas, cela mènera à la fermeture de ta pull-request, et tu pourras fièrement annoncer que tu as participé à un projet sur GitHub, ou bien avouer avec toute la honte du monde qu’il a été refusé.
</p>
</div>
</div>
<div id="outline-container-org4be47d9" class="outline-3">
<h3 id="org4be47d9"><span class="section-number-3">4.8</span> J’ai 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 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.
</p>
<p>
Si tu soumets un bug, avant d’ouvrir 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 d’une autre façon ? Est-ce que le bug apparaît ailleurs ? Est-tu sûr que le bug soit un bug ? Et si tu décides de le partager, assure-toi de partager un maximum d’information et tout ce que tu sais sur ce bug, en particulier les étapes et conditions pour le reproduire.
</p>
</div>
</div>
</div>
<div id="outline-container-orge9a66ca" class="outline-2">
<h2 id="orge9a66ca"><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 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 <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 d’ajouter d’un coup tout nouveau fichier d’un 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 n’a plus qu’à écrire directement le message de commit après <code>cm</code>.</dd>
<dt><code>cam</code></dt><dd>Non, ce n’est pas un plan, c’est le même alias que <code>cm</code> mais qui en plus met automatiquement tous les fichiers modifiés ou supprimés, donc s’il n’y a pas de nouveau fichier à ajouter, même pas besoin de passer par un <code>git a</code> avant le <code>git cam "j’aime 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 d’une 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 d’avoir le log un peu plus sympa et compact dont j’avais 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 n’a 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 qu’il y a sur le stash.</dd>
</dl>
</div>
</div>
<div id="outline-container-orge8dc58a" class="outline-2">
<h2 id="orge8dc58a"><span class="section-number-2">6</span> Et c’est tout ?</h2>
<div class="outline-text-2" id="text-6">
<p>
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 <code>git blame</code> ou <code>git reset</code>), 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 <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 d’union).
</p>
<p>
Si jamais tu as une question, n’hésite pas à m’envoyer 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, c’est justement le moment de mettre en pratique ce que tu as lu un peu plus haut et d’ouvrir 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> </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: 2018-10-05 ven. 17:29</p> <p class="date">Created: 2018-10-05 ven. 21:27</p>
<p class="validation"></p> <p class="validation"></p>
</div> </div>
</body> </body>

97
tutoriel-git.org
View File

@ -20,8 +20,14 @@ Très bonne question Kévin. Tout d’abord, il faut t’assurer que git soit in
$ yum install git # CentOS $ yum install git # CentOS
$ dnf -y install git # Fedora $ dnf -y install git # Fedora
$ pacman -S git # ArchLinux et les distros basées dessus $ pacman -S git # ArchLinux et les distros basées dessus
$ emerge --ask --verbose dec-vcs/git # >install Gentoo $ emerge --ask --verbose dec-vcs/git # Gentoo
#+END_SRC #+END_SRC
#+CAPTION: >install gentoo
#+NAME: >install gentoo
#+ATTR_HTML: :style display: block; margin: auto;
[[./install_gentoo.jpg]]
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 : 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 #+BEGIN_SRC text
$ pkg install git # FreeBSD $ pkg install git # FreeBSD
@ -214,7 +220,33 @@ Dans ce cas, il est grand temps de te présenter le fichier =.gitignore=. Comme
#+END_SRC #+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 l’historique des versions. Maintenant, si tu créés un fichier en =.out= ou =.exe=, il sera complètement ignoré par git et ne sera pas stocké dans l’historique des versions.
** On est plusieurs dessus en fait… ** 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.
Par défaut une brache est créée lors de la création d’un dépôt qui s’appelle =master=. Pour créer une nouvelle branche, on peut donc utiliser la commande =git checkout -b nomdelanouvellebranche=.
#+BEGIN_SRC text
$ git checkout -b nouvelle-branche
Switched to a new branch 'nouvelle-branche'
#+END_SRC
À partir d’ici, toute modification apportée aux fichiers du dépôt n’affecteront 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 d’utiliser 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 d’une étoile à côté de son nom.
#+BEGIN_SRC text
$ git branch --list
master
,* nouvelle-branche
#+END_SRC
Au bout d’un 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 l’ajouter à la version stable de ton code qui se situe sur =master=. Dans ce cas, ce que tu peux faire, c’est retourner sur ta branche =master=, puis tu vas effectuer ce qu’on appelle un /merge/ ; en gros, pour faire simple, tu vas appliquer les modifications de la branche que tu souhaites fusionner avec ta branche =master= sur cette dernière.
#+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 qu’une fonctionnalité a été ajoutée et que tu veux en bénéficier dans ta branche active. N’oublie juste pas de tout bien commit avant de faire ton /merge/.
* J’ai entendu parler de GitHub… * J’ai entendu parler de GitHub…
Tu commences à me plaire Enzo ! GitHub est un site web sur lequel tu peux héberger des projets libres ou open-source (si tu ne connais pas la différence, voici [[https://www.gnu.org/philosophy/open-source-misses-the-point.fr.html][un article]] pour t’aider à comprendre, et [[https://www.gnu.org/philosophy/free-software-for-freedom.fr.html][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. 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 t’aider à comprendre, et [[https://www.gnu.org/philosophy/free-software-for-freedom.fr.html][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.
** J’ai téléchargé un projet en zip ** J’ai téléchargé un projet en zip
@ -275,6 +307,67 @@ 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à, 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 Là, c’est un problème qui aurait pu être évité avec l’usage des branches dont je t’avais parlé plus haut, mais visiblement, vous êtes sur la même branche. Pas bien. Dans ce cas-là, met-toi d’accord avec Ginette pour savoir qui fait ses push en premier. Si le choix tombe sur Ginette, ou si elle a imposé sa vision des choses et a fait son push avant toi, GitHub va râler car tu n’es pas à jour. Dans ce cas ne panique pas, si tu n’as pas fait tes commits, lance la commande =git stash= ; ça va sauvegarder tes modifications dans un coin à part et va annuler tes modifications.
** GitHub ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !
Du calme Jean-Célestin. Cela veut tout simplement dire que tu n’as tout simplement pas les droits d’écriture sur son dépôt. Du coup, soit tu peux lui demander directement à ce qu’elle te donne les droits d’écriture si elle a confiance en toi, soit tu peux créer un fork puis une pull-request sur GitHub depuis ton fork où tu auras fait tes modifications.
** Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?
Ouhlà Billy, il va falloir remettre les choses au clair. Là il s’agit de quelque chose de spécifique à GitHub qu’à Git (d’où le fait qu’on en discute dans ce chapitre que le précédent).
Sur GitHub, il est possible de copier vers ton profil le dépôt de quelqu’un d’autre dans l’état où il est au moment du fork. Cela inclus les fichiers du =master=, mais également de toutes les branches du dépôt. Tu peux y penser en terme de super-branche dont tu deviens le propriétaire. Tu peux ainsi travailler comme bon te semble sur le code source sans que son propriétaire ne vienne t’engueuler car tu es en train de polluer sa base de code.
Si jamais il y a une modification dont tu es particulièrement fier, tu peux la soumettre au propriétaire du dépôt original (et à ses modérateurs et contributeurs s’il y en a) via ce qu’on appelle une pull-request. Cela signifie donc que tu demandes l’autorisation d’ajouter des commits à la base de code, et ces commits peuvent être lus et commentés par le propriétaire ou les modérateurs. Il peut y avoir une discussion entre toi et les autres personnes qui ont leur mot à dire, le code peut être temporairement refusé, auquel cas tu peux reproposer de nouveau commits sur la même pull-request jusqu’à ce que ton code soit définitivement accepté ou refusé. Dans tous les cas, cela mènera à la fermeture de ta pull-request, et tu pourras fièrement annoncer que tu as participé à un projet sur GitHub, ou bien avouer avec toute la honte du monde qu’il a été refusé.
** J’ai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même
Eh bien dans ce cas-là, ouvre une /issue/ Bernadette ; /issue/ qui en français veut dire /problème/. Il s’agit d’un système de GitHub te permettant de signaler quelque chose aux propriétaires du dépôt, il peut s’agir d’un bug, d’une demande de fonctionnalité ou de proposition de modification d’autres fonctionnalités. Cela peut donner lieu à des discussions menant à la compréhension du bug, ou à une amélioration de ta proposition.
Si tu soumets un bug, avant d’ouvrir une nouvelle /issue/, assure-toi de bien savoir comment le bug se produit et peut se reproduire. Est-ce que le bug apparaît si tu utilise ou ouvre le logiciel d’une autre façon ? Est-ce que le bug apparaît ailleurs ? Est-tu sûr que le bug soit un bug ? Et si tu décides de le partager, assure-toi de partager un maximum d’information et tout ce que tu sais sur ce bug, en particulier les étapes et conditions pour le reproduire.
* Les raccourcis et paramètres de Git
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.
#+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 d’ajouter d’un coup tout nouveau fichier d’un 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 n’a plus qu’à écrire directement le message de commit après =cm=.
- =cam= :: Non, ce n’est pas un plan, c’est le même alias que =cm= mais qui en plus met automatiquement tous les fichiers modifiés ou supprimés, donc s’il n’y a pas de nouveau fichier à ajouter, même pas besoin de passer par un =git a= avant le =git cam "j’aime 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 d’une 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 d’avoir le log un peu plus sympa et compact dont j’avais 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 n’a 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 qu’il y a sur le stash.
* 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 [[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 d’union).
Si jamais tu as une question, n’hésite pas à m’envoyer 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, c’est justement le moment de mettre en pratique ce que tu as lu un peu plus haut et d’ouvrir 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 # LocalWords: Jean-Kévin staging Ctrl-X déplace-y-toi push

BIN
tutoriel-git.pdf
View File

Binary file not shown.