انتقل إلى المحتوى

Profile README

الـ profile README نص Markdown يظهر في أعلى صفحتك الشخصية على ليڤانت غيت (LevantGit)، أو في صفحة الـ organization، فيعرّف بك وبمشاريعك كل من يزور الصفحة. تنشئه بـ repository عام اسمه .profile تضع فيه ملف README.md. لا يحتاج أي أمر في الطرفية، وتنتهي منه في دقيقتين.

الفكرة

ليڤانت غيت يبحث عن repository اسمه بالضبط .profile في حسابك. إن وجد فيه ملف README.md عرض محتواه تلقائيًا في تبويب Overview في صفحتك الشخصية، فوق قائمة الـ repositories. الشيء نفسه ينطبق على الـ organizations: repository اسمه .profile داخل الـ organization يظهر في صفحتها.

الخطوات

  1. من الـ dashboard اضغط + ثم New Repository.
  2. في خانة الاسم اكتب .profile (بالنقطة في البداية). اجعله Public.
  3. فعّل خيار Initialize Repository ليُنشأ README.md فورًا، أو أنشئه بعد ذلك بزر New File.
  4. افتح README.md واكتب ما تريد بصيغة Markdown، ثم أنشئ commit بالتعديل.
  5. افتح صفحتك الشخصية https://levantgit.com/username؛ سترى المحتوى في قسم Overview.

لإنشاء profile README لـ organization افعل الشيء نفسه داخلها: أنشئ repository اسمه .profile فيها، وضع فيه README.md.

ملاحظة

يجب أن يكون الملف على الـ default branch للـ repository، وأن يكون اسمه README.md بالضبط.

إخفاء الـ profile README

إن جعلت repository الـ .profile Private اختفى المحتوى من صفحتك دون أن تحذف شيئًا. هذه أسهل طريقة لتعطيله مؤقتًا والعودة إليه لاحقًا. وحذف الـ repository أو حذف README.md يخفيه أيضًا.

ماذا تكتب فيه؟

هو ملف Markdown عادي، فكل ما تعرفه من الصياغة يعمل هنا: عناوين، قوائم، روابط، صور، badges. أفكار شائعة:

  • سطر أو سطران عن نفسك أو عن مهمة الـ organization.
  • روابط إلى مشاريعك الأهم على ليڤانت غيت وخارجه.
  • كيف يتواصل الناس معك أو يساهمون في مشاريعك.
  • badges تعرض حالة الـ workflows في الـ repositories إن كنت تستخدم Actions.

مثال بسيط:

# مرحبًا، أنا سامر

أطوّر أدوات مفتوحة المصدر للغة العربية.

- [المشروع الأول](https://levantgit.com/samer/arabic-tools)
- [المشروع الثاني](https://levantgit.com/samer/rtl-css)

للتواصل: افتح issue في أي repository من مشاريعي.

نصيحة

الصور التي تضعها في repository الـ .profile نفسه تظهر بروابط نسبية عادية مثل images/banner.png. انظر Markdown لتفاصيل حلّ الروابط.

ماذا بعد؟

  • Markdown: كل ما يدعمه ليڤانت غيت من صياغة وروابط وتعابير.
  • Badge: أضف badge تعرض حالة آخر workflow run.
  • إنشاء حساب: إن لم يكن عندك حساب بعد.

هذه الصفحة مبنية على وثائق Gitea (رخصة MIT) بعد ترجمتها وتبسيطها.