DevToys Web Pro iconDevToys Web ProBlog
Valora'ns:
Prova l'extensió del navegador:

Generador d'insígnies (SVG estil Shields)

Predefinits
Estil
Logotip (URI de dades SVG o PNG)

Previsualització

build: passing

Codi SVG

  • Markdown (shields.io)

  • Markdown (SVG autoallotjat)

  • Baixa l'SVG de dalt, afegeix-lo al teu repositori (per exemple, com a badge.svg) i referencia'l amb aquesta ruta relativa per no dependre de shields.io.

    HTML

  • reStructuredText

  • AsciiDoc

  • URL estàtica de shields.io

  • Detalls tècnics

    Com funciona el generador d'insígnies

    Què fa el generador d'insígnies

    El generador d'insígnies crea insígnies d'estat estil shields com a fitxers SVG independents. Escriu una etiqueta i un missatge, tria colors (noms de shields com brightgreen, valors hex o rgb) i un de cinc estils: flat, flat-square, plastic, for-the-badge o social. L'amplada del text s'aproxima amb les mètriques de Verdana perquè la insígnia s'ajusti al contingut, i tot es renderitza al navegador. Obtens el codi SVG, una baixada, l'URL equivalent de shields.io i fragments llestos per enganxar.

    Casos d'ús habituals

    Les insígnies de README resumeixen l'estat de la compilació, la cobertura, la versió, la llicència, les plataformes compatibles i el patrocini. Fes servir aquesta eina quan vulguis una insígnia personalitzada que shields.io no ofereix, una insígnia que ha de funcionar sense connexió o en una xarxa privada, o un SVG estàtic inclòs al repositori perquè la documentació no es trenqui si un servei de tercers cau. Els predefinits de build passing, llicència MIT, versió, cobertura i PRs welcome faciliten l'inici.

    Formats de sortida

    La sortida inclou SVG sense processar, Markdown amb un URL d'imatge de shields.io, Markdown que apunta a un badge.svg autoallotjat, una etiqueta img d'HTML, una directiva image de reStructuredText i una macro image d'AsciiDoc. L'URL estàtic de shields.io segueix les regles d'escapament documentades: un guió passa a ser dos guions, un guió baix passa a ser dos guions baixos i els espais passen a ser guions baixos. L'URL només es genera com a text i mai no se sol·licita.

    Errors comuns i casos límit

    Els colors que no siguin un nom reconegut, un valor hex o una tripleta rgb() s'ignoren i s'utilitza el predeterminat, cosa que evita injectar marcatge a l'SVG. Els logotips han de ser URI de dades SVG o PNG en base64 i s'incrusten com a imatges, mai com a marcatge sense processar. L'amplada de la insígnia és una aproximació, de manera que tipus de lletra molt inusuals o text no llatí poden veure's una mica més amples que el requadre. GitHub serveix els SVG del teu repositori amb una política de contingut restrictiva, així que fes servir l'URL raw o la variant de shields.io en inserir-los fora del repositori.