Ce guide vous accompagne tout au long de la configuration de votre compte GitHub et de la prise en main des fonctionnalités deGitHub pour la collaboration et la communauté.
Partie 1 : Configuration de votre compte GitHub
Les premières étapes à suivre pour commencer à utiliser GitHub sont de créer un compte, de choisir un produit qui répond au mieux à vos besoins, de vérifier votre e-mail, de configurer une authentification à deux facteurs et d’afficher votre profil.
Il existe plusieurs types de comptes sur GitHub. Chaque personne qui utilise GitHub possède son propre compte personnel, qui peut faire partie de plusieurs organisations et équipes. Votre compte personnel est votre identité sur GitHub.com, et vous représente en tant qu’individu.
1. Création d’un compte
Pour vous inscrire à un compte, accédez à https://github.com/ et suivez les invites.
Pour sécuriser votre compte GitHub, vous devriez utiliser un mot de passe fort et unique. Pour plus d’informations, consultez « Création d’un mot de passe fort ».
2. Choisir votre produit GitHub
Vous pouvez choisir GitHub Free ou GitHub Pro pour avoir accès à différentes fonctionnalités pour votre compte personnel. Vous pouvez effectuer une mise à niveau à tout moment si vous n’êtes pas certain du produit souhaité.
Pour plus d’informations sur tous les plans de GitHub, consultez « Plans de GitHub ».
3. Vérification de votre adresse e-mail
Pour vous assurer de pouvoir utiliser toutes les fonctionnalités de votre plan GitHub, vérifiez votre adresse e-mail après avoir créé un compte. Pour plus d’informations, consultez « Vérification de votre adresse e-mail ».
4. Configuration d’une authentification à deux facteurs
Une authentification à deux facteurs, ou 2FA, est une couche supplémentaire de sécurité utilisée lors de la connexion à des sites web ou à des applications. Nous vous recommandons vivement de configurer 2FA pour la sécurité de votre compte. Pour plus d’informations, consultez « À propos de l’authentification à deux facteurs ».
Si vous le souhaitez, une fois que vous avez configuré 2FA, ajoutez une clé d’accès à votre compte pour activer une connexion sécurisée sans mot de passe. Consultez la section « Gestion de vos clés d'accès. »
5. Affichage de votre graphique de profil et de contribution GitHub
Votre profil GitHub raconte l’histoire de votre travail au travers des dépôts et gists que vous avez épinglés, des appartenances à des organisations que vous avez choisi de rendre publiques, des contributions que vous avez faites et des projets que vous avez créés. Pour plus d’informations, consultez « À propos de votre profil » et « Affichage des contributions sur votre profil ».
Partie 2 : Utilisation d’outils et de processus de GitHub
Pour utiliser au mieux GitHub, vous devez configurer Git. Git est responsable de tout ce qui est lié à GitHub qui se produit localement sur votre ordinateur. Pour collaborer efficacement sur GitHub, vous allez écrire dans des problèmes et demandes de tirage en utilisant Markdown adapté à GitHub.
1. Apprentissage de Git
L’approche collaborative de GitHub du développement dépend de la publication de validations à partir de votre dépôt local sur GitHub pour que d’autres personnes puissent afficher, extraire et mettre à jour à l’aide de Git. Pour plus d’informations sur Git, consultez le guide « Manuel Git ». Pour plus d’informations sur la façon dont Git est utilisé sur GitHub, consultez « GitHub flow ».
2. Configuration de Git
Si vous envisagez d’utiliser Git localement sur votre ordinateur, que ce soit via la ligne de commande, un IDE ou un éditeur de texte, vous devez installer et configurer Git. Pour plus d’informations, consultez « Configurer Git ».
Si vous préférez utiliser une interface visuelle, vous pouvez télécharger et utiliser GitHub Desktop. GitHub Desktop étant empaqueté avec Git. Il n’est pas nécessaire d’installer Git séparément. Pour plus d’informations, consultez « Bien démarrer avec GitHub Desktop ».
Une fois que vous avez installé Git, vous pouvez vous connecter à des dépôts GitHub à partir de votre ordinateur local, qu’il s’agisse de votre propre dépôt ou d’une duplication d’un autre utilisateur. Lorsque vous vous connectez à un dépôt sur GitHub.com à partir de Git, vous devez vous authentifier auprès de GitHub en utilisant le protocole HTTPS ou SSH. Pour plus d’informations, consultez « À propos des référentiels distants ».
3. Choix du mode d’interaction avec GitHub
Toute personne disposant de son propre workflow unique pour interagir avec GitHub. Les interfaces et méthodes que vous utilisez dépendent de vos préférences et de ce qui répond le mieux à vos besoins.
Pour plus d’informations sur les différentes approches d’interaction avec GitHub, et une comparaison des outils que vous pouvez utiliser, consultez « Connexion à GitHub ».
4. Écriture sur GitHub
Pour rendre votre communication claire et organisée dans des problèmes et demandes de tirage, vous pouvez utiliser un Markdown adapté à GitHub pour la mise en forme, qui combine une syntaxe facile à lire et à écrire avec certaines fonctionnalités personnalisées. Pour plus d’informations, consultez « À propos de l'écriture et de la mise en forme sur GitHub ».
Vous pouvez apprendre à utiliser le Markdown adapté à GitHub avec le cours « Communication à l’aide de Markdown » sur GitHub Skills.
5. Recherche sur GitHub
Notre recherche intégrée vous permet de trouver ce que vous cherchez parmi les nombreux dépôts, utilisateurs et lignes de code sur GitHub. Vous pouvez rechercher globalement dans tout GitHub, ou limiter votre recherche à un dépôt ou une organisation spécifiques. Pour plus d’informations sur les types de recherches que vous pouvez faire sur GitHub, consultez « À propos de la recherche sur GitHub ».
Notre syntaxe de recherche vous permet de construire des requêtes en utilisant des qualificateurs pour spécifier ce que vous souhaitez rechercher. Pour plus d’informations sur la syntaxe de recherche à utiliser dans la recherche, consultez « Recherche sur GitHub ».
6. Gestion de fichiers sur GitHub
Avec GitHub, vous pouvez créer, modifier, déplacer et supprimer des fichiers dans votre dépôt ou tout dépôt auquel vous avez accès en écriture. Vous pouvez également suivre l’historique des modifications dans un fichier ligne par ligne. Pour plus d’informations, consultez « Gestion des fichiers ».
Partie 3 : Collaboration sur GitHub
Un nombre quelconque de personnes peuvent collaborer dans des dépôts sur GitHub. Vous pouvez configurer des paramètres, créer des projets et gérer vos notifications pour encourager une collaboration efficace.
1. Utilisation des dépôts
Création d’un dépôt
Un dépôt est comme un dossier pour votre projet. Vous pouvez avoir n’importe quel nombre de dépôts publics et privés dans votre compte personnel. Un dépôt peut contenir des dossiers et fichiers, des images, des vidéos, des feuilles de calcul et des jeux de données, ainsi que l’historique des révisions de tous les fichiers qui s’y trouvent. Pour plus d’informations, consultez « À propos des dépôts ».
Lorsque vous créez un dépôt, vous devriez l’initialiser avec un fichier README afin d’informer les utilisateurs à propos de votre projet. Pour plus d’informations, consultez « Création d’un dépôt ».
Clonage d’un dépôt
Vous pouvez cloner un dépôt existant à partir de GitHub sur votre ordinateur local pour faciliter l’ajout ou la suppression de fichiers, la correction de conflits de fusion ou des validations complexes. Le clonage d’un dépôt extrait une copie complète de toutes les données du dépôt dont GitHub dispose à ce stade, y compris toutes les versions de chaque fichier et dossier du projet. Pour plus d’informations, consultez « Clonage d’un dépôt ».
Duplication d’un dépôt
Une duplication est une copie d’un dépôt que vous gérez, où aucune des modifications que vous apportez n’affecte le dépôt d’origine, sauf si vous soumettez une demande de tirage au propriétaire du projet. Le plus souvent, des duplications sont utilisées soit pour proposer des modifications au projet de quelqu’un d’autre, soit pour utiliser le projet de quelqu’un d’autre comme point de départ pour votre propre idée. Pour plus d’informations, consultez « Utilisation des duplications ».
2. Importation de vos projets
Si vous avez des projets existants que vous souhaitez déplacer vers GitHub, vous pouvez importer des projets à l’aide de GitHub Importer, de la ligne de commande ou d’outils de migration externe. Pour plus d’informations, consultez « Importation du code source ».
3. Gestion des collaborateurs et des autorisations
Vous pouvez collaborer sur votre projet avec d'autres personnes en utilisant les problèmes, demandes de tirage et projects de votre dépôt. Vous pouvez inviter d’autres personnes à votre dépôt en tant que collaborateurs à partir de l’onglet Collaborateurs dans les paramètres du dépôt. Pour plus d’informations, consultez « Invitation de collaborateurs à un dépôt personnel ».
Vous êtes le propriétaire de tout dépôt que vous créez dans votre compte personnel et disposez d’un contrôle total du dépôt. Les collaborateurs ont un accès en écriture à votre dépôt, ce qui limite ce qu’ils sont autorisés à faire. Pour plus d’informations, consultez « Niveaux d’autorisation pour un référentiel de compte personnel ».
4. Gestion des paramètres du dépôt
En tant que propriétaire d’un dépôt, vous pouvez configurer plusieurs paramètres, dont la visibilité, les rubriques et l’aperçu sur les réseaux sociaux du dépôt. Pour plus d’informations, consultez « Gestion des paramètres et fonctionnalités de votre dépôt ».
5. Configuration de votre projet pour des contributions saines
Pour encourager les collaborateurs dans votre dépôt, vous avez besoin d’une communauté qui encourage ses membres à utiliser, à enrichir et à promouvoir votre projet. Pour plus d’informations, consultez « Construction de communautés accueillantes » dans les Guides open source.
En ajoutant des fichiers tels que des directives de contribution, un code de conduite et une licence à votre dépôt, vous pouvez créer un environnement dans lequel il est plus facile pour les collaborateurs d’apporter des contributions utiles et significatives. Pour plus d’informations, consultez « Configuration de votre projet pour des contributions saines ».
6. Utilisation de GitHub Issues et Projects
Vous pouvez utiliser GitHub Issues pour organiser votre travail avec des problèmes et des demandes de tirage, ainsi que gérer votre flux de travail avec Projects. Pour plus d’informations, consultez « À propos des problèmes » et « À propos des Projects ».
7. Gestion des notifications
Les notifications fournissent des mises à jour concernant l’activité sur GitHub à laquelle vous vous êtes abonné ou avez participé. Si vous n’êtes plus intéressé par une conversation, vous pouvez vous désabonner, annuler la surveillance ou personnaliser les types de notifications que vous recevrez à l’avenir. Pour plus d’informations, consultez « À propos des notifications ».
8. Utilisation de GitHub Pages
Vous pouvez utiliser GitHub Pages pour créer et héberger un site web directement à partir d'un dépôt sur GitHub.com. Pour plus d’informations, consultez « À propos de GitHub Pages ».
9. Utilisation de GitHub Discussions
Vous pouvez activer GitHub Discussions pour votre dépôt afin d’aider à construire une communauté autour de votre projet. Des gestionnaires de maintenance, contributeurs et visiteurs peuvent utiliser des discussions pour partager des annonces, poser des questions et y répondre, et participer à des conversations autour d’objectifs. Pour plus d’informations, consultez « À propos des discussions ».
Partie 4 : Personnalisation et automatisation de votre travail sur GitHub
Vous pouvez utiliser des outils de GitHub Marketplace, l’API GitHub, et des fonctionnalités GitHub existantes pour personnaliser et automatiser votre travail.
1. Utilisation de GitHub Marketplace
GitHub Marketplace contient des intégrations qui ajoutent des fonctionnalités et améliorent votre workflow. Vous pouvez découvrir, parcourir et installer des outils gratuits et payants, y compris des GitHub Apps, des OAuth apps et des GitHub Actions, dans GitHub Marketplace.
2. Utilisation de l’API GitHub
Il existe deux versions de l’API GitHub : l’API REST et l’API GraphQL. Vous pouvez utiliser les API GitHub pour automatiser les tâches courantes, sauvegarder 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 ».
3. Génération d’GitHub Actions
Avec GitHub Actions, vous pouvez automatiser et personnaliser le workflow de développement de GitHub.com sur GitHub. Vous pouvez créer vos propres actions, ainsi qu’utiliser et personnaliser des actions personnalisées partagées par la communauté GitHub. Pour plus d’informations, consultez « Écriture de workflows ».
4. Publication et gestion de GitHub Packages
GitHub Packages est un service d’hébergement de package logiciel qui vous permet d’héberger vos packages logiciels en privé ou publiquement, ainsi que d’utiliser des packages en tant que dépendances dans vos projets. Pour plus d’informations, consultez « Introduction aux packages GitHub ».
Partie 5 : Génération en toute sécurité sur GitHub
GitHub offre diverses fonctionnalités de sécurité qui permettent de sécuriser le code et les secrets dans les dépôts. Certaines fonctionnalités sont disponibles pour tous les dépôts, tandis que d’autres ne sont disponibles que pour des dépôts publics et des dépôts avec une licence GitHub Advanced Security. Pour une vue d’ensemble des fonctionnalités de sécurité de GitHub, consultez « Fonctionnalités de sécurité de GitHub ».
1. Sécurisation de votre dépôt
En tant qu’administrateur de dépôt, vous pouvez sécuriser vos dépôts en configurant leurs paramètres de sécurité. Il s’agit notamment de la gestion de l’accès à votre dépôt, de la définition d’une stratégie de sécurité et de la gestion des dépendances. Pour les dépôts publics et pour les dépôts privés appartenant à des organisations où GitHub Advanced Security est activé, vous pouvez également configurer l’analyse du code et des secrets pour identifier automatiquement les vulnérabilités et vérifier que les jetons et les clés ne sont pas exposés.
Pour plus d’informations sur les étapes à suivre pour sécuriser vos dépôts, consultez « Démarrage rapide pour la sécurisation de votre dépôt ».
2. Gestion de vos dépendances
Une génération sécurisée consiste en grande partie à gérer les dépendances de votre projet pour vous assurer que l’ensemble des packages et applications dont vous dépendez sont à jour et sécurisés. Vous pouvez gérer les dépendances de votre dépôt sur GitHub en explorant le graphique de dépendances de votre dépôt, en utilisant Dependabot pour déclencher automatiquement des demandes de tirage afin de tenir vos dépendances à jour, et en recevant des alertes et mises à jour de sécurité de Dependabot pour des dépendances vulnérables.
Pour plus d’informations, consultez « Sécurisation de votre chaîne d’approvisionnement logicielle ».
Partie 6 : Participation à la communauté de GitHub
Il existe de nombreuses façons de participer à la communauté GitHub. Vous pouvez contribuer à des projets open source, interagir avec des personnes dans GitHub Community Support, ou apprendre avec GitHub Skills.
1. Contribution à des projets open source
Contribuer à des projets open source sur GitHub peut être un moyen gratifiant d’apprendre, d’enseigner et d’acquérir de l’expérience en lien avec pratiquement toute compétence. Pour plus d’informations, consultez « Comment contribuer à l’Open Source » dans Open Source Guides.
Vous trouverez des recommandations personnalisées pour des projets et de bons problèmes de départ en fonction de vos contributions passées, étoiles et autres activités dans Explorer GitHub. Pour plus d’informations, consultez « Trouver des moyens de contribuer à l’open source sur GitHub ».
2. Interaction avec GitHub Community Support
Vous pouvez entrer en contact avec les développeurs du monde entier pour poser et répondre à des questions, apprendre et interagir directement avec l’équipe de GitHub. Pour commencer la conversation, consultez « GitHub Community Support ».
3. Lecture à propos de GitHub sur GitHub Docs
Vous pouvez lire la documentation qui reflète les fonctionnalités disponibles sur GitHub. Pour plus d’informations, consultez « À propos des versions de GitHub Docs ».
4. Apprentissage avec GitHub Skills
Vous pouvez apprendre de nouvelles compétences en effectuant des projets amusants et réalistes dans votre propre dépôt GitHub avec GitHub Skills. Chaque cours consiste en une leçon pratique créée par la communauté GitHub et enseignée par un bot convivial.
Pour plus d’informations, consultez « Ressources pédagogiques Git et GitHub ».
5. Soutien de la communauté open source
GitHub Sponsors vous permet d’effectuer un paiement périodique mensuel à un développeur ou à une organisation qui conçoit, crée ou gère les projets open source dont vous dépendez. Pour plus d’informations, consultez « À propos de GitHub Sponsors ».
6. Contact de Support GitHub
Support GitHub peut vous aider à résoudre les problèmes que vous rencontrez pendant l’utilisation de GitHub. Pour plus d’informations, consultez « À propos du support GitHub ».