Ženkliukų generatorius (Shields stiliaus SVG)
Peržiūra
SVG kodas
Markdown (shields.io)
Markdown (savarankiškai talpinamas SVG)
Atsisiųskite aukščiau esantį SVG, įtraukite jį į savo saugyklą (pavyzdžiui, kaip badge.svg) ir nurodykite santykinį kelią, kad nepriklausytumėte nuo shields.io.
HTML
reStructuredText
AsciiDoc
shields.io statinis URL
Techninė informacija
Kaip veikia ženkliukų generatorius
Ką daro ženkliukų generatorius
Ženkliukų generatorius sukuria shields stiliaus būsenos ženkliukus kaip atskirus SVG failus. Įveskite etiketę ir pranešimą, pasirinkite spalvas (shields pavadinimus, pvz., brightgreen, hex ar rgb reikšmes) ir vieną iš penkių stilių: flat, flat-square, plastic, for-the-badge arba social. Teksto pločiai apskaičiuojami pagal Verdana metrikas, kad ženkliukas tiktų turiniui, o viskas atvaizduojama jūsų naršyklėje. Gaunate SVG kodą, atsisiuntimą, atitinkamą shields.io URL ir paruoštus įklijuoti fragmentus.
Dažniausi naudojimo atvejai
README ženkliukai apibendrina kūrimo būseną, aprėptį, versiją, licenciją, palaikomas platformas ir rėmimą. Naudokite šį įrankį, kai reikia pasirinktinio ženkliuko, kurio shields.io nesiūlo, kai ženkliukas turi veikti neprisijungus ar privačiame tinkle arba kai SVG įtraukiamas į saugyklą, kad dokumentacija niekada nesugestų dėl trečiosios šalies paslaugos gedimo. Šablonai build passing, MIT license, version, coverage ir PRs welcome padeda greitai pradėti.
Išvesties formatai
Išvestis apima neapdorotą SVG, Markdown su shields.io vaizdo URL, Markdown, nurodantį savarankiškai talpinamą badge.svg, HTML img žymę, reStructuredText image direktyvą ir AsciiDoc image makrokomandą. Shields.io statinis URL laikosi dokumentuotų ekranavimo taisyklių: brūkšnys tampa dviem brūkšniais, pabraukimas – dviem pabraukimais, o tarpai – pabraukimais. URL tik sugeneruojamas kaip tekstas ir niekada nėra užklausiamas.
Dažniausios klaidos ir ribiniai atvejai
Spalvos, kurios nėra atpažįstamas pavadinimas, hex reikšmė ar rgb() trejetas, ignoruojamos ir naudojama numatytoji, o tai neleidžia įterpti žymėjimo į SVG. Logotipai turi būti base64 SVG arba PNG data URI ir įterpiami kaip vaizdai, niekada kaip neapdorotas žymėjimas. Ženkliuko plotis yra apytikslis, todėl labai neįprasti šriftai ar ne lotyniškas tekstas gali būti šiek tiek platesni už langelį. GitHub pateikia SVG iš jūsų saugyklos su griežta turinio politika, todėl įterpdami už saugyklos ribų naudokite raw URL arba shields.io variantą.