Skip to main content

Guide de démarrage rapide pour les dépôts

Découvrez comment créer un dépôt et commiter votre première modification en 5 minutes.

Tool navigation

Créer un référentiel

Les dépôts GitHub permettent de stocker de nombreux types de projets. Dans ce guide, vous allez créer un dépôt et commiter votre première modification.

Note

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

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 créé votre premier commit sur GitHub.

  • Sécurisez votre référentiel à l’aide des fonctionnalités de sécurité disponibles de GitHub. Pour plus d’informations, consultez « Démarrage rapide pour la sécurisation de votre dépôt ».

  • 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 « Dupliquer (fork) un référentiel ».

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