README.md 3.75 KB
Newer Older
Thierry Fenasse's avatar
Thierry Fenasse committed
1
## POUR COMMENCER AVEC GIT et GITHUB
Thierry Fenasse's avatar
Thierry Fenasse committed
2

Thierry Fenasse's avatar
Thierry Fenasse committed
3
*Pour en apprendre sur Git (outil en [ligne de commande](https://fr.wikipedia.org/wiki/Interface_en_ligne_de_commande)) et GitHub ([application web](https://fr.wikipedia.org/wiki/Application_web) pour partager du code).*
Thierry Fenasse's avatar
Thierry Fenasse committed
4
5
6
7
8
9
10

* Markdown : [la syntaxe markdown](https://help.github.com/articles/markdown-basics/)
* C'est quoi Git et GitHub : [une vidéo en français (durée : 01:27:08)](https://www.youtube.com/watch?v=V6Zo68uQPqE)
* 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)
* License : [GPL v3 licence](http://dachary.org/loic/gpl-french.pdf)

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

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

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

17
18
*Pour pouvoir travailler avec un outil de versionnement, il faut que cet outil soit installé sur votre ordinateur.*

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

### configuration

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

Thierry Fenasse's avatar
Thierry Fenasse committed
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
* Vérifier que git est installé : `git --version`
* Définir votre nom : `git config --global "Votre Nom"` (Vous sur GitHub ou pas)
* Définir votre courriel : `git config --global "quelque.chose@domaine.extension"` (Celui utilisé sur GitHub ou pas)
* Afficher votre configuration actuelle : `git config -l`

### Créer un projet

*Ça revient simplement à créer un dossier sur votre ordinateur pour y mettre un unique fichier ou toute une arborescence de fichiers et dossiers*

* Créer un dossier pour votre projet : `mkdir dossier` (Remplacez «dossier» par ce que vous voulez)
* Rentrer dans ce dossier : `cd dossier`
* Commencer à [gérer les versions](https://fr.wikipedia.org/wiki/Gestion_de_versions) du(des) fichier(s) du projet : `git init`
* S'informer sur l'état du projet : `git status` (peut être utilisé n'importe quand)

### Votre premier fichier

43
44
*Un simple fichier texte contenant vos idées, un poème, une liste de tâche ou un début de page html, ou pourquoi pas une image?*

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

### Vos premières modifications

55
56
57
* Éditer votre fichier pour en modifier le contenu : En utilisant un [éditeur de texte](https://fr.wikipedia.org/wiki/%C3%89diteur_de_texte).
* S'informer sur l'état du projet : `git status` (Git vous dira que le fichier «index.html» est modifié)
* Comparer le fichier avant et après ces modification pour voir les différences : `git diff` (les lignes commaçamt par un + sont les ajouts, celles commençamt par un - les suppressions)
Thierry Fenasse's avatar
Thierry Fenasse committed
58
59
60
61
62
63

## Autres ressources

http://bloginfo.rakotonirina.net/git-commencer-a-utiliser-git/
http://christopheducamp.com/2013/12/15/github-pour-nuls-partie-1/
http://christopheducamp.com/2013/12/16/gitHub-pour-nuls-partie-2/