Ajoutez une branche, localement, à votre dépôt forké pour travailler sur vos modifications.

Branches

Les dépôts Git utilisent des branches pour isoler le travail au besoin. C'est une pratique courante lorsque vous travaillez sur un projet de créer une branche pour que vos modifications de travail soient conservée à part. De cette façon, vous pouvez faire votre travail, tandis que la branche principale, généralement nommée «master», reste stable. Lorsque le travail sur votre branche est terminé vous le fusionnez dans la branche principale 'master'.

Le schéma ci-dessous montre comment vous pouvez dériver de votre branche 'master', travailler et fusionner ces modifications dans «master». Vous pouvez même dériver d'une autre branche si vous le souhaitez, la branche 'master' n'a pas à être la base d'un embranchement.

Un diagramme montrant une ligne horizontale, représentant la branche maîtresse, avec une autre ligne se ramifiant vers le haut et plus tard reliant l'original. Une autre ligne dérive de la branche maîtresse par le bas et une autre branche dérive de celle-ci. De ceux-ci se rencontrent avec la ligne principale d'origine, aussi.

Pour une excellente visualisation sur la façon dont les branches fonctionnent dans un projet, consultez ce guide GitHub: guides.github.com/overviews/flow

GitHub Pages

GitHub hébergera automatiquement les fichiers de sites statiques. Pour être accessible comme un site web, il doivent être situées dans la branche nommée 'gh-pages'. Ce service gratuit est appelé GitHub Pages. Puisque le projet que vous avez lancé crée un site Web, la branche principale sera 'gh-pages' au lieu de 'master'. Tous les dépôt qui ont une branche 'gh-pages' ont un site Web directement accessible en ligne, se situant à l'URL construite sur le modèle suivant:

http://githubusername.github.io/repositoryname

Créer une branche

Lorsque vous créez une branche, Git copie l'intégralité de la branche sur laquelle vous vous trouvez et la place dans la branche nouvellement crée.

Toujours dans votre dépôt local «patchwork», tapez git status pour voir sur quelle branche vous êtes. Git devrait répondre que vous êtes sur la branche 'gh-pages'.

Créez maintenant une nouvelle branche et nommez-la "add-<username>", où 'username' est votre nom d'utilisateur. Par exemple, "Add-jlord". Les branches sont sensibles à la casse, nommez-là exactement avec la même capitalisation que votre compte GitHub.

git branch <BRANCHNAME>

Maintenant, vous avez une branche avec un nouveau nom identique à 'gh-pages'.

Pour entrer dans une branche et travailler dessus, vous devez checkout cette branche. Allez sur votre nouvelle branche:

git checkout <BRANCHNAME>

Étape: Créer un nouveau fichier

Retour dans votre éditeur de texte:

  • Créez un nouveau fichier nommé "add-<USERNAME>.txt", où 'username' est votre nom d'utilisateur. Par exemple, "add-jlord.txt".
  • Écrivez simplement votre nom d'utilisateur GitHub et c'est tout. Par exemple, je taperez 'jlord'.
  • Enregistrez ce fichier dans le dossier 'contributors' de Patchwork: Patchwork/contributors/add-yourusername.txt
  • Vérifiez vos modifications (voir ci-dessous).

Vérification

Effectuez les étapes ci-après pour vérifier un projet:

git status

git add <contributors/FILENAME>

git commit -m "commit message"

Maintenant vous pouvez pousser vos modifications sur votre fork, avec le remote 'origin', sur GitHub:

git push origin <BRANCHNAME>

Sélectionner le dossier contenant votre dépôt.

Permission denied...error: 403

Vous essayer de pousser des modifications à un référentiel auquel vous n'avez pas accès en écriture. Dans ce cas, vous poussez probablement sur le dépôt original 'jlord/patchwork'. Assurez-vous que avez bien poussé sur le remote 'origin' et qu'il pointe bien vers l'adresse de votre fork sur GitHub. Pour vérifier et voir quels sont les remotes et où ils pointent, exécutez git remote -v . Vous devriez avoir 'upstream' indiquant 'jlord/patchwork' et 'origin' indiquant 'yourusername/patchwork'

Pour réparer un remote qui pointe vers le mauvais endroit, vous pouvez redéfinir son URL:

git remote set-url origin

Authentication failed...error: 401

Votre identité n'a pas pu être vérifiée. Vous avez peut-être activé 2FA (Two Factor Authentication) auquel cas vous devez utiliser un jeton d'accès personnel comme mot de passe. Vous pouvez en générer un en suivant ces instructions . Vous devrez le garder et l'utiliser à la place de votre mot de passe lorsque vous y êtes invité. Vous pouvez également enregistrer ce jeton d'accès sur votre ordinateur afin de ne plus avoir à le saisir.

File NOT in contributors folder

Le fichier que vous créez doit être placé dans le dossier 'contributors' du référentiel Patchwork. Si vous l'avez mis ailleurs, déplacez votre fichier dans le dossier. Vous pouvez vérifiez à nouveau git status et vous verrez vos modifications. Ajoutez et soumettez (commit) "toutes" (-A) les modifications (ajouts et suppressions) avec les commandes ci-dessous.

git add -A

git commit -m "move file into contributors folder"

Branch name expected: _____

Le nom de la branche doit correspondre exactement à votre nom d'utilisateur. Pour changer votre nom de branche:

git branch -m <NEWBRANCHNAME>

Lorsque vous avez effectué vos mises à jour, vérifiez à nouveau!

  • Vous pouvez créer et passer sur une branche en une seule commande
  • git checkout -b <BRANCHNAME>
  • Créer une nouvelle branche
  • git branch <BRANCHNAME>
  • Se déplacer sur une branche
  • git checkout <BRANCHNAME>
  • Lister les branches
  • git branch
  • Renommer la branche courante
  • git branch -m <NEWBRANCHNAME>
  • Vérifiez la branche sur laquelle vous travaillez
  • git status