GitHub-merker kan øke lesbarheten til et depot ved å gi brukerne en rask måte å fange oppbevaringsberegningene. Merker kan legges inn i din README.md for å avklare viktigheten og nødvendigheten av prosjektet ditt for andre utviklere. Som et resultat får leserne en veldig rask ide om depotet ved å sjekke de vedlagte merkene.
Det er mange GitHub-merker tilgjengelig på internett, her er de fem mest informative merkene som skal inkluderes i README.md-filen. For hvert merke som er oppgitt, er tilsvarende Markdown-kode oppgitt.
Hva kan GitHub-merker gjøre for deg?
Å legge til GitHub-merker i depotet ditt kan virke trivielt, men faktisk er det utrolig nyttig. Alt du trenger å gjøre er å importere Markdown-kode fra kilden til README.md-filen.
Da jeg opprettet mitt Python Programming GitHub-lager, utelatt jeg merker. Mitt uembeliserte lager hadde riktig innhold, men skilte seg ikke ut. På grunn av dette fikk depotet svært lite trafikk (unike besøkende).
I slekt: Hvordan lage et GitHub-arkiv
Vil du dele utviklingsprosjektene dine på nettet? Slik kommer du i gang med ditt første Github-arkiv.
Etter å ha lagt til flere merker i depotet mitt, så jeg en automatisk økning i eksterne besøkende (fra 5 til 767) hver måned (se dine unike besøkende i Innsikt> Trafikk på depotet ditt.)
Innboksen min var fylt med kommentarer om hvor godt depotet mitt skilte seg ut fra andre Python-programmeringsregister på grunn av merker. Et enkelt GitHub-merke kan endre utseendet på depotet ditt.
Husk alltid dette: et merke er verdt 1000 linjer med kode.
GitHub Stats-merket viser det totale antallet stjerner, forpliktelser, trekkforespørsler, problemer og bidrag til GitHub-depotet ditt.
- Stjerner: Brukere lagrer GitHub-arkiver (som bokmerker). Dette indikerer at brukeren er interessert og ønsker å holde seg oppdatert med det lagrede depotet. Et stjernemerket arkiv kan imidlertid ikke redigeres.
- Forplikter: Å lagre en endring i et depot er referert til som en Commit. Ulike detaljer er lagt til en forpliktelse, innhold, melding (beskrivelse), forfatternavn og tidsstempel.
- Trekk forespørsel: En Pull Request informerer andre om forbedringer du har sendt til et annet GitHub-lager, bortsett fra ditt. Vi refererer ofte til Pull Request som hjertet i GitHub Collaboration.
- Problemer: GitHub-problemer brukes til å få tilbakemeldinger fra brukerne, spore ideer, forbedringer og listefeil rapportert til depotet.
- Bidrag: GitHub-bidrag angir antall bidrag som er gitt til andre arkiver. Et bidrag kan gis ved hjelp av en Pull Request.
For å legge til GitHub Stats-merket i depotet ditt, legg ned Markdown-koden nedenfor i README.md-filen.
! [Statistikken til ditt depot] ( https://github-readme-stats.vercel.app/api? brukernavn = Your_GitHub_Username & show_icons = true)
Forsikre deg om at du endrer brukernavn = verdi til GitHubs brukernavn. GitHub Stats-merket gir også rangeringer så som S + (topp 1%), S (topp 25%), A ++ (topp 45%), A + (topp 60%) og B + (alle). Jo høyere statistikk, jo bedre rangering.
Som navnet antyder, viser merket Mest brukte språk de vanligste språkene som brukes i hele GitHub. Det er en GitHub-beregning av hvilke språk som HTML, CSS, JavaScript, Python, Go, og flere har mest kode på GitHub. Språkene er oppført i synkende rekkefølge.
I slekt: Hvilket programmeringsspråk bør du lære?
For å legge til merket Mest brukte språk i depotet ditt, legg inn Markdown nedenfor i README.md-filen.
! [Statistikken til ditt depot] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)
Den eneste ulempen med dette merket er at det ikke viser Markdown som det mest brukte språket.
Contributors Badge viser alle operasjoner som tillegg, slettinger, og forplikter seg som er utført på arkivene dine. Når du slår sammen en pull-forespørsel i depotet ditt, legges personen som opprettet forespørselen til som en bidragsyter. Det er virkelig en god vane å kreditere bidragsyterne som har investert tiden sin i å gi en oppdatering til depotet ditt.
Contributors-merket kan genereres ved hjelp av contributors-img, et webapplikasjon som genererer et bilde for å vise listen over bidragsytere.
Å generere bidragsyterens image er ganske trivielt. Naviger til webområdet contributors-img og lim inn navnet på depotet ditt sammen med din brukernavn for å generere URL. Alternativt kan du bare legge inn Markdown-koden nedenfor for å få bildet.
! [GitHub Contributors Image] ( https://contrib.rocks/image? repo = Your_GitHub_Username / Your_GitHub_Repository_Name)
Den tilfeldige vitsegeneratoren vil generere en teknisk vits i form av spørsmål og svar. For eksempel, "Hva er et datavirus? Terminal sykdommen”.
For å bruke merket må du legge inn Markdown-koden i README.md-filen som vist nedenfor.
## 😂 Her er en tilfeldig vits som får deg til å le!
! [Vitsekort] ( https://readme-jokes.vercel.app/api)
Merket for profilvisningsteller viser antall ganger GitHub-profilen din har blitt sett i profilen din. For å generere dette merket, legg inn følgende Markdown-kode:
! [Profilvisning teller] ( https://komarev.com/ghpvc/?username=Your_GitHub_Username)
For å generere antall visninger av depotet, kan det være lurt å bruke HITS (Hvordan idioter sporer suksess) merke. Det er en enkel måte å se hvor mange som har besøkt din GitHub oppbevaringssted:
! [Treff] ( https://hitcounter.pythonanywhere.com/count/tag.svg? url = Paste_Your_GitHub_Repository_Link_Here)
Men ulempen med både Profile View-telleren og HITS er at de ikke viser antall visninger med unike ID-er. Hver gang du laster inn nettleseren / depotet på nytt, økes tellingen. Man kan enkelt få flere visninger ved å oppdatere siden.
Full implementering av GitHub-merker
Jeg har brukt GitHub-depotet mitt som et eksempel. For å generere merkene, anbefales det at du legger til disse kodene i den angitte README.md-filen. Hvis du ikke har en README.md-fil i GitHub-arkivet, er det beste alternativet å opprette en manuelt.
# Topp 5 merker som tar GitHub-arkivet til neste nivå
## 1. GitHub-statistikk
! [Statistikken til ditt depot] ( https://github-readme-stats.vercel.app/api? brukernavn = Tanu-N-Prabhu & show_icons = sant)
## 2. Mest brukte språk
! [Statistikken til ditt depot] ( https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green)
## 3. Bidragsgivermerke
! [Statistikken til ditt depot] ( https://contrib.rocks/image? repo = Tanu-N-Prabhu / Python)
## 4. Tilfeldig vitsgenerator
! [Vitsekort] ( https://readme-jokes.vercel.app/api)
## 5. Profilvisning Teller
! [Profilvisning teller] ( https://komarev.com/ghpvc/?username=Tanu-N-Prabhu)
### Repository View Counter - HITS
! [Treff] ( https://hitcounter.pythonanywhere.com/count/tag.svg? url = https://github.com/Tanu-N-Prabhu/Python)
Det er ikke behov for å kjøre eller kjøre ovennevnte merkodekodebit på README.md-filen. I det øyeblikket du lagrer filen med (.md) -utvidelse, vil GitHub automatisk gjengi utdataene, og endringene gjenspeiles direkte i depotet ditt.
Flere GitHub-merker tilgjengelig
Nå som du vet hvordan du legger til GitHub-merker i depotet ditt, er det et flott alternativ for utviklere og enkeltpersoner som kan bruke disse merkene for å øke lesbarheten til lagringsplassene sine. Det er ikke så vanskelig - alt du trenger å gjøre er å legge inn få linjer med Markdown-kode for å generere merkene.
Jo flere merker du tar med i depotet, jo mer oppmerksomhet får du. Et enkelt merke vil kunne gi nyttig informasjon når det gjelder statistikk, status og beregninger.
Vil du ta tak i programvaren på GitHub? Slik gjør du det østover med det strømlinjeformede GitHub Desktop-verktøyet.
- Programmering
- Markdown
- GitHub
Abonner på vårt nyhetsbrev
Bli med på nyhetsbrevet vårt for tekniske tips, anmeldelser, gratis e-bøker og eksklusive tilbud!
Ett steg til…!
Bekreft e-postadressen din i e-posten vi nettopp sendte deg.