مولّد الشارات (SVG بأسلوب Shields)
معاينة
كود SVG
Markdown (shields.io)
Markdown (SVG مستضاف ذاتيًا)
نزّل ملف SVG أعلاه، وأضفه إلى مستودعك (مثلًا باسم badge.svg)، وأشر إليه بهذا المسار النسبي لتجنب الاعتماد على shields.io.
HTML
reStructuredText
AsciiDoc
رابط shields.io الثابت
التفاصيل التقنية
كيف يعمل مولّد الشارات
ماذا يفعل مولّد الشارات
ينشئ مولّد الشارات شارات حالة بأسلوب shields كملفات SVG مستقلة. أدخل تسمية ورسالة، واختر الألوان (أسماء shields مثل brightgreen أو قيم hex أو rgb) وأحد خمسة أنماط: flat أو flat-square أو plastic أو for-the-badge أو social. تُقدَّر عروض النص تقريبيًا اعتمادًا على مقاييس خط Verdana ليلائم الشارة محتواها، ويتم كل شيء داخل متصفحك. تحصل على كود SVG ورابط تنزيل ورابط shields.io المكافئ ومقتطفات جاهزة للصق.
حالات الاستخدام الشائعة
تلخّص شارات README حالة البناء والتغطية والإصدار والترخيص والمنصات المدعومة والرعاية. استخدم هذه الأداة عندما تريد شارة مخصصة لا يوفرها shields.io، أو شارة يجب أن تعمل دون اتصال أو في شبكة خاصة، أو ملف SVG ثابتًا مضافًا إلى مستودعك حتى لا تتعطل الوثائق عند توقف خدمة طرف ثالث. تمنحك الإعدادات المسبقة لـ build passing وترخيص MIT والإصدار وcoverage وPRs welcome بداية سريعة.
صيغ الإخراج
يشمل الإخراج SVG خامًا، وMarkdown برابط صورة من shields.io، وMarkdown يشير إلى badge.svg مستضاف ذاتيًا، ووسم HTML من نوع img، وتوجيه image في reStructuredText، وماكرو image في AsciiDoc. يتبع رابط shields.io الثابت قواعد الهروب الموثقة: تتحول الشرطة إلى شرطتين، والشرطة السفلية إلى شرطتين سفليتين، وتتحول المسافات إلى شرطات سفلية. يُنشأ الرابط كنص فقط ولا يُطلب أبدًا.
المزالق الشائعة والحالات الحدّية
الألوان التي ليست اسمًا معروفًا أو قيمة hex أو ثلاثية rgb() تُتجاهل ويُستخدم اللون الافتراضي، مما يمنع حقن الترميز داخل SVG. يجب أن تكون الشعارات data URI بترميز base64 بصيغة SVG أو PNG، وتُضمَّن كصور وليس كترميز خام أبدًا. عرض الشارة تقريبي، لذا قد تظهر الخطوط غير المعتادة جدًا أو النصوص غير اللاتينية أعرض قليلًا من الإطار. يقدّم GitHub ملفات SVG من مستودعك بسياسة محتوى مقيّدة، لذا استخدم الرابط الخام أو نسخة shields.io عند التضمين خارج المستودع.