Cas 1 : Création d’un fork

Rendez-vous sur le dépôt GitHub du projet Pyrocms (vous devez au préalable être connecté au site) et cliquer sur « Fork ».

Un nouveau va être créé qui est une copie du dépôt original. Vous pouvez travailler sur votre propre copie. Afin de travailler sur votre poste en local, utilisez la commande suivante dans un terminal dans votre dossier de travail :

$ git clone git@github.com:votrenomutilisateur/pyrocms.git -b 2.0/develop

Vous pouvez maintenant éditer le code source, l’ensemble des modifications que vous apportez sont prises en comptes et signalées.

Cas 2 : Utilisation un dépôt externe

Vous pouvez utiliser votre propre dépôt Git

Envoyer ses modifications

Lorsque vous avez effectué des modifications (avez-vous testé correctement les modifications ?) vous pouvez :

• vérifier les fichiers qui ont été modifiés
• ajouter / supprimer des fichiers
• effectuer un commit (livraison)

$ git status
$ git add unfichier
$ git add undossier/
$ git rm fichier1 fichier 2
$ git rm -r undossierentier/
$ git commit -m "bug: description du bug corrige"

Une fois ceci effectué il ne s’est rien passé, vos modifications n’ont pas été répercutées, vous devez effectuer un push de vos travaux.

Afin d’effectuer ce push il faut executer la ligne de commande suivant

$ git push origin 2.0/develop

Un cas qui arrive souvent lors de cette étape est que votre dépôt ne soit plus à jour (ceci arrive souvent si quelqu’un travaille sur le même dépôt que vous).

Lancez la commande suivante :

$ git pull origin 2.0/develop

Si vous devez faire un retour en arrière (récupérer le fichier avant d’effectuer des modifications dessus) vous pouvez faire ceci :

$ git checkout -- cheminversledossier/nomdufichier.php

Récupérer les modifications de Pyrocms

Lorsque vous faites une copie de votre dépôt vous avez la version du projet à un instant donné. Si des modifications ont lieu sur le code source (il suffit de voir l’activité des PULL REQUEST sur un projet pour se rendre compte que ceux ci évoluent toute les heures) votre version n’est plus à jour.

Vous avez la possibilité d’ajouter un dépôt distant existant et de le déposer sur votre branche de travail pour cela il faut effectuer :

$ git remote add pyrocms git://github.com/pyrocms/pyrocms.git

Ensuite généralement la bonne pratique consiste à lancer les deux commandes suivantes avant de travailler :

$ git pull pyrocms 2.0/develop
$ git push origin 2.0/develop

Les différents commits sur le dépôt principal sont rapatriés et poussés sur votre propre dépôt.

Une fois les modifications faites sur votre code vous reprenez :

$ git status
$ git add unfichier
$ git add undossier/
$ git rm fichier1 fichier 2
$ git rm -r undossierentier/
$ git commit -m "bug: description du bug corige"

$ git push origin 2.0/develop //permet de pousser vos modifications

Puis rendez-vous sur votre dépôt sur le site GitHub et effectuez une PULL REQUEST afin d’envoyer vos modifications sur le code source général.

Vous pouvez ainsi contribuer au développement de n’importe quel projet open source.

Article traduit, lien vers l’article original