I badge GitHub possono aumentare la leggibilità di un repository fornendo agli utenti un modo rapido per acquisire le metriche del repository. I badge possono essere incorporati nel tuo README.md per chiarire l'importanza e la necessità del tuo progetto ad altri sviluppatori. Di conseguenza, i lettori si fanno un'idea molto veloce del repository controllando i badge allegati.
Ci sono molti badge GitHub disponibili su Internet, ecco i primi cinque badge più informativi da includere nel tuo file README.md. Per ogni badge elencato viene fornito il codice Markdown equivalente.
Cosa possono fare i badge GitHub per te?
L'aggiunta di badge GitHub al tuo repository potrebbe sembrare banale, ma in realtà è incredibilmente utile. Tutto quello che devi fare è importare il codice Markdown dalla sorgente nel tuo file README.md.
Quando ho creato il mio repository GitHub di programmazione Python, ho omesso i badge. Il mio repository non abbellito aveva i contenuti giusti ma non risaltava. Per questo motivo, il repository ha guadagnato pochissimo traffico (visitatori unici).
Correlati: Come creare un repository GitHub
Dopo aver aggiunto più badge al mio repository, ho visto un aumento automatico mensile dei visitatori esterni (da 5 a 767) (visualizza i tuoi visitatori unici in Insights > Traffic sul tuo repository.)
La mia casella di posta era piena di commenti su quanto il mio repository si distinguesse dagli altri repository di programmazione Python --- tutto a causa dei badge. Un semplice badge GitHub può cambiare completamente l'aspetto del tuo repository.
Tienilo sempre a mente: un badge vale 1000 righe di codice.
Il badge GitHub Stats mostra le stelle totali, i commit, le richieste pull, i problemi e i contributi del tuo repository GitHub.
- Stelle : gli utenti salvano i repository GitHub (come i segnalibri). Ciò indica che l'utente è interessato e desidera rimanere aggiornato con il repository salvato. Tuttavia, un repository speciale non può essere modificato.
- Commit : il salvataggio di una modifica in un repository è indicato come Commit. Vari dettagli vengono aggiunti a un commit, contenuti, messaggio (descrizione), nome dell'autore e timestamp .
- Pull Request : una pull request informa gli altri sui miglioramenti che hai inviato a un repository GitHub diverso, ad eccezione del tuo. Ci riferiamo spesso a Pull Request come il cuore della collaborazione GitHub.
- Problemi : i problemi di GitHub vengono utilizzati per ottenere feedback dagli utenti, tenere traccia di idee, miglioramenti ed elencare i bug segnalati al repository.
- Contributo : GitHub Contributions indica il numero di contributi che sono stati fatti ad altri repository. Un contributo può essere effettuato con l'aiuto di una Pull Request.
Per aggiungere il badge GitHub Stats al tuo repository, incorpora il codice Markdown sottostante nel tuo file README.md.
![Your Repository's Stats](https://github-readme-stats.vercel.app/api?username=Your_GitHub_Username&show_icons=true)
Assicurati di modificare il valore username= con il nome utente di GitHub. Il badge GitHub Stats fornisce anche gradi come S+ (primo 1%), S (primo 25%), A++ (primo 45%), A+ (primo 60%) e B+ (tutti) . Più alte sono le tue statistiche, migliore è il tuo ranking.
Come suggerisce il nome, il badge Lingue più utilizzate mostra le lingue più comuni utilizzate in GitHub. È una metrica GitHub di cui linguaggi come HTML, CSS, JavaScript, Python, Go e altri hanno la maggior parte del codice su GitHub. Le lingue sono elencate in ordine decrescente.
Correlati: quale linguaggio di programmazione dovresti imparare?
Per aggiungere il badge Lingue più utilizzate al tuo repository, incorpora il Markdown di seguito nel tuo file README.md.
![Your Repository's Stats](https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)
L'unico inconveniente di questo badge è che non elencherà Markdown come la lingua più comunemente usata.
Il badge dei collaboratori mostra tutte le operazioni come aggiunte , eliminazioni e commit che sono state eseguite sui tuoi repository. Quando unisci una richiesta pull nel tuo repository, la persona che ha creato la richiesta verrà aggiunta come contributore. È davvero una buona abitudine dare credito ai contributori che hanno investito il loro tempo nel fornire un aggiornamento al tuo repository.
Il Badge Contributors può essere generato utilizzando contributors-img, un'applicazione web che genera un'immagine per visualizzare l'elenco dei contributori.
Generare l'immagine del contributore è piuttosto banale. Vai al sito web contributors-img e incolla il nome del tuo repository insieme al tuo nome utente per generare l'URL. In alternativa, incorpora semplicemente il codice Markdown indicato di seguito per ottenere l'immagine.
![GitHub Contributors Image](https://contrib.rocks/image?repo=Your_GitHub_Username/Your_GitHub_Repository_Name)
Il generatore di battute casuali genererà una battuta tecnica sotto forma di domande e risposte. Ad esempio, " Cos'è un virus informatico? La malattia terminale ”.
Per utilizzare il badge è necessario incorporare il codice Markdown nel file README.md come mostrato di seguito.
## 😂 Here is a random joke that'll make you laugh! ![Jokes Card](https://readme-jokes.vercel.app/api)
Il badge Profile View Counter mostra il numero di volte in cui il tuo profilo GitHub è stato visualizzato nel tuo profilo. Per generare questo badge, incorpora il seguente codice Markdown:
![Profile View Counter](https://komarev.com/ghpvc/?username=Your_GitHub_Username)
Per generare il conteggio delle visualizzazioni del tuo repository, potresti voler utilizzare il badge HITS ( How Idiots Track Success ). È un modo semplice per vedere quante persone hanno visitato il tuo repository GitHub :
![Hits](https://hitcounter.pythonanywhere.com/count/tag.svg?url = Paste_Your_GitHub_Repository_Link_Here)
Ma lo svantaggio sia del contatore della vista profilo che di HITS è che non visualizzano il conteggio delle visualizzazioni con ID univoci. Ogni volta che si ricarica il browser/repository, i conteggi vengono incrementati. Si potrebbero facilmente ottenere più visualizzazioni aggiornando la pagina.
Implementazione completa dei badge GitHub
Ho usato il mio repository GitHub come esempio. Per generare i badge, si consiglia di aggiungere questi codici al file README.md designato. Se non hai un file README.md nel tuo repository GitHub, crearne uno manualmente è l'opzione migliore.
# Top 5 Badges That Will Take Your GitHub Repository to the Next Level ## 1. GitHub Stats ![Your Repository's Stats](https://github-readme-stats.vercel.app/api?username=Tanu-N-Prabhu&show_icons=true) ## 2. Most Used Languages ![Your Repository's Stats](https://github-readme-stats.vercel.app/api/top-langs/?username=Tanu-N-Prabhu&theme=blue-green) ## 3. Contributors Badge ![Your Repository's Stats](https://contrib.rocks/image?repo=Tanu-N-Prabhu/Python) ## 4. Random Joke Generator ![Jokes Card](https://readme-jokes.vercel.app/api) ## 5. Profile View Counter ![Profile View Counter](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)
Non è necessario eseguire o eseguire lo snippet di codice markdown precedente sul file README.md. Nel momento in cui salvi il file con estensione (.md), GitHub renderà automaticamente l'output e le modifiche si rifletteranno direttamente sul tuo repository.
Altri badge GitHub disponibili
Ora che sai come aggiungere i badge GitHub al tuo repository, è un'ottima opzione per gli sviluppatori e le persone che possono utilizzare questi badge per aumentare la leggibilità dei loro repository. Non è così difficile: tutto ciò che devi fare è incorporare poche righe di codice Markdown per generare i badge.
Più badge includi nel tuo repository, più attenzione otterrai. Un singolo badge avrà la capacità di fornire informazioni utili in termini di statistiche, stato e metriche.