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

الربط مع VS Code

VS Code يتعامل مع ليڤانت غيت بالنقر لا بالأوامر: افتح لوحة الأوامر ونفّذ Git: Clone بعد لصق رابط الـ repository، ثم استخدم لوحة Source Control لتجهيز الملفات وكتابة commit message وتنفيذ الـ commit، واضغط Sync Changes ليجري pull ثم push. يحتاج Git مثبّتًا على النظام ولا يأتي به مدمجًا. وفي النهاية بدائل قصيرة لمن لا يستخدم VS Code.

قبل أن تبدأ

  • ثبّت Git على جهازك. VS Code لا يأتي بـ Git مدمجًا بل يستخدم المثبَّت على النظام. راجع تثبيت Git.
  • ثبّت VS Code من code.visualstudio.com.
  • أعدّ طريقة الدخول: إما SSH key، أو access token من Settings ← Applications إن كنت ستستخدم HTTPS.

الـ clone من داخل VS Code

  1. انسخ رابط الـ repository من صفحته على ليڤانت غيت (زر Code): https://levantgit.com/username/repo.git أو [email protected]:username/repo.git.
  2. في VS Code افتح لوحة الأوامر: Ctrl+Shift+P (على ماك Cmd+Shift+P).
  3. اكتب Git: Clone واضغط Enter.
  4. الصق الرابط واضغط Enter.
  5. اختر مجلدًا على جهازك لحفظ النسخة فيه.
  6. حين يسأل Open cloned repository? اختر Open.

إن نفّذت الـ clone عبر HTTPS فسيطلب منك اسم المستخدم وكلمة السر عند أول عملية تحتاج صلاحية؛ ضع access token مكان كلمة السر، خاصةً إن كان الـ 2FA مفعّلًا. ويمكنك بدلًا من ذلك فتح مجلد نفّذت له clone سابقًا عبر File ← Open Folder.

لوحة Source Control

اضغط أيقونة التفرّع في الشريط الجانبي (أو Ctrl+Shift+G) لفتح لوحة Source Control. هنا تكتمل دورة العمل اليومية بالنقر:

  • Changes: الملفات التي عدّلتها. انقر ملفًا لترى الـ diff جنبًا إلى جنب.
  • التجهيز: اضغط + بجانب الملف لوضعه في الـ staging area، أو + بجانب عنوان القسم لتجهيز الكل. ستنتقل الملفات إلى Staged Changes.
  • الـ commit: اكتب الـ commit message في المربع العلوي واضغط Commit أو Ctrl+Enter.
  • المزامنة: اضغط Sync Changes ليجري VS Code pull ثم push. أو من قائمة … اختر Pull أو Push منفصلين.

في الزاوية السفلية اليسرى من النافذة يظهر اسم الـ branch الحالي؛ انقره لإنشاء branch جديد أو للانتقال إلى branch آخر.

نصيحة

إن ضغطت Commit والمربع فارغ فسيفتح VS Code محرّرًا نصيًا لكتابة رسالة أطول. السطر الأول هو العنوان، ثم سطر فارغ، ثم التفاصيل.

الطرفية داخل VS Code

حين تحتاج أمرًا غير موجود في الأزرار، افتح الطرفية بـ Ctrl+` (على ماك Cmd+`) أو من القائمة Terminal ← New Terminal. تُفتح في مجلد المشروع مباشرة، فتكتب git log --oneline أو أي أمر من ورقة الأوامر.

إضافات مفيدة (اختيارية)

  • GitLens: يعرض من عدّل كل سطر ومتى — وهو ما يسمّيه Git الـ blame — داخل المحرّر، مع عرض مرئي للـ log والـ branches. ليست ضرورية، لكنها تسهّل فهم تاريخ المشروع. ثبّتها من تبويب الإضافات بالبحث عن GitLens.

ملاحظة عن النصوص العربية

محرّر VS Code يعرض النص العربي داخل الملفات بشكل صحيح، لكن واجهته واتجاه الأسطر يبقيان من اليسار إلى اليمين. إن كنت تحرّر ملفات Markdown عربية طويلة فجرّب إحدى إضافات دعم RTL من متجر الإضافات؛ هي تحسّن العرض لكنها ليست شرطًا للعمل مع Git.

بدائل لمن لا يستخدم VS Code

  • Git Bash و Git GUI (ويندوز): يأتيان مع مثبِّت Git. Git Bash طرفية تعمل فيها كل أوامر هذا الدليل، و Git GUI واجهة بسيطة للتجهيز والـ commit والـ push.
  • GitHub Desktop: رغم اسمه يعمل مع أي repository محلي عبر File ← Add Local Repository. نفّذ clone للـ repository من ليڤانت غيت بالطرفية أولًا ثم أضفه، وسيتولّى هو الـ commits والـ pull والـ push.
  • محرّرات أخرى: معظم المحرّرات وبيئات التطوير الحديثة فيها تكامل مع Git يعمل مع ليڤانت غيت كما يعمل مع أي خادم Git، لأن ليڤانت غيت يتحدّث بروتوكول Git القياسي عبر HTTPS و SSH.

ملاحظة

لا يوجد تطبيق سطح مكتب رسمي خاص بـ Gitea أو ليڤانت غيت. كل ما تحتاجه هو Git وأي واجهة تفضّلها.

ماذا بعد؟