افهم الدمج بالتقديم السريع

• تعرف شرط السلف.
• أثبت اتفاق الطرفين بعد التقديم.
• افصل تحريك المرجع عن إنشاء الإيداع.
• توقع الرفض عند التباعد.

تبدأ من نسخة منفصلة من نتيجة الدرس الثامن عشر (main هو الدمج، وهو خالٍ): أنشئ scenario/ff-target عند هذا الإيداع ثم feature/dark-mode عند الإيداع نفسه؛ وتنال لوحة الألوان الداكنة إيداعًا واحدًا D على الميزة. عد إلى scenario/ff-target قبل الدمج.

سُجّل الفيديو باستخدام Git 2.52.0 وGitTree 2.0 على Ubuntu 24.04: لوحة الألوان الداكنة وإيداعها والتبديل والدمجان جرت في التطبيق؛ أما الفرعان التجريبيان والفحوص ففي الطرفية، وعُرض الرفض في التطبيق ثم في الطرفية. لم يُشغَّل شيء على macOS أو Windows، وUbuntu هو نظام Linux الوحيد المسجَّل. الحد الأدنى المقروء لـ GitTree هو Git 2.39.0.

يطلب GitTree تسجيل الدخول، ثم تشمل الخطة المجانية كل خطوات الدرس. لا مزوّد أو Pro أو اعتماد API أو خدمة إنترنت مطلوبة. الوجهة المحلية المجردة ليست GitLab أو CI. الهويات خيالية example.com؛ لا تنفذ الدرس في مستودع مصدر.

نفّذ التغييرات عبر التطبيق أو الطريق الأصلي من الحالة نفسها، لا كليهما بالتتابع. يمكن التحقق بالقراءة بعد أيهما. تُسمَّى التهيئة الطرفية أصلية، لا ميزة تطبيق مختلقة.

يمكن التقديم إذا كان الهدف سلفًا للوارد. ينتقل الوسم إلى التابع دون إيداع دمج جديد.

يبقى D بهويته وأبيه؛ ما زال M القديم دمجًا بأبوين، فلا تنسب أبويه إلى عملية اليوم.

التقديم فقط شرط سياسة لا إصلاح عام؛ إن تقدم الهدف مستقلًا تباعد الطرفان ويرفض الوضع.

يتقدم الهدف والملفات إلى D وتبقى الميزة؛ لا إيداع جديدًا أو تغيير خادم.

ابدأ نسخة عادية منفصلة من المشروع كما تركه الدرس الثامن عشر. يبقى gittree-features الأصلي محفوظًا ولا تنفذ في مستودع مصدر. (سمّت خطة سابقة للدورة نقطة بداية مختلفة؛ يستخدم الفيديو نتيجة الدرس الثامن عشر بالخطوات نفسها.) ورقة الأنماط أدناه هي styles.css للمشروع مع إضافة كتلة واحدة للوحة الداكنة. الهوية محلية خيالية والتوقيع معطل.

احفظ في المرحلة المحددة فقط بصيغة UTF-8 وLF وسطر نهائي. لا تلصق أسوار Markdown. ترث الملفات الثابتة نقطة البداية؛ لا تستبدل الأصل بنسخة إعادة منفصلة.

styles.css — DARK

:root {
  color-scheme: light;
  --page: #f7f8fa;
  --surface: #ffffff;
  --text: #17212e;
  --link: #154ab5;
  --line: #bac4d0;
}

* {
  box-sizing: border-box;
}

body {
  margin: 0;
  background: var(--page);
  color: var(--text);
  font: 1rem/1.6 system-ui, sans-serif;
}

a {
  color: var(--link);
}

.site-header,
main,
footer {
  width: min(68rem, 100% - 2rem);
  margin-inline: auto;
}

.site-header {
  display: flex;
  flex-wrap: wrap;
  justify-content: space-between;
  gap: 1rem;
  padding-block: 1rem;
}

.hero {
  max-width: 48rem;
  padding-block: 3rem;
}

h1 {
  font-size: clamp(2rem, 5vw, 3.5rem);
  line-height: 1.2;
}

.cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(16rem, 100%), 1fr));
  gap: 1rem;
}

.feature-card {
  padding: 1rem;
  border: 1px solid var(--line);
  border-radius: 0.75rem;
  background: var(--surface);
}

section {
  margin-block-end: 2rem;
}

button,
input {
  font: inherit;
}

button,
input {
  padding: 0.5rem 0.75rem;
}

:focus-visible {
  outline: 3px solid var(--link);
  outline-offset: 3px;
}

form {
  display: grid;
  max-width: 28rem;
  gap: 0.5rem;
}

:root[data-theme="dark"] {
  color-scheme: dark;
  --page: #121923;
  --surface: #1b2635;
  --text: #edf2f8;
  --link: #a4c6ff;
  --line: #7388a1;
}

لوحة الأوامر: Command+Shift+P (وCtrl+Shift+P على Ubuntu)، ثم الأمر المحدد حرفيًا. أفعال المرجع المسمّى في قائمة صفه، لا اختصار لوحة بلا وسيط.

1. أعدّ الفرعين في النسخة المنفصلة واحفظ DARK على الميزة.
2. أودِع styles.css وحده بالملخّص المحدد وافحص D.
3. تحت محلي (Local) افتح المجلد scenario وانقر ff-target بزر الفأرة الأيمن ← التبديل إلى scenario/ff-target (Checkout scenario/ff-target)؛ وتحقق أنه ما زال عند M وخالٍ.
4. تحت محلي (Local) افتح المجلد feature وانقر dark-mode بزر الفأرة الأيمن ← دمج feature/dark-mode في scenario/ff-target (Merge feature/dark-mode into scenario/ff-target)؛ وراجع المصدر والهدف في الحوار.
5. في طريقة التسجيل (Record it as) اختر تقديم سريع فقط (Fast-forward only) لا إنشاء دمج دائم.
6. انقر دمج (Merge) مرة واحدة وانتظر انتقال الهدف إلى D الموجود.
7. قارن المعرّفات الكاملة وافحص DARK والعمل الخالي.
8. اختبر الرفض في نسخة متباعدة منفصلة (افتحها من علامة تبويب جديدة (New Tab) والمستودعات الأخيرة): كرّر الدمج بـ تقديم سريع فقط (Fast-forward only) فيرفض التطبيق ويقول إن في الهدف «تغييرات ليست لديك بعد» (has changes you do not have yet). واترك الأصل دون تغيير.

لكل إيداع عادي: الملخّص (Summary) بالملخّص المحدد والوصف (Description) خالٍ؛ خيارات تعديل الإيداع الأخير (Amend Previous Commit) وتخطّي الخطّافات (Skip Hooks) وإضافة Signed-off-by (Add Signed-off-by) ومؤلف مختلف (Different Author) والدفع بعد الإيداع (Push After Commit) والسماح بإيداع فارغ (Allow Empty Commit) معطلة ودون مؤلفين مشاركين. جهّز الملفات المحددة ثم زر الإيداع ذي العدد الصحيح مرة واحدة، أو Command+Enter كبديل. درس التعديل الأخير وحده يغير خياره الصريح.

في نسخة منفصلة من نتيجة الدرس الثامن عشر:

git switch --create scenario/ff-target
git switch --create feature/dark-mode

ضع ورقة DARK كاملة مكان styles.css ثم:

git add -- styles.css
git commit --quiet -m "feat: add the dark palette"
git switch --quiet scenario/ff-target
git merge --quiet --ff-only feature/dark-mode
git rev-parse HEAD feature/dark-mode
git log -1 --format=%s
git status --short

يعرض استعلام SHA معرّفين متطابقين فعليًا. الملخّص:

feat: add the dark palette

الحالة خالية. أثبت الفحص اتفاق الهدف مع D المقاس سابقًا لا عقدة جديدة. للمُدخل البديل أضف إيداع docs/integration-note.md مستقلًا إلى الهدف في نسخة أخرى؛ يرفض ff-only مع حفظ الفرعين. لا تغيّر السياسة سرًا.

حيث تنتهي: يشير الفرعان إلى D الموجود نفسه؛ تتطابق الملفات مع DARK دون عقدة دمج جديدة وmain الأصلي ثابت.

• وصف أي التقاء رسم بإيداع دمج جديد.
• اعتبار النسخة البديلة نقطة الأصل.
• تكرار تغيير اكتمل في التطبيق.

بعد الرفض افحص التاريخين واختر مسارًا مستقلًا بعد المراجعة؛ لا يغير الرفض المرجع أو الملفات.

أجب عن كل سؤال ثم اقرأ السبب. الأسئلة المعلَّمة «مطلوب» تُحتسب لإكمال الدرس.

1. السؤال 1 من 6

   السؤال 1 من 6

   ما الشرط؟

   اختر إجابة واحدة.

   الملف نفسه

   اللون نفسه

   الهدف سلف الوارد

   تحقّق من الإجابة
2. السؤال 2 من 6

   السؤال 2 من 6

   ماذا يتغير؟

   اختر كل إجابة صحيحة.

   المرجع الهدف والملفات

   لا عقدة دمج جديدة

   كل الفروع البعيدة

   تحقّق من الإجابة
3. السؤال 3 من 6

   السؤال 3 من 6مطلوب

   معرّف الهدف الناتج؟

   اختر إجابة واحدة.

   D نفسه

   M دائمًا

   معرّف دمج جديد

   تحقّق من الإجابة
4. السؤال 4 من 6

   السؤال 4 من 6مطلوب

   أضفت إيداع هدف مستقلًا: ff-only؟

   اختر إجابة واحدة.

   يسقط الهدف

   يدمج تلقائيًا

   يرفض

   تحقّق من الإجابة
5. السؤال 5 من 6

   السؤال 5 من 6

   لـ M أبوان: دليل دمج اليوم؟

   اختر إجابة واحدة.

   الآباء بلا أهمية

   نعم دائمًا

   لا؛ افحص هوية الطرف

   تحقّق من الإجابة
6. السؤال 6 من 6

   السؤال 6 من 6مطلوب

   ما دليل الإتمام؟

   اختر كل إجابة صحيحة.

   اتفاق معرّفي الهدف وD

   بايتات DARK وخلو الحالة

   ضغط الزر فقط

   تحقّق من الإجابة

أثبت اتفاق الهدف مع D وكامل DARK، وتوقع رفض التباعد في نسخة منفصلة وافحص ثبات المراجع.

• يسمح النسب بالتقديم.
• يحفظ الوارد هويته.
• يرفض ff-only التباعد.

• ادمج فرعين تباعد سجلهما (الدرس الثامن عشر)
• ادفع الإيداعات وانشر فرعًا (الدرس الثالث عشر)
• تنزيل GitTree

Fast-forward — تقديم سريع; descendant — تابع; ancestor — سلف.