Compte GitHub

Loïc MorelLoïc Morel
25 juil. 2024
25 juil. 2024
La mission de Plan ₿ Academy est de mettre à disposition des ressources éducatives de premier plan sur Bitcoin, et ce, dans un maximum de langues. L'intégralité des contenus publiés sur le site est open source et hébergée sur GitHub, ce qui offre la possibilité à quiconque de participer à l'enrichissement de la plateforme. Les contributions peuvent prendre diverses formes : correction et relecture des textes existants, traduction dans d'autres langues, mise à jour des informations ou encore création de nouveaux tutoriels encore absents de notre site.
Si vous souhaitez contribuer à Plan ₿ Academy, vous devrez utiliser Git et GitHub. Si ces outils vous sont inconnus ou si leur fonctionnement vous semble obscur, pas de panique, cet article est fait pour vous ! Nous allons revoir ensemble les fondamentaux de Git et de GitHub, ainsi que le jargon technique associé, pour vous permettre par la suite de prendre en main ces outils efficacement.

C'est quoi Git ?

Git est un système de contrôle de version, spécialement conçu pour gérer des projets logiciels. Créé en 2005 par Linus Torvalds, Git est rapidement devenu la référence dans l'industrie du développement de logiciels pour le contrôle de version. Mais qu'est-ce que cela signifie exactement ?
À la base, Git permet aux développeurs de suivre les modifications apportées au code source d'un projet au fil du temps. Cela signifie qu'à chaque changement dans le code, Git enregistre une nouvelle version du projet. Si une erreur survient ou si une fonctionnalité expérimentale ne fonctionne pas comme prévu, il est possible de revenir à un état antérieur du code, comme une sorte de machine à remonter le temps pour les fichiers.
Une des fonctionnalités clés de Git est la gestion des branches. Une branche est une sorte de ligne parallèle sur laquelle les développeurs peuvent travailler indépendamment du reste du projet. Cela facilite grandement l'ajout de nouvelles fonctionnalités ou la correction de bugs sans perturber le code principal. Une fois les modifications testées et validées, elles peuvent être fusionnées avec la branche principale.
Une des particularités de Git est sa capacité à fonctionner de manière distribuée. Chaque développeur possède une copie complète du projet sur le disque dur de son propre ordinateur, ce qui permet de travailler hors ligne et de fusionner les changements ultérieurement, lorsqu'une connexion Internet est disponible. Cela réduit le risque de conflits et permet à plusieurs développeurs de travailler simultanément sur le même projet sans se gêner mutuellement.
Initialement, Git est donc principalement pensé pour les projets de développement logiciel. Cependant, il peut tout aussi bien servir à gérer des projets de rédaction de contenu. Plutôt que de collaborer sur du code, nous collaborons sur du texte. Et c'est justement cette méthode que Plan ₿ Academy a adoptée pour gérer ses contenus ! Git nous facilite la collaboration sur la rédaction de cours et de tutoriels, car il permet un suivi précis des modifications, une gestion efficace des versions et permet également la revue et l'amélioration du contenu par d'autres contributeurs.

C'est quoi GitHub ?

GitHub est une plateforme de gestion et d'hébergement de code source qui repose sur le système de contrôle de version Git dont nous venons de parler. Lancée en 2008, GitHub a rapidement gagné en popularité et est devenue une référence incontournable pour les développeurs du monde entier. Mais en quoi GitHub se distingue-t-il de Git, et pourquoi est-il si essentiel dans notre méthode de production de contenu ?
Tout d'abord, il faut comprendre que GitHub repose sur Git (dont nous avons parlé dans la partie précédente). Alors que Git est l'outil qui permet de suivre les modifications du code, GitHub est le service en ligne qui permet d'héberger, de partager et de gérer ce code.
Imaginez Git comme une sorte de carnet de bord que chaque développeur utilise sur son propre ordinateur pour enregistrer toutes les modifications de son projet. GitHub, quant à lui, est comme une bibliothèque publique où tous ces carnets de bord peuvent être partagés, comparés et combinés.
La différence fondamentale entre Git et GitHub réside donc dans leur fonction : Git est l'outil utilisé localement par chaque développeur pour gérer les versions de leur code, tandis que GitHub est la plateforme en ligne qui héberge ces versions et facilite la collaboration.
GitHub est donc bien plus qu'un simple hébergeur de code. C'est une plateforme de collaboration qui permet aux développeurs de travailler ensemble efficacement. Et justement, Plan ₿ Academy utilise cette plateforme pour héberger à la fois tout le code qui permet de faire tourner le site web, mais également, et c'est ce qui nous intéresse, tous les contenus (tutoriels, formations, ressources...).

Quelques termes techniques

Sur Git et GitHub, vous rencontrerez des commandes et des fonctionnalités dont les noms peuvent sembler complexes. Dans cette dernière partie, je vous donne des définitions simples pour comprendre les termes techniques que vous pourriez croiser lors de votre utilisation de Git et GitHub :
  • Fetch origin : Commande qui permet de récupérer les informations et les modifications récentes d'un dépôt distant sans les fusionner avec votre travail local. Elle met à jour votre dépôt local avec les nouvelles branches et les nouveaux commits présents sur le dépôt distant.
  • Pull origin : Commande qui permet de récupérer les mises à jour d'un dépôt distant et de les intégrer immédiatement à votre branche locale afin de la synchroniser. Cela combine les étapes de fetch et de merge en une seule commande.
  • Sync Fork : Fonctionnalité sur GitHub qui permet de mettre à jour votre fork d'un projet avec les dernières modifications du dépôt source. Cela assure que votre copie du projet reste à jour avec le développement principal.
  • Push origin : Commande qui sert à envoyer vos modifications locales à un dépôt distant.
  • Pull Request : Demande envoyée par un contributeur pour indiquer qu'il a poussé des modifications sur une branche dans un dépôt distant et qu'il souhaite que ces modifications soient examinées et potentiellement intégrées (merge) dans la branche principale du dépôt.
  • Commit : Sauvegarde de vos modifications. Un commit est comme une photo instantanée de votre travail à un moment donné, qui permet de garder un historique des changements. Chaque commit inclut un message descriptif expliquant ce qui a été modifié.
  • Branch : Version parallèle du dépôt, permettant de travailler sur des modifications sans affecter la branche principale (souvent appelée "main" ou "master"). Les branches facilitent le développement de nouvelles fonctionnalités et la correction de bugs sans risque de perturber le code stable.
  • Merge : Fusionner consiste à intégrer les modifications d'une branche dans une autre. On l'utilise, par exemple, pour ajouter les modifications d'une branche de travail sur la branche principale, ce qui permet d'ajouter les différentes contributions.
  • Fork : Faire un fork d'un dépôt consiste à créer une copie de ce dépôt sur votre propre compte GitHub, ce qui vous permet de travailler sur le projet sans affecter le dépôt original. Le fork peut soit faire son propre chemin, et devenir un projet différent du projet initial, soit se synchroniser régulièrement avec le projet initial, afin d'y contribuer.
  • Clone : Cloner un dépôt signifie en faire une copie locale sur votre ordinateur, ce qui vous donne accès à tous les fichiers et à l'historique. Cela vous permet de travailler sur le projet directement en local.
  • Repository : Espace de stockage pour un projet sur GitHub. Un dépôt contient tous les fichiers du projet ainsi que l'historique de toutes les modifications qui y ont été apportées. C'est la base de stockage et de collaboration sur GitHub.
  • Issue : Outil de suivi des tâches et des bugs sur GitHub. Les issues permettent de signaler des problèmes, de proposer des améliorations ou de discuter de nouvelles fonctionnalités. Chaque issue peut être assignée, étiquetée et commentée.
Cette liste n'est évidemment pas exhaustive. Il existe de nombreux autres termes techniques spécifiques à Git et GitHub. Cependant, ceux mentionnés ici sont les principaux que vous rencontrerez fréquemment.

Comment créer un compte GitHub

Si vous désirez apporter votre pierre à l'édifice Plan ₿ Academy, vous allez avoir besoin d'un compte sur GitHub. Dans ce tutoriel, nous vous expliquons comment procéder étape par étape pour créer votre propre compte, le paramétrer et le sécuriser comme il faut.
  • Choisissez un mot de passe fort, puis cliquez sur le bouton vert Continue :
  • Choisissez ensuite votre nom d'utilisateur. Vous pouvez révéler votre véritable identité, ou bien utiliser un pseudonyme. Puis, cliquez sur le bouton vert Continue :
  • Complétez le Captcha :
  • Un email contenant un code de confirmation vous sera envoyé ; vous devrez le saisir pour finaliser la création de votre compte :
  • Remplissez les questions si vous souhaitez que GitHub vous oriente vers certains outils, ou bien, cliquez sur skip personalization pour passer :
  • Choisissez le plan gratuit en cliquant sur le bouton Continue for free :
  • Vous serez alors redirigé vers votre tableau de bord.
  • Si vous le souhaitez, il vous est possible de personnaliser votre compte en cliquant sur votre photo de profil située en haut à droite de l'écran, puis en accédant au menu Settings :
  • Dans cette section, vous avez la possibilité d'ajouter une nouvelle photo de profil, de sélectionner un nom, de personnaliser votre biographie, ou encore d'ajouter un lien vers votre site web personnel :
  • Je vous conseille également d'aller faire un tour dans le menu Password and authentication, afin de mettre en place au minimum l'authentification à deux facteurs (2FA) :
Cela a-t-il bien fonctionné pour vous ?
7
0

Auteur

Ce tutoriel a été écrit par Loïc Morel

Vous pouvez dire merci en donnant un pourboire au professeur.

Crédits

Ce tutoriel a été relu par Asi0Flammeus & ProfScofield21

2/3Statut de relecture

Même si cette page est dans sa langue d'origine, une relecture humaine est toujours nécessaire pour garantir son exactitude.

Progress: 2/3Asi0FlammeusProfScofield210 sats
*Les récompenses peuvent varier en fonction du taux de change $

Chaque élément de contenu sur la plateforme est le produit d'un effort collaboratif : chaque leçon, traduction et révision est rendue possible grâce au travail des contributeurs. C'est pour cette raison que nous sommes toujours à la recherche de correcteurs qui peuvent examiner notre contenu dans un grand nombre de langues. Si vous souhaitez participer au processus de relecture, veuillez nous rejoindre dans notre groupe Telegram et consulter notre tutoriel. Nous vous rappelons que ce contenu est open-source - sous licence CC BY-SA - et peut donc être partagé et utilisé librement, à condition que la source originale soit reconnue.