shields
1.0.0
Ini adalah rumah bagi Shields.io, layanan untuk lencana yang ringkas, konsisten, dan dapat dibaca dalam format SVG dan raster, yang dapat dengan mudah dimasukkan dalam readmes GitHub atau halaman web lainnya. Layanan ini mendukung lusinan layanan integrasi berkelanjutan, pendaftar paket, distribusi, toko aplikasi, jejaring sosial, layanan cakupan kode, dan layanan analisis kode. Setiap bulan melayani lebih dari 1,6 miliar gambar dan digunakan oleh beberapa proyek open-source paling populer di dunia, VS Code, Vue.js dan Bootstrap untuk beberapa nama.
Repo ini menjadi tuan rumah:
Buat lencana Anda sendiri! (Contoh cepat: https://img.shields.io/badge/left-right-f39f37 )
Telusuri daftar lengkap lencana dan temukan lencana tertentu dengan menggunakan bilah pencarian atau dengan menjelajahi kategori. Klik lencana untuk mengisi elemen data yang diperlukan untuk jenis lencana itu (seperti nama pengguna atau repo Anda) dan secara opsional menyesuaikan (label, warna dll.). Dan itu siap digunakan!
Gunakan tombol di bagian bawah untuk menyalin URL atau cuplikan lencana Anda, yang kemudian dapat ditambahkan ke tempat -tempat seperti file readme github Anda atau halaman web lainnya.
Shields adalah proyek komunitas. Kami mengundang partisipasi Anda melalui masalah dan menarik permintaan! Anda dapat membaca dengan teliti pedoman yang berkontribusi.
Saat menambahkan atau mengubah layanan, silakan tambahkan tes.
Proyek ini memiliki banyak saran! Jika Anda baru mengenal proyek ini, mungkin Anda ingin membuka permintaan tarik untuk mengatasinya.
Anda dapat membaca tutorial tentang cara menambahkan lencana.
Jika Anda bermaksud melaporkan atau menyumbangkan perbaikan yang terkait dengan kerentanan keamanan, silakan lihat kebijakan keamanan kami terlebih dahulu.
npm ci untuk menginstal dependensi.npm start untuk memulai server lencana dan server Frontend Dev.http://localhost:3000/ untuk melihat frontend. Ketika file sumber server berubah, server lencana harus secara otomatis memulai kembali dirinya sendiri (menggunakan Nodemon). Ketika file frontend berubah, Frontend Dev Server ( docusaurus start ) juga harus secara otomatis memuat ulang. Namun definisi lencana dibangun hanya sebelum server pertama kali dimulai. Untuk meregenerasi itu, jalankan npm run prestart atau restart secara manual server.
Untuk men -debug lencana dari baris perintah, jalankan npm run badge -- /npm/v/nock . Ini juga berfungsi dengan URL lengkap seperti npm run badge -- https://img.shields.io/npm/v/nock .
Gunakan npm run debug:server untuk memulai server dalam mode debug. Resep ini menunjukkan cara men -debug aplikasi Node.js di VS Code.
Shields memiliki dukungan eksperimental untuk GITPOD, lingkungan pengembangan yang telah dikonfigurasi sebelumnya yang berjalan di browser Anda. Untuk menggunakan GitPod, klik tombol di bawah ini dan masuk dengan GitHub. GitPod juga menawarkan add-on browser, meskipun tidak diperlukan. Harap laporkan bug, pertanyaan, atau saran gitpod apa pun dalam edisi #2772.
Tes snapshot memastikan kami tidak secara tidak sengaja membuat perubahan yang mempengaruhi output SVG atau JSON. Saat dengan sengaja mengubah output, jalankan SNAPSHOT_DRY=1 npm run test:package untuk Pratinjau Perubahan ke Snapshot yang Disimpan, dan SNAPSHOT_UPDATE=1 npm run test:package untuk memperbaruinya.
Server dapat dikonfigurasi untuk menggunakan Sentry (konfigurasi) dan Prometheus (konfigurasi).
Suite tes lengkap kami serta cakupan kode dijalankan setiap hari.
Ada dokumentasi tentang hosting server Anda sendiri.
Lencana status digunakan secara luas di seluruh proyek perangkat lunak open-source dan swasta. Akademisi telah mempelajari lencana "sinyal" yang menyediakan tentang kualitas proyek perangkat lunak. Ada banyak perpustakaan yang ada untuk membuat lencana ini, dan alternatif untuk layanan lencana Shields Hosted. Awesome-Badges adalah kumpulan sumber daya yang dikuratori tersebut. Kontribusi dapat dipertimbangkan di sana. (Kehadiran proyek dalam koleksi itu tidak boleh ditafsirkan sebagai dukungan atau promosi dari proyek Shields)
B.Adge.Me adalah situs web asli untuk layanan ini. Heroku saat itu memiliki sesuatu yang membuatnya sulit untuk menggunakan domain Toplevel dengan itu, karenanya domain aneh. Ini menggunakan kode yang dikembangkan pada 2013 dari perpustakaan yang disebut GH-Badges, keduanya dikembangkan oleh Thaddée Tyl. Proyek ini bergabung dengan Shields.io dengan membuatnya menggunakan kode B.Adge.Me dan ditutup B.Adge.Me.
Spesifikasi lencana asli dikembangkan pada 2013 oleh Olivier Lacan. Itu terinspirasi oleh Travis CI dan lencana serupa (ada lebih sedikit, saat itu). Pada tahun 2014 Thaddée Tyl mendesain ulang dengan bantuan dari karyawan Travis CI dan meyakinkan semua orang untuk beralih ke sana. Desain lama adalah apa yang sekarang disebut gaya plastik; Yang baru adalah gaya datar.
Anda dapat membaca lebih lanjut tentang awal proyek, motivasi spesifikasi lencana SVG, dan spesifikasi itu sendiri.
Pemelihara:
Alumni:
Semua aset dan kode berada di bawah lisensi CC0 dan di domain publik kecuali ditentukan sebaliknya.
Terima kasih kepada orang -orang dan perusahaan yang menyumbangkan uang, layanan, atau waktu untuk menjaga proyek tetap berjalan. https://shields.io/Community
