Github

Table of Contents Prise en mains Comment faire un commit et un push ? Pour aller plus loin Pour aller moins loin

Prise en mains

Prérequis : avoir un compte Github (Guide d'installation en anglais)

1/

• Aller sur le site github désiré — notre exemple sera https://github.com/mozfr/www — et cliquer sur le bouton Fork en haut à droite

Fichier:BoutonFork.png

• Vous êtes redirigé vers https://github.com/MONCOMPTEGITHUB/www

2/

• Ouvrir une console, se mettre dans un dossier situé dans son home où on met les clones des dépôts github (supposons que c'est ~/github/) et taper la commande suivante :

 git clone [email protected]:MONCOMPTEGITHUB/www.git 

• Un dossier www est créé (~/github/www/), c'est une copie locale de votre fork du dépôt www de mozfr sur github

Nous allons nous positionner dans ce dossier :

 cd www

3/

Il faut définir le 'remote upstream', c'est à dire indiquer au dépôt local quel est le dépôt d'origine du projet :

 git remote add upstream git://github.com/mozfr/www.git 

4/

• Nous allons créer une branche sur notre dépôt local que nous nommerons "branche1"

 git branch branche1 

Normalement nous avons maintenant 2 branches locales, master et branche1.

• Nous allons nous mettre dans la branche branche1 avec cette commande :

 git checkout branche1 

• Nous allons publier cette branche sur notre dépôt personnel github.

 git push origin branche1 

Voilà, nous avons maintenant une configuration locale pour proposer des patchs. La création de la branche permet de travailler dans un dépôt à part qui ne servira qu'à faire une proposition de patchs, il est pratique en général de suivre ce processus pour proposer une amélioration:

1. je me crée une branche pour cette contribution
2. je me positionne sur cette branche
3. je fais mes patchs en local et je teste que ça marche
4. je committe mes patchs de ma branche locale vers ma branche distante sur github
5. je fais un pull request de mon commit sur github

Comment faire un commit et un push ?

1/ s'assurer que l'on est bien à jour par rapport au dépôt d'origine

 git pull upstream master

2/ faire ses modifications en local

3/ ajouter les fichiers modifiés ou ajoutés avant de faire un commit

 git add chemin/vers/mon/fichier/toto1.html 
 git add chemin/vers/mon/fichier/toto2.html 

...

4/ faire un commit local avec un message expliquant la contribution:

 git commit -m "modification qui permet d'avoir des chatons mignons en page d'accueil" 

5/ faire un push (envoi réel) de votre commit sur votre branche distante sur github :

 git push origin branche1 

6/ aller sur le github et se mettre sur la branche de travail (branche1 dans notre exemple) puis faire un pull request

Fichier:poulericouestbutton.png

Pour aller plus loin

• Un gros tutoriel en français

Pour aller moins loin

• Github pour les nuls, vachement plus facile !