Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révisionLes deux révisions suivantes | ||
tutos:github [2017/10/11 05:51] – ygangat | tutos:github [2017/10/13 07:01] – ygangat | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
====== GitHub====== | ====== GitHub====== | ||
+ | {{ : | ||
===== Présentation ===== | ===== Présentation ===== | ||
**GitHub** (exploité sous le nom de GitHub, Inc.) est un service web d' | **GitHub** (exploité sous le nom de GitHub, Inc.) est un service web d' | ||
Ligne 8: | Ligne 9: | ||
* travailler à plusieurs, sans risquer de se marcher sur les pieds. Si deux personnes modifient un même fichier en même temps, leurs modifications doivent pouvoir être fusionnées sans perte d’information. | * travailler à plusieurs, sans risquer de se marcher sur les pieds. Si deux personnes modifient un même fichier en même temps, leurs modifications doivent pouvoir être fusionnées sans perte d’information. | ||
- | ===== Installation | + | ===== Installation ===== |
- | ==== Installation | + | |
Le plus simple est de télécharger : https:// | Le plus simple est de télécharger : https:// | ||
(Laissez les options par défaut) | (Laissez les options par défaut) | ||
Ligne 15: | Ligne 15: | ||
Il est nécessaire d' | Il est nécessaire d' | ||
- | ==== Configuration sur IntelliJ==== | + | ===== Configuration sur IntelliJ |
Installation depuis : https:// | Installation depuis : https:// | ||
Ligne 46: | Ligne 46: | ||
* Une ligne vide sépare les différentes parties : la première est obligatoire et la troisième est optionnelle pour les changements triviaux | * Une ligne vide sépare les différentes parties : la première est obligatoire et la troisième est optionnelle pour les changements triviaux | ||
* En faisant juste un " | * En faisant juste un " | ||
- | ==== Configuration | + | |
+ | ===== Utilisation en ligne de commande ===== | ||
+ | ==== Déposer un projet existant | ||
+ | * Pré-requis : | ||
+ | * Avoir un compte GitHub personnel | ||
+ | * Appartenir à l' | ||
+ | * Méthode : | ||
+ | * Se connecter sur le site de **GitHub** | ||
+ | * Créer un dépôt et choisir " | ||
+ | * **Ne pas mettre de README** (si on veut déposer des fichiers qui se trouve sur notre serveur/ | ||
+ | * Mettre en privé (= privé à l' | ||
+ | |||
+ | {{ : | ||
+ | * Une fois que le dépôt est créé sur le site GitHub, il " | ||
+ | |||
+ | {{ : | ||
+ | * Se mettre sur son serveur/ | ||
+ | * Allez dans le répertoire voulu (par exemple '' | ||
+ | |||
+ | * '' | ||
+ | * A ce point on peut écrire un fichier '' | ||
+ | < | ||
+ | /rep1/ | ||
+ | /rep2/ | ||
+ | </ | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | Ca y est, votre code est en ligne et synchronisé avec votre machine local ! | ||
+ | |||
+ | ==== Et ensuite ? ==== | ||
+ | En partant du principe que nous n'avez d'IDE dédié, une fois que vous avez modifié vos fichiers, que faire ? | ||
+ | * Se replacer dans le même répertoire (par exemple '' | ||
+ | * Si besoin rajouter les nouveaux fichiers à la liste des fichiers à commiter en faisant | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * Une fois que le commit est fait, il suffit de faire un '' | ||
+ | |||
+ | ===== Un bon message de commit ===== | ||
+ | Il est recommandé de faire régulièrement des commits, mais pas des push. Vous ne devriez faire un push qu’une fois de temps en temps (pas plus d’une fois par jour en général). Evitez de faire systématiquement un push après chaque commit. Pourquoi ? Parce que vous perdriez la facilité avec laquelle il est possible d’annuler ou modifier un commit. | ||
+ | |||
+ | La convention avec Git est de rédiger un message de commit comme on rédige un e-mail : une ligne courte de sommaire (la seule qui s' | ||
+ | |||
+ | Le format est donc : | ||
+ | < | ||
+ | <ligne de sujet> | ||
+ | |||
+ | <un ou plusieurs paragraphe d' | ||
+ | </ | ||
+ | La ligne de sujet doit rester courte (si possible moins de 50 caractères, | ||
+ | |||
+ | Il faut une ligne blanche pour séparer la ligne de sujet, sinon Git va afficher tout le premier paragraphe partout où il aurait affiché la ligne de sujet. | ||
+ | |||
+ | La suite est une explication rédigée sur le commit. Ne pas hésiter à faire une explication longue si c'est nécessaire (typiquement plusieurs paragraphes). | ||
+ | |||
+ | Sauf cas particulier, | ||
+ | |||
+ | ==== Méthode de travail ==== | ||
+ | Lorsqu’on travaille avec Git, on suit en général toujours les étapes suivantes : | ||
+ | |||
+ | - modifier le code source ; | ||
+ | - tester votre programme pour vérifier si cela fonctionne ; | ||
+ | - faire un commit pour « enregistrer » les changements et les faire connaître à Git ; | ||
+ | - recommencer à partir de l’étape 1 pour une autre modification | ||
+ | |||
+ | Une fois que cela est fini, on fait un push en fin de journée par exemple sur GitHub. | ||
+ | |||
+ | À titre indicatif, si vous travaillez toute une journée sur un code et que vous ne faites qu’un commit à la fin de la journée, c’est qu’il y a un problème (sauf si vous avez passé toute la journée sur le même bug). Les commits sont là pour « valider » l’avancement de votre projet : n’en faites pas un pour chaque ligne de code modifiée, mais n’attendez pas d’avoir fait 50 modifications différentes non plus ! | ||
+ | |||
+ | |||
+ | ===== Liens très utiles ===== | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[http:// | ||
===== CheatSheet ===== | ===== CheatSheet ===== |