DevToys Web Pro iconDevToys Web ProBlogue
Avalie-nos:
Experimente a extensão do navegador:

Gerador de emblemas (SVG estilo Shields)

Predefinições
Estilo
Logótipo (SVG ou PNG data URI)

Pré-visualização

build: passing

Código SVG

  • Markdown (shields.io)

  • Markdown (SVG alojado por si)

  • Transfira 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 emblemas

    O que o gerador de emblemas faz

    O gerador de emblemas cria emblemas de status no estilo shields como ficheiros SVG independentes. Introduza um etiqueta 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 emblema se ajuste ao conteúdo, e tudo é renderizado no seu navegador. Obtém o código SVG, o transferência, a URL equivalente do shields.io e trechos prontos para colar.

    Casos de uso comuns

    Emblemas de README resumem status de build, cobertura, versão, licença, plataformas suportadas e patrocínio. Use esta ferramenta quando quiser um emblema personalizado que o shields.io não oferece, quando o emblema 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 alojado por si, 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. Logótipos devem ser data URIs base64 de SVG ou PNG e são incorporados como imagens, nunca como marcação bruta. A largura do emblema é 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.