|
| 1 | +<!DOCTYPE html> |
| 2 | +<html lang="en"> |
| 3 | +<head> |
| 4 | + <meta charset="utf-8"> |
| 5 | + <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> |
| 6 | + <title>git - petit guide - no deep shit!</title> |
| 7 | + <link href='http://fonts.googleapis.com/css?family=Chelsea+Market' rel='stylesheet' type='text/css'> |
| 8 | + <link rel="stylesheet" href="css/normalize.css" type="text/css"> |
| 9 | + <link rel="stylesheet" href="css/style.css" type="text/css"> |
| 10 | + <script type="text/javascript"> |
| 11 | + var _gaq = _gaq || []; |
| 12 | + _gaq.push(['_setAccount', 'UA-652147-13']); |
| 13 | + _gaq.push(['_trackPageview']); |
| 14 | + |
| 15 | + (function() { |
| 16 | + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; |
| 17 | + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; |
| 18 | + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); |
| 19 | + })(); |
| 20 | + </script> |
| 21 | +</head> |
| 22 | +<body> |
| 23 | + <div class="scrollblock block-title"> |
| 24 | + <h1>git - petit guide</h1> |
| 25 | + <p>juste un petit guide pour bien démarrer avec git. <!-- UNTRANSLATED -->no deep shit ;)</p> |
| 26 | + <a href="https://twitter.com/share" class="twitter-share-button" data-via="rogerdudler" data-size="large" data-related="rogerdudler" data-hashtags="git">Tweet</a> |
| 27 | + <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> |
| 28 | + <p class="meta"> |
| 29 | + par <a href="http://www.rogerdudler.com">Roger Dudler</a> |
| 30 | + <br />Remerciements à <a href="http://www.twitter.com/tfnico">@tfnico</a> et <a href="http://www.twitter.com/fhd">@fhd</a> |
| 31 | + </p> |
| 32 | + <img src="img/arrow.png" alt="" /> |
| 33 | + </div> |
| 34 | + <!-- setup --> |
| 35 | + <a name="setup"></a> |
| 36 | + <div class="scrollblock block-setup"> |
| 37 | + <h2>installation</h2> |
| 38 | + <p> |
| 39 | + <a href="http://code.google.com/p/git-osx-installer/downloads/list?can=3">Télécharger git pour Mac OSX</a> |
| 40 | + </p> |
| 41 | + <p> |
| 42 | + <a href="http://code.google.com/p/msysgit/downloads/list?can=3">Télécharger git pour Windows</a> |
| 43 | + </p> |
| 44 | + </div> |
| 45 | + <a name="create"></a> |
| 46 | + <div class="scrollblock block-create"> |
| 47 | + <h2>créer un nouveau dépôt</h2> |
| 48 | + <p> |
| 49 | + créez un nouveau dossier, ouvrez le et exécutez la commande<br /> |
| 50 | + <code>git init</code><br /> |
| 51 | + pour créer un nouveau dépôt. |
| 52 | + </p> |
| 53 | + </div> |
| 54 | + <a name="checkout"></a> |
| 55 | + <div class="scrollblock block-checkout"> |
| 56 | + <h2>cloner un dépôt</h2> |
| 57 | + <p> |
| 58 | + créez une copie de votre dépôt local en exécutant la commande<br /> |
| 59 | + <code>git clone /path/to/repository</code><br /> |
| 60 | + si vous utilisez un serveur distant, cette commande sera<br /> |
| 61 | + <code>git clone username@host:/path/to/repository</code> |
| 62 | + </p> |
| 63 | + </div> |
| 64 | + <a name="trees"></a> |
| 65 | + <div class="scrollblock block-trees"> |
| 66 | + <h2>arbres</h2> |
| 67 | + <p> |
| 68 | + votre dépôt local est composé de trois "arbres" gérés par git. |
| 69 | + le premier est votre <code>espace de travail</code> qui contient vos fichiers actuels. |
| 70 | + le second est un <code>Index</code> qui joue un rôle d'espace de transit pour vos fichiers et |
| 71 | + enfin <code>HEAD</code> qui pointe vers la dernière validation que vous ayez fait. |
| 72 | + </p> |
| 73 | + <img src="img/trees.png" alt="" /> |
| 74 | + </div> |
| 75 | + <a name="add"></a> |
| 76 | + <div class="scrollblock block-add"> |
| 77 | + <h2>ajouter & valider</h2> |
| 78 | + <p> |
| 79 | + Vous pouvez proposer un changement (l'ajouter à l'<b>Index</b>) en exécutant les commandes<br /> |
| 80 | + <code>git add <filename></code><br /> |
| 81 | + <code>git add *</code><br /> |
| 82 | + C'est la première étape dans un workflow git basique. Pour valider ces changements, utilisez<br /> |
| 83 | + <code>git commit -m "Message de commit"</code><br /> |
| 84 | + Le fichier est donc ajouté au <b>HEAD</b>, mais pas encore dans votre dépôt distant. |
| 85 | + </p> |
| 86 | + </div> |
| 87 | + <a name="push"></a> |
| 88 | + <div class="scrollblock block-remote"> |
| 89 | + <h2>envoyer des changements</h2> |
| 90 | + <p> |
| 91 | + Vos changements sont maintenant dans le <b>HEAD</b> de la copie de votre dépôt local. Pour les envoyer à votre dépôt distant, exécutez la commande<br /> |
| 92 | + <code>git push origin master</code><br /> |
| 93 | + Remplacez <i>master</i> par la branche dans laquelle vous souhaitez envoyer vos changements. |
| 94 | + <br /><br /> |
| 95 | + Si vous n'avez pas cloné votre dépôt existant et voulez le connecter à votre dépôt sur un serveur distant, vous devez l'ajouter avec<br /> |
| 96 | + <code>git remote add origin <server></code><br /> |
| 97 | + Maintenant, vous pouvez envoyer vos changements vers le serveur distant sélectionné<br /> |
| 98 | + |
| 99 | + </p> |
| 100 | + </div> |
| 101 | + <a name="branching"></a> |
| 102 | + <div class="scrollblock block-branching"> |
| 103 | + <h2>branches</h2> |
| 104 | + <p> |
| 105 | + Les branches sont utilisées pour développer des fonctionnalités isolées des autres. |
| 106 | + La branche <i>master</i> est la branche par défaut quand vous créez un dépôt. |
| 107 | + Utilisez les autres branches pour le développement et fusionnez ensuite à la branche principale quand vous avez fini. |
| 108 | + </p> |
| 109 | + <img src="img/branches.png" alt="" /> |
| 110 | + <p> |
| 111 | + créer une nouvelle branche nommée "feature_x" et <!-- BAD TRANSLATE -->passer dessus pour l'utiliser<br /> |
| 112 | + <code>git checkout -b feature_x</code><br /> |
| 113 | + retourner sur la branche principale<br /> |
| 114 | + <code>git checkout master</code><br /> |
| 115 | + et supprimer la branche<br /> |
| 116 | + <code>git branch -d feature_x</code><br /> |
| 117 | + une branche n'est <i>pas disponible pour les autres</i> tant que vous ne l'aurez pas envoyée vers votre dépôt distant<br /> |
| 118 | + <code>git push origin <branch></code> |
| 119 | + </p> |
| 120 | + </div> |
| 121 | + <a name="update"></a> |
| 122 | + <div class="scrollblock block-merging"> |
| 123 | + <h2>mettre à jour & fusionner</h2> |
| 124 | + <p> |
| 125 | + pour mettre à jour votre dépôt local vers les dernières validations, exécutez la commande<br /> |
| 126 | + <code>git pull</code><br /> |
| 127 | + dans votre espace de travail pour <i>récupérer</i> et <i>fusionner</i> les changements distants.<br /> |
| 128 | + pour fusionner une autre branche avec la branche active (par exemple master), utilisez<br /> |
| 129 | + <code>git merge <branch></code><br /> |
| 130 | + dans les deux cas, git tentre d'auto-fusionner les changements. Malheureusement, ça n'est pas toujours possible et résulte par des <i>conflits</i>. |
| 131 | + Vous devez alors régler ces <i>conflits</i> |
| 132 | + manuellement en éditant les fichiers indiqués par git. Après l'avoir fait, vous devez les marquer comme fusionnés avec<br /> |
| 133 | + <code>git add <filename></code><br /> |
| 134 | + après avoir fusionné les changements, vous pouvez en avoir un aperçu en utilisant<br /> |
| 135 | + <code>git diff <source_branch> <target_branch></code> |
| 136 | + </p> |
| 137 | + </div> |
| 138 | + <a name="tagging"></a> |
| 139 | + <div class="scrollblock block-tagging"> |
| 140 | + <h2>tags</h2> |
| 141 | + <p> |
| 142 | + il est recommandé de créer des tags pour les releases de programmes. c'est un concept connu, qui existe aussi dans SVN. Vous pouvez créer un tag nommé <i>1.0.0</i> en exécutant la commande<br /> |
| 143 | + <code>git tag 1.0.0 1b2e1d63ff</code><br /> |
| 144 | + le <i>1b2e1d63ff</i> désigne les 10 premiers caractères de l'identifiant du changement que vous voulez référencer avec ce tag. Vous pouvez obtenir cet identifiant avec <br /> |
| 145 | + <code>git log</code><br /> |
| 146 | + vous pouvez utiliser moins de caractères de cet identifiant, il doit juste rester unique. |
| 147 | + </p> |
| 148 | + </div> |
| 149 | + <a name="checkout-replace"></a> |
| 150 | + <div class="scrollblock block-checkout-replace"> |
| 151 | + <h2>remplacer les changements locaux</h2> |
| 152 | + <p> |
| 153 | + Dans le cas où vous auriez fait quelque chose de travers (ce qui bien entendu n'arrive jamais ;) vous pouvez annuler les changements locaux en utilisant cette commande<br /> |
| 154 | + <code>git checkout -- <filename></code><br /> |
| 155 | + cela remplacera les changements dans votre arbre de travail avec le dernier contenu du HEAD. Les changements déjà ajoutés à l'index, aussi bien les nouveaux fichiers, seront gardés. |
| 156 | + </p> |
| 157 | + <p> |
| 158 | + Si à la place vous voulez supprimer tous les changements et validations locaux, récupérez le dernier historique depuis le serveur et pointez la branche principale locale dessus comme ceci<br /> |
| 159 | + <code>git fetch origin</code><br /> |
| 160 | + <code>git reset --hard origin/master</code> |
| 161 | + </p> |
| 162 | + </div> |
| 163 | + <a name="hints"></a> |
| 164 | + <div class="scrollblock block-hints"> |
| 165 | + <h2>conseils utiles</h2> |
| 166 | + <p> |
| 167 | + Interface git incluse<br /> |
| 168 | + <code>gitk</code><br /> |
| 169 | + utiliser des couleurs dans la sortie de git<br /> |
| 170 | + <code>git config color.ui</code><br /> |
| 171 | + afficher le journal sur une seule ligne pour chaque validation<br /> |
| 172 | + <code>git config format.pretty oneline</code><br /> |
| 173 | + utiliser l'ajout interactif<br /> |
| 174 | + <code>git add -i</code> |
| 175 | + </p> |
| 176 | + </div> |
| 177 | + <a name="resources"></a> |
| 178 | + <div class="scrollblock block-resources"> |
| 179 | + <h2>liens et ressources</h2> |
| 180 | + <h3>clients graphiques</h3> |
| 181 | + <p> |
| 182 | + <ul> |
| 183 | + <li><a href="http://gitx.laullon.com/">GitX (L) (OSX, open source)</a></li> |
| 184 | + <li><a href="http://www.git-tower.com/">Tower (OSX)</a></li> |
| 185 | + <li><a href="http://www.sourcetreeapp.com/">Source Tree (OSX, free)</a></li> |
| 186 | + <li><a href="http://mac.github.com/">GitHub for Mac (OSX, GitHub only, free)</a></li> |
| 187 | + </ul> |
| 188 | + </p> |
| 189 | + <h3>guides</h3> |
| 190 | + <p> |
| 191 | + <ul> |
| 192 | + <li><a href="http://book.git-scm.com/">Git Community Book</a></li> |
| 193 | + <li><a href="http://progit.org/book/">Pro Git</a></li> |
| 194 | + <li><a href="http://think-like-a-git.net/">Think like a git</a></li> |
| 195 | + <li><a href="http://help.github.com/">GitHub Help</a></li> |
| 196 | + <li><a href="http://marklodato.github.com/visual-git-guide/index-en.html">A Visual Git Guide</a></li> |
| 197 | + </ul> |
| 198 | + </p> |
| 199 | + </div> |
| 200 | + <a name="comments"></a> |
| 201 | + <div class="scrollblock block-comments"> |
| 202 | + <h2>commentaires</h2> |
| 203 | + <div id="disqus_thread"></div> |
| 204 | + <script type="text/javascript"> |
| 205 | + /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */ |
| 206 | + var disqus_shortname = 'git-the-simple-guide'; // required: replace example with your forum shortname |
| 207 | + |
| 208 | + /* * * DON'T EDIT BELOW THIS LINE * * */ |
| 209 | + (function() { |
| 210 | + var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true; |
| 211 | + dsq.src = 'http://' + disqus_shortname + '.disqus.com/embed.js'; |
| 212 | + (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq); |
| 213 | + })(); |
| 214 | + </script> |
| 215 | + <noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript> |
| 216 | + </div> |
| 217 | +</body> |
| 218 | +</html> |
0 commit comments