GitHub Badges kunnen de leesbaarheid van een repository vergroten door gebruikers een snelle manier te bieden om de repository-statistieken vast te leggen. Badges kunnen in uw README.md worden ingesloten om het belang en de noodzaak van uw project aan andere ontwikkelaars duidelijk te maken. Als gevolg hiervan krijgen lezers een heel snel idee van de repository door de bijgevoegde badges te controleren.

Er zijn veel GitHub-badges beschikbaar op internet, hier zijn de vijf meest informatieve badges die je in je README.md-bestand kunt opnemen. Voor elke vermelde badge wordt de equivalente Markdown-code verstrekt.

Wat kunnen GitHub-badges voor u doen?

Het toevoegen van GitHub-badges aan uw repository lijkt misschien triviaal, maar in feite is het ongelooflijk handig. Het enige dat u hoeft te doen, is de Markdown-code van de bron naar uw README.md-bestand importeren.

Toen ik mijn Python Programming GitHub-repository maakte, liet ik badges weg. Mijn onversierde repository had de juiste inhoud, maar viel niet op. Hierdoor kreeg de repository zeer weinig traffic (unieke bezoekers).

instagram viewer

Verwant: Hoe u een GitHub-repository maakt

Hoe u uw eerste repository op Github maakt

Wilt u uw ontwikkelingsprojecten online delen? Hier leest u hoe u aan de slag gaat met uw eerste Github-repository.

Nadat ik meer badges aan mijn repository had toegevoegd, zag ik een automatische stijging van de externe bezoekers (van 5 naar 767) maandelijks (bekijk uw unieke bezoekers in Inzichten> Verkeer op uw repository.)

Mijn Postvak IN stond vol met opmerkingen over hoe goed mijn repository zich onderscheidde van andere Python-programmeerrepository's, allemaal vanwege badges. Een eenvoudige GitHub-badge kan het uiterlijk van uw repository volledig veranderen.

Houd hier altijd rekening mee: een badge is 1000 regels code waard.

De GitHub Stats-badge toont het totale aantal sterren, commits, pull-verzoeken, problemen en bijdragen van je GitHub-repository.

  1. Sterren: Gebruikers slaan GitHub-opslagplaatsen op (zoals bladwijzers). Dit geeft aan dat de gebruiker geïnteresseerd is en op de hoogte wil blijven van de opgeslagen repository. Een opslagplaats met ster kan echter niet worden bewerkt.
  2. Commits: Het opslaan van een wijziging in een repository wordt een Commit genoemd. Diverse details zijn toegevoegd aan een commit, inhoud, bericht (beschrijving), naam van de auteur en tijdstempel.
  3. Pull-verzoek: Een Pull Request informeert anderen over verbeteringen die je naar een andere GitHub-repository hebt gepusht, behalve die van jou. We verwijzen vaak naar Pull Request als het hart van GitHub Collaboration.
  4. Problemen: GitHub-problemen worden gebruikt om gebruikersfeedback te krijgen, ideeën bij te houden, verbeteringen aan te brengen en bugs weer te geven die aan de repository zijn gerapporteerd.
  5. Bijdrage: GitHub-bijdragen geven het aantal bijdragen aan dat is gedaan aan andere opslagplaatsen. Met behulp van een Pull Request kan een bijdrage worden geleverd.

Om de GitHub Stats-badge aan uw repository toe te voegen, sluit u de onderstaande Markdown-code in uw README.md-bestand in.

! [Statistieken van uw repository] ( https://github-readme-stats.vercel.app/api? gebruikersnaam = Your_GitHub_Username & show_icons = true)

Zorg ervoor dat u de gebruikersnaam = waarde toe aan de gebruikersnaam van je GitHub. De GitHub Stats-badge biedt ook rangen zoals S + (top 1%), S (top 25%), A ++ (top 45%), A + (top 60%) en B + (iedereen). Hoe hoger je statistieken, hoe beter je ranking.

Zoals de naam al doet vermoeden, geeft de badge Meest gebruikte talen de meest gebruikte talen weer die in GitHub worden gebruikt. Het is een GitHub-metriek van welke talen zoals HTML, CSS, JavaScript, Python, Go, en meer hebben de meeste code op GitHub. De talen worden in aflopende volgorde weergegeven.

Verwant: Welke programmeertaal moet u leren?

Om de meest gebruikte talen-badge aan uw repository toe te voegen, sluit u de Markdown hieronder in uw README.md-bestand in.

! [Statistieken van uw repository] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)

Het enige nadeel van deze badge is dat Markdown niet de meest gebruikte taal wordt genoemd.

De bijdragersbadge geeft alle bewerkingen weer, zoals toevoegingen, verwijderingen, en begaat die zijn uitgevoerd op uw repositories. Wanneer u een pull-verzoek samenvoegt met uw repository, wordt de persoon die het verzoek heeft gemaakt als bijdrager toegevoegd. Het is echt een goede gewoonte om de bijdragers te vermelden die hun tijd hebben geïnvesteerd in het verstrekken van een update van uw repository.

De bijdragersbadge kan worden gegenereerd met contributors-img, een webtoepassing die een afbeelding genereert om de lijst met bijdragers weer te geven.

Het genereren van de afbeelding van de bijdrager is vrij triviaal. Navigeer naar de contributors-img-website en plak het naam van uw repository samen met je gebruikersnaam om de URL te genereren. U kunt ook gewoon de onderstaande Markdown-code insluiten om de afbeelding te krijgen.

! [Afbeelding van GitHub-bijdragers] ( https://contrib.rocks/image? repo = Your_GitHub_Username / Your_GitHub_Repository_Name)

De willekeurige moppengenerator genereert een technische mop in de vorm van vragen en antwoorden. Bijvoorbeeld, "Wat is een computervirus? De terminale ziekte”.

Om de badge te gebruiken, moet u de Markdown-code insluiten in uw README.md-bestand, zoals hieronder weergegeven.

## 😂 Hier is een willekeurige grap die je aan het lachen maakt!
! [Grappenkaart] ( https://readme-jokes.vercel.app/api)

De profielteller-badge geeft het aantal keren weer dat uw GitHub-profiel in uw profiel is bekeken. Om deze badge te genereren, sluit u de volgende Markdown-code in:

! [Profielweergave-teller] ( https://komarev.com/ghpvc/?username=Your_GitHub_Username)

Om het aantal weergaven van je repository te genereren, wil je misschien de HITS (Hoe idioten succes bijhouden) badge. Het is een eenvoudige manier om te zien hoeveel mensen uw GitHub opslagplaats:

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

Maar het nadeel van zowel de profielweergaveteller als HITS is dat ze niet het aantal weergaven met unieke ID's weergeven. Elke keer dat u de browser / repository opnieuw laadt, worden de tellingen verhoogd. Je zou gemakkelijk meer views kunnen krijgen door de pagina te vernieuwen.

Volledige implementatie van GitHub-badges

Ik heb mijn GitHub-repository als voorbeeld gebruikt. Om de badges te genereren, wordt aanbevolen dat u deze codes toevoegt aan uw aangewezen README.md-bestand. Als je geen README.md-bestand in je GitHub-repository hebt, is het handmatig maken van een bestand de beste optie.

# Top 5 badges die uw GitHub-repository naar een hoger niveau tillen
## 1. GitHub-statistieken
! [Statistieken van uw repository] ( https://github-readme-stats.vercel.app/api? gebruikersnaam = Tanu-N-Prabhu & show_icons = true)
## 2. Meest gebruikte talen
! [Statistieken van uw repository] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green)
## 3. Badge voor bijdragers
! [Statistieken van uw repository] ( https://contrib.rocks/image? repo = Tanu-N-Prabhu / Python)
## 4. Willekeurige grapgenerator
! [Grappenkaart] ( https://readme-jokes.vercel.app/api)
## 5. Profielweergave teller
! [Profielweergave-teller] ( https://komarev.com/ghpvc/?username=Tanu-N-Prabhu)
### Repository View Counter - HITS
! [Hits] ( https://hitcounter.pythonanywhere.com/count/tag.svg? url = https://github.com/Tanu-N-Prabhu/Python)

Het is niet nodig om het bovenstaande markdown-codefragment op uw README.md-bestand uit te voeren of uit te voeren. Op het moment dat je het bestand opslaat met de extensie (.md), zal GitHub automatisch de uitvoer renderen en worden de wijzigingen direct weerspiegeld in je repository.

Meer GitHub-badges beschikbaar

Nu je weet hoe je GitHub-badges aan je repository kunt toevoegen, is het een geweldige optie voor ontwikkelaars en individuen die deze badges kunnen gebruiken om de leesbaarheid van hun repositories te vergroten. Het is niet zo moeilijk - het enige dat u hoeft te doen, is een paar regels Markdown-code insluiten om de badges te genereren.

Hoe meer badges u in uw repository opneemt, hoe meer aandacht u krijgt. Een enkele badge biedt de mogelijkheid om nuttige informatie te verstrekken in termen van statistieken, status en statistieken.

E-mail
Hoe een repository te klonen met GitHub Desktop

Wil je de software op GitHub leren kennen? Hier leest u hoe u het naar het oosten kunt maken met de gestroomlijnde GitHub Desktop-tool.

Gerelateerde onderwerpen
  • Programmeren
  • Markdown
  • GitHub
Over de auteur
Tanu Pradhu (1 Artikelen gepubliceerd)Meer van Tanu Pradhu

Abonneer op onze nieuwsbrief

Word lid van onze nieuwsbrief voor technische tips, recensies, gratis e-boeken en exclusieve deals!

Nog een stap…!

Bevestig uw e-mailadres in de e-mail die we u zojuist hebben gestuurd.

.