small update as to how I address the reader

This commit is contained in:
Phuntsok Drak-pa 2018-10-05 14:48:55 +02:00
parent 76364b494c
commit d616b0b001
3 changed files with 64 additions and 52 deletions

View File

@ -3,7 +3,7 @@
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
<head>
<!-- 2018-10-05 ven. 14:08 -->
<!-- 2018-10-05 ven. 14:48 -->
<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>
@ -243,29 +243,29 @@ for the JavaScript code in this tag.
<h2>Table des matières</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#orgd20e076">1. Git ? Quest-ce donc ?</a></li>
<li><a href="#org50cdb25">2. Ça a lair cool, comment ça sutilise?</a>
<li><a href="#org23b29bc">1. Git ? Quest-ce donc ?</a></li>
<li><a href="#org32855ad">2. Ça a lair cool, comment ça sutilise?</a>
<ul>
<li><a href="#orgfd576ff">2.1. Et surtout, comment ça sinstalle ?</a></li>
<li><a href="#orgf79c71e">2.2. Ok cest bon, et il y a une configuration à faire ?</a></li>
<li><a href="#orgea19d3c">2.1. Et surtout, comment ça sinstalle ?</a></li>
<li><a href="#orgec60f93">2.2. Ok cest bon, et il y a une configuration à faire ?</a></li>
</ul>
</li>
<li><a href="#org7a6ff6c">3. Ok très bien, mais je veux utiliser git moi!</a>
<li><a href="#org96548b9">3. Ok très bien, mais je veux utiliser git moi!</a>
<ul>
<li><a href="#orgae9ad7f">3.1. Je commmence comment?</a></li>
<li><a href="#org4a5e57e">3.2. Et pour ajouter des fichiers?</a></li>
<li><a href="#org34bef9e">3.3. Cool, mais jai accidentellement mis un fichier en staging</a></li>
<li><a href="#orgfc020de">3.4. En fait, jai juste oublié un truc dans mon commit précédent</a></li>
<li><a href="#org0f62d45">3.1. Je commmence comment?</a></li>
<li><a href="#orgfc00661">3.2. Et pour ajouter des fichiers?</a></li>
<li><a href="#orgc3fb330">3.3. Cool, mais jai accidentellement mis un fichier en staging</a></li>
<li><a href="#orgeaa9108">3.4. En fait, jai juste oublié un truc dans mon commit précédent</a></li>
</ul>
</li>
<li><a href="#orgfb68abb">4. Euh, jai oublié ce que jai changé lors du dernier commit</a></li>
<li><a href="#orga2a3077">5. Il y a des fichiers dont je me fiche dans mon dépot</a></li>
<li><a href="#orgd9de679">6. Jai entendu parler de GitHub…</a>
<li><a href="#orgf2fa74c">4. Euh, jai oublié ce que jai changé lors du dernier commit</a></li>
<li><a href="#org04e3f5a">5. Il y a des fichiers dont je me fiche dans mon dépot</a></li>
<li><a href="#orga961826">6. Jai entendu parler de GitHub…</a>
<ul>
<li><a href="#org51fec9d">6.1. Jai téléchargé un projet en zip</a></li>
<li><a href="#orgbd123a2">6.2. Et si je veux créer mon propre dépôt sur GitHub</a></li>
<li><a href="#orgc186792">6.3. Et du coup, comment je met tout ça en ligne ?</a></li>
<li><a href="#org453d1a0">6.4. Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?</a></li>
<li><a href="#org1e8cb0e">6.1. Jai téléchargé un projet en zip</a></li>
<li><a href="#org078e4f6">6.2. Et si je veux créer mon propre dépôt sur GitHub</a></li>
<li><a href="#orgb06f59e">6.3. Et du coup, comment je met tout ça en ligne ?</a></li>
<li><a href="#orge6f3f93">6.4. Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?</a></li>
</ul>
</li>
</ul>
@ -280,20 +280,28 @@ for the JavaScript code in this tag.
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.
</pre>
</div>
<div id="outline-container-orgd20e076" class="outline-2">
<h2 id="orgd20e076"><span class="section-number-2">1</span> Git ? Quest-ce donc ?</h2>
<div id="outline-container-org23b29bc" class="outline-2">
<h2 id="org23b29bc"><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-org50cdb25" class="outline-2">
<h2 id="org50cdb25"><span class="section-number-2">2</span> Ça a lair cool, comment ça sutilise?</h2>
<div id="outline-container-org32855ad" class="outline-2">
<h2 id="org32855ad"><span class="section-number-2">2</span> Ça a lair cool, comment ça sutilise?</h2>
<div class="outline-text-2" id="text-2">
</div>
<div id="outline-container-orgfd576ff" class="outline-3">
<h3 id="orgfd576ff"><span class="section-number-3">2.1</span> Et surtout, comment ça sinstalle ?</h3>
<div id="outline-container-orgea19d3c" class="outline-3">
<h3 id="orgea19d3c"><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 Kevin. 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.
@ -320,8 +328,8 @@ Si tu es sous Windows&#x2026; Bonne chance. Toutes les commandes seront en synta
</p>
</div>
</div>
<div id="outline-container-orgf79c71e" class="outline-3">
<h3 id="orgf79c71e"><span class="section-number-3">2.2</span> Ok cest bon, et il y a une configuration à faire ?</h3>
<div id="outline-container-orgec60f93" class="outline-3">
<h3 id="orgec60f93"><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 :
@ -350,8 +358,8 @@ Il y a encore pas mal de paramètres que tu peux gérer avec ce fichier, je repa
</div>
</div>
</div>
<div id="outline-container-org7a6ff6c" class="outline-2">
<h2 id="org7a6ff6c"><span class="section-number-2">3</span> Ok très bien, mais je veux utiliser git moi!</h2>
<div id="outline-container-org96548b9" class="outline-2">
<h2 id="org96548b9"><span class="section-number-2">3</span> Ok très bien, mais je veux utiliser git moi!</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 :
@ -365,8 +373,8 @@ 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.
</p>
</div>
<div id="outline-container-orgae9ad7f" class="outline-3">
<h3 id="orgae9ad7f"><span class="section-number-3">3.1</span> Je commmence comment?</h3>
<div id="outline-container-org0f62d45" class="outline-3">
<h3 id="org0f62d45"><span class="section-number-3">3.1</span> Je commmence 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>.
@ -395,8 +403,8 @@ Parfait!
</p>
</div>
</div>
<div id="outline-container-org4a5e57e" class="outline-3">
<h3 id="org4a5e57e"><span class="section-number-3">3.2</span> Et pour ajouter des fichiers?</h3>
<div id="outline-container-orgfc00661" class="outline-3">
<h3 id="orgfc00661"><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épot. Créé un fichier <code>main.c</code> dans lequel tu vas entrer ce code :
@ -458,8 +466,8 @@ Parfait! Certains éléments peuvent être un peu différent chez toi, comme
</p>
</div>
</div>
<div id="outline-container-org34bef9e" class="outline-3">
<h3 id="org34bef9e"><span class="section-number-3">3.3</span> Cool, mais jai accidentellement mis un fichier en staging</h3>
<div id="outline-container-orgc3fb330" class="outline-3">
<h3 id="orgc3fb330"><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 nomdetonfichier voiredautresfichiers</code> 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 -- tonfichier voiredautresfichiers</code>. Par exemple, si jai modifié mon <code>main.c</code> en modifiant ainsi les arguments du <code>main()</code> :
@ -491,8 +499,8 @@ Si je fait un <code>cat</code> du fichier, je vois quil est revenu à son ét
</p>
</div>
</div>
<div id="outline-container-orgfc020de" class="outline-3">
<h3 id="orgfc020de"><span class="section-number-3">3.4</span> En fait, jai juste oublié un truc dans mon commit précédent</h3>
<div id="outline-container-orgeaa9108" class="outline-3">
<h3 id="orgeaa9108"><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é.
@ -517,8 +525,8 @@ En gros, le commit que tu viens de faire a remplacé le précédent en conservan
</div>
</div>
</div>
<div id="outline-container-orgfb68abb" class="outline-2">
<h2 id="orgfb68abb"><span class="section-number-2">4</span> Euh, jai oublié ce que jai changé lors du dernier commit</h2>
<div id="outline-container-orgf2fa74c" class="outline-2">
<h2 id="orgf2fa74c"><span class="section-number-2">4</span> Euh, jai oublié ce que jai changé lors du dernier commit</h2>
<div class="outline-text-2" id="text-4">
<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.
@ -592,8 +600,8 @@ index 03b0f20..b93413f 100644
</div>
</div>
<div id="outline-container-orga2a3077" class="outline-2">
<h2 id="orga2a3077"><span class="section-number-2">5</span> Il y a des fichiers dont je me fiche dans mon dépot</h2>
<div id="outline-container-org04e3f5a" class="outline-2">
<h2 id="org04e3f5a"><span class="section-number-2">5</span> Il y a des fichiers dont je me fiche dans mon dépot</h2>
<div class="outline-text-2" id="text-5">
<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 :
@ -609,16 +617,16 @@ Maintenant, si tu créés un fichier en <code>.out</code> ou <code>.exe</code>,
</div>
</div>
<div id="outline-container-orgd9de679" class="outline-2">
<h2 id="orgd9de679"><span class="section-number-2">6</span> Jai entendu parler de GitHub…</h2>
<div id="outline-container-orga961826" class="outline-2">
<h2 id="orga961826"><span class="section-number-2">6</span> Jai entendu parler de GitHub…</h2>
<div class="outline-text-2" id="text-6">
<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-org51fec9d" class="outline-3">
<h3 id="org51fec9d"><span class="section-number-3">6.1</span> Jai téléchargé un projet en zip</h3>
<div id="outline-container-org1e8cb0e" class="outline-3">
<h3 id="org1e8cb0e"><span class="section-number-3">6.1</span> Jai téléchargé un projet en zip</h3>
<div class="outline-text-3" id="text-6-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 :
@ -638,11 +646,11 @@ Et cest bon, tu as accès au répertoire <code>chat-reseau-P8</code> et au co
</div>
</div>
<div id="outline-container-orgbd123a2" class="outline-3">
<h3 id="orgbd123a2"><span class="section-number-3">6.2</span> Et si je veux créer mon propre dépôt sur GitHub</h3>
<div id="outline-container-org078e4f6" class="outline-3">
<h3 id="org078e4f6"><span class="section-number-3">6.2</span> Et si je veux créer mon propre dépôt sur GitHub</h3>
<div class="outline-text-3" id="text-6-2">
<p>
Dans ce cas là, cest simple Kévin. Il faut que tu te créées 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 loccurence 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 loccurence 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>
@ -658,8 +666,8 @@ Et voilà, ton dépôt est lié au dépôt distant. Oui, juste comme ça.
</div>
</div>
<div id="outline-container-orgc186792" class="outline-3">
<h3 id="orgc186792"><span class="section-number-3">6.3</span> Et du coup, comment je met tout ça en ligne ?</h3>
<div id="outline-container-orgb06f59e" class="outline-3">
<h3 id="orgb06f59e"><span class="section-number-3">6.3</span> Et du coup, comment je met tout ça en ligne ?</h3>
<div class="outline-text-3" id="text-6-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 ligen 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.
@ -689,8 +697,8 @@ Bon, là en nom dutilisateur ya le mien, faudra remplacer avec le tiens. E
</div>
</div>
<div id="outline-container-org453d1a0" class="outline-3">
<h3 id="org453d1a0"><span class="section-number-3">6.4</span> Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?</h3>
<div id="outline-container-orge6f3f93" class="outline-3">
<h3 id="orge6f3f93"><span class="section-number-3">6.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-6-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 apparaitra 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>.
@ -717,7 +725,7 @@ Fast-forward
</div>
<div id="postamble" class="status">
<p class="author">Auteur: Lucien Cartier-Tilet</p>
<p class="date">Created: 2018-10-05 ven. 14:08</p>
<p class="date">Created: 2018-10-05 ven. 14:48</p>
<p class="validation"></p>
</div>
</body>

View File

@ -8,6 +8,10 @@ Et pour le code source de cette page, cest [[https://github.com/Phundrak/tuto
#+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 sutilise?
** Et surtout, comment ça sinstalle ?
Très bonne question Kevin. 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.
@ -229,7 +233,7 @@ Ou bien, tu peux télécharger le projet directement via =git=. Eh oui! git p
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 Kévin. Il faut que tu te créées un compte sur GitHub, puis tu cliques sur le bouton =+= et =New Repository=. Tu lui donnes le nom que tu souhaites (en loccurence 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.
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 loccurence 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

Binary file not shown.