DevToys Web Pro iconDevToys Web ProBlog
Évaluez-nous :
Essayez l’extension de navigateur :

Générateur de badges (SVG style Shields)

Préréglages
Style
Logo (URI de données SVG ou PNG)

Aperçu

build: passing

Code SVG

  • Markdown (shields.io)

  • Markdown (SVG auto-hébergé)

  • Téléchargez le SVG ci-dessus, validez-le dans votre dépôt (par exemple sous le nom badge.svg) et référencez-le avec ce chemin relatif pour ne pas dépendre de shields.io.

    HTML

  • reStructuredText

  • AsciiDoc

  • URL statique shields.io

  • Détails techniques

    Comment fonctionne le générateur de badges

    Ce que fait le générateur de badges

    Le générateur de badges crée des badges d’état de style Shields sous forme de fichiers SVG autonomes. Saisissez un libellé et un message, choisissez des couleurs (noms Shields comme brightgreen, valeurs hex ou rgb) et l’un des cinq styles : flat, flat-square, plastic, for-the-badge ou social. La largeur du texte est approximée à partir des métriques de Verdana pour que le badge s’adapte à son contenu, et tout est rendu dans votre navigateur. Vous obtenez le code SVG, un téléchargement, l’URL shields.io équivalente et des extraits prêts à coller.

    Cas d’usage courants

    Les badges de README résument l’état du build, la couverture, la version, la licence, les plateformes prises en charge et le sponsoring. Utilisez cet outil quand vous voulez un badge personnalisé que shields.io ne propose pas, un badge qui doit fonctionner hors ligne ou dans un réseau privé, ou un SVG statique versionné dans votre dépôt afin que la documentation ne casse jamais quand un service tiers est indisponible. Des préréglages pour build passing, licence MIT, version, couverture et PRs welcome offrent un départ rapide.

    Formats de sortie

    La sortie comprend le SVG brut, du Markdown avec une URL d’image shields.io, du Markdown pointant vers un badge.svg auto-hébergé, une balise HTML img, une directive image reStructuredText et une macro image AsciiDoc. L’URL statique shields.io suit les règles d’échappement documentées : un tiret devient deux tirets, un tiret bas devient deux tirets bas et les espaces deviennent des tirets bas. L’URL est seulement générée sous forme de texte et n’est jamais requêtée.

    Pièges et cas limites courants

    Les couleurs qui ne sont ni un nom reconnu, ni une valeur hex, ni un triplet rgb() sont ignorées et la valeur par défaut est utilisée, ce qui empêche l’injection de balisage dans le SVG. Les logos doivent être des URI de données SVG ou PNG en base64 et sont intégrés comme images, jamais comme balisage brut. La largeur du badge est une approximation : des polices très inhabituelles ou du texte non latin peuvent s’afficher légèrement plus large que le cadre. GitHub sert les SVG de votre dépôt avec une politique de contenu restrictive ; utilisez donc l’URL brute ou la variante shields.io pour l’intégrer en dehors du dépôt.