🇫🇷 Comment utiliser GitHub : Les bases
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 :
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.
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.
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 :
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.
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.
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.
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.
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]".
Et voici notre fichier à l'intérieur du dossier que nous avons créé.
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.
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 ;)
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.
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.
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 :
-
Accédez à votre dépôt :
- Allez sur la page principale de votre dépôt sur GitHub.
-
Ouvrez le menu des branches :
- Cliquez sur le menu déroulant des branches, généralement situé au-dessus de la liste des fichiers.
- 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.
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 :
-
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".
-
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 :
-
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.
-
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"
- Une fois installé, configurez votre nom d'utilisateur et votre adresse e-mail avec les commandes suivantes :
Commandes de base de Git
Voici quelques commandes de base pour commencer avec Git :
-
Initialiser un dépôt :
- Pour créer un nouveau dépôt Git dans un répertoire existant :
Bash
git init
- Pour créer un nouveau dépôt Git dans un répertoire existant :
-
Cloner un dépôt existant :
- Pour copier un dépôt distant sur votre machine locale :
Bash
git clone url_du_depot
- Pour copier un dépôt distant sur votre machine locale :
-
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 .
- Pour ajouter des fichiers spécifiques à l'index (staging area) avant de les commiter :
-
Commiter des modifications :
- Pour enregistrer les modifications dans le dépôt local :
Bash
git commit -m "Message de commit"
- Pour enregistrer les modifications dans le dépôt local :
-
Afficher l'état du dépôt :
- Pour voir les modifications non commitées et les fichiers non suivis :
Bash
git status
- Pour voir les modifications non commitées et les fichiers non suivis :
-
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
- Pour envoyer vos commits vers un dépôt distant :
-
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
- Pour récupérer les modifications depuis un dépôt distant :
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 :
-
Créer une nouvelle branche :
Bashgit branch nom_de_la_branche
-
Basculer vers une branche :
Bashgit checkout nom_de_la_branche
-
Créer et basculer vers une nouvelle branche :
Bashgit checkout -b nom_de_la_branche
-
Fusionner une branche dans la branche actuelle :
Bashgit 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 :
-
Créer un fichier
.gitignore
:- Créez un fichier nommé
.gitignore
dans votre répertoire de projet.
- Créez un fichier nommé
-
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/
- Ajoutez les chemins des fichiers ou dossiers que vous souhaitez ignorer, un par ligne. Par exemple :
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
-
Installer VS Code :
- Téléchargez et installez Visual Studio Code depuis le site officiel : Visual Studio Code.
-
Ouvrir un projet :
- Ouvrez un projet existant ou créez-en un nouveau dans VS Code.
-
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".
- 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
Utilisation des fonctionnalités Git dans VS Code
- 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.
- Ajouter des fichiers Ă l'index :
- Cliquez sur le signe
+
à côté des fichiers modifiés pour les ajouter à l'index (staging area).
- Cliquez sur le signe
- 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.
- Pousser et tirer des modifications :
Pour synchroniser vos modifications avec un dépôt distant dans Visual Studio Code, vous avez deux options principales
- 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.
- 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.
- 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".
- 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.
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é.
- Utilisez le raccourci
-
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.
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.
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
.
- GitHub vous redirigera vers un fichier de workflow dans votre répertoire, situé dans
- 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.
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.
- Une fois terminé, votre site sera accessible via l'URL fournie dans les paramètres GitHub Pages.
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 ?
-
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)
-
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".
-
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 :
-
Introduction Ă GitHub et Git :
- À propos de GitHub et Git : Une introduction complète pour comprendre les bases de GitHub et Git, idéale pour les débutants.
-
Formation en ligne sur Git :
- Formation Git par Grafikart : Une formation vidéo en français qui couvre les concepts de base et avancés de Git.
-
Automatisation avec GitHub Actions :
- Documentation GitHub Actions : Découvrez comment automatiser vos workflows de développement directement dans vos dépôts GitHub.
-
Déploiement de sites statiques :
- Documentation GitHub Pages : Apprenez à héberger des sites web statiques directement depuis vos dépôts GitHub.
-
Collaboration avec les Pull Requests :
- Documentation sur les Pull Requests : Comprenez comment utiliser les pull requests pour collaborer efficacement sur des projets.
-
Guides pratiques sur Git :
- GitHowTo : Un site proposant des guides pratiques et des tutoriels pour maîtriser Git et GitHub.