Märkesgenerator (Shields-liknande SVG)
Förhandsvisning
SVG-kod
Markdown (shields.io)
Markdown (egenhostad SVG)
Ladda ned SVG:n ovan, checka in den i ditt repo (till exempel som badge.svg) och referera till den med den här relativa sökvägen för att slippa bero på shields.io.
HTML
reStructuredText
AsciiDoc
Statisk shields.io-URL
Tekniska detaljer
Så fungerar märkesgeneratorn
Vad märkesgeneratorn gör
Märkesgeneratorn skapar statusmärken i shields-stil som fristående SVG-filer. Ange en etikett och ett meddelande, välj färger (shields-namn som brightgreen, hex- eller rgb-värden) och en av fem stilar: flat, flat-square, plastic, for-the-badge eller social. Textbredder uppskattas utifrån Verdana-mått så att märket passar sitt innehåll, och allt renderas i webbläsaren. Du får SVG-koden, en nedladdning, motsvarande shields.io-URL och färdiga kodsnuttar att klistra in.
Vanliga användningsområden
README-märken sammanfattar bygg-status, täckning, version, licens, plattformar som stöds och sponsring. Använd verktyget när du vill ha ett eget märke som shields.io inte erbjuder, ett märke som måste fungera offline eller i ett privat nätverk, eller en statisk SVG incheckad i ditt repo så att dokumentationen aldrig går sönder när en tredjepartstjänst ligger nere. Förval för bygget lyckades, MIT-licens, version, täckning och PRs welcome ger en snabb start.
Utdataformat
Utdata omfattar rå SVG, Markdown med en shields.io-bild-URL, Markdown som pekar på en egenhostad badge.svg, en HTML img-tagg, ett reStructuredText image-direktiv och ett AsciiDoc image-makro. Den statiska shields.io-URL:en följer de dokumenterade escape-reglerna: ett bindestreck blir två bindestreck, ett understreck blir två understreck och mellanslag blir understreck. URL:en genereras bara som text och anropas aldrig.
Vanliga fallgropar och specialfall
Färger som inte är ett känt namn, ett hex-värde eller en rgb()-tripplett ignoreras och standardfärgen används, vilket förhindrar att kod injiceras i SVG:n. Logotyper måste vara base64-kodade SVG- eller PNG-data-URI:er och bäddas in som bilder, aldrig som rå kod. Märkets bredd är en uppskattning, så mycket ovanliga typsnitt eller icke-latinsk text kan renderas något bredare än rutan. GitHub levererar SVG:er från ditt repo med en restriktiv innehållspolicy, så använd raw-URL:en eller shields.io-varianten när du bäddar in utanför repot.