Merkegenerator (SVG i Shields-stil)
Forhåndsvisning
SVG-kode
Markdown (shields.io)
Markdown (selvhostet SVG)
Last ned SVG-en ovenfor, commit den til repoet ditt (for eksempel som badge.svg) og referer til den med relativ sti for å slippe å være avhengig av shields.io.
HTML
reStructuredText
AsciiDoc
Statisk shields.io-URL
Tekniske detaljer
Slik fungerer merkegeneratoren
Hva merkegeneratoren gjør
Merkegeneratoren lager statusmerker i shields-stil som selvstendige SVG-filer. Skriv inn en etikett og en melding, velg farger (shields-navn som brightgreen, hex- eller rgb-verdier) og en av fem stiler: flat, flat-square, plastic, for-the-badge eller social. Tekstbredder estimeres ut fra Verdana-målinger slik at merket passer innholdet, og alt gjengis i nettleseren din. Du får SVG-koden, en nedlasting, tilsvarende shields.io-URL og ferdige kodebiter til å lime inn.
Vanlige bruksområder
README-merker oppsummerer byggestatus, dekning, versjon, lisens, støttede plattformer og sponsing. Bruk dette verktøyet når du vil ha et eget merke som shields.io ikke tilbyr, når merket må fungere frakoblet eller i et privat nettverk, eller når du committer en statisk SVG til repoet slik at dokumentasjonen aldri brytes av at en tredjepartstjeneste er nede. Forhåndsvalgene build passing, MIT license, version, coverage og PRs welcome gir deg en rask start.
Utdataformater
Utdataene inneholder rå SVG, Markdown med en shields.io-bilde-URL, Markdown som peker til en selvhostet badge.svg, en HTML img-tagg, et reStructuredText image-direktiv og en AsciiDoc image-makro. Den statiske shields.io-URL-en følger de dokumenterte escape-reglene: bindestrek blir to bindestreker, understrek blir to understreker og mellomrom blir understreker. URL-en genereres bare som tekst og blir aldri forespurt.
Vanlige fallgruver og spesialtilfeller
Farger som ikke er et gjenkjent navn, en hex-verdi eller en rgb()-trippel, ignoreres og standardfargen brukes, noe som hindrer at markup injiseres i SVG-en. Logoer må være base64 SVG- eller PNG-data-URI-er og bygges inn som bilder, aldri som rå markup. Merkebredden er en tilnærming, så svært uvanlige skrifttyper eller ikke-latinsk tekst kan gjengis litt bredere enn boksen. GitHub serverer SVG-er fra repoet ditt med en streng innholdspolicy, så bruk raw-URL-en eller shields.io-varianten når du bygger inn utenfor repoet.