Créer un référentiel

Dans cet article

Pour mettre votre projet sur GitHub, vous devez créer un dépôt pour qu’il y réside.

Tool navigation

Créer un référentiel

Vous pouvez stocker un large éventail de projets dans des dépôts GitHub, notamment des projets open source. Avec des projets open source, vous pouvez partager du code pour créer de meilleurs logiciels plus fiables. Vous pouvez utiliser des dépôts pour collaborer avec d’autres personnes et suivre votre travail. Pour plus d’informations, consultez « À propos des dépôts ». Pour en savoir plus sur les projets open source, visitez OpenSource.org.

Remarques :

  • Vous pouvez créer des dépôts publics pour un projet open source. Quand vous créez votre dépôt public, 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 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.
  • Vous pouvez également ajouter des fichiers d’intégrité de la communauté à vos dépôts pour définir des instructions sur la façon de contribuer, de garder vos dépôts en sécurité et bien plus encore. Pour plus d’informations, consultez « Création d’un fichier d’intégrité de la communauté par défaut ».

  1. En haut à droite d’une page, utilisez le menu déroulant et sélectionnez Nouveau dépôt.

    Capture d’écran d’un menu déroulant GitHub montrant les options permettant de créer des éléments. L’élément de menu « Nouveau référentiel » est souligné en orange foncé.

  2. Tapez un nom abrégé et facile à retenir pour votre dépôt. Par exemple, « hello-world ».

    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é.

  3. Ajoutez éventuellement une description pour votre dépôt. Par exemple, « Mon premier dépôt sur GitHub Enterprise Cloud ».

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

  5. Sélectionnez Initialize this repository with a README (Initialiser ce dépôt à l’aide d’un fichier LISEZMOI).

  6. Cliquez sur Créer le dépôt.

Félicitations ! Vous avez réussi à créer votre premier dépôt, puis à l’initialiser avec un fichier LISEZ-MOI.

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

  1. Dans la ligne de commande, accédez au répertoire dans lequel vous voulez créer un clone local de votre nouveau projet.
  2. Pour créer un dépôt pour votre projet, utilisez la sous-commande gh repo create. À l’invite, sélectionnez Créer un dépôt sur GitHub ex nihilo et entrez le nom de votre nouveau projet. Si vous voulez que votre projet appartienne à une organisation plutôt qu’à votre compte personnel, spécifiez le nom de l’organisation et le nom du projet avec organization-name/project-name.
  3. Suivez les invites interactives. Pour cloner le dépôt localement, répondez oui quand vous êtes invité à cloner le répertoire du projet distant.
  4. Sinon, pour ignorer les invites, indiquez le nom du dépôt et un indicateur de visibilité (--public, --private ou --internal). Par exemple : gh repo create project-name --public. Pour cloner le dépôt localement, passez l’indicateur --clone. Pour plus d’informations sur les arguments possibles, consultez le manuel de GitHub CLI.

Commiter votre première modification

Un commit s’apparente à un instantané de tous les fichiers inclus dans votre projet à un moment donné.

Quand vous avez créé votre dépôt, vous l’avez initialisé avec un fichier LISEZ-MOI. Les fichiers LISEZ-MOI sont parfaits pour décrire votre projet plus en détail ou pour ajouter des documents tels que des consignes d’installation ou d’utilisation de votre projet. Le contenu de votre fichier LISEZ-MOI apparaît automatiquement dans la page d’accueil de votre dépôt.

Nous allons commiter une modification apportée au fichier LISEZ-MOI.

  1. Dans la liste de fichiers de votre référentiel, sélectionnez README.md.

    Capture d’écran d’une liste de fichiers dans un dépôt. Un nom de fichier, « README.md » est mis en évidence avec un encadré orange.

  2. En haut à droite de la vue de fichier, cliquez sur pour ouvrir l’éditeur de fichier.

Capture d’écran d’un fichier. Dans l’en-tête, un bouton avec une icône de crayon est indiqué en orange foncé.

  1. Dans la zone de texte, tapez des informations sur vous-même.

  2. Au-dessus du nouveau contenu, cliquez sur Aperçu.

    Capture d’écran d’un fichier en mode d’édition. Au-dessus du contenu du fichier, un onglet intitulé « Aperçu » est indiqué en orange foncé.

  3. Passez en revue les modifications apportées au fichier. Si vous sélectionnez Afficher le diff, vous voyez le nouveau contenu en vert.

    Capture d’écran de la vue « Aperçu » d’un fichier. Une case intitulée « Afficher le diff » est cochée et un ajout au fichier est signalé par un trait vertical vert. Les deux sont encadrés en orange.

  4. Cliquez sur Valider les modifications...

  5. Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Création d’une validation avec plusieurs auteurs ».

  6. Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « Création d’une demande de tirage ».

    Capture d’écran d’une demande de tirage GitHub montrant une case d’option permettant de commiter directement dans la branche main ou de créer une branche. Une nouvelle branche est sélectionnée.

  7. Cliquez sur Valider les modifications ou Proposer des modifications.

Maintenant que vous avez créé un projet, vous pouvez commencer à commiter des modifications.

Les fichiers LISEZ-MOI sont parfaits pour décrire votre projet plus en détail ou pour ajouter des documents tels que des consignes d’installation ou d’utilisation de votre projet. Le contenu de votre fichier LISEZ-MOI apparaît automatiquement dans la page d’accueil de votre dépôt. Suivez ces étapes pour ajouter un fichier LISEZ-MOI.

  1. Dans la ligne de commande, accédez au répertoire racine de votre nouveau projet. (Ce répertoire a été créé lorsque vous avez exécuté la commande gh repo create.)

  2. Créez un fichier LISEZ-MOI contenant quelques informations sur le projet.

    echo "info about this project" >> README.md

  3. Entrez git status. Vous allez voir que vous avez un fichier README.md non suivi.

    $ git status

Untracked files:
  (use "git add <file>..." to include in what will be committed)
  README.md

nothing added to commit but untracked files present (use "git add" to track)

  4. Indexez et commitez le fichier.

    git add README.md && git commit -m "Add README"

  5. Poussez (push) les modifications vers votre branche.

    git push --set-upstream origin HEAD

Étapes suivantes

Vous avez maintenant créé un dépôt, qui comprend un fichier LISEZ-MOI, puis vous avez créé votre premier commit sur GitHub.com.

  • Vous pouvez maintenant cloner un dépôt GitHub pour créer une copie locale sur votre ordinateur. À partir de votre dépôt local, vous pouvez commiter des modifications, puis créer une demande de tirage afin de les mettre à jour dans le dépôt en amont. Pour plus d’informations, consultez « Clonage d’un dépôt » et « Configurer Git ».

  • Vous pouvez trouver des projets et des dépôts intéressants sur GitHub et leur apporter des modifications en créant une duplication (fork) de dépôt. La duplication (fork) d’un dépôt vous permet d’apporter des modifications à un autre dépôt sans affecter l’original. Pour plus d’informations, consultez « Fork a repo ».

  • 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 Enterprise Cloud. Pour plus d’informations, consultez « Prendre part au réseau social ».

  • 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.