Collaborer à PluXml

Rédigé par Jean-Pierre Pourrez -

Git adore travailler avec des branches.

Il ne faut pas hésiter à les utiliser si on ne veut pas se retrouver avec un dépôt qui ressemble à une "usine à gaz".

Autre remarque : la branche master est la branche par défaut.

Donc on suppose que :

  • tu t'es connecté-e sur ton compte Github
  • tu es allé-e sur le dépôt à :https://github.com/pluxml/PluXml-Wiki
  • que tu as forké le dépôt
  • que tu es allé-e voir ton dépôt tout neuf
  • et que tu as récupéré son adresse

Tu reviens sur ton PC. Et tu clones et tu vas dans ton dossier de travail:

git clone https://github.com/ton-compte/PluXml-Wiki.git
cd PluXml-Wiki

Histoire de ne pas être la dernière informé-e, tu vas suivre le dépôt de PluXml. En général, on le surnomme "upstream" :

git remote add upstream https://github.com/pluxml/PluXml-Wiki.git

Après un peu de patience, tu vérifies les dépôts que tu vas suivre : origin et upstream

git remote -v

Ensuite tu récupères le contenu du dépôt de PluXml : upstream

git pull upstream master

master est la branche par défaut du site.

Tu peux regarder les branches que tu as déjà recensé :

git branch -a

Sauf que tu sais que PluXml a d'autres branches. Pour récupérer la liste complète, faire :

git fetch upstream

Tu peux vérifier qu'il y a des nouvelles branches :

git branch -a

La branche de travail par défaut est "master". Sauf qu'on te demande de travailler sur la branche "multilang". Elle n'existe pas encore sur ton PC et elle doit suivre la branche multilang du dépôt "upstream" de PluXml. Donc on la crée :

git checkout -b multilang upstream/multilang

Si tu ne sais plus à quelle branche tu es accroché-e, faire :

git status

Maintenant tu peux commencer à faire des propositions pour la page de ton choix. Pour éviter le bazar, tu crées une branche pour cette nouvelle tâche :

git checkout -b ma-premiere-branche

Et là tu bosses

Si tu n'es pas content-e de ce que tu as fait, tu peux revenir au fichier original :

git checkout -- /chemin-vers-fichier/le-fichier-origine.md

Une fois fini, tu enregistres tes modifs :

git commit -am 'mes premières traductions'

Tant que tu n'as pas enregistré tes modifs, tu ne peux pas changer de branche !!!

Maintenant tu vas proposer ton oeuvre à PluXml en passant par ton dépôt "origin". Perso, j'aime bien revenir sur la branche par défaut "master" :

git checkout master
git push origin ma-premiere-branche

Tu retournes sur ton compte Github et dans ton dépôt (repository) et tu crées un nouveau pull-request (PR) sur la branche "multilang" de PluXml-Wiki.

Et tu attends que ta demande soit traitée.

Rien ne t'empêche de continuer à bosser en créant une nouvelle branche sur la branche "multilang" de ton PC

Lorsque que tes propositions (requests) sont acceptées, Github envoie une notification à ton adresse mail.

Pour suivre les évolutions de PluXml, faire régulièrement :

git checkout master
git pull upstream master

Et éventuellement :

git pull upstream multilang

Et s'il y a du nouveau, répercute les sur ton dépôt Github :

git push origin master
git push origin multilang

Et voilà

Classé dans : Pluxml
Mot-clés : aucun

Écrire un commentaire

Quelle est la dernière lettre du mot njgs ?