Generador d'insígnies (SVG estil Shields)
Previsualització
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.