Générateur de badges (SVG style Shields)
Aperçu
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.