Github
Pour vous créer un compte sur github, rendez-vous sur la page d'acceuil du site (ici).
Une fois votre compte créé, vous pouvez créer votre premier Repo Github.
Pour créer un nouveau répo, il suffit aller ici ou de cliquer sur le bouton : New repository. La page suivante est alors affichée :
Les repos sont payants sur Github. Les étudiants et les académiques ont des comptes illimités sur demande (la démarche est ici)
Une fois le répo créé, la page suivante est affichée :
Github nous donne les instructions pour connecter les dépôts (image précédente).
$ git remote add origin https://github.com/thomasdenecker/DemoGit.git
$ git push -u origin master
Counting objects: 9, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (9/9), 784 bytes | 261.00 KiB/s, done.
Total 9 (delta 0), reused 0 (delta 0)
remote:
remote: Create a pull request for 'master' on GitHub by visiting:
remote: https://github.com/thomasdenecker/DemoGit/pull/new/master
remote:
To https://github.com/thomasdenecker/DemoGit.git
* [new branch] master -> master
Branch 'master' set up to track remote branch 'master' from 'origin'.
Le dépôt local est maintenant connecté au dépôt distant !
Si nous reprenons notre fichier exemple test.txt et que nous faisons des modifications :
$ cat test.txt
Mon premier test sur Git
Modification du texte.
Modification dans la branche.
Changements pour Github
Nous réalisons ensuite le snapshot et son enregistrement :
$ git add test.txt
$ git commit -m "Changements pour Github"
Puis nous envoyons les changements :
$ git push origin master
Counting objects: 3, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 302 bytes | 302.00 KiB/s, done.
Total 3 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1), completed with 1 local object.
To https://github.com/thomasdenecker/DemoGit.git
c334c8b..aefd13a master -> master
Par défaut, le dépôt distant se nomme origin. Ici, nous envoyons les changements dans la branche master.
L'intérêt de Github est de pouvoir collaborer sur un projet. Vous pouvez ajouter un collaborateur à votre projet dans la partie settings.
Si vous avez effectué des modifications d'un fichier sur Github directement (ou sur un ordinateur en local) ou encore un collaborateur a modifié le projet, la commande suivante vous permet de récupérer la dernière version d'une branche. Dans l'exemple suivant, nous avons modifié le Readme sur Github dans la branche master :
$ git pull origin master
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), done.
From https://github.com/thomasdenecker/DemoGit
* branch master -> FETCH_HEAD
aefd13a..c17f8f4 master -> origin/master
Updating aefd13a..c17f8f4
Fast-forward
README.md | 1 +
1 file changed, 1 insertion(+)
create mode 100644 README.md
L'avantage de Github est que l'utilisateur peut très facilement faire remonter des problèmes ou des suggestions aux développeurs. Il déclare pour cela une Issue.
Lors que vous ouvrez une nouvelle branche et que vous la mettez sur Github, Github vous propose d'ouvrir une Pull request. En résumé, cela revient à proposer les changements aux développeurs du projet.
Si les développeurs trouvent les changements corrects, ils peuvent merger la branche sur la branche principale pour intégrer les modifications.
Un projet sur Github est comme un tableau avec des post-its. Par défaut, ce tableau se divise en 3 colonnes : A faire (to do), en cours (in progress) et fait (done). Un outil très pratique pour la collaboration !
Un exemple de projet :
Le wiki est très utile pour communiquer avec les utilisateurs : une documentation, des notices d'installation...
Par exemple, vous êtes dans le wiki du repo Au coin d'un clavier.
Un projet sur Github vous intéresse? Avec la commande git clone, vous pouvez le récupérer en toute simplicité. Vous cliquez sur le bouton Clone or download (sur la page d'acceuil du projet) puis vous copiez l'adresse. Il ne reste plus qu'à saisir git clone Adresse/copiée. Un exemple pour le projet bPeaks Application :
$ git clone https://github.com/thomasdenecker/bPeaks-application.git
Cloning into 'bPeaks-application'...
remote: Enumerating objects: 21, done.
remote: Counting objects: 100% (21/21), done.
remote: Compressing objects: 100% (19/19), done.
remote: Total 616 (delta 10), reused 4 (delta 2), pack-reused 595
Receiving objects: 100% (616/616), 116.58 MiB | 4.08 MiB/s, done.
Resolving deltas: 100% (199/199), done.
Checking out files: 100% (210/210), done.
Il ne reste plus qu'à l'utiliser et à proposer des modifications!
La documentation de Github est très bien faite. Si vous êtes perdu, je vous conseille de regarder les ressources proposées dans la page Git du wiki.