Création d’un dépôt à partir d’un modèle

Vous pouvez générer un nouveau dépôt avec les mêmes structure de répertoires et fichiers qu’un dépôt existant.

Qui peut utiliser cette fonctionnalité ?

Anyone with read access to a template repository can create a repository from that template.

Dans cet article

À propos des modèles de dépôt

Vous pouvez créer un modèle à partir d’un référentiel existant. Toute personne ayant accès au référentiel modèle peut créer un référentiel basé sur le modèle avec la même structure d’annuaire, branches et fichiers. Pour plus d’informations sur la création d’un modèle de référentiel, consultez « Création d’un modèle de dépôt ».

Astuce : vous pouvez également créer un dépôt à partir d’un modèle à l’aide de la GitHub CLI. Pour plus d’informations, consultez « gh repo create » dans la documentation GitHub CLI.

Vous pouvez choisir d’inclure la structure et les fichiers de répertoire uniquement à partir de la branche par défaut du modèle de dépôt, ou d’inclure toutes les branches. Les branches créées à partir d’un modèle ont des historiques séparés, ce qui signifie que vous ne pouvez pas créer de demandes de tirage ou de fusion entre les branches.

La création d’un dépôt à partir d’un modèle est similaire à la duplication d’un dépôt, mais il existe des différences importantes :

  • Une nouvelle duplication inclut tout l’historique de validation du dépôt parent, tandis qu’un dépôt créé à partir d’un modèle commence avec une validation unique.
  • Les validations d’une duplication n’apparaissent pas dans votre graphique de contributions, tandis que les validations d’un dépôt créé à partir d’un modèle apparaissent dans votre graphique de contribution.
  • Une duplication peut être un moyen temporaire de contribuer au code d’un projet existant, tandis que la création d’un dépôt à partir d’un modèle démarre un nouveau projet rapidement.

Pour plus d’informations sur les duplications, consultez « À propos des duplications (fork) ».

Création d’un dépôt à partir d’un modèle

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Au-dessus de la liste de fichiers, cliquez sur Utiliser ce modèle.

  3. Sélectionnez Créer un dépôt.

    Capture d’écran du bouton « Utiliser ce modèle » et du menu déroulant développé pour afficher l’option « Ouvrir dans un codespace ».

    Remarque : Vous pouvez également ouvrir le modèle dans un codespace et publier votre travail sur un nouveau dépôt plus tard. Pour plus d’informations, consultez « Création d’un codespace à partir d’un modèle ».

  4. Utilisez le menu déroulant Propriétaire pour sélectionner le compte auquel vous voulez donner la propriété du dépôt.

    Capture d’écran du menu propriétaire d’un nouveau dépôt GitHub. Le menu montre deux options, octocat et github.

  5. Tapez un nom pour votre dépôt et une description facultative.

    Capture d’écran de la première étape de la création d’un référentiel GitHub. Le champ « Nom du référentiel » contient le texte « hello-world » et est souligné en orange foncé.

  6. Choisissez une visibilité de dépôt. Pour plus d’informations, consultez « À propos des dépôts ».

  7. Si vous le souhaitez, pour inclure la structure et les fichiers de répertoire de toutes les branches dans le modèle, et pas seulement de la branche par défaut, sélectionnez Inclure toutes les branches.

  8. Si le compte personnel ou l’organisation que vous créez utilise des GitHub Apps de GitHub Marketplace, sélectionnez les applications que vous voulez utiliser dans le dépôt.

  9. Cliquez sur Create repository from template (Créer un référentiel à partir du modèle).