Introduction
GitHub est une application web qui vous permet d’héberger des fichiers dans des référentiels, de travailler en collaboration et de suivre les modifications apportées aux fichiers au fil du temps. Le suivi des versions sur GitHub se fait avec le logiciel Open Source Git. Chaque fois que vous mettez à jour un référentiel sur GitHub, Git effectue le suivi des modifications que vous apportez.
Il existe de nombreuses façons d’utiliser GitHub, et vous pouvez choisir une méthode qui convient à votre niveau d’expérience, vos préférences personnelles et les 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 débutez avec GitHub, une bonne façon de commencer à contribuer consiste à apporter des modifications dans le navigateur sur GitHub.com. À mesure que vous vous familiarisez avec GitHub et que vous commencez à apporter des modifications plus importantes, vous pouvez commencer à utiliser 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 l’utilisation de GitHub, consultez « Comparaison d’outils pour la connexion à GitHub ».
Bien démarrer
Dans l’interface utilisateur sur GitHub.com, vous pouvez effectuer l’ensemble « du flux GitHub » pour contribuer à un référentiel, notamment en créant une branche ou une duplication (fork), la modification et l’aperçu des fichiers, la validation de vos modifications et la création d’une demande de tirage( 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 conserver cette copie synchronisée.
- Si vous êtes déjà connecté à GitHub, vous avez accès à n’importe quel référentiel où vous disposez des autorisations nécessaires. Vous n’avez donc pas besoin de configurer d’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.
Afin d’obtenir un tutoriel pour vous aider à commencer à apporter 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 à partir de votre bureau et utiliser une copie locale du référentiel.
Travailler à partir du bureau
Pour utiliser un référentiel à partir de votre bureau, vous devez télécharger (ou « cloner ») une copie du référentiel sur votre ordinateur, puis envoyer (push) les modifications que vous apportez à 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 encore jamais travaillé avec un référentiel GitHub à partir de votre bureau, vous devez vous authentifier auprès de GitHub à partir de votre ordinateur. Vous pourrez alors 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 à partir de votre bureau. Ces outils vous permettent de vous authentifier sur GitHub, cloner un référentiel, suivre vos modifications et envoyer (push) les modifications à 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 de ligne de commande qui vous permet d’effectuer de nombreuses actions sur GitHub, telles que la création d’une demande de tirage (pull request) ou la duplication (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 rédacteur tel que VS Code inclut un terminal intégré et des boutons pour les commandes Git courantes. Vous pouvez donc modifier des fichiers et envoyer (push) vos modifications vers GitHub à partir d’un emplacement unique. Vous pouvez également installer une extension pour travailler directement avec des demandes de tirage (pull request) et des problèmes sur GitHub. Pour commencer, consultez Télécharger VS Code.
Comparaison des outils pour la connexion à GitHub
Le tableau suivant fournit une comparaison entre les outils à votre disposition pour travailler avec des 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 inclut l’accès non seulement aux commandes Git pour le suivi des modifications que vous avez apportées, mais également aux fonctionnalités spécifiques à GitHub, afin de créer une demande de tirage (pull request) avec vos modifications proposées à partir de l’endroit où vous travaillez.
Pour plus d’informations sur la façon de s’authentifier auprès de GitHub Enterprise Cloud avec chacune de ces méthodes, consultez « À 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 présentation, consultez « Hello World ». | Browser |
| 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 |
| API GitHub | Vous souhaitez automatiser des tâches courantes, comme sauvegarder 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 |
Pour aller plus loin
- « À propos de Git »