DevToys Web Pro iconDevToys Web ProBlog
Valutaci:
Prova l'estensione del browser:

Generatore di badge (SVG in stile Shields)

Preset
Stile
Logo (data URI SVG o PNG)

Anteprima

build: passing

Codice SVG

  • Markdown (shields.io)

  • Markdown (SVG self-hosted)

  • Scarica l’SVG qui sopra, aggiungilo al tuo repository (ad esempio come badge.svg) e referenzialo con questo percorso relativo per non dipendere da shields.io.

    HTML

  • reStructuredText

  • AsciiDoc

  • URL statico shields.io

  • Dettagli tecnici

    Come funziona il generatore di badge

    Cosa fa il generatore di badge

    Il generatore di badge crea badge di stato in stile Shields come file SVG autonomi. Inserisci un’etichetta e un messaggio, scegli i colori (nomi Shields come brightgreen, valori hex o rgb) e uno dei cinque stili: flat, flat-square, plastic, for-the-badge o social. Le larghezze del testo sono approssimate dalle metriche di Verdana in modo che il badge si adatti al contenuto, e tutto viene generato nel browser. Ottieni il codice SVG, un download, l’URL shields.io equivalente e snippet pronti da incollare.

    Casi d’uso comuni

    I badge del README riassumono stato della build, copertura, versione, licenza, piattaforme supportate e sponsorizzazioni. Usa questo strumento quando vuoi un badge personalizzato che shields.io non offre, un badge che deve funzionare offline o in una rete privata, oppure un SVG statico nel repository perché la documentazione non si rompa mai quando un servizio di terze parti non è disponibile. I preset per build passing, licenza MIT, versione, copertura e PRs welcome permettono di partire subito.

    Formati di output

    L’output comprende SVG grezzo, Markdown con un URL immagine shields.io, Markdown che punta a un badge.svg self-hosted, un tag HTML img, una direttiva image di reStructuredText e una macro image di AsciiDoc. L’URL statico shields.io segue le regole di escaping documentate: un trattino diventa due trattini, un trattino basso diventa due trattini bassi e gli spazi diventano trattini bassi. L’URL viene solo generato come testo e non viene mai richiesto.

    Insidie e casi limite comuni

    I colori che non sono un nome riconosciuto, un valore hex o una terna rgb() vengono ignorati e si usa il valore predefinito, il che impedisce di iniettare markup nell’SVG. I loghi devono essere data URI base64 SVG o PNG e vengono incorporati come immagini, mai come markup grezzo. La larghezza del badge è un’approssimazione, quindi font molto insoliti o testo non latino possono risultare un po’ più larghi del riquadro. GitHub serve gli SVG del tuo repository con una content policy restrittiva, quindi usa l’URL raw o la variante shields.io quando li incorpori fuori dal repository.