الفروع والمستودعات البعيدة والشريط الجانبي

شريط جانبي واحد قابل لإعادة الترتيب وللبحث يحمل الفروع والمستودعات البعيدة والوسوم والمخابئ وأشجار العمل والوحدات الفرعية. وكل قسم يمكن إخفاؤه أو إعادة ترتيبه (الإعدادات ← التخطيط)، وصندوق التصفية يسري عليها جميعًا. وتتذكر اللوحة أي الأقسام والمجلدات أبقيتها مفتوحة أو مطوية — لكل مستودع على حدة، وعبر إعادة التشغيل.

الشريط الجانبي كومة ألواح لا قائمة طويلة. القسم المفتوح يأخذ الارتفاع الذي تتركه الأقسام المطوية، وهي تبقى أسفله صفوف عناوين؛ افتح عدة أقسام فتتقاسم ذلك الارتفاع بالتساوي، ولكلٍ تمريره. قسم بمئات الوسوم يتمرر داخل لوحه وتبقى العناوين الأخرى مكانها، فلا يخرج شيء تريد النقر عليه عن الشاشة. افتح أكثر مما يتسع فتنكمش كل الألواح معًا حتى العنوان — والشريط نفسه لا يتمرر أبدًا.

المحلي وحده يبدأ مفتوحًا في مستودع لم ترتّبه بعد؛ وكل قسم آخر يبدأ كعنوان. يبدأ أي قسم يحتوي على أكثر من 300 مرجع مطويًا على أي حال. في مستودع يحمل آلاف الفروع البعيدة التي لم يحذفها أحد قط، كانت ستظهر كلها على الشاشة دون أن تطلبها؛ افتحه مرة واحدة ويُحفَظ هذا الاختيار مثل أي اختيار آخر.

الفروع

أنشئ وسُحُب وأعِد تسمية واحذف — محليًا وبعيدًا. وصفوف الفروع تعرض:

• ↑متقدم / ↓متأخر بالنسبة إلى منبعها،
• شارات حضور لكل مستودع بعيد (أي المستودعات البعيدة لديها هذا الفرع)،
• نقطة خطر بعد فحص رادار التعارضات،
• علامة ⟳ حين يكون المستودع البعيد قد أعاد كتابة السجل.

والفروع التي في أسمائها / تُطوى في مجلدات قابلة للطي تلقائيًا. والبادئة ذات الابن الواحد تبقى مجلدًا — release/1.2.3 هو release وفيه 1.2.3 — فإضافة release/1.2.4 لاحقًا لا تعيد رسم الشجرة. وسلسلة المجلدات ذات الابن الواحد تُطوى في ترويسة واحدة (dependabot/npm_and_yarn). ترويسات المجلد تحمل علامة مجلد؛ والمرجع نفسه علامة فرع أو بعيد أو وسم.

انقر بزر الفأرة الأيمن على رأس مجلد للتصرف في المجموعة كلها: حذف كل الفروع ضمن feature (4 فرعًا) يزيل كل ما بداخله بعد تأكيد واحد يسرد الفروع التي ستُحذف بالضبط — والفرع الذي أنت عليه مستثنى. والقائمة نفسها موجودة على مجلدات الفروع البعيدة، وتحذف من المستودع البعيد بدلًا من ذلك.

تعرض قائمة الفروع المنسدلة في شريط الأدوات الفروع المحلية والبعيدة. انقر بزر الفأرة الأيمن على أي فرع في تلك القائمة لإعادة تسمية فرع محلي، أو نسخ اسمه، أو سحبه في شجرة عمل (worktree) جديدة، أو دمجه في الفرع النشط، أو حذفه. الفروع البعيدة لا تعرض إعادة التسمية وتُحذف من بعيدها بعد التأكيد. يخفي Gitcito خيار الدمج عندما يكون المرجع المحدد متضمَّنًا بالفعل في الفرع النشط، ويعطّل إنشاء شجرة العمل عندما يكون ذلك الفرع مسحوبًا بالفعل.

وتُحدَّد الصفوف تحديدًا متعددًا كما الملفات: النقر مع ⌘/Ctrl يبدّل صفًا، والنقر مع Shift يحدّد نطاقًا، وShift+↑/↓ يوسّع التحديد من آخر صف نقرت عليه. انقر بزر الفأرة الأيمن على التحديد لقائمة الإجراءات الجماعية — حذف 4 فروع — التي تؤكّد بالقائمة الكاملة. والإيماءات نفسها تعمل على الفروع البعيدة والوسوم والمخابئ.

إعادة تسمية فرع

الفرع الذي سميته fix قبل ثلاثة أيام هو اليوم فرع لا أحد يعرف موضعه. أعِد تسميته من المكان الذي لاحظت فيه المشكلة:

إعادة التسمية المحلية هي git branch -m: فورية وقابلة للتراجع بـ ⌘Z — إذ يعيد إدخال التراجع الاسم القديم. وإعادة تسمية الفرع الذي تقف عليه تُبقيك عليه.

وحين يتتبّع الفرع مستودعًا بعيدًا، تقدّم القائمة أيضًا إعادة تسمية (مع البعيد)…: تعيد التسمية محليًا، وتدفع الاسم الجديد، وتحذف القديم في البعيد. وهذا غير قابل للتراجع — فالفرع البعيد القديم يختفي، وعلى كل من كان يسحبه أن يعيد التوجيه بنفسه. ولا تظهر على شارة المخطط إلا إذا كان الفرع يتتبّع مستودعًا بعيدًا واحدًا بالضبط؛ ومع أكثر من واحد اختر الفرع من الشريط الجانبي حتى يكون المنبع واضحًا.

الحدود: لا يعيد Gitcito كتابة أي شيء كان يشير إلى الاسم القديم — فطلبات السحب المفتوحة تظل تشير إلى الفرع الذي فُتحت عليه، وقواعد التكامل المستمر المبنية على نمط اسم الفرع تتوقف عن المطابقة. وإعادة تسمية فرع مسحوب في شجرة عمل أخرى تفشل، وgit يقول ذلك صراحة.

سحب ودفع فرع لست عليه

انقر بزر الفأرة الأيمن على أي فرع محلي: يعمل خيارا سحب وإرسال على ذلك الفرع، لا على الفرع المسحوب حاليًا — بلا التفاف عبر السحب لتحديث ثلاثة فروع. انظر الجلب والسحب والإرسال.

الفروع المثبَّتة

ضع نجمة على الفروع التي تعود إليها دائمًا — مرّر على الصف واضغط ★، أو انقر بالزر الأيمن ← تثبيت الفرع. فتظهر في مجموعة مثبَّتة أعلى القسم المحلي، محفوظةً لكل مستودع على حدة، مع بقائها في مكانها المعتاد أسفل ذلك.

سحب فرع بعيد

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

عندما يكون فرعك المحلي متأخّرًا

يُقدَّم سريعًا (fast-forward) إلى رأس الفرع البعيد ضمن عملية الانتقال. وإذا كانت شجرة العمل غير نظيفة فتُحفظ في مخبأ (stash) باسم محدّد ثم تُستعاد بعد التحديث، حتى لا تُلغي تعديلاتك المحلية العملية.

عندما يكون فرعك المحلي متقدّمًا

إذا كان الفرع المحلي متقدّمًا ولا جديد في الفرع البعيد، فإن الانتقال يردّ على طلب الفرع البعيد بعملك أنت غير المدفوع — لذلك لا يُنفَّذ أي انتقال حتى تحدّد الجانب الذي تقصده:

اترك خيار أنشئ فرع نسخة احتياطية أولاً مفعّلًا ليُحفظ رأس الفرع المحلي باسم backup/<الفرع>-<الطابع-الزمني> قبل أي تحريك، فيبقى حتى إعادة التعيين hard على بُعد انتقال واحد من التراجع. كما تدخل إعادة التعيين في مكدّس التراجع (⌘Z)، لكن حتى إغلاق المستودع فقط — أما فرع النسخة الاحتياطية فيبقى بعده.

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

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

قسم المستودعات البعيدة في الشريط الجانبي هو حيث تُضاف وتُحرَّر وتُجلب وتُحذف. الجلب أو السحب أو الإرسال على مستودع بلا أيٍّ منها يفتح حوار إضافة مستودع بعيد نفسه — الصق عنوانًا أو أنشئ المستودع على المضيف — بدل ألا يفعل شيئًا. انظر الجلب والسحب والإرسال.

انظر أيضًا: الدمج وإعادة الأساس · أشجار العمل