GitHub

Présentation

GitHub (exploité sous le nom de GitHub, Inc.) est un service web d’hébergement et de gestion de développement de logiciels, utilisant le logiciel de gestion de versions Git.

Un logiciel de gestion de version permet de :

suivre l’évolution d’un code source, pour retenir les modifications effectuées sur chaque fichier et être ainsi capable de revenir en arrière en cas de problème ;

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 et configuration

Installation

Le plus simple est de télécharger : https://git-scm.com/downloads (Laissez les options par défaut)

Il est nécessaire d’avoir un compte chez github et d’avoir été invité comme membre du projet: https://github.com/LE2P

Configuration sur IntelliJ

Installation depuis : https://www.jetbrains.com/idea/download

(Il est possible d’avoir une licence “éducation” gratuite pour la version Ultimate en faisant une demande : https://www.jetbrains.com/student/).

Au démarrage:

Dans le menu config (en bas à droite), aller su “settings”

Dans la barre de recherche, mettre “Git” et ensuite configurer les deux onglets “version Control” nommés

“Git” : le fichier installé précédemment

“GitHub” : login et mdp

Ensuite pour importer un projet:

Faire “Check out from version control”

Choisir le projet que l’on veut importer

Créer un projet à partir des fichiers importé

Dans le cas d’un projet Maven, chercher le sous repertoire contenant le pom.xml

Choisir le SDK approprié (JDK par exemple)

Pour mettre à jour le projet après modification,

Ouvrir le menu en faisant l’une des trois options :

Ctrl + K

Menu “VCS”, “Commit Changes”

Appuyer sur le bouton VCS avec la flèche verte vers le haut

Puis Entrer un texte concernant la modification apporté au projet dans le champ “Commit messages” avec un message explicatif, par exemple qui comprend :

Une première ligne résumant le pourquoi du patch (pas le comment)

Une description longue optionnelle permettant d’expliciter le contexte du résumé donné en première ligne ;

Une liste de fichier et leurs modifications.

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 “commit”, on effectue le changement uniquement sur la machine. Le “commit & push” permet d’envoyer sur le serveur distant les modification.

CheatSheet

Github/git CheatSheet.pdf url>http://le2p.univ-reunion.fr/le2pWiki/lib/exe/fetch.php/tutos/github-git-cheat-sheet.pdf

Configuration sur RStudio