Introduction
GitHub est une application web qui vous permet d'héberger des fichiers dans des référentiels, de collaborer sur le travail et de suivre les modifications apportées aux fichiers au fil du temps. Le suivi des versions sur GitHub est assuré par le logiciel libre Git. Chaque fois que vous mettez à jour un référentiel sur GitHub, Git suit les modifications que vous apportez.
Il existe de nombreuses façons de travailler avec GitHub, et vous pouvez choisir une méthode adaptée à votre niveau d'expérience, à vos préférences personnelles et aux référentiels avec lesquels vous travaillez. Par exemple, vous pouvez choisir de travailler dans le navigateur ou à partir de votre bureau, la façon dont vous souhaitez utiliser Git et les capacités dont vous avez besoin sur votre rédacteur et d’autres logiciels. Vous pouvez choisir d’utiliser différents référentiels de différentes manières.
Si vous êtes nouveau sur GitHub, une bonne façon de commencer à contribuer est de faire des changements dans le navigateur sur GitHub.com. Au fur et à mesure que vous vous familiarisez avec GitHub et que vous commencez à contribuer à des changements plus importants, vous voudrez peut-être commencer à travailler avec d'autres outils. Cet article explique comment parcourir ces étapes et vous aide à choisir le meilleur outil pour vos exigences à chaque étape. Pour comparer rapidement tous les outils disponibles pour travailler avec GitHub, voir Comparaison des outils pour se connecter à GitHub.
Mise en route
Dans l'interface utilisateur de GitHub.com, vous pouvez effectuer l'ensemble du « flux GitHub » pour contribuer à un référentiel, y compris la création d'une branche ou d'une fourche, l'édition et la prévisualisation des fichiers, la validation de vos modifications et la création d'une demande d'extraction (pull request). Vous pouvez également charger des fichiers à partir de votre ordinateur ou les télécharger à partir du référentiel. Pour plus d’informations, consultez « GitHub flow ».
Travailler directement sur GitHub.com est souvent le moyen le plus rapide de contribuer à un référentiel, pour les raisons suivantes.
- Vous travaillez directement avec le référentiel hébergé sur GitHub, vous n'avez donc pas besoin de télécharger une copie du référentiel sur votre ordinateur et de maintenir cette copie synchronisée.
- Si vous êtes déjà connecté à GitHub, vous avez accès à tous les référentiels pour lesquels vous disposez des autorisations nécessaires, vous n'avez donc pas besoin de mettre en place une authentification supplémentaire sur votre ordinateur.
- Vous pouvez valider les modifications dans l’interface utilisateur. Vous n’avez donc pas besoin d’utiliser la ligne de commande ou de mémoriser les commandes Git.
Pour obtenir un tutoriel qui vous aidera à commencer à effectuer des modifications dans le navigateur, consultez Hello World.
Apporter des modifications plus complexes dans le navigateur
Travailler directement sur GitHub.com est la meilleure solution pour les petites modifications simples, ciblant souvent un seul fichier dans un référentiel. Si vous souhaitez travailler dans le navigateur, mais que vous devez apporter des modifications plus complexes, telles que le déplacement de contenu entre les fichiers, vous pouvez choisir parmi les outils suivants pour ouvrir un référentiel dans un rédacteur dédié.
- Si vous souhaitez un rédacteur dans lequel vous pouvez rapidement ouvrir ou créer des fichiers, vous pouvez appuyer sur la touche
.dans n’importe quel référentiel pour ouvrir le rédacteur github.dev. Il s’agit d’un rédacteur web léger qui inclut de nombreuses fonctionnalités de Visual Studio Code, telles qu’une barre de recherche et des boutons pour les commandes Git. Pour plus d’informations, consultez « Éditeur web github.dev ». - Si vous souhaitez rester dans le navigateur, mais que vous devez effectuer des opérations comme exécuter des commandes, créer une build de test de votre projet ou installer des dépendances, vous pouvez ouvrir un référentiel dans un codespace. Un codespace est un environnement de développement distant avec stockage et puissance de calcul. Il inclut un rédacteur et un terminal intégré, et est préinstallé avec les outils courants que vous devrez peut-être utiliser pour un projet, y compris Git. Pour plus d’informations, consultez « Vue d’ensemble de GitHub Codespaces ».
Vous pouvez également vous connecter à GitHub depuis votre bureau, et travailler avec une copie locale du référentiel.
Travailler à partir du bureau
Pour travailler avec un référentiel depuis votre bureau, vous devez télécharger (ou « cloner ») une copie du référentiel sur votre ordinateur, puis transférer toutes les modifications que vous effectuez vers GitHub. Travailler à partir du bureau peut avoir plusieurs avantages par rapport au fait de travailler dans le navigateur.
- Vous pouvez utiliser tous vos fichiers et outils locaux.
- Vous avez accès à la puissance de calcul. Par exemple, vous devrez peut-être exécuter un script pour créer un aperçu local d’un site, afin de pouvoir tester les modifications que vous apportez.
- Vous n’avez pas besoin d’une connexion web pour travailler sur un projet.
Si vous n'avez jamais travaillé avec un référentiel GitHub depuis votre bureau, vous devrez vous authentifier sur GitHub depuis votre ordinateur, afin de pouvoir accéder aux référentiels dont vous avez besoin. Vous devrez peut-être également configurer votre environnement de travail avec les outils dont vous avez besoin pour contribuer, tels que Git, un rédacteur et des dépendances pour un projet. Pour ces raisons, il peut être plus long de commencer à travailler à partir de votre bureau que dans le navigateur.
Il existe plusieurs outils que vous pouvez utiliser pour vous connecter à GitHub depuis votre bureau. Ces outils vous permettent de vous authentifier auprès de GitHub, de cloner un référentiel, de suivre vos modifications et de pousser les changements vers GitHub.
- Si vous souhaitez plus de contrôle et de flexibilité, vous pouvez utiliser la ligne de commande. Vous devez installer Git et vous familiariser avec certaines commandes Git de base. Vous pouvez également installer GitHub CLI, une interface en ligne de commande qui vous permet d'effectuer de nombreuses actions sur GitHub, telles que la création d'une demande d'extraction ou le forking d'un référentiel. Pour plus d’informations, consultez « Configurer Git » et « À propos de GitHub CLI ».
- Si vous préférez utiliser une interface visuelle, vous pouvez télécharger et utiliser un client Git visuel comme GitHub Desktop. Avec GitHub Desktop, vous pouvez visualiser les modifications que vous apportez et accéder à la plupart des commandes Git via une interface visuelle. Vous n’avez donc pas besoin de mémoriser les commandes. Pour plus d’informations, consultez « À propos de GitHub Desktop ».
- Si vous souhaitez travailler dans un seul endroit, vous pouvez généralement réaliser la plupart des tâches dans votre rédacteur. Un éditeur tel que VS Code comprend un terminal intégré et des boutons pour les commandes Git courantes, ce qui vous permet de modifier les fichiers et de transférer vos modifications vers GitHub à partir d'un seul endroit. Vous pouvez également installer une extension pour travailler directement avec les pull requests et les issues sur GitHub. Pour commencer, consultez Télécharger VS Code.
Comparaison des outils de connexion à GitHub
Le tableau suivant fournit une comparaison entre les outils que vous pouvez utiliser pour travailler avec les référentiels sur GitHub, à la fois dans votre navigateur et à partir de votre bureau.
Vous pouvez effectuer l'ensemble du flux GitHub avec l'un des outils décrits ici. Chaque outil comprend l'accès non seulement aux commandes Git pour le suivi des modifications apportées, mais aussi aux fonctionnalités spécifiques GitHub, de sorte que vous puissiez créer une demande d'extraction avec les modifications que vous proposez, quel que soit l'endroit où vous travaillez.
Pour plus d'informations sur la manière de s'authentifier auprès de GitHub avec chacun de ces outils, voir À propos de l’authentification auprès de GitHub.
| Outil | Cas d’usage | Navigateur ou bureau |
|---|---|---|
| Sur GitHub.com | Vous souhaitez une interface visuelle et devez apporter des modifications simples et rapides, impliquant généralement une validation unique. Pour une introduction, consultez Hello World. | Browser |
| github.dev | Vous souhaitez apporter à un référentiel des modifications plus complexes que possible sur GitHub.com, mais n’avez pas besoin d’utiliser un terminal ou des outils que vous avez installés sur votre ordinateur. Pour plus d’informations, consultez « Éditeur web github.dev ». | Browser |
| GitHub Codespaces | Vous avez besoin des ressources d’un ordinateur pour exécuter des scripts, créer une build de test de votre projet ou installer des dépendances et commencer rapidement en travaillant dans un environnement informatique. Pour plus d’informations, consultez « Vue d’ensemble de GitHub Codespaces ». | Navigateur ou bureau |
| GitHub Desktop | Vous souhaitez travailler avec des fichiers localement et préférez une interface visuelle pour utiliser Git, visualiser les changements et interagir avec GitHub. Pour plus d’informations, consultez « À propos de GitHub Desktop ». | Bureau |
| IDE ou éditeur de texte | Vous travaillez avec des fichiers et des projets plus complexes et souhaitez tout concentrer en un seul endroit. | Bureau |
| Ligne de commande Git et GitHub CLI | Vous avez l’habitude de travailler à partir de la ligne de commande et souhaitez éviter de changer de contexte, ou vous devez accéder à une commande Git complexe qui n’est pas intégrée aux interfaces visuelles. Pour plus d’informations, consultez « Configurer Git » et « À propos de GitHub CLI ». | Bureau |
| GitHub API | Vous souhaitez automatiser des tâches courantes telles que la sauvegarde de vos données, ou créer des intégrations qui étendent GitHub. Pour plus d’informations, consultez « Comparaison de l’API REST de GitHub et de l’API GraphQL ». | Navigateur ou bureau |