Création de votre premier dépôt à l’aide de GitHub Desktop

Introduction

GitHub Desktop est une application open source gratuite qui vous permet d’utiliser du code hébergé sur GitHub ou d’autres services d’hébergement Git. Avec GitHub Desktop, vous pouvez effectuer des commandes Git, telles que la validation et l’envoi (push) de modifications, dans une interface utilisateur graphique, plutôt que d’utiliser la ligne de commande. Pour plus d’informations, consultez « À propos de GitHub Desktop ».

À la fin de ce guide, vous aurez utilisé GitHub Desktop pour créer un référentiel, apporter des modifications au référentiel et publier les modifications dans GitHub.

Après avoir installé GitHub Desktop et vous être connecté à GitHub ou à GitHub Enterprise, vous pouvez créer et cloner un dépôt de tutoriel. Le tutoriel présentera les bases de l’utilisation de Git et GitHub, notamment l’installation d’un éditeur de texte, la création d’une branche, la création d’un commit, l’envoi vers GitHub et l’ouverture d’une pull request. Le tutoriel est disponible si vous n’avez pas encore de dépôts sur GitHub Desktop.

Nous vous recommandons de suivre le didacticiel, mais si vous souhaitez explorer GitHub Desktop en créant un dépôt, ce guide vous guidera tout au long de l’utilisation GitHub Desktop pour travailler sur un dépôt Git.

Partie 1 : Installation GitHub Desktop et authentification de votre compte

Vous pouvez installer GitHub Desktop sur n’importe quel système d’exploitation pris en charge. Après avoir installé l’application, vous devez vous connecter et authentifier votre compte sur GitHub ou GitHub Enterprise avant de pouvoir créer et cloner un référentiel de tutoriels.

Pour plus d’informations sur l’installation et l’authentification, consultez Configuration de GitHub Desktop.

Partie 2 : Création d’un dépôt

Si vous n’avez pas de référentiels associés GitHub Desktop, vous verrez un message « Commençons ! » À partir de cette vue, vous pouvez créer et cloner un dépôt de tutoriel, cloner un dépôt existant provenant d’Internet, créer un dépôt ou ajouter un dépôt existant depuis votre disque dur.

Capture d’écran de « Commençons ! » afficher dans GitHub Desktop.

Création et clonage d’un dépôt de tutoriel

Nous vous recommandons de créer et de cloner un référentiel de tutoriels en tant que premier projet à utiliser GitHub Desktop.

Cliquez sur Créer un dépôt de tutoriel... .
Suivez les instructions du tutoriel pour installer un éditeur de texte, créer une branche, modifier un fichier, faire un commit, publier sur GitHub et ouvrir une pull request.

Création d’un dépôt

Si vous ne souhaitez pas créer et cloner un dépôt pour le tutoriel, vous pouvez créer un nouveau dépôt.

Cliquez sur Créer un dépôt sur le disque dur... .
Dans la fenêtre « Créer un dépôt », renseignez les champs et sélectionnez vos options préférées.
- « Name » définit le nom de votre référentiel localement et sur GitHub.
- « Description » est un champ facultatif qui vous permet de fournir plus d’informations sur la finalité de votre dépôt.
- « Chemin local » définit l’emplacement du dépôt sur votre ordinateur. Par défaut, GitHub Desktop crée un dossier GitHub à l’intérieur de votre dossier Documents pour stocker vos dépôts, mais vous pouvez choisir n’importe quel emplacement sur votre ordinateur. Votre nouveau dépôt sera un dossier situé à l’emplacement choisi. Par exemple, si vous nommez votre dépôt Tutorial, un dossier nommé Tutorial est créé dans le dossier que vous avez sélectionné pour votre chemin local. GitHub Desktop mémorise votre emplacement choisi la prochaine fois que vous créez ou clonez un nouveau référentiel.
- Initialiser ce dépôt avec un fichier README permet de créer un commit initial avec un fichier README.md. Les fichiers README aident les utilisateurs à comprendre la finalité de votre projet. Nous vous recommandons donc de cocher cette option et de fournir des informations pertinentes. Lorsque quelqu’un visite votre dépôt sur GitHub, le fichier README est la première chose qu’ils verront lorsqu’ils découvriront votre projet. Pour plus d’informations, consultez « À propos du fichier README d’un référentiel ».
- Le menu déroulant À ignorer par Git vous permet d’ajouter un fichier personnalisé pour ignorer au sein de votre dépôt local des fichiers spécifiques que vous ne souhaitez pas stocker dans la gestion de versions. Si vous comptez utiliser un langage ou un framework spécifique, vous pouvez sélectionner une option dans la liste disponible. Si vous êtes débutant, n’hésitez pas à ignorer cette sélection. Pour plus d’informations, consultez « Ignorer des fichiers ».
- Le menu déroulant Licence vous permet d’ajouter une licence open source à un fichier LICENSE dans votre dépôt. Vous n’avez pas à vous soucier de l’ajout d’une licence dans l’immédiat. Pour plus d’informations sur les licences open source disponibles et sur la façon de les ajouter à votre référentiel, consultez Gestion des licences d’un référentiel.
Cliquez sur Créer un dépôt.

Partie 3 : Exploration GitHub Desktop

Dans le menu fichier en haut de l’écran, vous pouvez accéder aux paramètres et actions que vous pouvez effectuer en GitHub Desktop. La plupart des actions ont également des raccourcis clavier pour vous aider à travailler plus efficacement. Pour obtenir la liste complète des raccourcis clavier, consultez Raccourcis clavier GitHub Desktop.

La barre de dépôt GitHub Desktop

En haut de l’application GitHub Desktop , vous verrez une barre qui affiche l’état actuel de votre référentiel.

Capture d’écran de l’application de bureau GitHub. Une barre affichant les détails du dépôt « hello-world » s’étend en haut de la fenêtre et est présentée en orange.

Dépôt actuel affiche le nom du dépôt que vous utilisez. Vous pouvez cliquer sur Dépôt actuel pour basculer vers un autre référentiel dans GitHub Desktop.
Branche actuelle affiche le nom de la branche que vous utilisez. Vous pouvez cliquer sur Branche actuelle pour voir toutes les branches de votre dépôt, passer à une autre branche ou créer une branche. Une fois que vous avez créé des pull requests dans votre dépôt, vous pouvez également les voir en cliquant sur Branche actuelle.
Publier le dépôt s’affiche parce que vous n’avez pas encore publié votre dépôt sur GitHub, ce que vous ferez plus tard, à l’étape suivante. Cette section de la barre change en fonction de l’état de votre branche et de votre dépôt actuels. Différentes actions contextuelles sont disponibles pour vous permettre d’échanger des données entre vos dépôts locaux et distants.

Changements et historique

Dans la barre latérale gauche, vous trouverez les vues Changements et Historique.

Capture d’écran de l’application de bureau GitHub. Une barre latérale sur le côté gauche, avec des onglets intitulés « Changements » et « Historique », est soulignée en orange.

La vue Changements montre les changements que vous avez apportés aux fichiers de votre branche actuelle, mais que vous n’avez pas commités dans votre dépôt local. Vers le bas, vous trouverez une zone contenant les zones de texte « Récapitulatif » et « Description » ainsi qu’un bouton Commiter dans BRANCHE. C’est là que vous commitez les nouveaux changements. Le bouton Commiter dans BRANCHE est dynamique. Il permet d’afficher la branche dans laquelle vous commitez vos changements.
La vue Historique affiche les commits précédents dans la branche actuelle de votre dépôt. Vous devriez voir un « commit initial » créé par GitHub Desktop lorsque vous avez créé votre dépôt. À droite de la validation, selon les options que vous avez sélectionnées au moment de la création de votre dépôt, vous pouvez voir les fichiers .gitattributes, .gitignore, LICENSE ou README. Vous pouvez cliquer sur chaque fichier pour voir les différences qui lui correspondent, c’est-à-dire les changements apportés au fichier dans le commit. L’affichage des différences montre uniquement les parties du fichier qui ont changé, et non l’intégralité du contenu de ce fichier

Partie 4 : Publication de votre référentiel dans GitHub

Quand vous créez un dépôt, il existe uniquement sur votre ordinateur. Vous êtes le seul à pouvoir y accéder. Vous pouvez publier votre référentiel pour GitHub le conserver synchronisé sur plusieurs ordinateurs et autoriser d’autres personnes à y accéder. Pour publier votre référentiel, envoyez (push) vos modifications locales vers GitHub.

Dans la barre du référentiel, cliquez sur Publier le référentiel.

Capture d’écran de la barre du dépôt. Un bouton, intitulé « Publier le dépôt », est mis en évidence avec un encadré orange.

Dans la fenêtre « Publier le dépôt », entrez les détails de votre nouveau dépôt.
- GitHub Desktop remplit automatiquement les champs « Nom » et « Description » avec les informations que vous avez entrées lors de la création du référentiel.
- Garder ce code privé vous permet de contrôler la visibilité de votre projet. Si vous laissez cette option non sélectionnée, d’autres utilisateurs GitHub pourront afficher votre code. Si vous sélectionnez cette option, votre code ne sera pas accessible publiquement.
- Le menu déroulant Organisation , le cas échéant, vous permet de publier votre dépôt dans une organisation spécifique sur laquelle GitHubvous appartenez.
1. Cliquez sur Publier le référentiel.
2. Vous pouvez accéder au dépôt sur GitHub depuis GitHub Desktop. Dans le menu Fichier, cliquez sur Dépôt, puis sur Voir sur GitHub. Cela vous amène directement au dépôt dans votre navigateur par défaut.

Partie 5 : Apport, commit et poussée de changements

Une fois que vous avez créé et publié votre dépôt, vous êtes prêt à apporter des changements à votre projet et à créer votre premier commit pour votre dépôt.

Pour lancer votre éditeur externe à partir de l’intérieur GitHub Desktop, dans la barre de menus «GitHub Desktop », sélectionnez Référentiel, puis cliquez sur Ouvrir dans l’ÉDITEUR. Pour plus d’informations, consultez « Configuration d’un éditeur par défaut dans GitHub Desktop ».

Capture d’écran d’une barre de menus sur un Mac. Sous le menu déroulant « Référentiel », un curseur pointe sur « Ouvrir dans Visual Studio Code », mis en surbrillance en bleu.

Apportez quelques changements au fichier README.md que vous avez créé. Vous pouvez ajouter des informations qui décrivent votre projet, par exemple sa finalité et son utilité. Une fois que vous êtes satisfait de vos changements, enregistrez-les dans votre éditeur de texte.
Dans GitHub Desktop, accédez à la vue Modifications . Dans la liste de fichiers, vous devez voir votre fichier README.md. La coche située à gauche du fichier README.md indique que les changements que vous avez apportés à ce fichier feront partie du commit que vous effectuez. Plus tard, vous pourrez changer plusieurs fichiers tout en commitant uniquement les changements apportés à certains d’entre eux. Si vous cliquez sur la coche en regard d’un fichier, ce dernier n’est pas inclus dans le commit.

Capture d’écran de l’onglet « Changements » dans la barre latérale. À gauche du fichier « README.md », une case à cocher sélectionnée est mise en évidence avec un contour orange.

Au bas de la liste Changements, entrez un message de commit. À droite de votre photo de profil, tapez une brève description du commit. Dans la mesure où nous changeons le fichier README.md, « Ajout d’informations sur la finalité du projet » peut être un bon récapitulatif de commit. Sous le récapitulatif, vous voyez un champ de texte « Description » dans lequel vous pouvez taper une description plus longue des changements apportés au commit. Cela vous permet ainsi de revoir l’historique d’un projet et de comprendre pourquoi des changements ont été apportés. Dans la mesure où vous effectuez une mise à jour de base d’un fichier README.md, vous pouvez ignorer la description.

Capture d’écran de l’onglet « Changements » dans la barre latérale. À droite d’une image de profil, un champ de texte contenant un message de validation est indiqué en orange.

Sous votre message de validation, cliquez sur Commiter dans NOM DE LA BRANCHE. Le bouton de commit montre votre branche actuelle pour que vous soyez sûr de commiter dans la branche souhaitée.
Pour envoyer vos modifications vers le référentiel distant sur GitHub, cliquez sur Push origin.

Capture d’écran de la barre de menus « Dépôt ». Un bouton, intitulé « Pousser l'origine », est mis en évidence avec un encadré orange.

Le bouton Push origin est le même que celui sur lequel vous avez cliqué pour publier votre dépôt sur GitHub. Ce bouton change de manière contextuelle en fonction de l’étape où vous vous trouvez dans le workflow Git. Il devrait maintenant dire Push origin avec un 1 côté de lui, indiquant qu’il y a une validation qui n’a pas été poussée jusqu’à GitHub.
Le terme « origin » dans Push origin signifie que vous envoyez vos modifications vers le dépôt distant appelé origin, qui, dans ce cas, correspond au dépôt de votre projet sur GitHub. Tant que vous n’avez pas poussé de nouveaux commits vers GitHub, il y aura des différences entre le dépôt de votre projet sur votre ordinateur et le dépôt de votre projet sur GitHub. Cela vous permet de travailler localement et d’envoyer uniquement vos modifications GitHub lorsque vous êtes prêt.

Dans la fenêtre à droite de la vue Changements, vous voyez s’afficher des suggestions d’actions à effectuer ensuite. Pour ouvrir le dépôt sur GitHub dans votre navigateur, cliquez sur Afficher sur GitHub.

Capture d’écran de l’écran « Aucune modification locale ». Dans une liste de suggestions, un bouton intitulé « Afficher sur GitHub » est mis en évidence avec un contour orange.

Dans votre navigateur, cliquez sur 2 commits. Vous verrez une liste des commits de ce dépôt sur GitHub. La première validation doit être la validation que vous venez d’effectuer.GitHub Desktop

Capture d’écran de la page du dépôt sur GitHub. Au-dessus de la liste des fichiers et à côté d’une icône d’horloge, un lien intitulé « 2 validations » est affiché en orange.

Conclusion

Vous avez maintenant créé un référentiel, publié le référentiel sur GitHub, effectué une validation et envoyé vos modifications à GitHub. Vous pouvez suivre ce même workflow quand vous contribuez à d’autres projets que vous créez, ou auxquels vous collaborez.