Gerador de selos (SVG estilo Shields)
Pré-visualização
Código SVG
Markdown (shields.io)
Markdown (SVG hospedado por você)
Baixe o SVG acima, faça commit dele no seu repositório (por exemplo como badge.svg) e referencie esse caminho relativo para não depender do shields.io.
HTML
reStructuredText
AsciiDoc
URL estática do shields.io
Detalhes técnicos
Como funciona o gerador de selos
O que o gerador de selos faz
O gerador de selos cria selos de status no estilo shields como arquivos SVG independentes. Informe um rótulo e uma mensagem, escolha as cores (nomes do shields como brightgreen, valores hex ou rgb) e um dos cinco estilos: flat, flat-square, plastic, for-the-badge ou social. As larguras do texto são aproximadas com métricas da Verdana para que o selo se ajuste ao conteúdo, e tudo é renderizado no seu navegador. Você recebe o código SVG, o download, a URL equivalente do shields.io e trechos prontos para colar.
Casos de uso comuns
Selos de README resumem status de build, cobertura, versão, licença, plataformas suportadas e patrocínio. Use esta ferramenta quando quiser um selo personalizado que o shields.io não oferece, quando o selo precisar funcionar offline ou em rede privada, ou quando um SVG estático for commitado no repositório para que a documentação nunca quebre por causa de um serviço de terceiros fora do ar. As predefinições build passing, MIT license, version, coverage e PRs welcome dão um começo rápido.
Formatos de saída
A saída inclui SVG bruto, Markdown com a URL de imagem do shields.io, Markdown apontando para um badge.svg hospedado por você, a tag HTML img, a diretiva image do reStructuredText e a macro image do AsciiDoc. A URL estática do shields.io segue as regras de escape documentadas: hífen vira dois hífens, sublinhado vira dois sublinhados e espaços viram sublinhados. A URL é apenas gerada como texto e nunca é requisitada.
Armadilhas comuns e casos extremos
Cores que não são um nome reconhecido, um valor hex ou uma tripla rgb() são ignoradas e a cor padrão é usada, o que impede a injeção de marcação no SVG. Logotipos devem ser data URIs base64 de SVG ou PNG e são incorporados como imagens, nunca como marcação bruta. A largura do selo é uma aproximação, então fontes muito incomuns ou texto não latino podem aparecer um pouco mais largos que a caixa. O GitHub serve SVGs do seu repositório com uma política de conteúdo restritiva, então use a URL raw ou a variante do shields.io ao incorporar fora do repositório.