Forking : création de votre propre copie du référentiel
Leforking est un concept central dans le monde du versioning de code avec Git et les plateformes d'hébergement de code comme GitHub. Lorsque vous créez un référentiel, vous créez une copie personnelle du référentiel de quelqu'un d'autre dans votre propre compte GitHub. Cette copie est indépendante du référentiel d'origine et vous sert de point de départ pour apporter vos propres modifications sans affecter le projet d'origine.
Pourquoi Fork ?
Forker un dépôt peut avoir plusieurs motivations. Le plus courant est lorsque vous souhaitez contribuer à un projet mais que vous n'êtes pas autorisé à le pousser directement vers le référentiel d'origine. Lorsque vous créez un fork, vous obtenez une copie sur laquelle vous pouvez travailler librement. Après avoir effectué vos modifications, vous pouvez proposer qu'elles soient intégrées au projet d'origine via une pull request.
Une autre raison de forker est lorsque vous souhaitez utiliser le projet comme point de départ pour développer une nouvelle fonctionnalité ou même un nouveau projet. Le fork vous permet d'hériter de tout l'historique de développement jusqu'à ce point et de continuer à partir de là.
Comment créer un fork sur GitHub
Pour créer un dépôt sur GitHub, vous devez avoir un compte sur la plateforme. Une fois connecté, suivez ces étapes :
- Accédez à la page du référentiel que vous souhaitez créer.
- Dans le coin supérieur droit de la page, cliquez sur le bouton Fork.
- Si vous appartenez à plusieurs organisations, sélectionnez où vous souhaitez bifurquer.
- GitHub lancera le processus de fork et, dans quelques secondes, vous serez redirigé vers la page de votre nouveau fork.
Félicitations ! Vous disposez désormais d'une copie du référentiel dans votre compte GitHub.
Gérer votre fourchette
Après avoir créé un fork, il est important de le gérer correctement. Cela inclut de garder votre fork synchronisé avec le référentiel d'origine, ce qui est essentiel pour éviter les conflits lorsque vous essayez d'apporter vos modifications.
Pour synchroniser votre fork, vous devez configurer une télécommande pointant vers le référentiel d'origine. Cela peut être fait comme suit :
git distant ajouté en amont https://github.com/original_owner/original_repository.git
Avec la configuration à distance en amont, vous pouvez récupérer les dernières modifications du référentiel d'origine en utilisant :
git fetch en amont
Vous pouvez ensuite fusionner ces modifications dans votre branche principale (généralement appelée master ou main) avec :
git checkout principal
git fusionner en amont/main
Si vous avez des modifications locales qui n'ont pas encore été validées dans votre fork sur GitHub, vous devrez peut-être résoudre les conflits avant de terminer la fusion.
Contribuer avec des Pull Requests
Après avoir apporté vos modifications à votre fork, vous souhaiterez peut-être qu'elles soient incluses dans le référentiel d'origine. Pour ce faire, vous devez ouvrir une pull request. Voici les étapes de base :
- Publiez vos modifications sur votre fork sur GitHub.
- Accédez à la page GitHub de votre fork.
- Cliquez sur le bouton Nouvelle demande de tirage.
- Examinez les modifications proposées et assurez-vous qu'elles sont correctes.
- Si tout va bien, cliquez sur Créer une demande de tirage.
- Donnez un titre et une description détaillée de votre demande d'extraction et soumettez-la.
Désormais, les responsables du référentiel d'origine peuvent examiner votre demande d'extraction. Ils peuvent l'accepter, demander des modifications ou le rejeter.
Bonnes pratiques lors du forking
Lors du fork d'un dépôt, il est important de suivre quelques bonnes pratiques :
- Respectez la licence du projet : avant de bifurquer, assurez-vous de bien comprendre la licence sous laquelle le projet est distribué et d'en respecter les termes.
- Gardez votre fork à jour : Synchronisez régulièrement votre fork avec le référentiel d'origine pour éviter les conflits.
- Contribuer en retour : Si vous apportez des améliorations significatives à votre fork, envisagez de contribuer au projet d'origine.
Conclusion
Forking est un outil puissant qui permet la collaboration et l'innovation dans le développement de logiciels. En créant votre propre copie d'un référentiel, vous pouvez expérimenter, contribuer et même donner vie à de nouveaux projets. N'oubliez pas de gérer votre fork avec soin et de contribuer à la communauté autant que possible.
Grâce à ces connaissances, vous êtes prêt à lancer des projets sur GitHub et à commencer à collaborer dans le vaste monde du développement de logiciels open source.
