Softonic

مولد شارات README

خطوة 1 / 2 Markdown
النتائج

اكتب تسمية ورسالة ولونًا، وسينشئ هذا المولد شارة shields.io ثابتة: تلك الكبسولة المسطحة الصغيرة التي تراها أسفل عنوان ملف README (build | passing، license | MIT، version | 1.4.0). يعرض معاينة حية ويمنحك كلًا من كود Markdown وكود HTML للصقهما. يُعد shields.io خدمة الشارات الفعلية للمشاريع مفتوحة المصدر؛ تنسيق العنوان بسيط لكنه مزعج للحفظ، لذا توفّر عليك واجهة رسومية صغيرة بضع دقائق عند إعداد مستودع جديد.

كيفية إنشاء شارة

  1. 1

    اكتب التسمية والرسالة

    التسمية هي النصف الأيسر (الرمادي)؛ والرسالة هي النصف الأيمن. اكتب ما تريد أن تعرضه الشارة: `build` / `passing`، `coverage` / `98%`، `license` / `MIT`.

  2. 2

    اختر لونًا

    لون مُسمّى (brightgreen، blue، red، orange) أو رمز سداسي عشري مثل `#ff0000`. يملأ النصف الأيمن من الشارة.

  3. 3

    صمّم أسلوبها

    اختر نمطًا (`flat`، `flat-square`، `for-the-badge`، `plastic`، `social`)، واختياريًا شعارًا عبر مُعرّف simple-icons الخاص به (github، npm، docker).

  4. 4

    انسخ كود Markdown أو HTML

    الصقه في ملف README الخاص بك. أضف رابط URL الاختياري لجعل الشارة قابلة للنقر. يعرض shields.io ملف SVG عند الطلب.

وصفات الشارات الشائعة

تنشئ هذه الأداة الصيغة الثابتة badge/label-message-color. أما الشارات التي تعرض بيانات حية (حالة البناء، الإصدار، التنزيلات) فانسخ أحد أنماط عناوين shields.io أدناه والصقه مباشرة في ملف README.

الغرض نمط عنوان shields.io
إصدار npm https://img.shields.io/npm/v/{package}
تنزيلات npm https://img.shields.io/npm/dm/{package}
نجوم GitHub https://img.shields.io/github/stars/{owner}/{repo}
آخر التزام على GitHub https://img.shields.io/github/last-commit/{owner}/{repo}
حالة سير عمل GitHub https://img.shields.io/github/actions/workflow/status/{owner}/{repo}/{workflow.yml}
الترخيص https://img.shields.io/github/license/{owner}/{repo}
إصدار PyPI https://img.shields.io/pypi/v/{package}
عمليات سحب Docker https://img.shields.io/docker/pulls/{org}/{image}
تغطية Codecov https://img.shields.io/codecov/c/github/{owner}/{repo}
تسمية ثابتة https://img.shields.io/badge/{label}-{message}-{color}

مقارنة أنماط الشارات

  • flat: مستطيلات كلاسيكية مستديرة الحواف. النمط الافتراضي.
  • flat-square: زوايا حادة، وأكثر حداثة قليلًا.
  • for-the-badge: أحرف كبيرة بارزة، لأقصى قدر من جذب الانتباه.
  • plastic: تدرّج لوني وظل غائر، على الطراز القديم.
  • social: زوايا مستديرة وألوان خافتة، تتماشى مع أزرار النجمة والتفريع في GitHub.

متى تستخدم الشارات

  • البناء + التغطية: يُوضّح للزوار أن المشروع مُصان فعليًا.
  • الإصدار + التنزيلات: يُخبرهم بأنه قيد الاستخدام.
  • الترخيص: إشارة قانونية لكل من يفكر في المساهمة أو الاستخدام.
  • رابط الوثائق: موقع وثائق خارجي أو rustdoc.rs.
  • الدردشة / الدعم: رابط Discord أو Matrix أو GitHub Discussions.

متى لا تستخدم الشارات

  • إحصاءات مظهرية لا تتحدّث أبدًا. شارة “النجوم” لمستودع لديه 0 نجمة تجعل المشروع يبدو ميتًا.
  • كل مقياس ممكن. خمس شارات تروي قصة؛ خمس عشرة شارة لا تروي شيئًا.
  • معلومات مكرّرة. الترخيص + “MIT” مرتين، أو الإصدار معروضًا كشارة وفي أول سطر من النص معًا.
  • شارات لخدمات لا تستخدمها. لا تُضِف Codecov إذا لم تكن قد أعددت تقارير التغطية؛ فالشارة المعطّلة أسوأ من غياب الشارة.

التخزين المؤقت والموثوقية

يُخزّن shields.io الطلبات مؤقتًا بقوة. الشارة التي تتحدّث ببطء تحتاج عادةً إلى إبطال التخزين المؤقت (بإضافة ?v=2) أو بضع دقائق فقط. وإذا تعطّل shields.io، يعرض GitHub كلمة “shields” دون رسم؛ أمر يستحق الذكر، لكنه يتعافى بسرعة.

الأسئلة الشائعة

لا. shields.io مجاني ويُموَّل عبر التبرعات. ويُطلب من المستخدمين ذوي الاستخدام الكثيف جدًا الاستضافة الذاتية أو دعم المشروع.

نعم. shields مفتوح المصدر؛ يمكنك تشغيله خلف نطاقك الخاص. لكن معظم المشاريع لا تحتاج إلى ذلك، فالخدمة المجانية موثوقة.

التخزين المؤقت. أضف ?cacheSeconds=60 أو ?v=anything لفرض التحديث. وتوقّع بضع دقائق حتى انتشار التغيير.

نعم، أضف ?logo=github (أو أي مُعرّف simple-icons). واستخدم ?logoColor=white لضبط لون الأيقونة.

لا. كل شيء يعمل داخل المتصفح، وتُولَّد العناوين من جانب العميل للنسخ.

أدوات ذات صلة

مرجع جدول ASCII

جدول ASCII كامل من 0 إلى 127 مع التمثيل العشري والست عشري والثماني والثنائي والمرجع الرقمي في HTML لكل محرف، بما في ذلك أكواد التحكم مثل NUL وLF وDEL.

مرجع أحرف HTML

قائمة قابلة للبحث بكيانات HTML، مع رموزها المسمّاة والرقمية، بالإضافة إلى خيار النسخ بنقرة واحدة للأحرف والرموز الخاصة.

مرجع اختصارات لوحة المفاتيح

ابحث في الاختصارات الافتراضية الموثقة لـ VS Code وChrome وBash مع GNU Readline على macOS وWindows وLinux.

مدقق البريد الإلكتروني

تحقق من عنوان بريد إلكتروني: فحص صياغة RFC 5322، واستعلام حي عن سجل MX، بالإضافة إلى تفاصيل الجزء المحلي والنطاق والطول. لا يتم إرسال أي بريد.

مولد EditorConfig

أنشئ ملف .editorconfig من قواعد المسافة البادئة ونهاية السطر ومجموعة الأحرف، ثم أضف قسمًا صحيحًا لكل لغة في مستودعك: Python وGo وYAML وMakefile وغيرها.

عدّاد FPS

قِس معدل الإطارات FPS في المتصفح عبر requestAnimationFrame: تنعيم، وأدنى وأقصى معدل إطارات، وحد تنبيه، ورسم بياني اختياري. يعمل محليًا بلا رفع ملفات وبلا API.

الأداة متاحة بلغات أخرى