README.md 4.82 KB
Newer Older
1
2
Découverte de git
=================
3

Thierry Fenasse's avatar
Thierry Fenasse committed
4
Quelques pistes en français pour démarrer avec **git** (outil en [ligne de commande](https://fr.wikipedia.org/wiki/Interface_en_ligne_de_commande)) et **GitLab** ([application web](https://fr.wikipedia.org/wiki/Application_web) pour partager du code).
Thierry Fenasse's avatar
Thierry Fenasse committed
5

6
* Syntaxe utilisée pour ce fichier README.md : [la syntaxe markdown](https://help.github.com/articles/markdown-basics/)
Thierry Fenasse's avatar
Thierry Fenasse committed
7
8
* Un éditeur de fichiers textes : [Atom](https://atom.io/)
* Un exemple de fichier (en anglais): [README.md](https://gist.github.com/indexzero/1363524#file-readme-outline-md)
Thierry Fenasse's avatar
Thierry Fenasse committed
9
* License : [GPL v3 licence](https://www.gnu.org/licenses/gpl-3.0.txt) ou en [version française](http://dachary.org/loic/gpl-french.pdf)
Thierry Fenasse's avatar
Thierry Fenasse committed
10

11
12
Résumé des commandes utilisées dans la vidéo
--------------------------------------------
Thierry Fenasse's avatar
Thierry Fenasse committed
13
14
15

*Prérequis : il faut que le logiciel git soit installé*

16
17
Installation
------------
Thierry Fenasse's avatar
Thierry Fenasse committed
18

Thierry Fenasse's avatar
Thierry Fenasse committed
19
*Pour pouvoir travailler avec un outil de versionnement, il faut que cet outil soit installé sur ton ordi.*
20

Thierry Fenasse's avatar
Thierry Fenasse committed
21
22
23
24
* Sur GNU/Linux ou Solaris : [Installation depuis un terminal](http://git-scm.com/download/linux)
* Sur Mac OSX : [Téléchargement et installation](http://git-scm.com/download/mac)
* Sur Windows : [Téléchargement et installation](http://git-scm.com/download/win)

25
26
Configuration
-------------
Thierry Fenasse's avatar
Thierry Fenasse committed
27

28
29
*Il y a certainement plein d'autres options de configuration, mais c'est pour commencer!*

Thierry Fenasse's avatar
Thierry Fenasse committed
30
31
32
33
* Est-ce que git est installé : `git --version`
* Définir ton nom dans git : `git config --global "Votre Nom"` (Vous sur GitHub ou pas)
* Définir ton adresse email : `git config --global "quelque.chose@domaine.extension"` (Celui utilisé sur GitHub ou pas)
* Afficher ta config actuelle : `git config -l`
Thierry Fenasse's avatar
Thierry Fenasse committed
34

35
36
Créer un projet
---------------
Thierry Fenasse's avatar
Thierry Fenasse committed
37

Thierry Fenasse's avatar
Thierry Fenasse committed
38
*Ça revient simplement à créer un dossier sur ta machine pour y mettre un ou plusieurs fichiers voir toute une arborescence de fichiers et dossiers.*
Thierry Fenasse's avatar
Thierry Fenasse committed
39

Thierry Fenasse's avatar
Thierry Fenasse committed
40
41
42
43
* Crée un dossier pour ton super projet : `mkdir dossier` (Remplacez «dossier» par ce que vous voulez)
* Rentre dans ce dossier : `cd dossier`
* Commence à [gérer les versions](https://fr.wikipedia.org/wiki/Gestion_de_versions) du(des) fichier(s) du projet : `git init`
* Pour t'informer sur l'état du projet : `git status` (peut être utilisé n'importe quand)
Thierry Fenasse's avatar
Thierry Fenasse committed
44

45
46
Premier fichier
---------------
Thierry Fenasse's avatar
Thierry Fenasse committed
47

Thierry Fenasse's avatar
Thierry Fenasse committed
48
*Un simple fichier texte contenant tes idées, un poème, une liste de tâche ou un début de page html, ou pourquoi pas une image?*
49

Thierry Fenasse's avatar
Thierry Fenasse committed
50
51
52
* Crée un fichier : `touch index.html` (ou n'importe quel autre nom de fichier)
* Édite ce fichier pour y écrire quelque chose : En utilisant un [éditeur de texte](https://fr.wikipedia.org/wiki/%C3%89diteur_de_texte).
* Voir l'état du projet : `git status` (Git vous dira qu'il existe un fichier «index.html» non suivi)
Thierry Fenasse's avatar
Thierry Fenasse committed
53
* Demander à git de suivre les versions de ce fichier : `git add index.html` (ou le nom de votre fichier)
Thierry Fenasse's avatar
Thierry Fenasse committed
54
* Voir l'état du projet : `git status` (Git vous dira qu'il y a un nouveau fichier)
Thierry Fenasse's avatar
Thierry Fenasse committed
55
* Dire à git de prendre en compte cette version du fichier avec un commentaire : `git commit --message "création du fichier"`
Thierry Fenasse's avatar
Thierry Fenasse committed
56
* Voir sur l'état du projet : `git status` (Git vous affichera que la copie de travail est propre et qu'il n'y a rien à valider ou *à commiter*)
Thierry Fenasse's avatar
Thierry Fenasse committed
57

58
59
Premières modifs
----------------
Thierry Fenasse's avatar
Thierry Fenasse committed
60

Thierry Fenasse's avatar
Thierry Fenasse committed
61
62
* Édite ton fichier pour en modifier le contenu : En utilisant un [éditeur de texte](https://fr.wikipedia.org/wiki/%C3%89diteur_de_texte). (votre index.html ou autre fichiers)
* Voir l'état du projet : `git status` (Git vous dira que le fichier «index.html» est modifié)
63
* Comparer le fichier avant et après ces modification pour voir les différences : `git diff` (les lignes qui commencent par un + sont les ajouts, celles par un - les suppressions)
64
65
* Demander à git de suivre les versions de ce fichier : `git add index.html` (ou le nom de votre fichier)
* Dire à git de prendre en compte cette version du fichier avec un commentaire : `git commit -m "modification du fichier"` (notez que --message "commentaire" peut-être raccourcis en -m "commentaire").
66
* Demander à git une listes des commits et leur commentaires : `git log` (Git vous affichera un ID, l'auteur, la date et le commentaire de chaque *commit*)
67
68

TODO : la suite :D
Thierry Fenasse's avatar
Thierry Fenasse committed
69

70
71
Autres ressources
-----------------
Thierry Fenasse's avatar
Thierry Fenasse committed
72

73
74
75
76
77
78
79
* [Autre tutoriel de base](http://christopheducamp.com/2013/12/15/github-pour-nuls-partie-1/)
* [Et sa suite](http://christopheducamp.com/2013/12/16/gitHub-pour-nuls-partie-2/)
* [Autre tutoriel et explications sur le fonctionnement de git](http://www.robusta.io/content/tutoriel/git/start-git.html)
* [Avec quelques info sur .gitignore](http://bloginfo.rakotonirina.net/git-commencer-a-utiliser-git/)
* [Page wikipedia](https://fr.wikipedia.org/wiki/Git)
* [La liste des commandes de git](http://git-scm.com/docs)
* [Visualiser des commit, branch, merge ...](http://www.wei-wang.com/ExplainGitWithD3/)
Thierry Fenasse's avatar
Thierry Fenasse committed
80
* [Enfin comprendre git](https://www.miximum.fr/blog/enfin-comprendre-git/)