illustration image

🇫🇷 Comment utiliser GitHub : Les bases

February 13, 2025
Share this article

Comment utiliser GitHub : Les bases

Cet article vous guide dans l'utilisation de GitHub, l'outil indispensable pour les développeurs. Vous apprendrez à créer un compte, naviguer dans l'interface, et créer votre premier dépôt. Nous aborderons également les commits, les pull requests, et d'autres fonctionnalités essentielles. GitHub sera votre espace de travail principal pour coder, collaborer et partager vos projets.

Premiers pas

Une fois que vous aurez créé un compte, vous aurez une interface de ce type :

illustration image

Eh bien, c'est votre accueil, un fil d'actualités un peu comme Twitter, mais plutôt axé sur l'activité de la communauté (si quelqu'un vous a suivi, mis une étoile "like" sur un de vos dépôts).

J'ai dit "dépôt", qu'est-ce que c'est ? Eh bien, c'est dans son nom exact repository (dépôt). C'est là où votre code sera stocké.

Premier dépôt

Pour créer un dépôt et commencer à y ajouter des fichiers de code, rien de plus simple : il faudra cliquer sur le petit Plus qui se trouve en haut de votre écran à droite.

illustration image

Vous y trouverez plusieurs actions possibles :

  • Nouveau dĂ©pĂ´t (New repository)
  • Importer un dĂ©pĂ´t (Import repository)
  • Nouvel espace de code (New codespace)
  • Nouveau gist (Nouveau document)
  • Nouvelle organisation (New organization)
  • Nouveau projet (New project)

Ce qui va nous intéresser en premier, c'est New repository. Cliquez sur cette option et nous reviendrons aux autres plus tard.

illustration image

Une fois arrivé sur cette page, plusieurs champs s'afficheront :

  • L'auteur du dĂ©pĂ´t : Si c'est sur votre compte ou une organisation dans laquelle vous ĂŞtes.
  • Le nom du dĂ©pĂ´t : C'est un nom unique qui ne pourra pas ĂŞtre rĂ©utilisĂ© (sur le compte/organisation choisie).
  • Une description (optionnelle) : C'est une courte information qui dĂ©crit votre dĂ©pĂ´t.
  • La visibilitĂ© : Publique ou privĂ©e. Si vous choisissez privĂ©e, alors seulement vous ou les membres que vous aurez autorisĂ©s pourront accĂ©der au dĂ©pĂ´t. Si Jean essaie d'accĂ©der Ă  votre dĂ©pĂ´t privĂ©, alors une erreur (404) lui sera affichĂ©e, ne donnant aucune info sur l'existence ou non du dĂ©pĂ´t.
  • Initialiser le projet avec un fichier "Lisez-moi" : Comme son nom d'option l'indique, c'est un fichier au format Markdown qui sera créé Qu'est-ce que le Markdown ?
  • Ajouter un .gitignore : Ce fichier permet de spĂ©cifier les fichiers et dossiers que Git doit ignorer. Une fois que vous publiez du code depuis votre ordinateur, les fichiers ou dossiers ajoutĂ©s dans le .gitignore seront ignorĂ©s et non publiĂ©s. Nous y reviendrons plus tard.
  • Choisir une licence : Une licence dĂ©finit les conditions d'utilisation de votre code.

Pour l'instant, nous allons créer un dépôt public, avec un fichier de départ (readme) sans licence et sans fichier gitignore.

Une fois créé, vous vous retrouverez devant une interface comme celle-ci :

illustration image

Les différents onglets

Dans cette interface, nous y trouvons beaucoup d'éléments. Tout d'abord, en haut, vous y trouverez une navigation horizontale avec comme liens :

  • Code : L'onglet principal de tout dĂ©pĂ´t GitHub. Il affiche le contenu de votre dĂ©pĂ´t, y compris les fichiers et les dossiers. Vous pouvez naviguer dans les diffĂ©rents rĂ©pertoires, visualiser le code source, et accĂ©der Ă  l'historique des commits.

L'onglet Code contient différents éléments :

  • Épingler : S'affiche si vous ĂŞtes un ou le mainteneur du dĂ©pĂ´t. Si vous l'Ă©pinglez, il sera mis en avant sur votre profil comme exemple : "Regardez mon travail".
  • Ne plus suivre / Suivre : Ces options vous permettent de gĂ©rer les notifications concernant les activitĂ©s d'un dĂ©pĂ´t. En "suivant" un dĂ©pĂ´t, vous recevez des notifications sur toutes les activitĂ©s. En choisissant "ne plus suivre", vous ne recevez plus ces notifications.
  • Fork (Bifurcation) : Le "fork" est une fonctionnalitĂ© qui permet de crĂ©er une copie personnelle d'un dĂ©pĂ´t. Cela vous permet de travailler sur le projet indĂ©pendamment de l'original. Les modifications peuvent ensuite ĂŞtre proposĂ©es Ă  l'original via une pull request.
  • Étoile (Favoris) : Le bouton "Étoile" permet de marquer un dĂ©pĂ´t comme favori. C'est une manière d'exprimer votre intĂ©rĂŞt ou votre apprĂ©ciation pour un projet. Les dĂ©pĂ´ts que vous "Ă©toilez" apparaissent dans votre liste de favoris sur votre profil GitHub.
  • Issues ("Problèmes") : Cet onglet permet de suivre les problèmes ou les tâches liĂ©s au projet. Les utilisateurs peuvent signaler des bugs, suggĂ©rer des amĂ©liorations, ou poser des questions. Chaque issue peut ĂŞtre commentĂ©e et assignĂ©e Ă  des membres spĂ©cifiques de l'Ă©quipe.

  • Pull requests (Demandes de tirage) : Les pull requests sont des demandes de fusion de modifications provenant d'une branche dans une autre, gĂ©nĂ©ralement de la branche de dĂ©veloppement vers la branche principale. Elles permettent de revoir le code, de discuter des changements, et de s'assurer que les modifications sont approuvĂ©es avant d'ĂŞtre intĂ©grĂ©es.

  • Actions : GitHub Actions permet d'automatiser les workflows de dĂ©veloppement directement dans votre dĂ©pĂ´t. Vous pouvez configurer des workflows pour compiler le code, exĂ©cuter des tests, ou dĂ©ployer des applications.

  • Projets : Cet onglet permet de gĂ©rer des projets en utilisant des tableaux Kanban. Vous pouvez crĂ©er des cartes pour les tâches, les organiser en colonnes, et suivre la progression des diffĂ©rentes parties du projet.

  • Wiki : Le wiki est un espace oĂą vous pouvez documenter votre projet. Il est souvent utilisĂ© pour fournir des guides d'utilisation, des FAQ, ou des informations techniques sur le projet.

  • SĂ©curitĂ© : Cet onglet regroupe les outils de sĂ©curitĂ© de GitHub, tels que la dĂ©tection de vulnĂ©rabilitĂ©s, l'analyse de la composition des dĂ©pendances, et les alertes de sĂ©curitĂ©.

  • Insights (Analyses) : Fournit des analyses et des statistiques sur le dĂ©pĂ´t, y compris les contributeurs, les commits, et l'activitĂ© du projet.

  • Paramètres : Cet onglet permet de configurer divers paramètres du dĂ©pĂ´t, tels que les collaborateurs, les branches protĂ©gĂ©es, les webhooks, et les paramètres de sĂ©curitĂ©.

Premiers commits

Pour l'exemple de cet article, nous allons aller jusqu'à l'étape de déploiement d'un site statique (HTML / CSS) directement depuis GitHub.

Tout d'abord, nous allons envoyer des fichiers dans notre dépôt. En envoyant des fichiers, cela va automatiquement créer une commit.

  • Qu'est-ce qu'une commit ? Une commit, c'est un peu comme une photo instantanĂ©e de votre projet Ă  un moment prĂ©cis. Imaginez que vous travaillez sur un projet, et Ă  un certain point, vous voulez sauvegarder l'Ă©tat actuel de votre code. Eh bien, c'est lĂ  que la commit entre en jeu !

Envoi et création de fichiers

Pour envoyer des fichiers, rien de plus simple que le glisser-déposer. Pour cela, nous allons cliquer sur Add file.

illustration image

Cela nous donne le choix de créer ou d'envoyer des fichiers. Pour l'exemple, nous allons envoyer des fichiers pour l'instant. Nous verrons plus tard la création.

Envoi de fichiers

Ce qui est bien avec GitHub, c'est qu'il permet le glisser-déposer, ce qui signifie que vous pouvez déposer des fichiers comme des dossiers, et il s'occupera de créer les chemins pour vous.

illustration image

Maintenant, nous allons créer la commit. Par défaut, le titre est "Add files via upload". Dans ce cas, vous pouvez y mettre un titre personnalisé pour mieux vous retrouver si vous avez besoin de revenir dans 3-4 mois, si besoin, pour récupérer du code perdu. (Vous pouvez aussi ajouter une description à votre commit).

Ensuite, la sélection de branches. Pour l'instant, nous allons laisser par défaut donc main et nous y reviendrons plus tard sur ce sujet.

Et une fois rempli, cliquez simplement sur "Commit changes", et le tour est joué, vos fichiers sont sur GitHub.

illustration image

Création de fichiers

Maintenant, nous allons voir comment créer un fichier. Nous recliquons sur "Add file" puis sur "Create new file".

Nous nous retrouverons avec une interface sur laquelle nous aurons un bouton vert pour la commit, un explorateur de fichiers sur la gauche et un champ pour écrire le nom du fichier.

illustration image

Ce champ peut aussi créer des dossiers, juste en écrivant / cela va créer un dossier. Donc, par exemple : /scripts. Une fois que nous enverrons la commit, un dossier sera créé, et le dernier élément du champ sera le nom du fichier. Dans mon exemple, ce sera index.js.

Une fois que nous avons fini d'écrire notre fichier, nous allons à nouveau cliquer sur le bouton pour envoyer nos modifications (commit). Cette fois, un formulaire va apparaître mais avec les mêmes pré-requis : un titre, une description qui est toujours optionnelle ainsi qu'un choix de branches.

Le titre par défaut pour la création de fichier sera toujours "Create [filename].[file_extension]".

illustration image

Et voici notre fichier à l'intérieur du dossier que nous avons créé.

illustration image

Suppression de fichiers

Pour supprimer un fichier, rien de plus simple qu'un bouton représentant une poubelle. Pour cela, cliquez sur le fichier que vous voulez supprimer pour avoir son contenu, et jetez un coup d'œil en haut à droite.

illustration image

Voici des options qui s'offrent à vous, comme par exemple télécharger ce fichier, aller à la ligne, copier des liens d'accès et aussi des options d'accessibilité/vues.

Et ce qui nous intéresse le plus, un bouton pour supprimer le fichier. Cliquez dessus et encore une fois, on va nous demander de confirmer tout en remplissant une commit. Vous devriez vous y habituer ;)

illustration image

Petite spécificité : quand vous supprimez un fichier qui se trouve dans un dossier, si celui-ci se retrouve vide, alors il disparaît lui aussi.

Modification de fichiers

Pour la modification de fichiers, c'est à peu près pareil que la suppression, sauf que cette fois ce sera dans les icônes simples.

illustration image

Petite spécificité sur laquelle nous reviendrons plus tard : en cliquant sur l'icône à côté, cela vous proposera d'autres moyens d'édition.

Une fois cliqué, cela vous changera l'interface pour une qui permet l'édition. [...] Une fois que votre fichier sera édité, alors le bouton qui permet de commit les changements s'activera.

illustration image

Branches

Les branches sont un élément fondamental de GitHub, permettant aux développeurs de travailler sur différentes versions d'un projet simultanément. Voici un guide pour comprendre et utiliser les branches efficacement, directement depuis l'interface web de GitHub :

Qu'est-ce qu'une branche ?

Une branche est une ligne de développement indépendante au sein d'un dépôt. Par défaut, chaque dépôt GitHub commence avec une branche principale appelée main. Les branches permettent de développer des fonctionnalités, corriger des bugs ou expérimenter sans affecter le code principal.

Créer une nouvelle branche

Pour créer une nouvelle branche sur GitHub, suivez ces étapes simples :

  1. Accédez à votre dépôt :

    • Allez sur la page principale de votre dĂ©pĂ´t sur GitHub.
  2. Ouvrez le menu des branches :

    • Cliquez sur le menu dĂ©roulant des branches, gĂ©nĂ©ralement situĂ© au-dessus de la liste des fichiers.

illustration image

  1. Créez une nouvelle branche :
    • Entrez le nom de la nouvelle branche dans le champ prĂ©vu Ă  cet effet.
    • Appuyez sur EntrĂ©e ou cliquez sur "CrĂ©er une branche" pour finaliser.

illustration image

Travailler avec des branches

Une fois que vous avez créé une branche, vous pouvez y apporter des modifications indépendamment des autres branches. Voici comment procéder :

  • Basculer entre les branches :

    • Utilisez le mĂŞme menu dĂ©roulant pour sĂ©lectionner et basculer entre les diffĂ©rentes branches de votre dĂ©pĂ´t. (Par dĂ©faut après crĂ©ation vous y ĂŞtes redirigĂ©s)
  • Fusionner des branches :

    • Pour intĂ©grer les modifications d'une branche dans une autre, vous pouvez crĂ©er une pull request (demande de tirage).

Les Pull Requests

Les pull requests (PR) sont essentielles pour collaborer sur GitHub. Elles permettent de proposer des modifications d'une branche à une autre, généralement de la branche de développement vers la branche principale. Voici comment créer une pull request :

  1. Sur GitHub :

    • Allez sur la page de votre dĂ©pĂ´t.
    • Cliquez sur l'onglet "Pull requests".
    • Cliquez sur "New pull request".
    • SĂ©lectionnez la branche source et la branche cible, puis cliquez sur "Create pull request".
  2. Révision et fusion :

    • Les membres de l'Ă©quipe peuvent rĂ©viser le code, laisser des commentaires et demander des modifications.
    • Une fois approuvĂ©e, la pull request peut ĂŞtre fusionnĂ©e dans la branche cible.

Bonnes pratiques

  • Nommer les branches de manière descriptive : Utilisez des noms qui dĂ©crivent le but de la branche (par exemple, feature/nouvelle-fonctionnalite).
  • Garder les branches Ă  jour : Fusionnez rĂ©gulièrement les modifications de la branche principale dans vos branches de fonctionnalitĂ©s pour Ă©viter les conflits.
  • Utiliser des branches pour chaque tâche : CrĂ©ez une nouvelle branche pour chaque fonctionnalitĂ© ou correction de bug pour isoler les modifications.

Les branches sont un outil puissant pour gérer le développement collaboratif et maintenir un code propre et organisé. En les utilisant efficacement, vous pouvez améliorer la qualité de votre code et faciliter la collaboration au sein de votre équipe.

CLI

La CLI (Command Line Interface) de Git est un outil essentiel pour les développeurs qui souhaitent gérer leurs dépôts de code source directement depuis le terminal. Git est un système de contrôle de version qui permet de suivre les modifications apportées aux fichiers au fil du temps. Voici un guide pour comprendre et utiliser la CLI de Git :

Qu'est-ce que Git ?

Git est un logiciel de gestion de versions qui permet de suivre les modifications apportées à un ensemble de fichiers, généralement du code source. Il est particulièrement utile pour la collaboration sur des projets logiciels, car il permet à plusieurs développeurs de travailler sur le même code sans se gêner mutuellement.

Installation de Git

Pour utiliser Git, vous devez d'abord l'installer sur votre machine. Voici comment procéder :

  1. Téléchargement et installation :

    • Rendez-vous sur le site officiel de Git et tĂ©lĂ©chargez l'installateur pour votre système d'exploitation.
    • Suivez les instructions d'installation.
  2. Configuration initiale :

    • Une fois installĂ©, configurez votre nom d'utilisateur et votre adresse e-mail avec les commandes suivantes :
      Bash
      git config --global user.name "Votre Nom" git config --global user.email "votre.email@example.com"

Commandes de base de Git

Voici quelques commandes de base pour commencer avec Git :

  1. Initialiser un dépôt :

    • Pour crĂ©er un nouveau dĂ©pĂ´t Git dans un rĂ©pertoire existant :
      Bash
      git init
  2. Cloner un dépôt existant :

    • Pour copier un dĂ©pĂ´t distant sur votre machine locale :
      Bash
      git clone url_du_depot
  3. Ajouter des fichiers Ă  l'index :

    • Pour ajouter des fichiers spĂ©cifiques Ă  l'index (staging area) avant de les commiter :
      Bash
      git add nom_du_fichier
    • Pour ajouter tous les fichiers modifiĂ©s :
      Bash
      git add .
  4. Commiter des modifications :

    • Pour enregistrer les modifications dans le dĂ©pĂ´t local :
      Bash
      git commit -m "Message de commit"
  5. Afficher l'état du dépôt :

    • Pour voir les modifications non commitĂ©es et les fichiers non suivis :
      Bash
      git status
  6. Pousser les modifications vers un dépôt distant :

    • Pour envoyer vos commits vers un dĂ©pĂ´t distant :
      Bash
      git push origin nom_de_la_branche
  7. Tirer les modifications depuis un dépôt distant :

    • Pour rĂ©cupĂ©rer les modifications depuis un dĂ©pĂ´t distant :
      Bash
      git pull origin nom_de_la_branche

Utilisation des branches avec la CLI

Les branches sont essentielles pour travailler sur différentes fonctionnalités ou corrections sans affecter le code principal. Voici quelques commandes pour gérer les branches :

  1. Créer une nouvelle branche :

    Bash
    git branch nom_de_la_branche
  2. Basculer vers une branche :

    Bash
    git checkout nom_de_la_branche
  3. Créer et basculer vers une nouvelle branche :

    Bash
    git checkout -b nom_de_la_branche
  4. Fusionner une branche dans la branche actuelle :

    Bash
    git merge nom_de_la_branche

Utilisation du fichier .gitignore

Le fichier .gitignore permet de spécifier les fichiers et dossiers que Git doit ignorer. Voici comment l'utiliser :

  1. Créer un fichier .gitignore :

    • CrĂ©ez un fichier nommĂ© .gitignore dans votre rĂ©pertoire de projet.
  2. Ajouter des fichiers ou dossiers Ă  ignorer :

    • Ajoutez les chemins des fichiers ou dossiers que vous souhaitez ignorer, un par ligne. Par exemple :
      Bash
      # Pour ignorer tous les fichiers portant une extension spécifique *.tmp # Pour ignorer des fichiers spécifiques config.local.json # Et pour ignorer des dossiers (parents) et leurs fichiers (enfants) node_modules/

Git est un outil puissant pour la gestion de versions et la collaboration sur des projets logiciels. En maîtrisant la CLI de Git, vous pouvez améliorer votre flux de travail et collaborer efficacement avec d'autres développeurs.

Git dans Visual Studio Code

Visual Studio Code (VS Code) est un éditeur de code source populaire qui offre une intégration native avec Git, facilitant ainsi la gestion des dépôts directement depuis l'interface de l'éditeur.

Pourquoi utiliser Git dans VS Code ?

  • Interface utilisateur intuitive : VS Code offre une interface graphique pour les opĂ©rations Git, ce qui est particulièrement utile pour les dĂ©butants ou ceux qui prĂ©fèrent Ă©viter la ligne de commande.
  • ProductivitĂ© accrue : Vous pouvez effectuer des opĂ©rations Git sans quitter votre environnement de dĂ©veloppement.
  • IntĂ©gration complète : VS Code permet de visualiser l'historique des commits, de gĂ©rer les branches, et de rĂ©soudre les conflits de fusion directement dans l'Ă©diteur.

Configuration de Git dans VS Code

  1. Installer VS Code :

    • TĂ©lĂ©chargez et installez Visual Studio Code depuis le site officiel : Visual Studio Code.
  2. Ouvrir un projet :

    • Ouvrez un projet existant ou crĂ©ez-en un nouveau dans VS Code.
  3. Initialiser Git :

    • Si votre projet n'est pas encore un dĂ©pĂ´t Git, vous pouvez l'initialiser en cliquant sur l'icĂ´ne de la barre latĂ©rale qui ressemble Ă  une branche (ou en utilisant le raccourci Ctrl+Shift+G), puis en sĂ©lectionnant "Initialize Repository".

Utilisation des fonctionnalités Git dans VS Code

  1. Voir l'état des fichiers :
    • L'icĂ´ne de la barre latĂ©rale de Git affiche l'Ă©tat des fichiers dans votre dĂ©pĂ´t. Vous pouvez voir quels fichiers ont Ă©tĂ© modifiĂ©s, ajoutĂ©s ou supprimĂ©s.

illustration image

  1. Ajouter des fichiers Ă  l'index :
    • Cliquez sur le signe + Ă  cĂ´tĂ© des fichiers modifiĂ©s pour les ajouter Ă  l'index (staging area).

illustration image

  1. Commiter des modifications :
    • Entrez un message de commit dans la zone de texte prĂ©vue Ă  cet effet et cliquez sur l'icĂ´ne de validation (coche) pour commiter les modifications.

illustration image

  1. Pousser et tirer des modifications :

Pour synchroniser vos modifications avec un dépôt distant dans Visual Studio Code, vous avez deux options principales

  1. Utiliser l'icĂ´ne de synchronisation :
    • En bas de la fenĂŞtre de VS Code, vous verrez une icĂ´ne avec des flèches circulaires. Cliquez dessus pour synchroniser vos modifications.
    • Cela enverra vos modifications locales au dĂ©pĂ´t distant et rĂ©cupĂ©rera les dernières modifications du dĂ©pĂ´t.
  2. Utiliser "Sync Changes" :
    • Dans la section "Source Control" sur le cĂ´tĂ© gauche de VS Code, vous verrez un bouton "Sync Changes".
    • Cliquez sur ce bouton pour envoyer vos modifications locales au dĂ©pĂ´t distant et obtenir les dernières modifications du dĂ©pĂ´t en une seule action.

Ces deux méthodes vous permettent de garder votre projet à jour et de partager vos modifications avec d'autres collaborateurs.

  1. Gérer les branches :
    • Vous pouvez crĂ©er de nouvelles branches, basculer entre les branches existantes, et fusionner des branches directement depuis l'interface de VS Code.
    • Pour crĂ©er une nouvelle branche, cliquez sur l'icĂ´ne de branche dans le coin infĂ©rieur gauche et sĂ©lectionnez "Create New Branch".

illustration image

  1. Résoudre les conflits de fusion :
    • VS Code facilite la rĂ©solution des conflits de fusion en affichant les diffĂ©rences directement dans l'Ă©diteur et en permettant de choisir les modifications Ă  conserver.

illustration image

Source Image: Stack Overflow

Utilisation du terminal intégré

Bien que VS Code offre une interface graphique pour Git, vous pouvez également utiliser le terminal intégré pour exécuter des commandes Git directement :

  • Ouvrir le terminal :

    • Utilisez le raccourci Ctrl+ ` (accent grave) pour ouvrir le terminal intĂ©grĂ©.
  • ExĂ©cuter des commandes Git :

    • Vous pouvez exĂ©cuter toutes les commandes Git standard directement dans le terminal intĂ©grĂ© de VS Code.

Extensions utiles pour Git

VS Code dispose de nombreuses extensions qui peuvent améliorer votre expérience avec Git :

  • GitLens : Cette extension offre des fonctionnalitĂ©s avancĂ©es pour visualiser l'historique des commits, voir les auteurs des lignes de code, et bien plus encore.
  • Git Graph : Cette extension affiche un graphique de l'historique des commits, facilitant ainsi la visualisation des branches et des fusions.

illustration image

En utilisant Git directement dans Visual Studio Code, vous pouvez gérer vos dépôts de manière efficace et intuitive, tout en restant dans votre environnement de développement préféré.

Déploiement d'un site statique avec GitHub Pages

1. Accéder aux Paramètres de GitHub Pages

  • Rendez-vous sur la page de votre rĂ©pertoire GitHub.
  • Cliquez sur l'onglet "Settings" (Paramètres) situĂ© en haut Ă  droite de la page.
  • Dans le menu de gauche, faites dĂ©filer vers le bas et cliquez sur "Pages" sous la section "Code and automation".

2. Configurer la Source de GitHub Pages

  • Sous "Build and deployment", vous verrez une section intitulĂ©e "Source".
  • SĂ©lectionnez "GitHub Actions" comme source pour le dĂ©ploiement.

illustration image

3. Choisir le Workflow Static HTML

  • Une fois que vous avez sĂ©lectionnĂ© GitHub Actions, vous verrez plusieurs options de workflows prĂ©configurĂ©s.
  • Cliquez sur "Static HTML" pour configurer ce workflow.

4. Configurer le Workflow

  • AccĂ©der au Fichier de Workflow :
    • GitHub vous redirigera vers un fichier de workflow dans votre rĂ©pertoire, situĂ© dans .github/workflows/.
    • Ce fichier est gĂ©nĂ©ralement nommĂ© static.yml.
  • VĂ©rifier le Contenu :
    • Le fichier est prĂ©-rempli avec les Ă©tapes nĂ©cessaires pour dĂ©ployer un site statique. Vous n'avez pas besoin de le modifier pour un dĂ©ploiement de base.

illustration image

5. Enregistrer les Changements

  • Commiter le Fichier :
    • Faites dĂ©filer vers le haut si besoin de la page et cliquez sur "Commit changes".
    • Ajoutez un message de commit simple, comme "Configurer le dĂ©ploiement statique".
    • Cliquez sur "Commit changes" pour enregistrer.

6. Vérifier le Déploiement

  • Suivre le DĂ©ploiement :
    • Une fois le fichier commitĂ©, GitHub Actions lancera automatiquement le dĂ©ploiement.
    • Allez dans l'onglet "Actions" de votre rĂ©pertoire pour suivre l'Ă©tat du dĂ©ploiement.

illustration image

  • Une fois terminĂ©, votre site sera accessible via l'URL fournie dans les paramètres GitHub Pages.

illustration image

Qu'est-ce que Gist ?

Gist est un service fourni par GitHub qui permet de partager facilement des extraits de code, des notes ou tout autre type de texte. Il s'agit d'une version simplifiée de GitHub, spécialement conçue pour le partage rapide et léger de fichiers individuels ou de petits groupes de fichiers. Voici quelques points clés sur Gist :

  • Partage rapide : Gist permet de crĂ©er et de partager des extraits de code ou des notes en quelques clics. Vous pouvez choisir de rendre vos Gists publics ou secrets. Les Gists publics sont accessibles Ă  tous, tandis que les Gists secrets ne sont visibles que par ceux qui possèdent le lien.

  • Versioning : Comme GitHub, Gist utilise Git pour le contrĂ´le de version. Cela signifie que vous pouvez suivre les modifications apportĂ©es Ă  vos Gists au fil du temps, revenir Ă  des versions antĂ©rieures et collaborer avec d'autres utilisateurs.

  • Syntax Highlighting : Gist prend en charge la coloration syntaxique pour de nombreux langages de programmation, ce qui rend les extraits de code plus lisibles et faciles Ă  comprendre.

  • Collaboration : Vous pouvez inviter d'autres utilisateurs Ă  collaborer sur vos Gists. Ils peuvent commenter, modifier et amĂ©liorer vos extraits de code ou vos notes.

  • IntĂ©gration avec GitHub : Gist est intĂ©grĂ© Ă  GitHub, ce qui signifie que vous pouvez utiliser votre compte GitHub pour crĂ©er et gĂ©rer vos Gists. Vous pouvez Ă©galement lier vos Gists Ă  des dĂ©pĂ´ts GitHub pour une gestion plus centralisĂ©e de votre code.

Comment utiliser Gist ?

  1. Créer un Gist :

    • Rendez-vous sur gist.github.com.
    • Connectez-vous avec votre compte GitHub.
    • Cliquez sur "New gist" pour crĂ©er un nouvel extrait. (Ou page par dĂ©faut)
  2. Ajouter du contenu :

    • Donnez un nom Ă  votre fichier et ajoutez votre code ou texte dans la zone de texte principale.
    • Vous pouvez ajouter plusieurs fichiers Ă  un mĂŞme Gist en cliquant sur "Add file".
  3. Partager votre Gist :

    • Une fois votre Gist créé, vous pouvez le partager en copiant l'URL unique gĂ©nĂ©rĂ©e.
    • Vous pouvez Ă©galement intĂ©grer votre Gist dans des blogs ou des sites web en utilisant l'option d'intĂ©gration fournie.

Gist est un outil pratique pour les développeurs et les écrivains techniques qui souhaitent partager rapidement des extraits de code ou des idées sans avoir à créer un dépôt GitHub complet. Que ce soit pour obtenir des commentaires sur un bout de code, partager une solution à un problème ou simplement sauvegarder des notes, Gist est une solution simple et efficace.

Ressources supplémentaires

Pour approfondir vos connaissances sur GitHub et Git, voici quelques ressources supplémentaires en français qui peuvent vous être utiles :

  1. Introduction Ă  GitHub et Git :

  2. Formation en ligne sur Git :

  3. Automatisation avec GitHub Actions :

    • Documentation GitHub Actions : DĂ©couvrez comment automatiser vos workflows de dĂ©veloppement directement dans vos dĂ©pĂ´ts GitHub.
  4. Déploiement de sites statiques :

  5. Collaboration avec les Pull Requests :

  6. Guides pratiques sur Git :

    • GitHowTo : Un site proposant des guides pratiques et des tutoriels pour maĂ®triser Git et GitHub.
🇫🇷 Comment utiliser GitHub : Les bases