GitHub-märken kan öka läsbarheten för ett arkiv genom att ge användarna ett snabbt sätt att fånga arkivets mätvärden. Märken kan bäddas in i din README.md för att förtydliga vikten och nödvändigheten av ditt projekt för andra utvecklare. Som ett resultat får läsarna en riktigt snabb uppfattning om förvaret genom att kontrollera de bifogade märkena.
Det finns många GitHub-märken tillgängliga på internet, här är de fem mest informativa märkena att inkludera i din README.md-fil. För varje listad märke tillhandahålls motsvarande Markdown-kod.
Vad kan GitHub-märken göra för dig?
Att lägga till GitHub-märken till ditt förråd kan verka trivialt, men i själva verket är det otroligt användbart. Allt du behöver göra är att importera Markdown-kod från källan till filen README.md.
När jag skapade mitt Python-programmering GitHub-förråd utelämnade jag märken. Mitt outsmyckade förråd hade rätt innehåll men stack inte ut. På grund av detta fick förvaret mycket lite trafik (unika besökare).
Efter att ha lagt till fler märken i mitt arkiv såg jag en automatisk ökning av antalet externa besökare (från 5 till 767) varje månad (visa dina unika besökare i Insikter > Trafik på ditt förråd.)
Min inkorg var fylld med kommentarer om hur väl mitt förråd skilde sig från andra Python-programmeringsförråd — allt på grund av märken. Ett enkelt GitHub-märke kan helt förändra utseendet på ditt förvar.
Ha alltid detta i åtanke: ett märke är värt 1000 rader kod.
GitHub Stats-märket visar det totala antalet stjärnor, åtaganden, dragförfrågningar, problem och bidrag från ditt GitHub-förråd.
- Stjärnor: Användare sparar GitHub-arkiv (som bokmärken). Detta indikerar att användaren är intresserad och vill hålla sig uppdaterad med det sparade arkivet. Ett stjärnmärkt arkiv kan dock inte redigeras. Begår: Att spara en ändring i ett arkiv kallas en Commit. Olika detaljer läggs till en commit, innehåll, meddelande (beskrivning), författarens namn och tidsstämpel. Dra förfrågan: En Pull Request informerar andra om förbättringar som du har skickat till ett annat GitHub-förråd, förutom ditt. Vi hänvisar ofta till Pull Request som hjärtat i GitHub Collaboration. frågor: GitHub-problem används för att få användarfeedback, spåra idéer, förbättringar och lista buggar som rapporterats till förvaret. Bidrag: GitHub-bidrag indikerar antalet bidrag som har gjorts till andra arkiv. Ett bidrag kan göras med hjälp av en Pull Request.
För att lägga till GitHub Stats-märket till ditt arkiv, bädda in nedanstående Markdown-kod i din README.md-fil.
Se till att du ändrar användarnamn= värde till din GitHubs användarnamn. GitHub Stats-märket ger också rangordningar som t.ex S+ (översta 1 %), S (översta 25 %), A++ (översta 45 %), A+ (översta 60 %) och B+ (alla). Ju högre statistik, desto bättre ranking.
Som namnet antyder visar märket Mest använda språk de vanligaste språken som används i hela GitHub. Det är ett GitHub-mått över vilka språk som t.ex HTML, CSS, JavaScript, Python, Go, och fler har mest kod på GitHub. Språken listas i fallande ordning.
För att lägga till märket Most Used Languages till ditt förråd, bädda in Markdown nedan i din README.md-fil.
Den enda nackdelen med detta märke är att det inte kommer att lista Markdown som det mest använda språket.
Medarbetarmärket visar alla operationer som t.ex tillägg, raderingar, och begår som har utförts på dina arkiv. När du slår samman en pull-begäran i ditt arkiv kommer personen som skapade begäran att läggas till som en bidragsgivare. Det är verkligen en god vana att kreditera bidragsgivarna som har investerat sin tid i att tillhandahålla en uppdatering av ditt förråd.
Contributors Badge kan skapas med hjälp av contributors-img, en webbapplikation som genererar en bild för att visa listan över bidragsgivare.
Att skapa bidragsgivarens bild är ganska trivialt. Navigera till webbplatsen för contributors-img och klistra in namnet på ditt förråd tillsammans med din Användarnamn för att generera URL:en. Alternativt kan du helt enkelt bädda in Markdown-koden nedan för att få bilden.
Den slumpmässiga skämtgeneratorn kommer att generera ett tekniskt skämt i form av frågor och svar. Till exempel, “Vad är ett datorvirus? Den terminala sjukdomen”.
För att använda märket måste du bädda in Markdown-koden i filen README.md som visas nedan.
## 😂 Here is a random joke that'll make you laugh!
Profile View Counter-märket visar hur många gånger din GitHub-profil har visats i din profil. För att generera detta märke, bädda in följande Markdown-kod:
För att generera visningsantalet för ditt arkiv, kanske du vill använda HITS (Hur idioter spårar framgång) bricka. Det är ett enkelt sätt att se hur många som har besökt din GitHub förråd:
Men nackdelen med både Profile View-räknaren och HITS är att de inte visar antalet visningar med unika ID:n. Varje gång du laddar om webbläsaren/förvaret kommer antalet att öka. Man kan enkelt få fler visningar genom att uppdatera sidan.
Fullständig implementering av GitHub-märken
Jag har använt mitt GitHub-förråd som ett exempel. För att generera märkena rekommenderas det att du lägger till dessa koder i din utsedda README.md-fil. Om du inte har en README.md-fil i ditt GitHub-förråd, är det bästa alternativet att manuellt skapa en.
# Top 5 Badges That Will Take Your GitHub Repository to the Next Level
## 1. GitHub Stats
## 2. Most Used Languages
## 3. Contributors Badge
## 4. Random Joke Generator
## 5. Profile View Counter
### Repository View Counter - HITS
Det finns inget behov av att köra eller köra kodavsnittet ovan på din README.md-fil. I samma ögonblick som du sparar filen med tillägget (.md), kommer GitHub automatiskt att rendera utdata och ändringarna kommer att återspeglas direkt på ditt arkiv.
Fler GitHub-märken tillgängliga
Nu när du vet hur du lägger till GitHub-märken till ditt förråd, är det ett bra alternativ för utvecklare och individer som kan använda dessa märken för att öka läsbarheten för sina förvar. Det är inte så svårt – allt du behöver göra är att bädda in några rader med Markdown-kod för att generera märkena.
Ju fler märken du inkluderar i ditt arkiv, desto mer uppmärksamhet får du. Ett enda märke kommer att ge användbar information när det gäller statistik, status och mätvärden.
Om författaren
Tanu Pradhu (1 artiklar publicerade)
Mer från Tanu Pradhu
Prenumerera på vårt nyhetsbrev
Gå med i vårt nyhetsbrev för tekniska tips, recensioner, free e-böcker och exklusiva erbjudanden!
Klicka här för att prenumerera
