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 votre instance GitHub Enterprise Server. À 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 votre instance GitHub Enterprise Server, 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 votre instance GitHub Enterprise Server 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 ».
Travailler directement dans le navigateur est la meilleure solution pour les petites modifications simples, ciblant souvent un seul fichier dans un référentiel. Si vous souhaitez apporter des modifications plus complexes, vous devrez peut-être vous connecter à GitHub à partir du 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 Server avec chacune de ces méthodes, consultez « À propos de l’authentification auprès de GitHub ».
| Outil | Cas d’usage | Navigateur ou bureau |
|---|---|---|
| Sur votre instance GitHub Enterprise Server | 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 Enterprise Server | 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 »