DevToys Web Pro iconDevToys Web ProBlog
Bewerten Sie uns:
Browser-Erweiterung ausprobieren:

Badge-Generator (SVG im Shields-Stil)

Vorlagen
Stil
Logo (SVG- oder PNG-Data-URI)

Vorschau

build: passing

SVG-Code

  • Markdown (shields.io)

  • Markdown (selbst gehostetes SVG)

  • Laden Sie das obige SVG herunter, committen Sie es in Ihr Repository (zum Beispiel als badge.svg) und verweisen Sie mit diesem relativen Pfad darauf, um nicht von shields.io abhängig zu sein.

    HTML

  • reStructuredText

  • AsciiDoc

  • Statische shields.io-URL

  • Technische Details

    So funktioniert der Badge-Generator

    Was der Badge-Generator macht

    Der Badge-Generator erstellt Status-Badges im Shields-Stil als eigenständige SVG-Dateien. Geben Sie eine Beschriftung und einen Text ein, wählen Sie Farben (Shields-Namen wie brightgreen, Hex- oder rgb-Werte) und einen von fünf Stilen: flat, flat-square, plastic, for-the-badge oder social. Die Textbreiten werden anhand der Verdana-Metriken näherungsweise berechnet, sodass das Badge zum Inhalt passt, und alles wird in Ihrem Browser gerendert. Sie erhalten den SVG-Code, einen Download, die entsprechende shields.io-URL und fertige Snippets zum Einfügen.

    Typische Anwendungsfälle

    README-Badges fassen Build-Status, Testabdeckung, Version, Lizenz, unterstützte Plattformen und Sponsoring zusammen. Nutzen Sie dieses Tool, wenn Sie ein individuelles Badge brauchen, das shields.io nicht anbietet, ein Badge, das offline oder in einem privaten Netzwerk funktionieren muss, oder ein statisches SVG im Repository, damit die Dokumentation nicht bricht, wenn ein Drittanbieter ausfällt. Vorlagen für Build passing, MIT-Lizenz, Version, Coverage und PRs welcome erleichtern den Einstieg.

    Ausgabeformate

    Die Ausgabe umfasst rohes SVG, Markdown mit einer shields.io-Bild-URL, Markdown mit Verweis auf ein selbst gehostetes badge.svg, ein HTML-img-Tag, eine reStructuredText-Image-Direktive und ein AsciiDoc-Image-Makro. Die statische shields.io-URL folgt den dokumentierten Escape-Regeln: Ein Bindestrich wird zu zwei Bindestrichen, ein Unterstrich zu zwei Unterstrichen und Leerzeichen werden zu Unterstrichen. Die URL wird nur als Text erzeugt und nie abgerufen.

    Häufige Fallstricke und Sonderfälle

    Farben, die kein bekannter Name, kein Hex-Wert und kein rgb()-Tripel sind, werden ignoriert und durch den Standard ersetzt; das verhindert das Einschleusen von Markup in das SVG. Logos müssen Base64-SVG- oder PNG-Data-URIs sein und werden als Bilder eingebettet, nie als rohes Markup. Die Badge-Breite ist eine Näherung, daher können sehr ungewöhnliche Schriften oder nicht-lateinische Texte etwas breiter als das Feld dargestellt werden. GitHub liefert SVGs aus Ihrem Repository mit einer restriktiven Content-Policy aus; verwenden Sie daher die Raw-URL oder die shields.io-Variante, wenn Sie das Badge außerhalb des Repositorys einbinden.