====== GESTIONNAIRE DE VERSIONS GIT ======

Git est un gestionnaire de version. Il permet :
  * d'historiser les états successifs de chaque fichier
  * des retours en arrière possibles
  * le travail simultané par plusieurs personnes sur un seul fichier
  * le travail en parallèle sur plusieurs branches 

Un cours est disponible [[https://openclassrooms.com/fr/courses/7162856-gerez-du-code-avec-git-et-github?archived-source=2342361|ici]]

===== Installer GIT =====

=== Windows ===

[[https://git-scm.com/download|Installer Git]].
Penser à indiquer l'éditeur (vim par default, conseillé notepad++). 

=== Linux === 

Avec les droits administrateur :
<code>apt-get install git</code>

===== Configuration =====

Avant d'utiliser Git, il faut entrer les commandes suivantes (git bash sous Windows, terminal sous Linux) :
<code>
git config --global user.name <nomUtilisateur>
</code>
<code>
git config --global user.email <mailUtilisateur>
</code>

==== Confusion de comptes git sur le poste : ====

Lors de la publication (push) des ressources sur gitHub, le nom de l'utilisateur stocké sur le poste peut ne pas être le bon.
Git enregistre un fichier sous Windows.Il faut donc supprimer ce fichier.

''Aller dans le panneau de configuration'' | ''Comptes Utilisateurs'' | ''Gérer vos informations d'identification''.

Supprimer alors le fichier concernant git dans les informations d'identifications Windows.


===== Initialiser un dépot =====
==== Nouveau projet ====
Dans le répertoire contenant le projet :
<code>
git init
</code>

__**Astuce**__ : Sous Windows on peut faire un clic droit -> Git Bash Here pour se positionner directement dans le répertoire.

Création d'un dossier caché .git (ne pas toucher!).

==== Clone projet existant distant ====
<code>
git clone <url>
</code>

Cela crée le projet dans un sous-dossier du même nom.
__**Attention**__ : si le projet ne vous appartient pas, se référer à la partie **//remote//**.

===== Commandes =====

=== Ajout de fichier ===
Pour ajouter un seul fichier :
<code>
git add <cheminDuFichier>
</code>

Pour ajouter tous les fichiers d'un coup : 

<code>
git add -A
</code>

=== Commit ===

== Voir les modifications en cours ==
Lister les fichiers modifiés depuis le dernier commit :
<code>
git status
</code>

Voir toutes les lignes modifiées sur le projet depuis le dernier commit :

<code>
git diff [cheminFichier]
</code>

Pour afficher les modifications d'un seul fichier, préciser le chemin.

== Faire un commit ==
Remarque : Le commit concerne tout les fichiers précédemment ajoutés
<code>
git commit
</code>

cela ouvre l'éditeur de texte enregistré par défaut. On enregistre alors un message pour préciser les changements effectués.

<code>
git commit -m "<messageCommit>"
</code>
Cette commande permet de directement ajouter le message du commit sans passer par l'éditeur de texte.

== Lister les commits ==
Voir les différents commits effectués sur la branche actuelle :
<code>
git log
</code>

Voir l'historique de tous les commits sur les différentes branches :

<code>
git log --graph --oneline --all
</code>

=== Annuler les modifications ===
== Sur un fichier ==
Restaurer un fichier à son état lors du dernier commit :
<code>
git checkout -- <nomFichier>
</code>


====== Cycle de travail git ======
Pour le travail en équipe, un serveur git distant est nécessaire.
GitHub permet de centraliser tous les versions réalisées par les différents membres d'une équipe.
Chaque membre doit donc disposer d'un compte github.
Afin d'éviter les conflits, une organisation de travail est impérative.

Avant même de pouvoir récupérer les modifications présentes en ligne vous allez devoir ajouter l'ensemble de vos modifications puis créer le paquet correspondant.

<code>git add .</code>

puis

<code>git commit -m "Votre message de commit" »</code>

<wrap em>Attention ne bien mettre un commentaire explicite et crédible !</wrap>

Vous pouvez maintenant récupérer les fichiers distants avec la commande :

<code>git pull</code>

Attention à bien vérifier que vos fichiers et lignes ne rentrent pas en collision avec les fichiers et lignes distants.

Incroyable maintenant vous pouvez Push vos fichiers.

<code>git push</code>



== Sur un commit ==
 
=== Gérer une branche ===
== Créer ==
== Supprimer ==
== Changer ==
== Fusionner ==

=== Envoyer / récupérer changements ===
== Remote ==

=== tag ===
=== show === 
=== autres ===
== gitk ==
== .gitignore ==
== Gestion des conflits ==
=== GitHub === 
== README == 
== LICENCE ==