Mais que se passe-t-il si vous faites quelque chose d'intéressant dans un projet et que vous souhaitez apporter des modifications à un projet alors que vous n'avez pas le privilège de le faire? Eh bien, c'est là qu'intervient la demande de tirage. La demande d'extraction GitHub est un moyen de contribuer à un projet sur GitHub même lorsque vous n'avez aucun privilège pour apporter des modifications au projet. Tout ce que vous avez à faire est simplement de dupliquer le projet, de cloner le projet sur votre ordinateur, d'apporter des modifications, de transmettre les modifications au référentiel de fork et de faire une demande d'extraction au référentiel de projet d'origine. Si le propriétaire aime les modifications que vous avez apportées, il peut les fusionner avec le projet d'origine. Sinon, il pourra retirer votre demande à tout moment. Une très belle fonctionnalité.
Dans cet article, je vais vous montrer comment faire une pull request dans GitHub. Alors, commençons.
Forking du référentiel GitHub :
Pour créer un référentiel GitHub, accédez à la page du référentiel GitHub (que vous ne possédez pas ou n'avez pas l'autorisation de modifier) sur laquelle vous souhaitez contribuer et cliquez sur Fourchette comme indiqué dans la capture d'écran ci-dessous.
Le référentiel est en cours de fork comme vous pouvez le voir dans la capture d'écran ci-dessous.
Une fois le référentiel forké, il devrait apparaître avec votre nom d'utilisateur comme vous pouvez le voir dans la capture d'écran ci-dessous. Ceci est une copie du référentiel d'origine que vous avez forké.
Clonage du référentiel GitHub :
Maintenant que le référentiel GitHub est fork, vous pouvez apporter les modifications que vous souhaitez ici. Alors, clonons-le.
Pour cloner le référentiel GitHub, cliquez sur Cône ou téléchargement et copiez l'URL du référentiel.
Ensuite, utilisez git clone commande pour cloner le référentiel sur votre ordinateur.
$ git clone https://github.com/dev-shovon/toc-generator-plugin.git
Le dépôt GitHub doit être cloné.
Apporter des modifications au référentiel forké :
Le référentiel que j'ai forké contient 3 fichiers. démo.html, LISEZ-MOI.Maryland, toc_plugin.js. Je vais faire un simple changement pour démo.html et poussez le changement vers GitHub dans cette section.
C'est le contenu du démo.html déposer.
C'est ce que j'obtiens quand je lance le démo.html fichier dans le navigateur. Maintenant, changeons les en-têtes de la table des matières (TOC) en vert.
J'ai ajouté un peu de CSS dans le démo.html pour rendre les en-têtes TOC verts.
Comme vous pouvez le voir, les en-têtes TOC sont verts.
Maintenant, je vais valider les modifications et les pousser vers le référentiel GitHub fork.
Tout d'abord, accédez à votre référentiel Git cloné comme suit :
$ cd toc-generator-plugin/
Maintenant, organisez les changements comme suit :
$ git ajouter -A
Maintenant, faites un nouveau commit comme suit :
$ git commit -m 'a changé la couleur de l'en-tête de la table des matières en vert'
Maintenant, transférez les modifications au référentiel GitHub fork avec la commande suivante :
$ git push origin master
Vous devrez peut-être fournir les informations de connexion de votre compte GitHub. Une fois que vous le faites, les modifications doivent être téléchargées sur GitHub.
Comme vous pouvez le voir, le démo.html le fichier est mis à jour sur GitHub.
Création d'une demande de tirage :
Maintenant, pour créer une pull request, cliquez sur Nouvelle demande de tirage bouton comme indiqué dans la capture d'écran ci-dessous.
Maintenant, assurez-vous que le référentiel de base, la branche de base et les informations de votre référentiel forké sont correctement définis. Une fois que vous avez terminé, cliquez sur Créer une demande de tirage comme indiqué dans la capture d'écran ci-dessous.
Saisissez vos commentaires sur cette pull request afin que l'équipe de développement sache ce que vous essayez de faire. Une fois que vous avez terminé, cliquez sur Créer une demande de tirage comme indiqué dans la capture d'écran ci-dessous.
La pull request doit être créée comme vous pouvez le voir dans la capture d'écran ci-dessous.
Désormais, le propriétaire du référentiel GitHub d'origine verra une nouvelle demande d'extraction.
Si le propriétaire souhaite fusionner les modifications apportées au projet d'origine, il peut le faire. Pour fusionner les modifications, il devra cliquer sur Fusionner la demande d'extraction.
Ensuite, confirmez la demande de fusion en cliquant sur Confirmer la fusion.
Une fois que le propriétaire confirme la demande de fusion, les modifications doivent être fusionnées dans le référentiel GitHub d'origine.
Comme vous pouvez le voir, le démo.html le fichier est mis à jour dans le référentiel d'origine.
Alors, c'est comme ça que vous faites une pull request dans GitHub. Merci d'avoir lu cet article.