تنزيل shields - تنزيل رمز المصدر shields

shields

شفرة المصدر الأخرى

1.0.0

تنزيل

هذا هو موطن Shields.io ، وهي خدمة للشارات الموجزة والمتسقة والواقعية بتنسيق SVG و Raster ، والتي يمكن تضمينها بسهولة في Github readmes أو أي صفحة ويب أخرى. تدعم الخدمة العشرات من خدمات التكامل المستمر ، وسجلات الحزم ، والتوزيعات ، ومتاجر التطبيقات ، والشبكات الاجتماعية ، وخدمات تغطية الكود ، وخدمات تحليل الكود. كل شهر يخدم أكثر من 1.6 مليار صورة ويستخدمه بعض من أكثر المشاريع ذات المصدر المفتوح في العالم ، VS Code و Vue.js و Bootstrap على سبيل المثال لا الحصر.

مضيفي هذا الريبو:

الواجهة الأمامية shields.io ورمز الخادم
مكتبة NPM لتوليد شارات
- الوثائق
- Changelog
مواصفات تصميم الشارة

أمثلة

نسبة تغطية الكود:
إصدار إصدار مستقر:
إصدار مدير الحزمة:
حالة تبعيات الطرف الثالث:
درجة تحليل الكود الثابت:
مراقبة إصدار Semver:
مبلغ تبرعات Liberapay في الأسبوع:
تنزيلات حزمة بيثون:
تصنيف تمديد متجر Chrome Web:
نسبة الروبوت في وقت التشغيل:

اصنع شاراتك! (مثال سريع: https://img.shields.io/badge/left-right-f39f37 )

Quickstart

تصفح قائمة كاملة من الشارات وتحديد موقع شارة معينة باستخدام شريط البحث أو عن طريق تصفح الفئات. انقر على الشارة لملء عناصر البيانات المطلوبة لنوع الشارة هذا (مثل اسم المستخدم أو الريبو) والتخصيص اختياريًا (Label ، Colors وما إلى ذلك). وهو جاهز للاستخدام!

استخدم الزر الموجود في الأسفل لنسخ عنوان URL أو المقتطف الشارة ، والذي يمكن بعد ذلك إضافته إلى أماكن مثل ملفات GitHub readMe أو صفحات الويب الأخرى.

المساهمة

Shields هو مشروع مجتمعي. ندعو مشاركتك من خلال القضايا وسحب الطلبات! يمكنك الاطلاع على المبادئ التوجيهية المساهمة.

عند إضافة أو تغيير خدمة ، يرجى إضافة اختبارات.

هذا المشروع لديه تراكم للاقتراحات! إذا كنت جديدًا في المشروع ، فربما ترغب في فتح طلب سحب لمعالجة أحدهم.

يمكنك قراءة برنامج تعليمي حول كيفية إضافة شارة.

إذا كنت تنوي الإبلاغ أو المساهمة بإصلاح يتعلق بمواجهة الأمن ، فيرجى الرجوع أولاً إلى سياسة الأمان الخاصة بنا.

تطوير

تثبيت العقدة 20 أو الأحدث. يمكنك استخدام مدير الحزمة الذي تختاره. تحتاج الاختبارات إلى المرور في العقدة 20 و 22.
استنساخ هذا المستودع.
تشغيل npm ci لتثبيت التبعيات.
تشغيل npm start في بدء تشغيل خادم الشارة وخادم Dev Frontend.
افتح http://localhost:3000/ لعرض الواجهة الأمامية.

عندما تتغير ملفات مصدر الخادم ، يجب على خادم الشارة إعادة تشغيل نفسه تلقائيًا (باستخدام Nodemon). عندما تتغير ملفات الواجهة الأمامية ، يجب أيضًا إعادة تحميل خادم Dev Frontend ( docusaurus start ) تلقائيًا. ومع ذلك ، يتم تصميم تعريفات الشارة فقط قبل بدء الخادم لأول مرة. لتجديدها ، إما تشغيل npm run prestart أو إعادة تشغيل الخادم يدويًا.

لتصحيح شارة من سطر الأوامر ، قم npm run badge -- /npm/v/nock . كما أنه يعمل مع عناوين URL الكاملة مثل npm run badge -- https://img.shields.io/npm/v/nock .

استخدم npm run debug:server لبدء الخادم في وضع التصحيح. توضح هذه الوصفة كيفية تصحيح تطبيق Node.js في VS Code.

يتمتع Shields بدعم تجريبي لـ GITPOD ، وهي بيئة تطوير تم تكوينها مسبقًا تعمل في متصفحك. لاستخدام gitpod ، انقر فوق الزر أدناه وتسجيل الدخول مع Github. يقدم Gitpod أيضًا وظيفة إضافية للمتصفح ، على الرغم من أنها غير مطلوبة. يرجى الإبلاغ عن أي أخطاء أو أسئلة أو اقتراحات في العدد رقم 2772.

تضمن اختبارات اللقطات أننا لا نقوم عن غير قصد بإجراء تغييرات تؤثر على إخراج SVG أو JSON. عند تغيير الإخراج عمداً ، قم بتشغيل SNAPSHOT_DRY=1 npm run test:package لمعاينة التغييرات على اللقطات المحفوظة ، و SNAPSHOT_UPDATE=1 npm run test:package لتحديثها.

يمكن تكوين الخادم لاستخدام Sentry (التكوين) و Prometheus (التكوين).

يتم تشغيل مجموعة الاختبار الكاملة لدينا وكذلك تغطية الكود على أساس يومي.

استضافة الخادم الخاص بك

هناك وثائق حول استضافة الخادم الخاص بك.

المشاريع ذات الصلة

يتم استخدام شارات الحالة على نطاق واسع عبر مشاريع البرمجيات المفتوحة والمصدر. لقد درس الأكاديميون شارات "الإشارة" التي توفرها جودة مشروع البرمجيات. هناك العديد من المكتبات الحالية لتقديم هذه الشارات ، وبدائل لخدمة شارة Shields المستضافة. رهيبة badges هي مجموعة منسقة من هذه الموارد. يمكن اعتبار المساهمات هناك. (لا ينبغي تفسير وجود مشروع في هذه المجموعة على أنه تأييد ولا ترقية من مشروع Shields)

تاريخ

كان B.Adge.me الموقع الأصلي لهذه الخدمة. كان لدى Heroku في ذلك الوقت شيء جعل من الصعب استخدام مجال Toplevel معه ، ومن ثم المجال الفردي. استخدمت الكود الذي تم تطويره في عام 2013 من مكتبة تسمى GH-Badges ، وكلاهما تم تطويره بواسطة Thaddée Tyl. اندمج المشروع مع shields.io من خلال جعله يستخدم رمز B.Adge.me وأغلقت B.Adge.Me.

تم تطوير مواصفات الشارة الأصلية في عام 2013 من قبل أوليفييه لاكان. كانت مستوحاة من Travis CI والشارات المماثلة (كان هناك عدد أقل بكثير ، في ذلك الوقت). في عام 2014 ، أعيد تصميم Thaddée Tyl بمساعدة موظف Travis CI وأقنع الجميع بالتبديل إليه. التصميم القديم هو ما يسمى اليوم أسلوب البلاستيك. الجديد هو النمط المسطح.

يمكنك قراءة المزيد حول بداية المشروع ، ودوافع مواصفات شارة SVG ، والمواصفات نفسها.