initial commit
This commit is contained in:
Phuntsok Drak-pa
commit
860412dc41
3
.gitignore
vendored
Normal file
3
.gitignore
vendored
Normal file
@ -0,0 +1,3 @@
|
||||
*.tex
|
||||
/_minted*
|
||||
/auto
|
||||
16
headers.org
Normal file
16
headers.org
Normal file
@ -0,0 +1,16 @@
|
||||
#+AUTHOR: Lucien Cartier-Tilet
|
||||
#+EMAIL: phundrak@phundrak.fr
|
||||
#+CREATOR: Lucien Cartier-Tilet
|
||||
#+LANGUAGE: fr
|
||||
#+SETUPFILE: theme-readtheorg.setup
|
||||
#+LATEX_CLASS: article
|
||||
#+LaTeX_CLASS_OPTIONS: [a4paper,twoside]
|
||||
#+LATEX_HEADER: \usepackage{xltxtra,fontspec,xunicode}\usepackage[total={6.5in,9.5in}]{geometry}\setromanfont[Numbers=Lowercase]{Charis SIL}
|
||||
#+LATEX_HEADER: \usepackage{xcolor} \usepackage{hyperref}
|
||||
#+LATEX_HEADER: \hypersetup{colorlinks=true,linkbordercolor=red,linkcolor=blue,pdfborderstyle={/S/U/W 1}}
|
||||
#+LATEX_HEADER: \usepackage{multicol}
|
||||
#+OPTIONS: H:4
|
||||
#+OPTIONS: toc:nil
|
||||
src_latex{\newpage}
|
||||
#+TOC: headlines
|
||||
src_latex{\newpage}
|
||||
9
theme-readtheorg.setup
Normal file
9
theme-readtheorg.setup
Normal file
@ -0,0 +1,9 @@
|
||||
# -*- mode: org; -*-
|
||||
|
||||
#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="https://langue.phundrak.fr/css/htmlize.css"/>
|
||||
#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="https://langue.phundrak.fr/css/readtheorg.css"/>
|
||||
|
||||
#+HTML_HEAD: <script src="https://phundrak.fr/js/jquery.min.js"></script>
|
||||
#+HTML_HEAD: <script src="https://phundrak.fr/js/bootstrap.min.js"></script>
|
||||
#+HTML_HEAD: <script type="text/javascript" src="https://phundrak.fr/js/jquery.stickytableheaders.min.js"></script>
|
||||
#+HTML_HEAD: <script type="text/javascript" src="https://phundrak.fr/js/readtheorg.js"></script>
|
||||
724
tutoriel-git.html
Normal file
724
tutoriel-git.html
Normal file
@ -0,0 +1,724 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
||||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr">
|
||||
<head>
|
||||
<!-- 2018-10-05 ven. 13:59 -->
|
||||
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
<title>Tutoriel Git et GitHub</title>
|
||||
<meta name="generator" content="Org mode" />
|
||||
<meta name="author" content="Lucien Cartier-Tilet" />
|
||||
<style type="text/css">
|
||||
<!--/*--><![CDATA[/*><!--*/
|
||||
.title { text-align: center;
|
||||
margin-bottom: .2em; }
|
||||
.subtitle { text-align: center;
|
||||
font-size: medium;
|
||||
font-weight: bold;
|
||||
margin-top:0; }
|
||||
.todo { font-family: monospace; color: red; }
|
||||
.done { font-family: monospace; color: green; }
|
||||
.priority { font-family: monospace; color: orange; }
|
||||
.tag { background-color: #eee; font-family: monospace;
|
||||
padding: 2px; font-size: 80%; font-weight: normal; }
|
||||
.timestamp { color: #bebebe; }
|
||||
.timestamp-kwd { color: #5f9ea0; }
|
||||
.org-right { margin-left: auto; margin-right: 0px; text-align: right; }
|
||||
.org-left { margin-left: 0px; margin-right: auto; text-align: left; }
|
||||
.org-center { margin-left: auto; margin-right: auto; text-align: center; }
|
||||
.underline { text-decoration: underline; }
|
||||
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
|
||||
p.verse { margin-left: 3%; }
|
||||
pre {
|
||||
border: 1px solid #ccc;
|
||||
box-shadow: 3px 3px 3px #eee;
|
||||
padding: 8pt;
|
||||
font-family: monospace;
|
||||
overflow: auto;
|
||||
margin: 1.2em;
|
||||
}
|
||||
pre.src {
|
||||
position: relative;
|
||||
overflow: visible;
|
||||
padding-top: 1.2em;
|
||||
}
|
||||
pre.src:before {
|
||||
display: none;
|
||||
position: absolute;
|
||||
background-color: white;
|
||||
top: -10px;
|
||||
right: 10px;
|
||||
padding: 3px;
|
||||
border: 1px solid black;
|
||||
}
|
||||
pre.src:hover:before { display: inline;}
|
||||
/* Languages per Org manual */
|
||||
pre.src-asymptote:before { content: 'Asymptote'; }
|
||||
pre.src-awk:before { content: 'Awk'; }
|
||||
pre.src-C:before { content: 'C'; }
|
||||
/* pre.src-C++ doesn't work in CSS */
|
||||
pre.src-clojure:before { content: 'Clojure'; }
|
||||
pre.src-css:before { content: 'CSS'; }
|
||||
pre.src-D:before { content: 'D'; }
|
||||
pre.src-ditaa:before { content: 'ditaa'; }
|
||||
pre.src-dot:before { content: 'Graphviz'; }
|
||||
pre.src-calc:before { content: 'Emacs Calc'; }
|
||||
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
|
||||
pre.src-fortran:before { content: 'Fortran'; }
|
||||
pre.src-gnuplot:before { content: 'gnuplot'; }
|
||||
pre.src-haskell:before { content: 'Haskell'; }
|
||||
pre.src-hledger:before { content: 'hledger'; }
|
||||
pre.src-java:before { content: 'Java'; }
|
||||
pre.src-js:before { content: 'Javascript'; }
|
||||
pre.src-latex:before { content: 'LaTeX'; }
|
||||
pre.src-ledger:before { content: 'Ledger'; }
|
||||
pre.src-lisp:before { content: 'Lisp'; }
|
||||
pre.src-lilypond:before { content: 'Lilypond'; }
|
||||
pre.src-lua:before { content: 'Lua'; }
|
||||
pre.src-matlab:before { content: 'MATLAB'; }
|
||||
pre.src-mscgen:before { content: 'Mscgen'; }
|
||||
pre.src-ocaml:before { content: 'Objective Caml'; }
|
||||
pre.src-octave:before { content: 'Octave'; }
|
||||
pre.src-org:before { content: 'Org mode'; }
|
||||
pre.src-oz:before { content: 'OZ'; }
|
||||
pre.src-plantuml:before { content: 'Plantuml'; }
|
||||
pre.src-processing:before { content: 'Processing.js'; }
|
||||
pre.src-python:before { content: 'Python'; }
|
||||
pre.src-R:before { content: 'R'; }
|
||||
pre.src-ruby:before { content: 'Ruby'; }
|
||||
pre.src-sass:before { content: 'Sass'; }
|
||||
pre.src-scheme:before { content: 'Scheme'; }
|
||||
pre.src-screen:before { content: 'Gnu Screen'; }
|
||||
pre.src-sed:before { content: 'Sed'; }
|
||||
pre.src-sh:before { content: 'shell'; }
|
||||
pre.src-sql:before { content: 'SQL'; }
|
||||
pre.src-sqlite:before { content: 'SQLite'; }
|
||||
/* additional languages in org.el's org-babel-load-languages alist */
|
||||
pre.src-forth:before { content: 'Forth'; }
|
||||
pre.src-io:before { content: 'IO'; }
|
||||
pre.src-J:before { content: 'J'; }
|
||||
pre.src-makefile:before { content: 'Makefile'; }
|
||||
pre.src-maxima:before { content: 'Maxima'; }
|
||||
pre.src-perl:before { content: 'Perl'; }
|
||||
pre.src-picolisp:before { content: 'Pico Lisp'; }
|
||||
pre.src-scala:before { content: 'Scala'; }
|
||||
pre.src-shell:before { content: 'Shell Script'; }
|
||||
pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
|
||||
/* additional language identifiers per "defun org-babel-execute"
|
||||
in ob-*.el */
|
||||
pre.src-cpp:before { content: 'C++'; }
|
||||
pre.src-abc:before { content: 'ABC'; }
|
||||
pre.src-coq:before { content: 'Coq'; }
|
||||
pre.src-groovy:before { content: 'Groovy'; }
|
||||
/* additional language identifiers from org-babel-shell-names in
|
||||
ob-shell.el: ob-shell is the only babel language using a lambda to put
|
||||
the execution function name together. */
|
||||
pre.src-bash:before { content: 'bash'; }
|
||||
pre.src-csh:before { content: 'csh'; }
|
||||
pre.src-ash:before { content: 'ash'; }
|
||||
pre.src-dash:before { content: 'dash'; }
|
||||
pre.src-ksh:before { content: 'ksh'; }
|
||||
pre.src-mksh:before { content: 'mksh'; }
|
||||
pre.src-posh:before { content: 'posh'; }
|
||||
/* Additional Emacs modes also supported by the LaTeX listings package */
|
||||
pre.src-ada:before { content: 'Ada'; }
|
||||
pre.src-asm:before { content: 'Assembler'; }
|
||||
pre.src-caml:before { content: 'Caml'; }
|
||||
pre.src-delphi:before { content: 'Delphi'; }
|
||||
pre.src-html:before { content: 'HTML'; }
|
||||
pre.src-idl:before { content: 'IDL'; }
|
||||
pre.src-mercury:before { content: 'Mercury'; }
|
||||
pre.src-metapost:before { content: 'MetaPost'; }
|
||||
pre.src-modula-2:before { content: 'Modula-2'; }
|
||||
pre.src-pascal:before { content: 'Pascal'; }
|
||||
pre.src-ps:before { content: 'PostScript'; }
|
||||
pre.src-prolog:before { content: 'Prolog'; }
|
||||
pre.src-simula:before { content: 'Simula'; }
|
||||
pre.src-tcl:before { content: 'tcl'; }
|
||||
pre.src-tex:before { content: 'TeX'; }
|
||||
pre.src-plain-tex:before { content: 'Plain TeX'; }
|
||||
pre.src-verilog:before { content: 'Verilog'; }
|
||||
pre.src-vhdl:before { content: 'VHDL'; }
|
||||
pre.src-xml:before { content: 'XML'; }
|
||||
pre.src-nxml:before { content: 'XML'; }
|
||||
/* add a generic configuration mode; LaTeX export needs an additional
|
||||
(add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
|
||||
pre.src-conf:before { content: 'Configuration File'; }
|
||||
|
||||
table { border-collapse:collapse; }
|
||||
caption.t-above { caption-side: top; }
|
||||
caption.t-bottom { caption-side: bottom; }
|
||||
td, th { vertical-align:top; }
|
||||
th.org-right { text-align: center; }
|
||||
th.org-left { text-align: center; }
|
||||
th.org-center { text-align: center; }
|
||||
td.org-right { text-align: right; }
|
||||
td.org-left { text-align: left; }
|
||||
td.org-center { text-align: center; }
|
||||
dt { font-weight: bold; }
|
||||
.footpara { display: inline; }
|
||||
.footdef { margin-bottom: 1em; }
|
||||
.figure { padding: 1em; }
|
||||
.figure p { text-align: center; }
|
||||
.inlinetask {
|
||||
padding: 10px;
|
||||
border: 2px solid gray;
|
||||
margin: 10px;
|
||||
background: #ffffcc;
|
||||
}
|
||||
#org-div-home-and-up
|
||||
{ text-align: right; font-size: 70%; white-space: nowrap; }
|
||||
textarea { overflow-x: auto; }
|
||||
.linenr { font-size: smaller }
|
||||
.code-highlighted { background-color: #ffff00; }
|
||||
.org-info-js_info-navigation { border-style: none; }
|
||||
#org-info-js_console-label
|
||||
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
|
||||
.org-info-js_search-highlight
|
||||
{ background-color: #ffff00; color: #000000; font-weight: bold; }
|
||||
.org-svg { width: 90%; }
|
||||
/*]]>*/-->
|
||||
</style>
|
||||
<link rel="stylesheet" type="text/css" href="https://langue.phundrak.fr/css/htmlize.css"/>
|
||||
<link rel="stylesheet" type="text/css" href="https://langue.phundrak.fr/css/readtheorg.css"/>
|
||||
<script src="https://phundrak.fr/js/jquery.min.js"></script>
|
||||
<script src="https://phundrak.fr/js/bootstrap.min.js"></script>
|
||||
<script type="text/javascript" src="https://phundrak.fr/js/jquery.stickytableheaders.min.js"></script>
|
||||
<script type="text/javascript" src="https://phundrak.fr/js/readtheorg.js"></script>
|
||||
<script type="text/javascript">
|
||||
/*
|
||||
@licstart The following is the entire license notice for the
|
||||
JavaScript code in this tag.
|
||||
|
||||
Copyright (C) 2012-2018 Free Software Foundation, Inc.
|
||||
|
||||
The JavaScript code in this tag is free software: you can
|
||||
redistribute it and/or modify it under the terms of the GNU
|
||||
General Public License (GNU GPL) as published by the Free Software
|
||||
Foundation, either version 3 of the License, or (at your option)
|
||||
any later version. The code is distributed WITHOUT ANY WARRANTY;
|
||||
without even the implied warranty of MERCHANTABILITY or FITNESS
|
||||
FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.
|
||||
|
||||
As additional permission under GNU GPL version 3 section 7, you
|
||||
may distribute non-source (e.g., minimized or compacted) forms of
|
||||
that code without the copy of the GNU GPL normally required by
|
||||
section 4, provided you include this license notice and a URL
|
||||
through which recipients can access the Corresponding Source.
|
||||
|
||||
|
||||
@licend The above is the entire license notice
|
||||
for the JavaScript code in this tag.
|
||||
*/
|
||||
<!--/*--><![CDATA[/*><!--*/
|
||||
function CodeHighlightOn(elem, id)
|
||||
{
|
||||
var target = document.getElementById(id);
|
||||
if(null != target) {
|
||||
elem.cacheClassElem = elem.className;
|
||||
elem.cacheClassTarget = target.className;
|
||||
target.className = "code-highlighted";
|
||||
elem.className = "code-highlighted";
|
||||
}
|
||||
}
|
||||
function CodeHighlightOff(elem, id)
|
||||
{
|
||||
var target = document.getElementById(id);
|
||||
if(elem.cacheClassElem)
|
||||
elem.className = elem.cacheClassElem;
|
||||
if(elem.cacheClassTarget)
|
||||
target.className = elem.cacheClassTarget;
|
||||
}
|
||||
/*]]>*///-->
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
<div id="content">
|
||||
<h1 class="title">Tutoriel Git et GitHub</h1>
|
||||
<p>
|
||||
|
||||
</p>
|
||||
<div id="table-of-contents">
|
||||
<h2>Table des matières</h2>
|
||||
<div id="text-table-of-contents">
|
||||
<ul>
|
||||
<li><a href="#org424efeb">1. Git ? Qu’est-ce donc ?</a></li>
|
||||
<li><a href="#org04d5b23">2. Ça a l’air cool, comment ça s’utilise ?</a>
|
||||
<ul>
|
||||
<li><a href="#org46a0365">2.1. Et surtout, comment ça s’installe ?</a></li>
|
||||
<li><a href="#orgd3f885f">2.2. Ok c’est bon, et il y a une configuration à faire ?</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#org3b01d46">3. Ok très bien, mais je veux utiliser git moi !</a>
|
||||
<ul>
|
||||
<li><a href="#orga446891">3.1. Je commmence comment ?</a></li>
|
||||
<li><a href="#orgaf9966d">3.2. Et pour ajouter des fichiers ?</a></li>
|
||||
<li><a href="#org4d067d2">3.3. Cool, mais j’ai accidentellement mis un fichier en staging</a></li>
|
||||
<li><a href="#orga03d27e">3.4. En fait, j’ai juste oublié un truc dans mon commit précédent</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#org5c917f7">4. Euh, j’ai oublié ce que j’ai changé lors du dernier commit</a></li>
|
||||
<li><a href="#org35ba9ee">5. Il y a des fichiers dont je me fiche dans mon dépot</a></li>
|
||||
<li><a href="#orgccda07e">6. J’ai entendu parler de GitHub…</a>
|
||||
<ul>
|
||||
<li><a href="#orgde64bff">6.1. J’ai téléchargé un projet en zip</a></li>
|
||||
<li><a href="#org1e85cba">6.2. Et si je veux créer mon propre dépôt sur GitHub</a></li>
|
||||
<li><a href="#org7eaca37">6.3. Et du coup, comment je met tout ça en ligne ?</a></li>
|
||||
<li><a href="#org9c233f0">6.4. Quelqu’un a fait des modifications depuis mon dernier commit, je récupère ça comment ?</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
<p>
|
||||
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-org">Et tout d’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’est par là</a></span>.
|
||||
|
||||
Et pour le code source de cette page, c’est <span style="color: #975D4A; text-decoration: underline;"><a href="https://phundrak.fr/git/tutoriel-git.org">là</a></span>, <span style="color: #975D4A; text-decoration: underline;"><a href="https://phundrak.fr/git/theme-readtheorg.setup">là</a></span> et <span style="color: #975D4A; text-decoration: underline;"><a href="https://phundrak.fr/git/headers.org">là</a></span>.
|
||||
</pre>
|
||||
</div>
|
||||
<div id="outline-container-org424efeb" class="outline-2">
|
||||
<h2 id="org424efeb"><span class="section-number-2">1</span> Git ? Qu’est-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 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.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org04d5b23" class="outline-2">
|
||||
<h2 id="org04d5b23"><span class="section-number-2">2</span> Ça a l’air cool, comment ça s’utilise ?</h2>
|
||||
<div class="outline-text-2" id="text-2">
|
||||
</div>
|
||||
<div id="outline-container-org46a0365" class="outline-3">
|
||||
<h3 id="org46a0365"><span class="section-number-3">2.1</span> Et surtout, comment ça s’installe ?</h3>
|
||||
<div class="outline-text-3" id="text-2-1">
|
||||
<p>
|
||||
Très bonne question Kevin. Tout d’abord, il faut t’assurer que git soit installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux, tu peux l’installer via ton gestionnaire de paquet, ce qui rendra la commande accessible directement depuis le terminal.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ apt install git # Debian, Ubuntu et les distros basées dessus
|
||||
$ yum install git # CentOS
|
||||
$ dnf -y install git # Fedora
|
||||
$ pacman -S git # ArchLinux et les distros basées dessus
|
||||
$ emerge --ask --verbose dec-vcs/git # >install Gentoo
|
||||
</pre>
|
||||
</div>
|
||||
<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 :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ pkg install git # FreeBSD
|
||||
$ brew install git # macOS avec brew
|
||||
$ port install git +svn +doc +bash_completion +gitweb # macOS avec MacPorts
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Si tu es sous Windows… Bonne chance. Toutes les commandes seront en syntaxe Unix dans ce tutoriel, mais si tu as bien deux neurones, tu devrais pouvoir tout de même suivre le tutoriel.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgd3f885f" class="outline-3">
|
||||
<h3 id="orgd3f885f"><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">
|
||||
<p>
|
||||
Tu peux configurer Git si tu le souhaites, oui. En général, il est recommandé de paramétrer au moins son nom et son email. Tu peux les paramétrer via la ligne de commande :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git config --global user.name "Ton Nom"
|
||||
$ git config --global user.email "ton@email.truc"
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Tu peux aussi éditer le fichier <code>~/.gitconfig</code> comme suit :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">[user]
|
||||
email = ton@email.truc
|
||||
name = Ton nom
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Cela permettra d’associer ton nom et ton adresse mail à tes commits. Par défaut, ceux qui sont enregistrés avec ton compte utilisateur de ton PC sont mis par défaut dans ces paramètres, mais on met quasiment tous un nom à la con quand on le créé. Et ça permet d’avoir les même paramètres si tu es sur un autre ordinateur.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Il y a encore pas mal de paramètres que tu peux gérer avec ce fichier, je reparlerai de certains plus tard, mais pour le reste, la documentation en ligne sur <code>gitconfig</code> ne manque pas.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org3b01d46" class="outline-2">
|
||||
<h2 id="org3b01d46"><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 :
|
||||
</p>
|
||||
<blockquote>
|
||||
<p>
|
||||
Celui qui marche trop vite…… marche…………… trop… vite…? Tu peux tomber et te faire mal je suppose.
|
||||
</p>
|
||||
</blockquote>
|
||||
<p>
|
||||
Bon, c’est une contrefaçon, donc la qualité de la citation n’est pas extraordinaire. Bref.
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-orga446891" class="outline-3">
|
||||
<h3 id="orga446891"><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>.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ mkdir monsuperprojet
|
||||
$ cd monsuperprojet
|
||||
$ git init
|
||||
Initialized empty Git repository in /tmp/monsuperprojet/.git/
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Si tu obtiens à peu près le même message après la dernière commande, félicitations ! Tu viens de créer ton premier dépôt git. En l’occurence, j’ai créé mon dépôt dans <code>/tmp</code>, mais toi tu peux voir un truc du genre <code>/home/corentin/monsuperprojet</code> à la place. Tu peux vérifier que tout va bien en rentrant la commande <code>git status</code>
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git status
|
||||
On branch master
|
||||
|
||||
No commits yet
|
||||
|
||||
nothing to commit (create/copy files and use "git add" to track)
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Parfait !
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgaf9966d" class="outline-3">
|
||||
<h3 id="orgaf9966d"><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 d’abord, on va voir ce qu’il 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 :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-C"><span style="color: #AF6F55;">#include</span> <span style="color: #e2c6ac;"><</span><span style="color: #7A5343;">stdio.h</span><span style="color: #e2c6ac;">></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>
|
||||
printf<span style="color: #8D5039;">(</span><span style="color: #7A5343;">"Hello World!\n"</span><span style="color: #8D5039;">)</span>;
|
||||
<span style="color: #975D4A; font-weight: bold;">return</span> <span style="color: #8D5039;">0</span>;
|
||||
<span style="color: #e2c6ac;">}</span>
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
En exécutant à nouveau <code>git status</code>, on peut voir la sortie suivante :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git status
|
||||
On branch master
|
||||
|
||||
No commits yet
|
||||
|
||||
Untracked files:
|
||||
(use "git add <file>..." to include in what will be committed)
|
||||
|
||||
main.c
|
||||
|
||||
nothing added to commit but untracked files present (use "git add" to track)
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Tu commences à comprendre un peu le bail ? Git vient de détecter qu’un nouveau fichier a été créé qu’il ne connaissait pas avant. Suivons ses bon conseils et ajoutons le fichier au dépôt.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git add main.c
|
||||
$ git status
|
||||
On branch master
|
||||
|
||||
No commits yet
|
||||
|
||||
Changes to be committed:
|
||||
(use "git rm --cached <file>..." to unstage)
|
||||
|
||||
new file: main.c
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Super, maintenant git va surveiller les changements du fichier, mais attention, il n’a pas encore enregistré son état. Pour l’instant il sait juste que le fichier est là, dans un certain état, mais rien ne garanti encore qu’on pourra retrouver cet état plus tard. On appelle ça le <i>staging</i>. Pour ce faire, il faut créer ce qu’on appelle un commit. En gros, il s’agit d’un enregistrement des modifications apportées à un ou plusieurs fichers (dans leur globalité ou partiellement, on verra ça plus tard), le tout avec un commentaire.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git commit -m "Un petit pas pour moi, un grand pas pour mon projet"
|
||||
[master (root-commit) 89139ef] Un petit pas pour moi, un grand pas pour mon projet
|
||||
1 file changed, 6 insertions(+)
|
||||
create mode 100644 main.c
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Parfait ! Certains éléments peuvent être un peu différent chez toi, comme par exemple la référence du commit juste avant le message. Ça, 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.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org4d067d2" class="outline-3">
|
||||
<h3 id="org4d067d2"><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">
|
||||
<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> :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-C"><span style="color: #AF6F55;">#include</span> <span style="color: #e2c6ac;"><</span><span style="color: #7A5343;">stdio.h</span><span style="color: #e2c6ac;">></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>
|
||||
printf<span style="color: #8D5039;">(</span><span style="color: #7A5343;">"Hello World!\n"</span><span style="color: #8D5039;">)</span>;
|
||||
<span style="color: #975D4A; font-weight: bold;">return</span> <span style="color: #8D5039;">0</span>;
|
||||
<span style="color: #e2c6ac;">}</span>
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Je peux annuler tout ça via ces commandes :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git reset HEAD main.c
|
||||
Unstaged changes after reset:
|
||||
M main.c
|
||||
$ git checkout -- main.c
|
||||
$ git status
|
||||
On branch master
|
||||
nothing to commit, working tree clean
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Si je fait un <code>cat</code> du fichier, je vois qu’il est revenu à son état initial.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orga03d27e" class="outline-3">
|
||||
<h3 id="orga03d27e"><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">
|
||||
<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é.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git add main.c # J’ai refait les modifications annulées plus tôt
|
||||
$ git commit -m "second commit"
|
||||
[master 97f698a] second commit
|
||||
1 file changed, 1 insertion(+), 1 deletion(-)
|
||||
$ echo "C’est un super projet !" > projet.txt
|
||||
$ git add projet.txt
|
||||
$ git commit --amend -m "second commit + oubli"
|
||||
[master 9aff4c0] second commit + oubli
|
||||
Date: Fri Oct 5 11:10:56 2018 +0200
|
||||
2 files changed, 2 insertions(+), 1 deletion(-)
|
||||
create mode 100644 projet.txt
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
En gros, le commit que tu viens de faire a remplacé le précédent en conservant les informations du commit précédent, mis à part son commentaire. Si tu ne met pas l’option <code>-m "ton texte"</code> lors de l’amendement du commit, ton éditeur texte par défaut va s’ouvrir pour que tu puisses modifier le texte du commit précédent si tu le souhaite. Si jamais vi ou vim s’ouvre et que tu n’as aucune idée de comment sortir de cet enfant du démon, tu as juste à appuyer sur la touche Échap (au cas où), puis à taper <code>:wq</code> (<code>w</code> pour écrire le fichier, <code>q</code> pour quitter), puis tu appuye sur la touche Entrée. Si tu as Nano qui s’est ouvert, alors il faut taper Ctrl-X.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org5c917f7" class="outline-2">
|
||||
<h2 id="org5c917f7"><span class="section-number-2">4</span> Euh, j’ai oublié ce que j’ai 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 d’un certain fichier, tu peux ajouter le nom de ton fichier à la fin de la commande.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ echo "C’est un super projet !" > projet.txt
|
||||
$ git diff
|
||||
diff --git a/projet.txt b/projet.txt
|
||||
index 03b0f20..b93413f 100644
|
||||
--- a/projet.txt
|
||||
+++ b/projet.txt
|
||||
@@ -1 +1 @@
|
||||
-projet
|
||||
+C’est un super projet !
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Tu peux également voir les différences de fichiers entre deux commits en entrant leur référence. Pour avoir la référence, tu peux rentrer la commande <code>git log</code> pour avoir un petit historique des commits.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git log
|
||||
commit 4380d8717261644b81a1858920406645cf409028 (HEAD -> master)
|
||||
Author: Phuntsok Drak-pa <a href="mailto:phundrak%40phundrak.fr"><phundrak@phundrak.fr></a>
|
||||
Date: Fri Oct 5 11:59:40 2018 +0200
|
||||
|
||||
new commit
|
||||
|
||||
commit 59c21c6aa7e3ec7edd229f81b87becbc7ec13596
|
||||
Author: Phuntsok Drak-pa <a href="mailto:phundrak%40phundrak.fr"><phundrak@phundrak.fr></a>
|
||||
Date: Fri Oct 5 11:10:56 2018 +0200
|
||||
|
||||
nouveau texte
|
||||
|
||||
commit 89139ef233d07a64d3025de47f8b6e8ce7470318
|
||||
Author: Phuntsok Drak-pa <a href="mailto:phundrak%40phundrak.fr"><phundrak@phundrak.fr></a>
|
||||
Date: Fri Oct 5 10:56:58 2018 +0200
|
||||
|
||||
Un petit pas pour moi, un grand pas pour mon projet
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Bon, c’est un peu long et un peu trop d’infos d’un coup, généralement je préfère taper <code>git log --oneline --graph --decorate</code> afin d’avoir un affichage comme suit :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git log --oneline --graph --decorate
|
||||
* 4380d87 (HEAD -> master) new commit
|
||||
* 59c21c6 nouveau texte
|
||||
* 89139ef Un petit pas pour moi, un grand pas pour mon projet
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Plus propre, non ? Et les références sont plus courtes, ce qui est plus agréable à taper. Allez, comparons les deux derniers commits.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git add .
|
||||
$ git commit -m "new commit"
|
||||
$ git log --oneline --graph --decorate
|
||||
* 4380d87 (HEAD -> master) new commit
|
||||
* 59c21c6 nouveau texte
|
||||
* 89139ef Un petit pas pour moi, un grand pas pour mon projet
|
||||
$ git diff 59c21c6 4380d87
|
||||
diff --git a/projet.txt b/projet.txt
|
||||
index 03b0f20..b93413f 100644
|
||||
--- a/projet.txt
|
||||
+++ b/projet.txt
|
||||
@@ -1 +1 @@
|
||||
-projet
|
||||
+C’est un super projet !
|
||||
</pre>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="outline-container-org35ba9ee" class="outline-2">
|
||||
<h2 id="org35ba9ee"><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 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 :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">*.out
|
||||
*.exe
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Maintenant, si tu créés un fichier en <code>.out</code> ou <code>.exe</code>, il sera complètement ignoré par git et ne sera pas stocké dans l’historique des versions.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="outline-container-orgccda07e" class="outline-2">
|
||||
<h2 id="orgccda07e"><span class="section-number-2">6</span> J’ai 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 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>
|
||||
</div>
|
||||
|
||||
<div id="outline-container-orgde64bff" class="outline-3">
|
||||
<h3 id="orgde64bff"><span class="section-number-3">6.1</span> J’ai 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, 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 :
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git clone https://github.com/Phundrak/chat-reseau-P8.git
|
||||
Cloning into 'chat-reseau-P8'...
|
||||
remote: Enumerating objects: 345, done.
|
||||
remote: Total 345 (delta 0), reused 0 (delta 0), pack-reused 345
|
||||
Receiving objects: 100% (345/345), 63.91 KiB | 39.00 KiB/s, done.
|
||||
Resolving deltas: 100% (107/107), done.
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Et c’est bon, tu as accès au répertoire <code>chat-reseau-P8</code> et au code source du projet.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="outline-container-org1e85cba" class="outline-3">
|
||||
<h3 id="org1e85cba"><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à, c’est 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 l’occurence 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.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Et là, magie ! GitHub indique comment ajouter le dépôt distant à ton dépôt local.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git remote add origin https://github.com/Phundrak/temporary-repo.git
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Et voilà, ton dépôt est lié au dépôt distant. Oui, juste comme ça.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="outline-container-org7eaca37" class="outline-3">
|
||||
<h3 id="org7eaca37"><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 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 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.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git push -u origin master
|
||||
Username for 'https://github.com': phundrak
|
||||
Password for 'https://phundrak@github.com':
|
||||
Enumerating objects: 10, done.
|
||||
Counting objects: 100% (10/10), done.
|
||||
Delta compression using up to 8 threads
|
||||
Compressing objects: 100% (7/7), done.
|
||||
Writing objects: 100% (10/10), 940 bytes | 313.00 KiB/s, done.
|
||||
Total 10 (delta 0), reused 0 (delta 0)
|
||||
remote:
|
||||
remote: Create a pull request for 'master' on GitHub by visiting:
|
||||
remote: https://github.com/Phundrak/temporary-repo/pull/new/master
|
||||
remote:
|
||||
To https://github.com/Phundrak/temporary-repo.git
|
||||
* [new branch] master -> master
|
||||
Branch 'master' set up to track remote branch 'master' from 'origin'.
|
||||
</pre>
|
||||
</div>
|
||||
<p>
|
||||
Bon, là en nom d’utilisateur y’a le mien, faudra remplacer avec le tiens. Et ouais, ma vitesse de mise en ligne n’est pas fameuse, je suis sur une connexion 3G+ à l’heure où j’écris ces lignes, ne me juge pas. Bref, toujours est-il que je viens de mettre en ligne les fichiers du dépôt sur GitHub. Pas la peine de chercher le mien sur GitHub par contre, ça fera un bail que je l’aurai supprimé au moment où tu liras ces lignes.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div id="outline-container-org9c233f0" class="outline-3">
|
||||
<h3 id="org9c233f0"><span class="section-number-3">6.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-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 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>.
|
||||
</p>
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-text">$ git pull
|
||||
remote: Enumerating objects: 4, done.
|
||||
remote: Counting objects: 100% (4/4), done.
|
||||
remote: Compressing objects: 100% (3/3), done.
|
||||
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
|
||||
Unpacking objects: 100% (3/3), done.
|
||||
From https://github.com/Phundrak/temporary-repo
|
||||
4380d87..8bd4896 master -> origin/master
|
||||
Updating 4380d87..8bd4896
|
||||
Fast-forward
|
||||
README.md | 2 ++
|
||||
1 file changed, 2 insertions(+)
|
||||
create mode 100644 README.md
|
||||
</pre>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="postamble" class="status">
|
||||
<p class="author">Auteur: Lucien Cartier-Tilet</p>
|
||||
<p class="date">Created: 2018-10-05 ven. 13:59</p>
|
||||
<p class="validation"></p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
278
tutoriel-git.org
Normal file
278
tutoriel-git.org
Normal file
@ -0,0 +1,278 @@
|
||||
#+INCLUDE: "headers.org"
|
||||
#+TITLE: Tutoriel Git et GitHub
|
||||
|
||||
#+begin_src org :exports (when (eq org-export-current-backend 'xelatex) "none")
|
||||
Et 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://phundrak.fr/git/tutoriel-git.org][là]], [[https://phundrak.fr/git/theme-readtheorg.setup][là]] et [[https://phundrak.fr/git/headers.org][là]].
|
||||
#+end_src
|
||||
* 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.
|
||||
* Ça a l’air cool, comment ça s’utilise ?
|
||||
** Et surtout, comment ça s’installe ?
|
||||
Très bonne question Kevin. Tout d’abord, il faut t’assurer que git soit installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux, tu peux l’installer via ton gestionnaire de paquet, ce qui rendra la commande accessible directement depuis le terminal.
|
||||
#+BEGIN_SRC text
|
||||
$ apt install git # Debian, Ubuntu et les distros basées dessus
|
||||
$ yum install git # CentOS
|
||||
$ dnf -y install git # Fedora
|
||||
$ pacman -S git # ArchLinux et les distros basées dessus
|
||||
$ emerge --ask --verbose dec-vcs/git # >install Gentoo
|
||||
#+END_SRC
|
||||
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
|
||||
$ pkg install git # FreeBSD
|
||||
$ brew install git # macOS avec brew
|
||||
$ port install git +svn +doc +bash_completion +gitweb # macOS avec MacPorts
|
||||
#+END_SRC
|
||||
Si tu es sous Windows... Bonne chance. Toutes les commandes seront en syntaxe Unix dans ce tutoriel, mais si tu as bien deux neurones, tu devrais pouvoir tout de même suivre le tutoriel.
|
||||
** Ok 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 :
|
||||
#+BEGIN_SRC text
|
||||
$ git config --global user.name "Ton Nom"
|
||||
$ git config --global user.email "ton@email.truc"
|
||||
#+END_SRC
|
||||
Tu peux aussi éditer le fichier =~/.gitconfig= comme suit :
|
||||
#+BEGIN_SRC text
|
||||
[user]
|
||||
email = ton@email.truc
|
||||
name = Ton nom
|
||||
#+END_SRC
|
||||
Cela permettra d’associer ton nom et ton adresse mail à tes commits. Par défaut, ceux qui sont enregistrés avec ton compte utilisateur de ton PC sont mis par défaut dans ces paramètres, mais on met quasiment tous un nom à la con quand on le créé. Et ça permet d’avoir les même paramètres si tu es sur un autre ordinateur.
|
||||
|
||||
Il y a encore pas mal de paramètres que tu peux gérer avec ce fichier, je reparlerai de certains plus tard, mais pour le reste, la documentation en ligne sur =gitconfig= ne manque pas.
|
||||
* Ok très bien, mais je veux utiliser git moi !
|
||||
Du calme Jean-Kévin, ralentis un peu. Comme le dit ce vieux dicton Chinois :
|
||||
#+BEGIN_QUOTE
|
||||
Celui qui marche trop vite…… marche…………… trop… vite…? Tu peux tomber et te faire mal je suppose.
|
||||
#+END_QUOTE
|
||||
Bon, c’est une contrefaçon, donc la qualité de la citation n’est pas extraordinaire. Bref.
|
||||
** Je commmence comment ?
|
||||
Si tu souhaites créer un dépôt git, rien de plus simple : créé ton répertoire dans lequel tu travailleras, et déplace-y-toi. Ensuite, tu pourra initialiser ton dépôt via la commande =git init=.
|
||||
#+BEGIN_SRC text
|
||||
$ mkdir monsuperprojet
|
||||
$ cd monsuperprojet
|
||||
$ git init
|
||||
Initialized empty Git repository in /tmp/monsuperprojet/.git/
|
||||
#+END_SRC
|
||||
Si tu obtiens à peu près le même message après la dernière commande, félicitations ! Tu viens de créer ton premier dépôt git. En l’occurence, j’ai créé mon dépôt dans =/tmp=, mais toi tu peux voir un truc du genre =/home/corentin/monsuperprojet= à la place. Tu peux vérifier que tout va bien en rentrant la commande =git status=
|
||||
#+BEGIN_SRC text
|
||||
$ git status
|
||||
On branch master
|
||||
|
||||
No commits yet
|
||||
|
||||
nothing to commit (create/copy files and use "git add" to track)
|
||||
#+END_SRC
|
||||
Parfait !
|
||||
** Et pour ajouter des fichiers ?
|
||||
Maintenant tu peux commencer à travailler sur ton projet. Mais tout d’abord, on va voir ce qu’il se passe si jamais on créé un fichier dans le dépot. Créé un fichier =main.c= dans lequel tu vas entrer ce code :
|
||||
#+BEGIN_SRC C
|
||||
#include <stdio.h>
|
||||
|
||||
int main(int argc, char *argv[]) {
|
||||
printf("Hello World!\n");
|
||||
return 0;
|
||||
}
|
||||
#+END_SRC
|
||||
En exécutant à nouveau =git status=, on peut voir la sortie suivante :
|
||||
#+BEGIN_SRC text
|
||||
$ git status
|
||||
On branch master
|
||||
|
||||
No commits yet
|
||||
|
||||
Untracked files:
|
||||
(use "git add <file>..." to include in what will be committed)
|
||||
|
||||
main.c
|
||||
|
||||
nothing added to commit but untracked files present (use "git add" to track)
|
||||
#+END_SRC
|
||||
Tu commences à comprendre un peu le bail ? Git vient de détecter qu’un nouveau fichier a été créé qu’il ne connaissait pas avant. Suivons ses bon conseils et ajoutons le fichier au dépôt.
|
||||
#+BEGIN_SRC text
|
||||
$ git add main.c
|
||||
$ git status
|
||||
On branch master
|
||||
|
||||
No commits yet
|
||||
|
||||
Changes to be committed:
|
||||
(use "git rm --cached <file>..." to unstage)
|
||||
|
||||
new file: main.c
|
||||
#+END_SRC
|
||||
Super, maintenant git va surveiller les changements du fichier, mais attention, il n’a pas encore enregistré son état. Pour l’instant il sait juste que le fichier est là, dans un certain état, mais rien ne garanti encore qu’on pourra retrouver cet état plus tard. On appelle ça le /staging/. Pour ce faire, il faut créer ce qu’on appelle un commit. En gros, il s’agit d’un enregistrement des modifications apportées à un ou plusieurs fichers (dans leur globalité ou partiellement, on verra ça plus tard), le tout avec un commentaire.
|
||||
#+BEGIN_SRC text
|
||||
$ git commit -m "Un petit pas pour moi, un grand pas pour mon projet"
|
||||
[master (root-commit) 89139ef] Un petit pas pour moi, un grand pas pour mon projet
|
||||
1 file changed, 6 insertions(+)
|
||||
create mode 100644 main.c
|
||||
#+END_SRC
|
||||
Parfait ! Certains éléments peuvent être un peu différent chez toi, comme par exemple la référence du commit juste avant le message. Ça, 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()= :
|
||||
#+BEGIN_SRC C
|
||||
#include <stdio.h>
|
||||
|
||||
int main(void) {
|
||||
printf("Hello World!\n");
|
||||
return 0;
|
||||
}
|
||||
#+END_SRC
|
||||
Je peux annuler tout ça via ces commandes :
|
||||
#+BEGIN_SRC text
|
||||
$ git reset HEAD main.c
|
||||
Unstaged changes after reset:
|
||||
M main.c
|
||||
$ git checkout -- main.c
|
||||
$ git status
|
||||
On branch master
|
||||
nothing to commit, working tree clean
|
||||
#+END_SRC
|
||||
Si je fait un =cat= du fichier, je vois qu’il est revenu à son état initial.
|
||||
** 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é.
|
||||
#+BEGIN_SRC text
|
||||
$ git add main.c # J’ai refait les modifications annulées plus tôt
|
||||
$ git commit -m "second commit"
|
||||
[master 97f698a] second commit
|
||||
1 file changed, 1 insertion(+), 1 deletion(-)
|
||||
$ echo "C’est un super projet !" > projet.txt
|
||||
$ git add projet.txt
|
||||
$ git commit --amend -m "second commit + oubli"
|
||||
[master 9aff4c0] second commit + oubli
|
||||
Date: Fri Oct 5 11:10:56 2018 +0200
|
||||
2 files changed, 2 insertions(+), 1 deletion(-)
|
||||
create mode 100644 projet.txt
|
||||
#+END_SRC
|
||||
En gros, le commit que tu viens de faire a remplacé le précédent en conservant les informations du commit précédent, mis à part son commentaire. Si tu ne met pas l’option =-m "ton texte"= lors de l’amendement du commit, ton éditeur texte par défaut va s’ouvrir pour que tu puisses modifier le texte du commit précédent si tu le souhaite. Si jamais vi ou vim s’ouvre et que tu n’as aucune idée de comment sortir de cet enfant du démon, tu as juste à appuyer sur la touche Échap (au cas où), puis à taper =:wq= (=w= pour écrire le fichier, =q= pour quitter), puis tu appuye sur la touche Entrée. Si tu as Nano qui s’est ouvert, alors il faut taper Ctrl-X.
|
||||
* 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.
|
||||
#+BEGIN_SRC text
|
||||
$ echo "C’est un super projet !" > projet.txt
|
||||
$ git diff
|
||||
diff --git a/projet.txt b/projet.txt
|
||||
index 03b0f20..b93413f 100644
|
||||
--- a/projet.txt
|
||||
+++ b/projet.txt
|
||||
@@ -1 +1 @@
|
||||
-projet
|
||||
+C’est un super projet !
|
||||
#+END_SRC
|
||||
Tu peux également voir les différences de fichiers entre deux commits en entrant leur référence. Pour avoir la référence, tu peux rentrer la commande =git log= pour avoir un petit historique des commits.
|
||||
#+BEGIN_SRC text
|
||||
$ git log
|
||||
commit 4380d8717261644b81a1858920406645cf409028 (HEAD -> master)
|
||||
Author: Phuntsok Drak-pa <phundrak@phundrak.fr>
|
||||
Date: Fri Oct 5 11:59:40 2018 +0200
|
||||
|
||||
new commit
|
||||
|
||||
commit 59c21c6aa7e3ec7edd229f81b87becbc7ec13596
|
||||
Author: Phuntsok Drak-pa <phundrak@phundrak.fr>
|
||||
Date: Fri Oct 5 11:10:56 2018 +0200
|
||||
|
||||
nouveau texte
|
||||
|
||||
commit 89139ef233d07a64d3025de47f8b6e8ce7470318
|
||||
Author: Phuntsok Drak-pa <phundrak@phundrak.fr>
|
||||
Date: Fri Oct 5 10:56:58 2018 +0200
|
||||
|
||||
Un petit pas pour moi, un grand pas pour mon projet
|
||||
#+END_SRC
|
||||
Bon, c’est un peu long et un peu trop d’infos d’un coup, généralement je préfère taper =git log --oneline --graph --decorate= afin d’avoir un affichage comme suit :
|
||||
#+BEGIN_SRC text
|
||||
$ git log --oneline --graph --decorate
|
||||
,* 4380d87 (HEAD -> master) new commit
|
||||
,* 59c21c6 nouveau texte
|
||||
,* 89139ef Un petit pas pour moi, un grand pas pour mon projet
|
||||
#+END_SRC
|
||||
Plus propre, non ? Et les références sont plus courtes, ce qui est plus agréable à taper. Allez, comparons les deux derniers commits.
|
||||
#+BEGIN_SRC text
|
||||
$ git add .
|
||||
$ git commit -m "new commit"
|
||||
$ git log --oneline --graph --decorate
|
||||
,* 4380d87 (HEAD -> master) new commit
|
||||
,* 59c21c6 nouveau texte
|
||||
,* 89139ef Un petit pas pour moi, un grand pas pour mon projet
|
||||
$ git diff 59c21c6 4380d87
|
||||
diff --git a/projet.txt b/projet.txt
|
||||
index 03b0f20..b93413f 100644
|
||||
--- a/projet.txt
|
||||
+++ b/projet.txt
|
||||
@@ -1 +1 @@
|
||||
-projet
|
||||
+C’est un super projet !
|
||||
#+END_SRC
|
||||
|
||||
* Il y a des fichiers dont je me fiche dans mon dépot
|
||||
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 :
|
||||
#+BEGIN_SRC text
|
||||
,*.out
|
||||
,*.exe
|
||||
#+END_SRC
|
||||
Maintenant, si tu créés un fichier en =.out= ou =.exe=, il sera complètement ignoré par git et ne sera pas stocké dans l’historique des versions.
|
||||
|
||||
* 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.
|
||||
|
||||
** 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 :
|
||||
#+BEGIN_SRC text
|
||||
$ git clone https://github.com/Phundrak/chat-reseau-P8.git
|
||||
Cloning into 'chat-reseau-P8'...
|
||||
remote: Enumerating objects: 345, done.
|
||||
remote: Total 345 (delta 0), reused 0 (delta 0), pack-reused 345
|
||||
Receiving objects: 100% (345/345), 63.91 KiB | 39.00 KiB/s, done.
|
||||
Resolving deltas: 100% (107/107), done.
|
||||
#+END_SRC
|
||||
Et c’est 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à, c’est 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 l’occurence je le nomme =temporary-repo= car je vais le supprimer cinq minutes après l’écriture de ces lignes), et tu cliques sur =Create Repository=. Tu n’ajoutes rien avant, pas de description, pas de =.gitignore=, RIEN.
|
||||
|
||||
Et là, magie ! GitHub indique comment ajouter le dépôt distant à ton dépôt local.
|
||||
#+BEGIN_SRC text
|
||||
$ git remote add origin https://github.com/Phundrak/temporary-repo.git
|
||||
#+END_SRC
|
||||
Et voilà, ton dépôt est lié au dépôt distant. Oui, juste comme ça.
|
||||
|
||||
** Et du coup, comment je met tout ça en ligne ?
|
||||
Bon ok, ce n’est pas aussi simple que ça. Une fois que tu as lié ton dépôt au dépôt distant, il faudra que tu mettes en ligne tes commits quand tu en auras l’occasion. Pour ce faire, tu n’as qu’à taper =git push= ; et la première fois, il faudra que tu indiques à ton dépôt où mettre en ligen précisément dans le dépôt distant, auquel cas tu ajoutes =-u origin master= pour cette première fois. Git te demandera donc tes identifiants GitHub pour pouvoir mettre tout ça en ligne.
|
||||
#+BEGIN_SRC text
|
||||
$ git push -u origin master
|
||||
Username for 'https://github.com': phundrak
|
||||
Password for 'https://phundrak@github.com':
|
||||
Enumerating objects: 10, done.
|
||||
Counting objects: 100% (10/10), done.
|
||||
Delta compression using up to 8 threads
|
||||
Compressing objects: 100% (7/7), done.
|
||||
Writing objects: 100% (10/10), 940 bytes | 313.00 KiB/s, done.
|
||||
Total 10 (delta 0), reused 0 (delta 0)
|
||||
remote:
|
||||
remote: Create a pull request for 'master' on GitHub by visiting:
|
||||
remote: https://github.com/Phundrak/temporary-repo/pull/new/master
|
||||
remote:
|
||||
To https://github.com/Phundrak/temporary-repo.git
|
||||
,* [new branch] master -> master
|
||||
Branch 'master' set up to track remote branch 'master' from 'origin'.
|
||||
#+END_SRC
|
||||
Bon, là en nom d’utilisateur y’a le mien, faudra remplacer avec le tiens. Et ouais, ma vitesse de mise en ligne n’est pas fameuse, je suis sur une connexion 3G+ à l’heure où j’écris ces lignes, ne me juge pas. Bref, toujours est-il que je viens de mettre en ligne les fichiers du dépôt sur GitHub. Pas la peine de chercher le mien sur GitHub par contre, ça fera un bail que je l’aurai supprimé au moment où tu liras ces lignes.
|
||||
|
||||
** 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 apparaitra formatté sur la page du dépôt sur GitHub s’il est au format =.md= (Markdown) ou =.org= (org-mode, le Markdown d’Emacs avec lequel est écrit ce tutoriel). Mais il n’est pas présent dans mon dépôt local, du coup je vais devoir le récupérer. On va donc entrer =git pull=.
|
||||
#+BEGIN_SRC text
|
||||
$ git pull
|
||||
remote: Enumerating objects: 4, done.
|
||||
remote: Counting objects: 100% (4/4), done.
|
||||
remote: Compressing objects: 100% (3/3), done.
|
||||
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
|
||||
Unpacking objects: 100% (3/3), done.
|
||||
From https://github.com/Phundrak/temporary-repo
|
||||
4380d87..8bd4896 master -> origin/master
|
||||
Updating 4380d87..8bd4896
|
||||
Fast-forward
|
||||
README.md | 2 ++
|
||||
1 file changed, 2 insertions(+)
|
||||
create mode 100644 README.md
|
||||
#+END_SRC
|
||||
BIN
tutoriel-git.pdf
Normal file
BIN
tutoriel-git.pdf
Normal file
Binary file not shown.
Loading…
Reference in New Issue
Block a user