Generator Badge (SVG gaya Shields)
Pratinjau
Kode SVG
Markdown (shields.io)
Markdown (SVG self-hosted)
Unduh SVG di atas, commit ke repositori Anda (misalnya sebagai badge.svg), lalu rujuk dengan path relatif ini agar tidak bergantung pada shields.io.
HTML
reStructuredText
AsciiDoc
URL statis shields.io
Detail teknis
Cara Kerja Generator Badge
Fungsi Generator Badge
Generator Badge membuat badge status gaya Shields sebagai berkas SVG mandiri. Masukkan label dan pesan, pilih warna (nama Shields seperti brightgreen, nilai hex, atau rgb) dan salah satu dari lima gaya: flat, flat-square, plastic, for-the-badge, atau social. Lebar teks diperkirakan dari metrik Verdana agar badge sesuai dengan isinya, dan semuanya dirender di browser Anda. Anda mendapatkan kode SVG, unduhan, URL shields.io yang setara, dan potongan kode siap tempel.
Kasus Penggunaan Umum
Badge README meringkas status build, cakupan, versi, lisensi, platform yang didukung, dan sponsor. Gunakan alat ini saat Anda menginginkan badge kustom yang tidak disediakan shields.io, badge yang harus berfungsi offline atau di jaringan privat, atau SVG statis yang di-commit ke repositori agar dokumentasi tidak pernah rusak saat layanan pihak ketiga down. Preset untuk build passing, lisensi MIT, versi, cakupan, dan PRs welcome memberi awal yang cepat.
Format Keluaran
Keluaran mencakup SVG mentah, Markdown dengan URL gambar shields.io, Markdown yang menunjuk ke badge.svg self-hosted, tag HTML img, direktif image reStructuredText, dan makro image AsciiDoc. URL statis shields.io mengikuti aturan escaping yang terdokumentasi: satu tanda hubung menjadi dua tanda hubung, satu garis bawah menjadi dua garis bawah, dan spasi menjadi garis bawah. URL hanya dibuat sebagai teks dan tidak pernah diminta.
Jebakan Umum dan Kasus Tepi
Warna yang bukan nama yang dikenali, nilai hex, atau triplet rgb() diabaikan dan warna default digunakan, yang mencegah injeksi markup ke dalam SVG. Logo harus berupa data URI base64 SVG atau PNG dan disematkan sebagai gambar, tidak pernah sebagai markup mentah. Lebar badge hanyalah perkiraan, sehingga font yang sangat tidak umum atau teks non-Latin dapat tampil sedikit lebih lebar dari kotaknya. GitHub menyajikan SVG dari repositori Anda dengan kebijakan konten yang ketat, jadi gunakan URL raw atau varian shields.io saat menyematkan di luar repositori.