إضافة مستودعات إلى مساحة عمل

يبيّن هذا الدليل كيف تسجّل نسخة عمل Git في مساحة عمل، وتعيد فهرستها، ثم تزيلها.

المستودعات على نطاق مساحة العمل. لا سجل عام ولا خطوة ربط: إضافة المستودع ووضعه في مساحة العمل فعل واحد. نسخة العمل الواحدة، إذا سُجّلت في مساحتي عمل، تصير صفين مستقلين بمعرّفين مختلفين. بين مساحات العمل تُعرَف هوية المستودع بمسار نظام ملفاته، لا بمعرّفه.

قبل أن تبدأ

لا يُسجَّل مجلد إلا إذا تحققت الشروط الثلاثة:

أن يكون داخل شجرة عمل Git.
أن يكون لتلك الشجرة مستودع بعيد origin.
أن يشير المستودع البعيد origin إلى مضيف شفرة مدعوم: github.com أو gitlab.com أو bitbucket.org.

ما عدا ذلك يُرفض عند التسجيل برسالة صريحة: «المجلد ليس داخل شجرة عمل Git.» أو «لا يوجد مستودع بعيد origin مُعدّ لهذا المستودع.» أو «المستودع البعيد origin غير مستضاف على مضيف شفرة مدعوم (github.com، gitlab.com، bitbucket.org).». لا يوجد وضع للمستودعات المحلية فقط.

يُقرأ مضيف الشفرة من المستودع البعيد ويُخزَّن على المستودع، ولا تختاره أنت. يمكن لمساحة عمل واحدة أن تضم مستودعات من المضيفين الثلاثة معًا، ويُخاطَب كل منها عبر واجهته البرمجية وبيانات اعتماده. تبقى مساحات الأسماء المتداخلة في GitLab كما هي، فيُسجَّل gitlab.com/group/subgroup/project بمالك group/subgroup واسم project.

يجب أن يقع المجلد أيضًا على الجهاز الذي يستضيف cc_server، داخل أحد مجلدات --repo-roots لذلك الخادم. تقتصر قائمة السماح افتراضيًا على المجلد الرئيسي لمستخدم الخادم، ويُرفض تصفح ما فوق أي جذر.

تسجيل نسخة عمل

افتح الإعدادات ← مساحة العمل ← المستودعات (/workspaces/<id>/settings/workspace/repositories).
انقر إضافة مستودع.

الحوار مستعرض ملفات يمكن التنقل فيه داخل نظام ملفات الخادم، لا نظام ملفاتك. الخطوات نفسها على الحاسوب والويب والهاتف، لأن منتقي مجلدات النظام يختار مجلدًا على الجهاز الخطأ.

تنقّل ضمن الجذور التي ضبطها الخادم. تُميَّز المجلدات التي هي نسخ عمل Git.
ضع علامة على أي عدد منها. يبقى التحديد وأنت تتنقّل، فتجمع نسخ العمل من عدة مجلدات.
سجّلها في دفعة واحدة.

اختيار واحد فاشل لا يُسقط بقية الدفعة: تحصل على المعرّفات التي أُنشئت، وعلى خطأ لكل مسار رُفض. إعادة تسجيل مسار موجود أصلًا في مساحة العمل هذه تُعيد المستودع القائم، ولا تنشئ مكررًا.

يظهر كل مستودع مسجّل في القائمة مع owner/name، وشارة تسمّي مضيف شفرته، ومساره على الخادم. تعرض مستودعات GitHub الصورة الرمزية للمالك أيضًا. أما المضيفون الآخرون فلا عنوان يمكن تخمينه للصورة الرمزية للمالك، فتُعرض الأحرف الأولى.

شارة مضيف الشفرة مهمة في مساحة العمل المختلطة: قد يُسمّى مستودعان acme/web على مضيفين مختلفين، ويتصرفان على نحو مختلف، فيما تستطيع المراجعة فعله وفي وجهة الرابط.

ماذا يحدث بعد ذلك

يُطلق التسجيل حدث RepoAdded على نطاق مساحة العمل هذه، فيبدأ خط أنابيب index_code لنسخة العمل تلك. هذا ما يملأ مخطط الشفرة، فيجد البحث وتحليل التأثير ما يجيبان به.

لا تُفهرَس إلا الملفات التي لِلغتها قواعد تحليل مُضمَّنة (Dart، JavaScript، TypeScript، TSX، PHP، Python، Rust، Zig، C، C++، Go، Java، Ruby، C#، Swift، Kotlin، R، Assembly، MATLAB وAda). انظر البحث في الشفرة عبر مخطط الشفرة.

إعادة فهرسة مستودع

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

إعادة ترتيب المستودعات

اسحب المقبض في الصف. الترتيب الذي تضبطه هو الترتيب الذي تقرأه قوائم المستودعات كلها في التطبيق.

تصحيح رابط GitHub

أيقونة الرابط في الصف تفتح محرّرًا لمالك المستودع واسمه على GitHub. يفيد ذلك إذا أُعيدت تسمية المستودع البعيد أو نُقل.

إزالة مستودع

افتح الإعدادات ← مساحة العمل ← المستودعات.
انقر أيقونة سلة المهملات في الصف.
أكّد «هل تريد إزالة المستودع من مساحة العمل؟».

يقول الحوار ما يفعله: «ستتم إزالة name من مساحة العمل هذه. لن تُمسّ الملفات المحلية على القرص.»

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

أدلة ذات صلة

مفاهيم ذات صلة

مساحات العمل والعزل