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

أول repository

لرفع مشروعك على ليڤانت غيت (LevantGit) أنشئ repository جديدًا من زر New Repository، ثم اختر مسارًا: نفّذ له clone واعمل داخل المجلد الناتج، أو ادخل مجلد مشروعك الموجود ونفّذ git init ثم add ثم commit ثم git remote add origin وأخيرًا push. هذه الصفحة تشرح المسارين، ثم صفحة الـ repository والتعديل من المتصفّح.

يُفترض أنك ثبّت Git، وأنشأت حسابًا، وأضفت SSH key.

الخطوة ١: أنشئ الـ repository على الموقع

  1. سجّل الدخول، واضغط زر + في أعلى الصفحة ثم New Repository.
  2. املأ النموذج:
الحقل ماذا تختار
Owner اسم مستخدمك، أو organization إن كنت عضوًا في واحدة
Repository Name حروف لاتينية وأرقام و-، مثل my-first-repo. سيصبح جزءًا من العنوان
Visibility Private إن أردت ألا يراه أحد غيرك، أو اتركه Public ليراه الجميع
Description سطر يشرح المشروع، اختياري
Initialize Repository فعّل Add README ليولد الموقع أول commit ويصبح الـ repository جاهزًا
.gitignore اختر لغة مشروعك (مثل Python أو Node) ليتجاهل Git الملفات المؤقتة تلقائيًا
License اختر رخصة إن كان المشروع عامًا ومفتوحًا؛ MIT خيار شائع وبسيط
Default Branch اتركه main
  1. اضغط Create Repository.

ملاحظة

إن كنت تملك مجلدًا على جهازك فيه ملفات جاهزة وتريد رفعه، لا تفعّل خيار التهيئة (README و.gitignore والرخصة). أنشئ repository فارغًا ثم اتبع المسار «ب» أدناه.

الخطوة ٢: اربط الـ repository بجهازك

أمامك مساران؛ اختر واحدًا:

أنشأت الـ repository مع README وتريد نسخة منه على جهازك لتعمل فيها. تنزيل هذه النسخة اسمه clone.

  1. في صفحة الـ repository اضغط زر Code (أو انظر إلى حقل العنوان أعلى قائمة الملفات)، واختر SSH وانسخ العنوان. شكله: [email protected]:username/my-first-repo.git.
  2. في الطرفية انتقل إلى المجلد الذي تريد وضع المشروع فيه، ثم:
git clone [email protected]:username/my-first-repo.git
cd my-first-repo

سيظهر مجلد جديد باسم الـ repository وفيه README.md. هذا المجلد هو نسختك المحلية، مرتبط تلقائيًا بنسخة الموقع — أي بالـ remote — تحت الاسم origin.

جرّب تعديلًا: افتح README.md وأضف سطرًا، ثم:

git add README.md
git commit -m "تحديث README"
git push

حدّث صفحة الـ repository في المتصفّح؛ سترى التعديل.

لديك مجلد مشروع جاهز (كود، ملفات، أي شيء) وتريد رفعه إلى الـ repository الفارغ الذي أنشأته.

في الطرفية ادخل إلى المجلد ثم نفّذ الأوامر بالترتيب:

cd path/to/my-project

git init                     # حوّل المجلد إلى repository
git add .                    # جهّز كل الملفات للـ commit
git commit -m "أول commit"  # أنشئ أول commit
git remote add origin [email protected]:username/my-first-repo.git
git push -u origin main      # نفّذ push إلى ليڤانت غيت

ماذا فعلت كل خطوة؟

  • git init ينشئ مجلد .git المخفي، فيصبح المجلد repository يتتبّعه Git.
  • git add . يضع كل الملفات في الـ staging area، وهي الطاولة التي تجمع عليها ما تريد حفظه. النقطة تعني «كل شيء هنا».
  • git commit يصنع أول commit، ورسالته هي ما كتبته بعد -m.
  • git remote add origin ... يخبر Git بعنوان النسخة على الموقع ويسمّي هذا الـ remote origin.
  • git push -u origin main يرسل الـ branch المسمّى main إلى origin. الخيار -u يحفظ الارتباط، فتكتفي لاحقًا بـ git push وحدها.

تنبيه

إن ظهر خطأ يقول إن الـ branch المحلي اسمه master لا main، فأعد تسميته قبل الـ push: git branch -M main. ولضبط ذلك نهائيًا راجع تثبيت Git.

حدّث صفحة الـ repository في المتصفّح؛ ستجد ملفاتك كلها.

الخطوة ٣: افهم صفحة الـ repository

صفحة الـ repository على https://levantgit.com/username/my-first-repo هي مركز كل شيء:

  • الشريط العلوي يحمل التبويبات الرئيسية:
    • Code: الملفات والمجلدات كما هي في آخر commit.
    • Issues: بطاقات المهام والأخطاء والأفكار. افتح issue لأي شيء تريد تذكّره.
    • Pull Requests: مراجعة التعديلات قبل دمجها في main.
    • Actions وPackages وWiki: ستحتاجها لاحقًا.
    • Settings: اسم الـ repository، والظهور، وإضافة collaborators، وحماية الـ branches، والحذف. تظهر للـ owner فقط.
  • تحت التبويبات: أزرار Watch وStar وFork.
  • فوق قائمة الملفات: قائمة الـ branches لتنقّل بينها، وعدّاد Commits الذي يفتح الـ log الكامل: من غيّر ماذا ومتى.
  • أسفل الملفات: محتوى README.md معروضًا. هذا أول ما يراه الزائر، فاجعله مفيدًا.

الخطوة ٤: عدّل ملفًا من المتصفّح

لا تحتاج الطرفية للتعديلات الصغيرة:

  1. في تبويب Code اضغط على README.md.
  2. اضغط أيقونة القلم Edit File.
  3. اكتب تعديلك في المحرّر. ستجد تبويب Preview لرؤية النتيجة.
  4. انزل إلى أسفل الصفحة إلى قسم Commit Changes، واكتب رسالة قصيرة تصف ما غيّرت، واترك الخيار Commit directly to the main branch.
  5. اضغط Commit Changes.

الآن صارت نسخة الموقع متقدّمة بـ commit واحد على نسخة جهازك. لجلبه نفّذ في الطرفية:

git pull

هذه هي الدورة التي ستكرّرها كل يوم: عدّل محليًا ← نفّذ commit ← نفّذ push، وأحيانًا نفّذ pull لتجلب ما تغيّر على الموقع.

نصيحة

بالزر نفسه Add File يمكنك إنشاء ملفات جديدة أو رفعها من جهازك مباشرة في المتصفّح، وهو مفيد للصور والمستندات.

أسئلة شائعة

كيف أرفع مشروعي على ليڤانت غيت؟

أنشئ repository فارغًا على الموقع بلا README، ثم في مجلد مشروعك على جهازك نفّذ git init وgit add . وgit commit -m "أول commit"، ثم git remote add origin مع رابط الـ repository، وأخيرًا git push -u origin main. حدّث صفحة الـ repository في المتصفّح لترى ملفاتك.

ما معنى clone؟

الـ clone تنزيل نسخة كاملة من repository موجود على الموقع إلى جهازك، بتاريخه كله لا بملفاته الأخيرة فقط. الأمر git clone ينشئ مجلدًا باسم الـ repository ويربطه تلقائيًا بنسخة الموقع تحت الاسم origin، فتستطيع بعده تنفيذ pull و push مباشرة.

هل أختار Public أم Private؟

اختر Private إن كان المشروع خاصًا بك أو فيه عمل لعميل، فلا يراه أحد غيرك ومن تدعوه إليه. واختر Public إن أردت أن يطّلع عليه الجميع، كمشروع مفتوح المصدر أو معرض أعمال. تستطيع تغيير الخيار لاحقًا من Settings. وانتبه أن جعل repository عامًا يكشف تاريخه كله، لا ملفاته الأخيرة وحدها.

أنشأت الـ repository مع README ثم رفضت الـ push، ماذا أفعل؟

ستظهر لك رسالة refusing to merge unrelated histories لأن للطرفين تاريخين منفصلين. نفّذ مرة واحدة git pull origin main --allow-unrelated-histories، ثم حلّ أي تعارض في README ونفّذ commit ثم push. أو انسخ ملفاتك إلى مجلد نفّذت له clone من البداية.

ماذا بعد؟