Collaborer à PluXml
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à
#1 - Hans a dit :