FRFAM.COM >> Famille >> Technologie &Innovation >> Informatique

Top 5 des badges qui vont booster votre référentiel GitHub

Les badges GitHub peuvent améliorer la lisibilité d'un référentiel en offrant aux utilisateurs un moyen rapide de capturer les métriques du référentiel. Des badges peuvent être intégrés dans votre README.md pour clarifier l'importance et la nécessité de votre projet pour les autres développeurs. En conséquence, les lecteurs ont une idée très rapide du référentiel en vérifiant les badges joints.

Il existe de nombreux badges GitHub disponibles sur Internet, voici les cinq badges les plus informatifs à inclure dans votre fichier README.md. Pour chaque badge répertorié, le code Markdown équivalent est fourni.

Que peuvent faire les badges GitHub pour vous ?

L'ajout de badges GitHub à votre référentiel peut sembler trivial, mais en fait, il est incroyablement utile. Tout ce que vous avez à faire est d'importer le code Markdown de la source vers votre fichier README.md.

Lorsque j'ai créé mon référentiel Python Programming GitHub, j'ai omis les badges. Mon référentiel sans fioritures avait le bon contenu mais ne se démarquait pas. De ce fait, le référentiel a généré très peu de trafic (visiteurs uniques).

Après avoir ajouté plus de badges à mon référentiel, j'ai constaté une augmentation automatique du nombre de visiteurs externes (de 5 à 767) par mois (consultez vos visiteurs uniques dans Insights > Trafic sur votre dépôt.)

Ma boîte de réception était remplie de commentaires sur la façon dont mon référentiel se démarquait des autres référentiels de programmation Python --- tout cela à cause des badges. Un simple badge GitHub peut complètement changer l'apparence de votre dépôt.

Gardez toujours ceci à l'esprit :un badge vaut 1 000 lignes de code.

1. Statistiques GitHub

Top 5 des badges qui vont booster votre référentiel GitHub

Le badge GitHub Stats indique le nombre total d'étoiles, de validations, de demandes d'extraction, de problèmes et de contributions de votre référentiel GitHub.

  1. Étoiles :Les utilisateurs enregistrent les référentiels GitHub (comme les favoris). Cela indique que l'utilisateur est intéressé et souhaite rester à jour avec le dépôt enregistré. Cependant, un dépôt suivi ne peut pas être modifié.
  2. Engagements :L'enregistrement d'une modification dans un référentiel est appelé Commit. Divers détails sont ajoutés à un commit, contenu, message (description), nom de l'auteur et horodatage .
  3. Demande d'extraction :Une demande d'extraction informe les autres des améliorations que vous avez apportées à un référentiel GitHub différent, à l'exception du vôtre. Nous nous référons souvent à Pull Request comme au cœur de GitHub Collaboration.
  4. Problèmes :les problèmes GitHub sont utilisés pour obtenir les commentaires des utilisateurs, suivre les idées, les améliorations et répertorier les bogues signalés au référentiel.
  5. Contribution :GitHub Contributions indique le nombre de contributions qui ont été faites à d'autres dépôts. Une contribution peut être apportée à l'aide d'une Pull Request.

Pour ajouter le badge GitHub Stats à votre référentiel, intégrez le code Markdown ci-dessous dans votre fichier README.md.

 ![Statistiques de votre référentiel](https://github-readme-stats.vercel.app/api?username=Your_GitHub_Username&show_icons=true) 

Assurez-vous de changer le username= value au nom d'utilisateur de votre GitHub. Le badge GitHub Stats fournit également des classements tels que S+ (top 1%), S (top 25%), A++ (top 45%), A+ (top 60 %) et B+ (tout le monde) . Plus vos statistiques sont élevées, meilleur est votre classement.

2. Langues les plus utilisées

Comme son nom l'indique, le badge Langues les plus utilisées affiche les langues les plus couramment utilisées dans GitHub. Il s'agit d'une métrique GitHub dont les langages tels que HTML, CSS, JavaScript, Python, Go, et plus ont le plus de code sur GitHub. Les langues sont répertoriées par ordre décroissant.

Pour ajouter le badge Langues les plus utilisées à votre référentiel, intégrez le Markdown ci-dessous à votre fichier README.md.

 ![Statistiques de votre référentiel](https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green) 

Le seul inconvénient de ce badge est qu'il ne répertorie pas Markdown comme le langage le plus couramment utilisé.

3. Badge Contributeurs

Top 5 des badges qui vont booster votre référentiel GitHub

Le Badge Contributeurs affiche toutes les opérations telles que les ajouts , suppressions , et commit qui ont été effectuées sur vos référentiels. Lorsque vous fusionnez une demande d'extraction dans votre référentiel, la personne qui a créé la demande sera ajoutée en tant que contributeur. C'est vraiment une bonne habitude de créditer les contributeurs qui ont investi leur temps pour fournir une mise à jour de votre dépôt.

Le badge des contributeurs peut être généré à l'aide de contributeurs-img, une application Web qui génère une image pour afficher la liste des contributeurs.

Générer l'image du contributeur est assez trivial. Accédez au site Web de contributeurs-img et collez le nom de votre référentiel avec votre nom d'utilisateur pour générer l'URL. Vous pouvez également incorporer simplement le code Markdown indiqué ci-dessous pour obtenir l'image.

 ![Image des contributeurs GitHub](https://contrib.rocks/image?repo=Your_GitHub_Username/Your_GitHub_Repository_Name) 

4. Générateur de blagues aléatoires

Le générateur de blagues aléatoires générera une blague technique sous forme de questions et réponses. Par exemple, "Qu'est-ce qu'un virus informatique ? La maladie terminale ”.

Pour utiliser le badge, vous devez intégrer le code Markdown dans votre fichier README.md, comme indiqué ci-dessous.

## 😂 Voici une blague au hasard qui va vous faire rire ! 
![Carte blagues](https://readme-jokes.vercel.app/api)

5. Compteur de vues de profil

Le badge Profile View Counter affiche le nombre de fois que votre profil GitHub a été consulté dans votre profil. Pour générer ce badge, intégrez le code Markdown suivant :

 ![Compteur de vues de profil](https://komarev.com/ghpvc/?username=Your_GitHub_Username) 

Pour générer le nombre de vues de votre référentiel, vous pouvez utiliser le HITS (How Idiots Track Success ) insigne. C'est un moyen simple de voir combien de personnes ont visité votre GitHub référentiel :

![Hits](https://hitcounter.pythonanywhere.com/count/tag.svg?url =Paste_Your_GitHub_Repository_Link_Here) 

Mais l'inconvénient du compteur de vues de profil et des HITS est qu'ils n'affichent pas le nombre de vues avec des identifiants uniques. Chaque fois que vous rechargez le navigateur/référentiel, les comptes seraient incrémentés. On pourrait facilement obtenir plus de vues en actualisant la page.

Implémentation complète des badges GitHub

J'ai utilisé mon référentiel GitHub comme exemple. Pour générer les badges, il est recommandé d'ajouter ces codes à votre fichier README.md désigné. Si vous n'avez pas de fichier README.md dans votre référentiel GitHub, en créer un manuellement est la meilleure option.

# Top 5 des badges qui feront passer votre référentiel GitHub au niveau supérieur 
## 1. Statistiques GitHub
![Statistiques de votre dépôt](https://github-readme-stats.vercel.app/api?username=Tanu-N-Prabhu&show_icons=true)
## 2. Langues les plus utilisées
![Statistiques de votre dépôt](https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green)
## 3. Badge Contributeurs
![Statistiques de votre dépôt](https://contrib.rocks/image?repo=Tanu-N-Prabhu/Python)
## 4. Générateur de blagues aléatoires
![Carte blagues](https://readme-jokes.vercel.app/api)
## 5. Compteur de vues de profil
![Compteur de vues de profil](https://komarev.com/ghpvc/?username=Tanu-N-Prabhu)
### Compteur d'affichage du référentiel - HITS
![Hits](https://hitcounter.pythonanywhere.com/count/tag.svg?url=https://github.com/Tanu-N-Prabhu/Python)

Il n'est pas nécessaire d'exécuter ou d'exécuter l'extrait de code Markdown ci-dessus sur votre fichier README.md. Au moment où vous enregistrez le fichier avec l'extension (.md), GitHub rendra automatiquement la sortie et les modifications seront directement répercutées sur votre référentiel.

Plus de badges GitHub disponibles

Maintenant que vous savez comment ajouter des badges GitHub à votre référentiel, c'est une excellente option pour les développeurs et les particuliers qui peuvent utiliser ces badges pour augmenter la lisibilité de leurs référentiels. Ce n'est pas si difficile — tout ce que vous avez à faire est d'intégrer quelques lignes de code Markdown pour générer les badges.

Plus vous incluez de badges dans votre référentiel, plus vous attirerez l'attention. Un seul badge aura la capacité de fournir des informations utiles en termes de statistiques, de statut et de métriques.


[]