Dupliquer (fork) un référentiel

Une duplication est un nouveau référentiel qui partage le code et les paramètres de visibilité avec le référentiel « en amont » d’origine.

Platform navigation

Dans cet article

À propos des duplications (fork)

Une duplication est un nouveau référentiel qui partage le code et les paramètres de visibilité avec le référentiel « en amont » d’origine. Les duplications sont souvent utilisées pour itérer sur les idées ou les modifications avant qu’elles ne soient proposées à nouveau au référentiel en amont, par exemple dans des projets open source ou lorsqu’un utilisateur n’a pas d’accès en écriture au référentiel en amont. Pour plus d’informations, consultez Utilisation des duplications.

Proposer des modifications à apporter au projet d’une autre personne

Par exemple, vous pouvez utiliser des duplications pour proposer des modifications liées à la correction d’un bogue. Au lieu de journaliser un problème pour un bogue que vous avez trouvé, vous pouvez :

  • Dupliquez (fork) le dépôt.
  • Appliquer le correctif.
  • Soumettre une demande de tirage au propriétaire du projet.

Utiliser le projet d’une autre personne comme point de départ de votre propre idée.

Les logiciels open source reposent sur l’idée que le partage de leur code nous permet de les améliorer et de les rendre plus fiables. Pour plus d’informations, consultez À propos de l’initiative open source sur le site Open Source Initiative.

Pour plus d’informations sur l’application des principes open source au travail de développement de votre organisation sur GitHub, consultez le livre blanc de GitHub intitulé An introduction to innersource.

Quand vous créez votre dépôt public à partir d’une duplication du projet d’une autre personne, veillez à inclure un fichier de licence qui détermine la façon dont vous souhaitez que votre projet soit partagé avec d’autres personnes. Pour plus d’informations, consultez la page Choisir une licence open source du site choosealicense.com.

Pour plus d’informations sur l’open source, plus précisément sur la manière de créer et de faire évoluer un projet open source, nous avons créé des Guides Open Source qui vous aideront à promouvoir une communauté open source saine en recommandant des meilleures pratiques pour la création et la gestion des dépôts pour votre projet open source. Vous pouvez également suivre un cours gratuit GitHub Skills sur la maintenance des communautés open source.

Prérequis

Si vous ne l’avez pas encore fait, configurez d’abord Git et l’authentification avec GitHub.com à partir de Git. Pour plus d’informations, consultez « Configurer Git ».

Duplication d’un dépôt

Vous pouvez dupliquer un projet pour proposer des modifications au référentiel en amont. Dans ce cas, une bonne pratique consiste à synchroniser régulièrement votre duplication avec le dépôt en amont. Pour cela, vous avez besoin d’utiliser Git sur la ligne de commande. Vous pouvez vous entraîner à définir le dépôt en amont à l’aide du même dépôt octocat/Spoon-Knife que vous venez de dupliquer (fork).

  1. Sur GitHub, accédez au dépôt octocat/Spoon-Knife.

  2. Dans le coin supérieur droit de la page, cliquez sur Dupliquer.

    Capture d’écran de la page principale d’un dépôt. Un bouton, étiqueté avec une icône de duplication (fork) et « Fork 59.3k », est encadré en orange foncé.

  3. Sous « Propriétaire », sélectionnez le menu déroulant et cliquez sur un propriétaire pour le dépôt dupliqué.

  4. Par défaut, les duplications ont le même nom que leurs référentiels en amont. Si vous le souhaitez, pour mieux distinguer votre duplication, dans le champ « Nom du dépôt », tapez un nom.

  5. Dans le champ « Description », vous pouvez taper la description de votre duplication.

  6. Si vous le souhaitez, sélectionnez Copier la branche PAR DÉFAUT uniquement.

    Dans de nombreux scénarios de duplication, tels que la contribution à des projets open source, vous devez uniquement copier la branche par défaut. Si vous ne sélectionnez pas cette option, toutes les branches sont copiées dans la nouvelle duplication.

  7. Cliquez sur Créer une duplication.

Note

Si vous souhaitez copier des branches supplémentaires à partir du référentiel en amont, vous pouvez le faire depuis la page Branches. Pour plus d’informations, consultez « Création et suppression de branches dans votre référentiel ».

Note

Pour plus d’informations sur GitHub CLI, consultez « À propos de GitHub CLI ».

Pour créer une duplication d’un dépôt, utilisez la sous-commande gh repo fork.

gh repo fork REPOSITORY

Pour créer la duplication dans une organisation, utilisez l’indicateur --org.

gh repo fork REPOSITORY --org "octo-org"

Vous pouvez dupliquer un dépôt sur GitHub.com ou dans GitHub Desktop. Pour plus d’informations sur la duplication sur GitHub.com, consultez la version Navigateur web de cet article.

Dans GitHub Desktop, si vous tentez de cloner un dépôt auquel vous n’avez pas accès en écriture, une duplication est automatiquement créée pour vous.

  1. Dans le menu Fichier, cliquez sur Cloner le dépôt.

    Capture d’écran de la barre de menus sur un Mac. Le menu déroulant « Fichier » est développé et l’option « Cloner le dépôt » est mise en évidence avec un contour orange.

    Capture d’écran de la barre de menus « GitHub Desktop » sur Windows. Le menu déroulant « Fichier » est développé et l’option « Cloner le dépôt » est mise en évidence avec un contour orange.

  2. Cliquez sur l’onglet qui correspond à l’emplacement du dépôt à cloner. Vous pouvez aussi cliquer sur l’URL pour entrer manuellement l’emplacement du dépôt.

    Capture d’écran de la fenêtre « Cloner un dépôt ». En haut de la fenêtre, les onglets intitulés « GitHub.com », « GitHub Enterprise » et « URL » sont mis en évidence avec un contour orange.

  3. Dans la liste des dépôts, cliquez sur le dépôt que vous souhaitez cloner.

    Capture d’écran de la fenêtre « Cloner un dépôt ». Le dépôt « github/docs », est mis en évidence avec un encadré orange.

  4. Pour sélectionner le répertoire local dans lequel vous souhaitez cloner le dépôt, en regard du champ « Chemin d’accès local », cliquez sur Choisir... et accédez au répertoire.

    Capture d’écran de la fenêtre « Cloner un dépôt ». Un bouton, intitulé « Choisir », est mis en évidence avec un encadré orange.

  5. En bas de la fenêtre « Cloner un dépôt », cliquez sur Cloner.

  6. Lisez les informations de la section « Comment envisagez-vous d’utiliser cette duplication ? » .

    • Si vous envisagez d’utiliser cette duplication pour contribuer au dépôt en amont d’origine, cliquez sur Pour contribuer au projet parent.
    • Si vous envisagez d’utiliser cette duplication pour un projet qui n’est pas connecté à l’amont, cliquez Pour mon propre usage.

  7. Cliquez sur Continuer.

Clonage de votre dépôt dupliqué

Pour l’instant, vous disposez d’une duplication du dépôt Spoon-Knife, mais les fichiers inclus dans ce dépôt ne sont pas localement sur votre ordinateur.

  1. Sur GitHub, accédez à votre duplication du dépôt Spoon-Knife.

  2. Au-dessus de la liste des fichiers, cliquez sur Code.

    Capture d’écran de la liste des fichiers dans la page d’accueil d’un dépôt. Le bouton « Code » est mis en évidence avec un encadré orange foncé.

  3. Copiez l’URL du dépôt.

    • Pour cloner le dépôt avec le protocole HTTPS, sous « HTTPS », cliquez sur .

    • Pour cloner le dépôt avec une clé SSH, en incluant un certificat émis par l’autorité de certification SSH de votre organisation, cliquez sur SSH et sur .

    • Pour cloner un dépôt avec l’GitHub CLI, cliquez sur GitHub CLI et sur .

      Capture d’écran du menu déroulant « Code ». À droite de l’URL HTTPS du dépôt, une icône de copie est indiquée en orange foncé.

  4. Ouvrez TerminalTerminalGit Bash.

  5. Remplacez le répertoire de travail actuel par l’emplacement où vous voulez mettre le répertoire cloné.

  6. Tapez git clone, puis collez l’URL que vous avez copiée précédemment. Voici ce à quoi cela ressemble, avec votre nom d’utilisateur GitHub au lieu de YOUR-USERNAME :

    git clone https://github.com/YOUR-USERNAME/Spoon-Knife

  7. Appuyez sur Entrée. Votre clone local va être créé.

    $ git clone https://github.com/YOUR-USERNAME/Spoon-Knife
> Cloning into `Spoon-Knife`...
> remote: Counting objects: 10, done.
> remote: Compressing objects: 100% (8/8), done.
> remote: Total 10 (delta 1), reused 10 (delta 1)
> Unpacking objects: 100% (10/10), done.

Note

Pour plus d’informations sur GitHub CLI, consultez « À propos de GitHub CLI ».

Pour créer un clone de votre duplication, utilisez l’indicateur --clone.

gh repo fork REPOSITORY --clone=true

  1. Dans le menu Fichier, cliquez sur Cloner le dépôt.

    Capture d’écran de la barre de menus sur un Mac. Le menu déroulant « Fichier » est développé et l’option « Cloner le dépôt » est mise en évidence avec un contour orange.

    Capture d’écran de la barre de menus « GitHub Desktop » sur Windows. Le menu déroulant « Fichier » est développé et l’option « Cloner le dépôt » est mise en évidence avec un contour orange.

  2. Cliquez sur l’onglet qui correspond à l’emplacement du dépôt à cloner. Vous pouvez aussi cliquer sur l’URL pour entrer manuellement l’emplacement du dépôt.

    Capture d’écran de la fenêtre « Cloner un dépôt ». En haut de la fenêtre, les onglets intitulés « GitHub.com », « GitHub Enterprise » et « URL » sont mis en évidence avec un contour orange.

  3. Dans la liste des dépôts, cliquez sur le dépôt que vous souhaitez cloner.

    Capture d’écran de la fenêtre « Cloner un dépôt ». Le dépôt « github/docs », est mis en évidence avec un encadré orange.

  4. Pour sélectionner le répertoire local dans lequel vous souhaitez cloner le dépôt, en regard du champ « Chemin d’accès local », cliquez sur Choisir... et accédez au répertoire.

    Capture d’écran de la fenêtre « Cloner un dépôt ». Un bouton, intitulé « Choisir », est mis en évidence avec un encadré orange.

  5. En bas de la fenêtre « Cloner un dépôt », cliquez sur Cloner.

Configuration de Git pour synchroniser votre duplication avec le référentiel en amont

Quand vous dupliquez un projet pour proposer des modifications du référentiel en amont, vous pouvez configurer Git pour tirer (pull) des modifications depuis le référentiel en amont vers le clone local de votre duplication.

  1. Sur GitHub, accédez au dépôt octocat/Spoon-Knife.

  2. Au-dessus de la liste des fichiers, cliquez sur Code.

    Capture d’écran de la liste des fichiers dans la page d’accueil d’un dépôt. Le bouton « Code » est mis en évidence avec un encadré orange foncé.

  3. Copiez l’URL du dépôt.

    • Pour cloner le dépôt avec le protocole HTTPS, sous « HTTPS », cliquez sur .

    • Pour cloner le dépôt avec une clé SSH, en incluant un certificat émis par l’autorité de certification SSH de votre organisation, cliquez sur SSH et sur .

    • Pour cloner un dépôt avec l’GitHub CLI, cliquez sur GitHub CLI et sur .

      Capture d’écran du menu déroulant « Code ». À droite de l’URL HTTPS du dépôt, une icône de copie est indiquée en orange foncé.

  4. Ouvrez TerminalTerminalGit Bash.

  5. Changez de répertoire pour accéder à l’emplacement de la duplication que vous avez clonée.

    • Pour accéder à votre répertoire de base, tapez simplement cd sans aucun autre texte.
    • Pour lister les fichiers et dossiers inclus dans votre répertoire actuel, tapez ls.
    • Pour accéder à l’un de vos répertoires listés, tapez cd YOUR-LISTED-DIRECTORY.
    • Pour monter d’un répertoire, tapez cd ...

  6. Tapez git remote -v, puis appuyez sur Entrée. Vous allez voir le dépôt distant actuellement configuré pour votre duplication.

    $ git remote -v
> origin  https://github.com/YOUR-USERNAME/YOUR-FORK.git (fetch)
> origin  https://github.com/YOUR-USERNAME/YOUR-FORK.git (push)

  7. Tapez git remote add upstream, collez l’URL que vous avez copiée à l’étape 3, puis appuyez sur Entrée. Voici le résultat :

    git remote add upstream https://github.com/ORIGINAL-OWNER/Spoon-Knife.git

  8. Pour vérifier le nouveau dépôt en amont que vous avez spécifié pour votre duplication, retapez git remote -v. Vous devriez voir l’URL de votre duplication indiquée en tant que origin et l’URL du référentiel en amont indiquée en tant que upstream.

    $ git remote -v
> origin    https://github.com/YOUR-USERNAME/YOUR-FORK.git (fetch)
> origin    https://github.com/YOUR-USERNAME/YOUR-FORK.git (push)
> upstream  https://github.com/ORIGINAL-OWNER/ORIGINAL-REPOSITORY.git (fetch)
> upstream  https://github.com/ORIGINAL-OWNER/ORIGINAL-REPOSITORY.git (push)

À présent, vous pouvez garder votre duplication synchronisée avec le dépôt en amont à l’aide de quelques commandes Git. Pour plus d’informations, consultez « Synchronisation d’une duplication ».

Note

Pour plus d’informations sur GitHub CLI, consultez « À propos de GitHub CLI ».

Pour configurer un dépôt distant pour le dépôt dupliqué, utilisez l’indicateur --remote.

gh repo fork REPOSITORY --remote=true

Pour spécifier le nom du dépôt distant, utilisez l’indicateur --remote-name.

gh repo fork REPOSITORY --remote-name "main-remote-repo"

Modification d’une duplication

Vous pouvez apporter des modifications à une duplication, notamment :

  • Créer des branches : Les branches vous permettent de générer de nouvelles fonctionnalités ou de tester des idées sans faire courir le moindre risque à votre projet principal (main).
  • Ouvrir des demandes de tirage : si vous espérez contribuer à nouveau au référentiel en amont, vous pouvez demander à l’auteur original de tirer votre duplication dans son référentiel en lui envoyant une demande de tirage.

Rechercher un autre dépôt à dupliquer

Dupliquez un dépôt pour commencer à contribuer à un projet. Vous pouvez dupliquer n’importe quel dépôt public sur votre compte personnel ou sur une organisation où vous avez l’autorisation de créer des dépôts. Si vous avez accès à un dépôt privé dont le propriétaire autorise la duplication, vous pouvez dupliquer le dépôt sur votre compte personnel ou sur une organisation sur GitHub Team où vous avez l’autorisation de créer des dépôts. Vous ne pouvez pas dupliquer un dépôt privé vers une organisation en utilisant GitHub Free. Pour plus d’informations sur GitHub Team et GitHub Free, consultez « Plans de GitHub ». Pour plus d’informations sur le moment où vous pouvez dupliquer un référentiel, consultez À propos des autorisations et de la visibilité des duplications.

Vous pouvez parcourir la page Explorer GitHub pour trouver des projets et commencer à apporter votre contribution à des référentiels open source. Pour plus d’informations, consultez « Trouver des moyens de contribuer à l’open source sur GitHub ».

Étapes suivantes

Vous avez maintenant dupliqué un dépôt, vous vous êtes entraîné à cloner votre duplication et vous avez configuré un dépôt en amont.

  • Pour plus d’informations sur le clonage de la duplication et la synchronisation des modifications dans un référentiel dupliqué à partir de votre ordinateur, consultez Configurer Git.

  • Vous pouvez également créer un dépôt dans lequel vous pouvez placer tous vos projets et partager le code sur GitHub. La création d’un référentiel pour votre projet vous permet de stocker du code dans GitHub. Cela fournit une sauvegarde de votre travail que vous pouvez choisir de partager avec d’autres développeurs. Pour plus d’informations, consultez « Guide de démarrage rapide pour les dépôts ».

  • Chaque dépôt sur GitHub appartient à une personne ou à une organisation. Vous pouvez interagir avec les personnes, les dépôts et les organisations en les connectant et en les suivant sur GitHub. Pour plus d’informations, consultez « Trouver l'inspiration sur GitHub ».

  • GitHub dispose d’une vaste communauté de support dans laquelle vous pouvez demander de l’aide et parler avec des personnes du monde entier. Participez à la conversation dans GitHub Community.