{"meta":{"title":"Guide de démarrage rapide pour les dépôts","intro":"Découvrez comment créer un dépôt et commiter votre première modification en 5 minutes.","product":"Référentiels","breadcrumbs":[{"href":"/fr/repositories","title":"Référentiels"},{"href":"/fr/repositories/creating-and-managing-repositories","title":"Créer et gérer des dépôts"},{"href":"/fr/repositories/creating-and-managing-repositories/quickstart-for-repositories","title":"Guide de démarrage rapide pour les dépôts"}],"documentType":"article"},"body":"# Guide de démarrage rapide pour les dépôts\n\nDécouvrez comment créer un dépôt et commiter votre première modification en 5 minutes.\n\n## Créer un référentiel\n\nLes 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.\n\n<div class=\"ghd-tool webui\">\n\n1. Dans le coin supérieur droit de n’importe quelle page, sélectionnez sur <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-plus\" aria-label=\"Create something new\" role=\"img\"><path d=\"M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z\"></path></svg>, puis cliquez sur **Nouveau référentiel**.\n\n   ![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é.](/assets/images/help/repository/repo-create-global-nav-update.png)\n2. Tapez un nom abrégé et facile à retenir pour votre dépôt. Par exemple, « hello-world ».\n\n   ![Capture d’écran d’une première étape de la création d’un référentiel. Le champ « Nom du référentiel » contient le texte « hello-world » et est souligné en orange foncé.](/assets/images/help/repository/create-repository-name.png)\n3. Ajoutez éventuellement une description pour votre dépôt. Par exemple, « Mon premier dépôt sur GitHub ».\n4. Choisissez une visibilité de dépôt. Pour plus d’informations, consultez « [À propos des dépôts](/fr/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility) ».\n5. Réglez l’option **Ajouter README** sur **Actif**.\n6. Cliquez sur **Créer le dépôt**.\n\nFélicitations ! Vous avez réussi à créer votre premier dépôt, puis à l’initialiser avec un fichier *LISEZ-MOI*.\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\n> \\[!NOTE]\n> Pour plus d’informations sur GitHub CLI, consultez [À propos de l’interface CLI GitHub](/fr/github-cli/github-cli/about-github-cli).\n\n1. Dans la ligne de commande, accédez au répertoire dans lequel vous voulez créer un clone local de votre nouveau projet.\n2. Pour créer un dépôt pour votre projet, utilisez la sous-commande `gh repo create`. Lorsque vous y êtes invité, sélectionnez **Créer un nouveau référentiel sur GitHub à partir de zéro** 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`.\n3. 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.\n4. 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 [GitHub manuel CLI](https://cli.github.com/manual/gh_repo_create).\n\n</div>\n\n## Commiter votre première modification\n\n<div class=\"ghd-tool webui\">\n\nUn [commit](/fr/get-started/learning-about-github/github-glossary#commit) s’apparente à un instantané de tous les fichiers inclus dans votre projet à un moment donné.\n\nQuand vous avez créé votre dépôt, vous l’avez initialisé avec un fichier *README*. 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.\n\nNous allons commiter une modification apportée au fichier LISEZ-MOI.\n\n1. Dans la liste de fichiers de votre référentiel, sélectionnez **README.md**.\n\n![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.](/assets/images/help/repository/create-commit-open-readme.png)\n\n1. En haut à droite de la vue de fichier, cliquez sur <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-pencil\" aria-label=\"Edit file\" role=\"img\"><path d=\"M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z\"></path></svg> pour ouvrir l’éditeur de fichier.\n   ![Capture d’écran d’un fichier. Dans l’en-tête, un bouton avec une icône de crayon est indiqué en orange foncé.](/assets/images/help/repository/edit-file-edit-button.png)\n\n2. Dans la zone de texte, tapez des informations sur vous-même.\n\n3. Au-dessus du nouveau contenu, cliquez sur **Aperçu**.\n\n   ![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é.](/assets/images/help/repository/edit-readme-preview-changes.png)\n\n4. Passez en revue les modifications apportées au fichier. Si vous sélectionnez **Afficher le diff**, vous voyez le nouveau contenu en vert.\n\n![Capture d’écran d’un aperçu de fichier. La case à cocher « Afficher la différence » est activée et les ajouts au fichier sont affichés avec une ligne verte. Les deux sont encadrés en orange.](/assets/images/help/repository/create-commit-review.png)\n\n1. Cliquez sur **Commiter les changements**.\n\n2. 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éer un commit avec plusieurs auteurs ou au nom d’une organisation](/fr/pull-requests/how-tos/commit-changes/creating-a-commit-with-multiple-authors) ».\n\n3. 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 nouvelle branche pour y effectuer votre commit, puis créer une pull request. Pour plus d’informations, consultez « [Création d’une pull request](/fr/pull-requests/how-tos/create-pull-requests/creating-a-pull-request) ».\n\n   ![Capture d’écran d’une pull request GitHub montrant un bouton radio permettant soit de valider directement sur la branche main, soit de créer une nouvelle branche. Une nouvelle branche est sélectionnée.](/assets/images/help/repository/choose-commit-branch.png)\n\n4. Cliquez sur **Valider les modifications** ou **Proposer des modifications**.\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\nMaintenant que vous avez créé un projet, vous pouvez commencer à commiter des modifications.\n\nLes 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*.\n\n1. 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`.)\n\n2. Créez un fichier *LISEZ-MOI* contenant quelques informations sur le projet.\n\n   ```shell\n   echo \"info about this project\" >> README.md\n   ```\n\n3. Saisissez `git status`. Vous allez voir que vous avez un fichier `README.md` non suivi.\n\n   ```shell\n   $ git status\n\n   Untracked files:\n     (use \"git add <file>...\" to include in what will be committed)\n     README.md\n\n   nothing added to commit but untracked files present (use \"git add\" to track)\n   ```\n\n4. Indexez et commitez le fichier.\n\n   ```shell\n   git add README.md && git commit -m \"Add README\"\n   ```\n\n5. Poussez (push) les modifications vers votre branche.\n\n   ```shell\n   git push --set-upstream origin HEAD\n   ```\n\n</div>\n\n## Étapes suivantes\n\nVous avez maintenant créé un dépôt, qui comprend un fichier *README*, puis vous avez créé votre premier commit sur GitHub.\n\n<div class=\"ghd-tool webui\">\n\n* 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](/fr/repositories/creating-and-managing-repositories/cloning-a-repository) » et « [Configurer Git](/fr/get-started/git-basics/set-up-git) ».\n\n</div>\n\n* Sécurisez votre référentiel à l’aide des fonctionnalités de sécurité disponibles de GitHub. Pour plus d’informations, consultez « [Guide de démarrage rapide pour sécuriser votre référentiel](/fr/code-security/getting-started/quickstart-for-securing-your-repository) ».\n\n* 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 un référentiel](/fr/pull-requests/how-tos/work-with-forks/fork-a-repo) ».\n\n* 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 vous connectant à eux et en les suivant sur GitHub. Pour plus d’informations, consultez « [Découverte de projets sur GitHub](/fr/get-started/exploring-projects-on-github/discovering-projects-on-github) ».\n\n* 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](https://github.com/orgs/community/discussions)."}