README.md 4.69 KB
Newer Older
1 2
# tutoriel-git

Thierry Fenasse's avatar
Thierry Fenasse committed
3
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
4

5
* 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
6 7
* 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
8
* 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
9

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

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

Thierry Fenasse's avatar
Thierry Fenasse committed
14
### Installation
Thierry Fenasse's avatar
Thierry Fenasse committed
15

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

Thierry Fenasse's avatar
Thierry Fenasse committed
18 19 20 21
* 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)

22
### Configuration
Thierry Fenasse's avatar
Thierry Fenasse committed
23

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

Thierry Fenasse's avatar
Thierry Fenasse committed
26 27 28 29
* 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
30 31 32

### Créer un projet

Thierry Fenasse's avatar
Thierry Fenasse committed
33
*Ç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
34

Thierry Fenasse's avatar
Thierry Fenasse committed
35 36 37 38
* 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
39

Thierry Fenasse's avatar
Thierry Fenasse committed
40
### Premier fichier
Thierry Fenasse's avatar
Thierry Fenasse committed
41

Thierry Fenasse's avatar
Thierry Fenasse committed
42
*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?*
43

Thierry Fenasse's avatar
Thierry Fenasse committed
44 45 46
* 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
47
* 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
48
* Voir l'état du projet : `git status` (Git vous dira qu'il y a un nouveau fichier)
Thierry Fenasse's avatar
Thierry Fenasse committed
49
* 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
50
* 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
51

Thierry Fenasse's avatar
Thierry Fenasse committed
52
### Premières modifs
Thierry Fenasse's avatar
Thierry Fenasse committed
53

Thierry Fenasse's avatar
Thierry Fenasse committed
54 55
* É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é)
56
* 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)
57 58
* 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").
59
* 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*)
60 61

TODO : la suite :D
Thierry Fenasse's avatar
Thierry Fenasse committed
62 63 64

## Autres ressources

65 66 67 68 69 70 71
* [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
72
* [Enfin comprendre git](https://www.miximum.fr/blog/enfin-comprendre-git/)