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 votre instance GitHub Enterprise Server. 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 votre instance GitHub Enterprise Server, 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 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 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.
Le travail directement dans le navigateur est préférable pour les petites modifications simples, ciblant souvent un seul fichier dans un référentiel. Si vous souhaitez effectuer des modifications plus complexes, vous devrez peut-être vous connecter à GitHub depuis le 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 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 introduction, consultez Hello World. | Browser |
| 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 Enterprise Server 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 |