GitHub Badges kann die Lesbarkeit eines Repositorys verbessern, indem es Benutzern eine schnelle Möglichkeit bietet, die Repository-Metriken zu erfassen. Badges können in Ihre README.md eingebettet werden, um anderen Entwicklern die Bedeutung und Notwendigkeit Ihres Projekts zu verdeutlichen. Als Ergebnis erhalten die Leser eine wirklich schnelle Vorstellung vom Repository, indem sie die beigefügten Badges überprüfen.
Es gibt viele GitHub-Abzeichen im Internet, hier sind die fünf informativsten Abzeichen, die Sie in Ihre README.md-Datei aufnehmen sollten. Für jedes aufgeführte Abzeichen wird der entsprechende Markdown-Code bereitgestellt.
Was können GitHub-Abzeichen für Sie tun?
Das Hinzufügen von GitHub-Badges zu Ihrem Repository mag trivial erscheinen, aber in Wirklichkeit ist es unglaublich nützlich. Sie müssen lediglich den Markdown-Code aus dem Quellcode in Ihre README.md-Datei importieren.
Als ich mein GitHub-Repository für die Python-Programmierung erstellt habe, habe ich Abzeichen weggelassen. Mein ungeschöntes Repository hatte den richtigen Inhalt, fiel aber nicht auf. Aus diesem Grund gewann das Repository sehr wenig Verkehr (einmalige Besucher).
Verwandte: So erstellen Sie ein GitHub-Repository
Nachdem ich meinem Repository weitere Badges hinzugefügt hatte, sah ich monatlich einen automatischen Anstieg der externen Besucher (von 5 auf 767) (sehen Sie sich Ihre einzelnen Besucher unter Insights > Traffic in Ihrem Repository an).
Mein Posteingang war voller Kommentare darüber, wie gut sich mein Repository von anderen Python-Programmier-Repositorys abhebt – alles wegen der Abzeichen. Ein einfaches GitHub-Badge kann das Aussehen Ihres Repositorys vollständig ändern.
Denken Sie immer daran: Ein Badge ist 1000 Zeilen Code wert.
Das GitHub-Stats-Badge zeigt die Gesamtzahl der Stars, Commits, Pull Requests, Issues und Contributions Ihres GitHub-Repositorys.
- Sterne : Benutzer speichern GitHub-Repositorys (wie Lesezeichen). Dies zeigt an, dass der Benutzer interessiert ist und mit dem gespeicherten Repository auf dem Laufenden bleiben möchte. Ein markiertes Repository kann jedoch nicht bearbeitet werden.
- Commits : Das Speichern einer Änderung in einem Repository wird als Commit bezeichnet. An Commit, Inhalt, Nachricht (Beschreibung), Autorname und Zeitstempel werden verschiedene Details angehängt .
- Pull Request : Ein Pull Request informiert andere über Verbesserungen, die Sie in ein anderes GitHub-Repository als Ihres übertragen haben. Wir bezeichnen Pull Request oft als das Herzstück der GitHub Collaboration.
- Probleme : GitHub-Probleme werden verwendet, um Benutzerfeedback zu erhalten, Ideen und Verbesserungen zu verfolgen und Fehler aufzulisten, die an das Repository gemeldet wurden.
- Beitrag : GitHub-Beiträge geben die Anzahl der Beiträge an, die zu anderen Repositories gemacht wurden. Mit Hilfe eines Pull Requests kann ein Beitrag geleistet werden.
Um das GitHub Stats-Badge zu Ihrem Repository hinzuzufügen, betten Sie den folgenden Markdown-Code in Ihre README.md-Datei ein.
![Your Repository's Stats](https://github-readme-stats.vercel.app/api?username=Your_GitHub_Username&show_icons=true)
Stellen Sie sicher, dass Sie den Wert username= in den Benutzernamen Ihres GitHubs ändern . Das GitHub Stats-Badge bietet auch Ränge wie S+ (Top 1%), S (Top 25%), A++ (Top 45%), A+ (Top 60%) und B+ (alle) . Je höher Ihre Statistiken, desto besser Ihr Ranking.
Wie der Name schon sagt, zeigt das Abzeichen für die am häufigsten verwendeten Sprachen die gängigsten Sprachen an, die in GitHub verwendet werden. Es ist eine GitHub-Metrik, von der Sprachen wie HTML, CSS, JavaScript, Python, Go und mehr den meisten Code auf GitHub haben. Die Sprachen sind in absteigender Reihenfolge aufgelistet.
Verwandte: Welche Programmiersprache sollten Sie lernen?
Um das Abzeichen für die am häufigsten verwendeten Sprachen zu Ihrem Repository hinzuzufügen, betten Sie den untenstehenden Markdown in Ihre README.md-Datei ein.
![Your Repository's Stats](https://github-readme-stats.vercel.app/api/top-langs/?username=Your_GitHub_Username&theme=blue-green)
Der einzige Nachteil dieses Abzeichens ist, dass Markdown nicht als die am häufigsten verwendete Sprache aufgeführt wird.
Das Contributors Badge zeigt alle Operationen wie Hinzufügen , Löschungen und Commits an , die an Ihren Repositorys durchgeführt wurden. Wenn Sie eine Pull-Anfrage mit Ihrem Repository zusammenführen, wird die Person, die die Anfrage erstellt hat, als Mitwirkender hinzugefügt. Es ist wirklich eine gute Angewohnheit, die Mitwirkenden zu erwähnen, die ihre Zeit in die Bereitstellung eines Updates für Ihr Repository investiert haben.
Das Contributors Badge kann mit contributors-img generiert werden, einer Webanwendung, die ein Bild generiert, um die Liste der Mitwirkenden anzuzeigen.
Das Bild des Mitwirkenden zu generieren ist ziemlich trivial. Navigieren Sie zur contributors-img-Website und fügen Sie den Namen Ihres Repositorys zusammen mit Ihrem Benutzernamen ein , um die URL zu generieren. Alternativ können Sie einfach den unten angegebenen Markdown-Code einbetten, um das Bild zu erhalten.
![GitHub Contributors Image](https://contrib.rocks/image?repo=Your_GitHub_Username/Your_GitHub_Repository_Name)
Der Zufallswitzgenerator generiert einen technischen Witz in Form von Fragen und Antworten. Zum Beispiel: „ Was ist ein Computervirus? Die unheilbare Krankheit “.
Um das Abzeichen zu verwenden, müssen Sie den Markdown-Code wie unten gezeigt in Ihre README.md-Datei einbetten.
## 😂 Here is a random joke that'll make you laugh! ![Jokes Card](https://readme-jokes.vercel.app/api)
Das Profilansichtszähler-Badge zeigt an, wie oft Ihr GitHub-Profil in Ihrem Profil aufgerufen wurde. Um dieses Abzeichen zu generieren, betten Sie den folgenden Markdown-Code ein:
![Profile View Counter](https://komarev.com/ghpvc/?username=Your_GitHub_Username)
Um die Anzahl der Aufrufe Ihres Repositorys zu generieren, können Sie das HITS- Badge ( How Idiots Track Success ) verwenden. So können Sie ganz einfach sehen, wie viele Personen Ihr GitHub- Repository besucht haben:
![Hits](https://hitcounter.pythonanywhere.com/count/tag.svg?url = Paste_Your_GitHub_Repository_Link_Here)
Der Nachteil sowohl des Profilansichtszählers als auch der HITS besteht jedoch darin, dass sie nicht die Anzahl der Ansichten mit eindeutigen IDs anzeigen. Jedes Mal, wenn Sie den Browser/das Repository neu laden, werden die Zählerstände erhöht. Man könnte leicht mehr Aufrufe erhalten, indem man die Seite aktualisiert.
Vollständige Implementierung von GitHub-Badges
Als Beispiel habe ich mein GitHub-Repository verwendet. Um die Badges zu generieren, wird empfohlen, diese Codes zu Ihrer angegebenen README.md-Datei hinzuzufügen. Wenn Sie in Ihrem GitHub-Repository keine README.md-Datei haben, ist die manuelle Erstellung die beste Option.
# 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)
Es ist nicht erforderlich, das obige Markdown-Code-Snippet in Ihrer README.md-Datei auszuführen oder auszuführen. Sobald Sie die Datei mit der Erweiterung (.md) speichern, rendert GitHub automatisch die Ausgabe und die Änderungen werden direkt in Ihrem Repository widergespiegelt.
Weitere GitHub-Abzeichen verfügbar
Nachdem Sie nun wissen, wie Sie Ihrem Repository GitHub-Badges hinzufügen, ist dies eine großartige Option für Entwickler und Einzelpersonen, die diese Badges verwenden können, um die Lesbarkeit ihrer Repositorys zu verbessern. Es ist nicht so schwierig – Sie müssen lediglich einige Zeilen Markdown-Code einbetten, um die Abzeichen zu generieren.
Je mehr Badges Sie in Ihr Repository aufnehmen, desto mehr Aufmerksamkeit erhalten Sie. Ein einzelnes Abzeichen bietet die Möglichkeit, nützliche Informationen in Bezug auf Statistiken, Status und Metriken bereitzustellen.