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 open source Git. Chaque fois que vous mettez à jour un référentiel, GitHubGit 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, de 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 débutez sur GitHub, un bon moyen de commencer à contribuer est d’apporter des modifications directement dans le navigateur sur votre instance GitHub Enterprise Server. Au fur et à mesure que vous connaissez GitHub mieux et que vous commencez à apporter des modifications plus importantes, vous pouvez 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, consultez Comparaison des outils de connexion à GitHub.
Mise en route
Dans l’interface utilisateur de votre instance GitHub Enterprise Server, vous pouvez effectuer tout le flux « GitHub » pour contribuer à un référentiel, notamment créer une branche ou un fork, modifier et prévisualiser des fichiers, valider vos modifications et créer une 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 « flux de GitHub ».
Travailler directement sur votre instance GitHub Enterprise Server est souvent le moyen le plus rapide de contribuer à un dépôt 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.
Pour obtenir un tutoriel qui vous aidera à commencer à effectuer des modifications dans le navigateur, consultez Hello World.
L’utilisation directe dans le navigateur est idéale 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 pas encore utilisé de GitHub référentiel à partir de votre bureau, vous devez vous authentifier auprès GitHub de votre ordinateur pour 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 ordinateur de bureau que dans le navigateur.
Vous pouvez utiliser plusieurs outils pour vous connecter à GitHub partir de votre bureau. Ces outils vous permettent de vous authentifier auprès GitHubd’un référentiel, de cloner un référentiel, de suivre vos modifications et d’envoyer (push) les modifications 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 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 d’un référentiel. Pour plus d’informations, consultez « Configurer Git » et « À propos de l’interface CLI GitHub ».
- Si vous préférez utiliser une interface visuelle, vous pouvez utiliser un client Git visuel tel que 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 éditeur. Un éditeur 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 vos modifications à tous à GitHub partir d’un emplacement unique. Vous pouvez également installer une extension pour travailler directement avec les demandes de tirage et les problèmes sur GitHub. Pour commencer, consultez Télécharger VS Code.
Comparaison d’outils pour la connexion à GitHub
Le tableau suivant fournit une comparaison entre les outils que vous pouvez utiliser pour utiliser des référentiels sur GitHub, à la fois dans votre navigateur et à partir de votre bureau.
Vous pouvez réaliser l’intégralité du flux GitHub avec l’un des outils décrits ici. Chaque outil inclut l’accès non seulement aux commandes Git pour suivre les modifications que vous avez apportées, mais aussi à des fonctionnalités spécifiques à GitHub, afin que vous puissiez créer une pull request avec les modifications que vous proposez, où que vous travailliez.
Pour plus d’informations sur la façon de s’authentifier auprès de GitHub avec chacun de ces outils, consultez À propos de l’authentification à GitHub.
| Outil | Cas d’usage | Navigateur ou bureau |
|---|---|---|
| Activé 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. | Navigateur |
| GitHub Desktop | Vous souhaitez utiliser des fichiers localement et préféreriez une interface visuelle pour utiliser Git, visualiser les modifications 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 l’interface CLI GitHub ». | Bureau |
| GitHub Enterprise Server API | Vous souhaitez automatiser des tâches courantes telles que la sauvegarde de vos données ou la création d’intégrations qui s’étendent GitHub. Pour plus d’informations, consultez « Comparaison de l'API REST de GitHub et de l'API GraphQL ». | Navigateur ou bureau |