Softonic

مولّد ملف README للملف الشخصي على GitHub

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

إنشاء مستودع يتطابق اسمه مع اسم مستخدمك على GitHub يمنحك ملف README يظهر في أعلى صفحة ملفك الشخصي. يُنشئ هذا المولّد ملف Markdown نظيفًا لهذا المستودع، يتضمن عنوانًا رئيسيًا، ونبذة قصيرة، وقائمة بمجموعة تقنياتك، بالإضافة إلى بطاقات إحصائية اختيارية مُشغَّلة بأداة github-readme-stats.

كيفية إعداد ملف README الخاص بالملف الشخصي

  1. 1

    أدخل تفاصيلك

    عرض الاسم، الشعار، الموقع، وما تعمل عليه وما تتعلمه.

  2. 2

    أضف مجموعة التقنيات الخاصة بك

    قائمة مفصولة بفواصل، ويتم عرض كل عنصر على شكل رمز مكتوب بخط عريض.

  3. 3

    قم بتفعيل بطاقات الإحصائيات

    تُعرض بطاقتا إحصائيات GitHub وأبرز لغات البرمجة مباشرةً من مصدر github-readme-stats؛ بينما يضيف خيار النشاط رابطًا إلى مخطط مساهماتك.

  4. 4

    انسخ نص Markdown

    قم بإنشاء مستودع باسم اسم المستخدم الخاص بك، ثم قم بنشر ملف README.md في المجلد الجذري (root).

كيف يعمل “المستودع الخاص”

إذا كان اسم مستخدمك هو alex وأنشأت مستودعًا عامًا باسم alex، فإن GitHub سيعرض ملف README.md الخاص بهذا المستودع على صفحة ملفك الشخصي (أعلى قسم “المستودعات الشائعة”). إنها ميزة موثّقة رسميًا، وليست مجرد حيلة.

البطاقات التي يمكن للمولّد تضمينها

البطاقة رابط المصدر ملاحظات
إحصائيات GitHub github-readme-stats-one-bice.vercel.app/api?username=...&show_icons=true الالتزامات (commits)، طلبات السحب (PRs)، المشكلات (issues)
اللغات الرئيسية github-readme-stats-one-bice.vercel.app/api/top-langs/?username=... توزيع اللغات حسب حجم المستودع
نشاط المساهمات github.com/{username}?tab=overview رابط يظهر عند تفعيل خيار “السلسلة”

البطاقتان الإحصائيتان نقطتا نهاية بصيغة PNG؛ تُعرضان في أي عارض Markdown، حتى عندما يفتح أحدهم ملفك الشخصي دون تسجيل دخول، بينما يفتح رابط النشاط مخطط مساهماتك على GitHub.

محتوى يُقرأ جيدًا

  • عبارة ترويجية من سطر واحد: الدور + التركيز (“مهندس بنية تحتية متخصص في Rust، مهتم بالتتبّع”).
  • من 3 إلى 5 نقاط كحد أقصى فوق مجموعة التقنيات؛ فما زاد على ذلك يبدو وكأنه تفريغ لسيرة ذاتية (CV).
  • المهارات على شكل وسوم، وليست فقرة. فالقراء يبحثون عن التقنيات بسرعة.
  • روابط إلى المشاريع التي تديرها فعليًا. فالمستودعات المهجورة المثبّتة على الملف الشخصي أسوأ من عدم وجود أي روابط.
  • سطر التواصل: بريد إلكتروني أو حساب اجتماعي واحد؛ تجنّب ذكر ست شبكات.

ما لا ينبغي وضعه هناك

  • عناوين أو أرقام هواتف خاصة.
  • عبارات موجّهة للمسؤولين عن التوظيف (“مُتاح للعمل” مكانها LinkedIn أو خيار الشعار في GitHub).
  • رموز تعبيرية (Emojis) في كل سطر، واحد أو اثنان مقبولان، أما الإكثار منها فهو تشويش.

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

يتم استضافة ملف github-readme-stats على منصة Vercel، وقد تُطبَّق عليه أحيانًا قيود على عدد التحميلات أو يتم تخزين البيانات القديمة مؤقتًا. إذا تعطلت إحدى البطاقات، فانتظر بضع دقائق أو قم بتخزين المشروع بشكل مستقل؛ حيث يحتوي المستودع على زر نشر في Vercel بنقرة واحدة.

فقط عند التحقق من خدمة باستخدام رمز يحمل نطاق repo. بشكل افتراضي، تُحتسب الإحصائيات فقط للإيداعات العامة، وهو ما يُعد عادةً الخيار الصحيح في ملف شخصي عام.

نعم، يسمح GitHub باستخدام مجموعة محدودة من وسوم HTML داخل Markdown، وهي: <img>، <details>، <sub>، <sup>، بالإضافة إلى أنماط التصميم المباشر (inline) البسيطة. أما النصوص البرمجية (scripts) والنماذج فتُزال لأسباب أمنية.

لا. تُرسل القيم التي تكتبها إلى خادمنا لإنشاء المعاينة، وتُحمَل في رابط الصفحة بين الخطوات عند استخدام العرض متعدد الخطوات. لا يُخزَّن أي شيء في قاعدة بيانات، ويُتخلَّص من كل شيء عند إغلاق التبويب.

أدوات ذات صلة

مرجع جدول ASCII

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

مرجع أحرف HTML

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

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

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

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

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

مولد EditorConfig

أنشئ ملف .editorconfig بقواعد نمط المسافة البادئة وحجمها ونهاية السطر ومجموعة الأحرف والمسافات البيضاء، لتنسيق موحّد عبر بيئات التطوير المتكاملة (IDEs) والمحررات.

منسق HTML

نسّق HTML محلياً في المتصفح بمسافة بادئة من مسافتين أو أربع مسافات. لا يُرفع HTML ولا يُتحقق منه.

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