MarineLLV / github-slideshow

A robot powered training repository :robot:

Home Page:https://lab.github.com/githubtraining/introduction-to-github

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Getting Started with GitHub

github-learning-lab opened this issue · comments

👋 Bienvenue au cours "Introduction à GitHub" de GitHub Learning Lab

Pour commencer, je vais vous guider à travers quelques premières étapes importantes de la programmation et la collaboration sur GitHub.

👇 Cette flèche signifie que vous pouvez agrandir la fenêtre. Cliquez dessus tout au long du cours pour trouver plus d'informations.

Qu'est-ce que GitHub?

Qu'est-ce que GitHub?

Merci d'avoir posé cette question! Beaucoup de gens viennent sur GitHub parce qu'ils veulent contribuer à des projets libres (open source 📖), ou ils sont invités par des collègues ou des camarades de classe qui l'utilisent pour leurs projets. Pourquoi les gens utilisent-ils GitHub pour ces projets?

GitHub est une plateforme de collaboration.

Des logiciels aux documents juridiques, vous pouvez compter sur GitHub pour vous aider à réaliser le meilleur travail possible avec les outils de collaboration et de sécurité dont votre équipe a besoin. Avec GitHub, vous pouvez garder des projets complètement privés ou inviter des personnes à collaborer et fluidifier chaque étape de votre projet.

GitHub est également un puissant outil de contrôle de version.

GitHub utilise Git 📖, l'outil open source de gestion de version le plus populaire, afin de tracer chaque contribution et contributeur 📖 de votre projet, afin que vous sachiez d'où vient chaque ligne de code.

GitHub vous aide à faire beaucoup plus.

GitHub est utilisé pour créer certaines des technologies les plus avancées au monde. Que vous visualisiez des données ou construisiez un nouveau jeu, il existe toute une communauté et un ensemble d'outils sur GitHub qui peuvent vous aider à passer à l'étape suivante. Ce cours commence par les bases, mais nous approfondirons le reste plus tard!

📺 Qu'est-ce que GitHub?



Exploration d'un dépôt GitHub

Exploration d'un dépôt GitHub

📺 Video: Exploration d'un dépôt

Autres fonctionnalités

La vidéo a couvert certaines des fonctionnalités les plus utilisées. Voici quelques autres éléments que vous pouvez trouver dans les dépôts GitHub :

  • Tableaux de suvi de projet : créez un tableau de suivi des tâches de style Kanban dans GitHub
  • Wiki : créer et stocker la documentation relative à votre projet
  • Insights : affichez des outils d'analyse pour votre dépôt, notamment :
    • Pulse: tableau de bord de projet pemettant la recherche d'information sur les travaux terminés et les travaux en cours
    • Graphiques : les graphiques fournissent une vue plus granulaire de l'activité du dépôt, donnant des détails sur qui a contribué au dépôt, qui l'a créé et quand les contributions ont été effectuées

Fichiers spéciaux

Dans la vidéo, vous avez découvert un fichier spécial appelé README.md. Voici quelques autres fichiers spéciaux que vous pouvez ajouter à vos dépôts :

  • CONTRIBUTING.md: Le fichier CONTRIBUTING.md est utilisé pour décrire le processus de contribution aux dépôts. Un lien vers le fichier CONTRIBUTING.md est affiché chaque fois que quelqu'un crée une nouvelle Issue ou une Pull Request.
  • ISSUE_TEMPLATE.md: ISSUE_TEMPLATE.md est un autre fichier que vous pouvez utiliser pour préremplir le corps d'une Issue. Par exemple, si vous avez toujours besoin des mêmes types d'informations pour les rapports de bugs, incluez-les dans le modèle d'Issue, et chaque nouvelle Issue sera ouverte avec votre texte de démarrage recommandé.

Utiliser les Issues

Ceci est une Issue 📖: un endroit où vous pouvez avoir des conversations sur les bugs dans votre code, la révision du code et à peu près tout le reste.

Les titres des Issues sont comme les lignes d'objet des e-mails. Ils indiquent à vos collaborateurs de quoi il s'agit en un coup d'œil. Par exemple, le titre de cette Issue est "Getting started with GitHub".

Utiliser les Issues GitHub

Utiliser les Issues GitHub

Les Issues sont utilisées pour discuter des idées, des améliorations, des tâches et des bugs. Elles facilitent la collaboration en :

  • Fournissant à tout le monde (même aux futurs membres de l'équipe) l'historique complet en un seul endroit
  • En permettant les références croisées avec d'autres Issues et Pull Requests 📖
  • Centralisant dans un dépôt unique les décisions et leurs motivations
  • Vous permettant d'inclure facilement les bonnes personnes et les bonnes équipes dans une conversation avec les @-mentions

📺 Video: Utiliser les Issues GitHub


Gérer les notifications

Gérer les notifications

📺 Video: Watching, notifications, stars, et explore

Une fois que vous avez commenté une Issue ou une Pull Request, vous commencerez à recevoir des notifications par e-mail dès lors qu'il y aura de l'activité dans le fil d'actualité.

Comment faire taire ou réactiver des Issues spécifiques

  1. Aller à l'Issue ou la Pull Request
  2. Sous "Notifications", cliquez le bouton Unsubscribe à droite afin de taire les notifications ou le bouton Subscribe afin de les activer

Vous verrez une courte description qui explique votre statut de notification actuel.

Comment personnaliser les notifications dans vos réglages

  1. Cliquez votre photo de profil
  2. Cliquez Settings
  3. Cliquez Notifications depuis le menu de gauche et ajustez vos préférences de notification

Options de notification du dépôt

  • Watch: Vous recevrez une notification lorsqu'une nouvelle Issue, une Pull Request ou un commentaire est publié, et lorsqu'une Issue est fermé ou qu'une Pull Request est fusionnée
  • Not watching: Vous ne recevrez plus de notifications sauf si vous êtes @-mentionné
  • Ignore: Vous ne recevrez plus de notifications du dépôt

Comment configurer les notifications des dépots que vous suivez

  1. Cliquez votre photo de profil
  2. Cliquez Settings
  3. Cliquez Notifications depuis le menu de gauche
  4. Cliquez sur le lien "things you’re watching"
  5. Sélectionnez l'onglet Watching t
  6. Cliquez le bouton Unwatch pour désactiver les notifications, ou Watch les activer


Continuez à lire ci-dessous pour trouver votre première tâche

Étape 1: Assignation

Les Issues non assignées ne sont sous la responsabilité de personne. Lorsque vous êtes assigné à une Issue ou une Pull Request, les visiteurs du dépôt sont informés que vous êtes le facilitateur de la discussion ou de la tâche 💪.

⌨️ Activité

  1. Sur la partie droite de l'écran, sous la section "Assignees", cliquez l'icône engrenage et séléctionnez vous.

Pour obtenir une version imprimable des étapes de ce cours, visitez le Quick Reference Guide.


Je vous réponderai dès que vous vous serez assigné cette Issue.

Parfois je réponds trop rapidement et la page n'a pas le temps de s'actualiser. Si vous avez effectué l'action espérée et que vous ne voyez pas de réponse de ma part, attendez quelques secondes et rafraîchissez la page afin d'obtenir les prochaines instructions.

Étape 2: Activez GitHub Pages

🎉 Vous êtes maintenant le fier gestionnaire de cette Issue ! Maintenant que vous vous êtes assigné, les personnes qui passent savent qu'elles sont les bienvenues pour participer, mais aussi que vous êtes chargé de faire avancer le sujet jusqu'à la ligne d'arrivée. 😎.

Utilisons GitHub Pages

Maintenant, au boulot ! GitHub Pages vous permet de servir un site statique à partir d'un dépot. Nous avons rempli ce dépot avec du contenu de site, mais le site rendu n'est pas visible pour le moment. Changeons cela.

⌨️ Activité: Activez GitHub Pages

  1. Cliquez sur l'onglet Settings de ce dépôt
  2. Défilez jusqu'à la section "GitHub Pages"
  3. Depuis le menu déroulant "Source", selectionnez main branch

Note : même si vous voyez une option pour choisir un thème, n'appliquez pas de thème à ce stade. Nous avons protégé le code afin que vous ne puissiez pas apporter de modifications involontaires. Vous aurez la possibilité d'appliquer un thème une fois le cours terminé.


Je répondrai dans cette discussion lorsque j'aurai détecté que GitHub Pages a déployé votre site.

Activer GitHub Pages déclenche le déploiement de votre dépôt. Ceci peut prendre jusqu'à une minute.

Étape 3: Fermeture de la discussion

Vous avez activé GitHub Pages!

Votre site est maintenant public. Jetez-y un oeil à l'adresse .

Maintenant que vous avez effectué les tâches, vous pouvez fermer l'Issue. Fermer une Issue informe les autres contributeurs que cette discussion ou tâche est terminée.

⌨️ Activité

  1. Cliquez sur le boutton Close issue ci-dessous

Je vous répondrai quand vous aurez fermé cette issue.

Cette Issue est close! ✅


Procédez à la prochaine tâche maintenant !