Badge Generator (Shields-style na SVG)
Preview
SVG code
Markdown (shields.io)
Markdown (self-hosted na SVG)
I-download ang SVG sa itaas, i-commit ito sa iyong repository (halimbawa bilang badge.svg), at i-reference gamit ang relative path na ito para hindi umasa sa shields.io.
HTML
reStructuredText
AsciiDoc
Static na URL ng shields.io
Mga teknikal na detalye
Paano Gumagana ang Badge Generator
Ano ang Ginagawa ng Badge Generator
Gumagawa ang Badge Generator ng mga Shields-style na status badge bilang standalone na SVG file. Maglagay ng label at mensahe, pumili ng mga kulay (mga pangalang Shields tulad ng brightgreen, hex, o rgb) at isa sa limang estilo: flat, flat-square, plastic, for-the-badge, o social. Tinatantiya ang lapad ng text mula sa mga sukat ng Verdana para magkasya ang badge sa nilalaman nito, at lahat ay nire-render sa iyong browser. Makakakuha ka ng SVG code, download, katumbas na shields.io URL, at mga snippet na handang i-paste.
Karaniwang Gamit
Binubuod ng mga README badge ang build status, coverage, bersyon, lisensya, mga sinusuportahang platform, at sponsorship. Gamitin ang tool na ito kapag gusto mo ng custom na badge na hindi iniaalok ng shields.io, badge na dapat gumana offline o sa pribadong network, o static na SVG na naka-commit sa iyong repository para hindi masira ang dokumentasyon kapag down ang serbisyo ng third party. Ang mga preset para sa build passing, MIT license, version, coverage, at PRs welcome ay nagbibigay ng mabilis na simula.
Mga Output Format
Kasama sa output ang raw SVG, Markdown na may shields.io image URL, Markdown na tumuturo sa self-hosted na badge.svg, HTML img tag, reStructuredText image directive, at AsciiDoc image macro. Sinusunod ng static na URL ng shields.io ang dokumentadong mga panuntunan sa escaping: ang isang dash ay nagiging dalawang dash, ang isang underscore ay nagiging dalawang underscore, at ang mga espasyo ay nagiging underscore. Ang URL ay nabubuo lang bilang text at hindi kailanman hinihiling.
Karaniwang Pitfall at Edge Case
Ang mga kulay na hindi kilalang pangalan, hex value, o rgb() triplet ay binabalewala at ginagamit ang default, na pumipigil sa pag-inject ng markup sa SVG. Dapat na base64 SVG o PNG data URI ang mga logo at ie-embed bilang larawan, hindi kailanman bilang raw markup. Pagtatantya lang ang lapad ng badge, kaya ang napakaraming kakaibang font o non-Latin na text ay maaaring lumabas na bahagyang mas malapad kaysa sa kahon. Ang GitHub ay nagsisilbi ng mga SVG mula sa iyong repository na may mahigpit na content policy, kaya gamitin ang raw URL o ang shields.io variant kapag nag-e-embed sa labas ng repository.