Generator značaka (SVG u Shields stilu)
Pregled
SVG kôd
Markdown (shields.io)
Markdown (SVG na sopstvenom hostingu)
Preuzmite SVG iznad, komitujte ga u svoj repozitorijum (na primer kao badge.svg) i referišite ga ovom relativnom putanjom da ne biste zavisili od shields.io.
HTML
reStructuredText
AsciiDoc
Statički shields.io URL
Tehnički detalji
Kako radi generator značaka
Šta radi generator značaka
Generator značaka pravi statusne značke u shields stilu kao samostalne SVG datoteke. Unesite oznaku i poruku, izaberite boje (shields nazive kao što je brightgreen, hex ili rgb vrednosti) i jedan od pet stilova: flat, flat-square, plastic, for-the-badge ili social. Širine teksta se procenjuju prema Verdana metrici da bi značka odgovarala sadržaju, a sve se iscrtava u vašem pregledaču. Dobijate SVG kôd, preuzimanje, ekvivalentan shields.io URL i isečke spremne za lepljenje.
Uobičajene upotrebe
README značke sumiraju status izgradnje, pokrivenost, verziju, licencu, podržane platforme i sponzorstvo. Koristite alatku kada vam treba prilagođena značka koju shields.io ne nudi, značka koja mora da radi oflajn ili u privatnoj mreži, ili statički SVG komitovan u repozitorijum da se dokumentacija nikada ne pokvari kada usluga treće strane ne radi. Unapred podešene opcije za build passing, MIT licencu, verziju, pokrivenost i PRs welcome omogućavaju brz početak.
Izlazni formati
Izlaz obuhvata sirov SVG, Markdown sa shields.io URL-om slike, Markdown koji pokazuje na sopstveni badge.svg, HTML img oznaku, reStructuredText image direktivu i AsciiDoc image makro. Statički shields.io URL prati dokumentovana pravila escape-ovanja: jedna crtica postaje dve crtice, jedna donja crta postaje dve donje crte, a razmaci postaju donje crte. URL se generiše samo kao tekst i nikada se ne poziva.
Uobičajene zamke i granični slučajevi
Boje koje nisu prepoznati naziv, hex vrednost ili rgb() trojka ignorišu se i koristi se podrazumevana, što sprečava ubacivanje markupa u SVG. Logotipi moraju biti base64 SVG ili PNG data URI i ugrađuju se kao slike, nikada kao sirov markup. Širina značke je aproksimacija, pa veoma neobični fontovi ili nelatinični tekst mogu biti iscrtani malo šire od okvira. GitHub servira SVG-ove iz vašeg repozitorijuma sa restriktivnom politikom sadržaja, pa koristite raw URL ili shields.io varijantu kada ugrađujete van repozitorijuma.