عكس تغيير في تاريخ مشترك

• أن تشرح العكس إيداعًا معاكسًا، ولماذا يناسب تاريخًا يملكه الآخرون.
• أن تتوقع أب الإيداع الجديد والملف الذي يتركه.
• أن تتعامل مع عكس يتعارض، وتعرف لماذا يسألك عكس الدمج عن أب.
• أن تنشر الإصلاح دون فرض.

أنت على shared/dark-regression، وهو فرع من ناتج الدرس 18 (M). آخر إيداع فيه، «style: introduce the rehearsal contrast regression»، يضيف قاعدة واحدة إلى styles.css هي body { color: #f7f8fa; }، فيصير نص الصفحة بلون الخلفية الباهت نفسه. هذا الإيداع موجود بالفعل على خادم محلي أعددته لهذا الدرس، فقد يملكه زميل. تريد أن يعود النص مقروءًا دون إعادة كتابة شيء يملكه الآخرون.

كل شيء هنا محلي وضمن الخطة المجانية (يطلب GitTree تسجيل الدخول): دون حساب استضافة أو مزوّد أو إنترنت. الخادم مستودع محلي مجرّد (bare)، وليس GitHub. كل الهويات خيالية (example.com). لا تنفّذ الدرس في مشروع حقيقي.

نفّذ التغييرات في GitTree أو بأوامر Git الأصلية، لا بالطريقتين في النسخة نفسها. القراءة بعد التنفيذ آمنة دائمًا. تسميات القوائم مأخوذة من نصوص GitTree 2.0 نفسها، وشُغّلت الأوامر الأصلية بـ Git 2.43 في نسخ مؤقتة. لم تُشغَّل خطوات GitTree على macOS أو Windows أو Linux.

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

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

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

لا يحصل إلا الفرع الحالي على إيداع. ولا يتحرك شيء آخر حتى تدفع.

ابدأ من نسخة عادية منفصلة من ناتج الدرس 18 (M) وأبقِ أصلك دون مساس. أنشئ الفرع واحفظ DOC_DARK_BAD فوق styles.css وأودِعه، وأنشئ مستودعًا مجرّدًا فارغًا جديدًا بجانب النسخة، وأضفه مستودعًا بعيدًا باسم rehearsal، وادفع الفرع مع الفرع المتتبَّع. أما CSS_RESTORED فهو ما يجب أن يبدو عليه الملف بعد العكس.

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

styles.css — DOC_DARK_BAD

: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;
}

body { color: #f7f8fa; }

styles.css — CSS_RESTORED

: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;
}

افتح لوحة الأوامر بـ Command+Shift+P (وCtrl+Shift+P على Ubuntu). تستخدم أفعال الإيداع قائمة النقر بزر الفأرة الأيمن على الإيداع.

1. ابنِ الفرع والإيداع والخادم المحلي كما يبيّن القسم التالي. أبقِ shared/dark-regression محدَّدًا ومجلد العمل خاليًا.
2. في المخطط حدّد الإيداع السيئ واقرأ تفاصيله: مسار واحد متغيّر هو styles.css، وسطر واحد مضاف.
3. انقره بزر الفأرة الأيمن واختر عكس الإيداع (Revert Commit). يُطبَّق فورًا على الفرع الذي أنت عليه؛ ولا محرر رسالة. يقول الإشعار «تم العكس.» وإن توقف بدل ذلك فيعرض الشريط «جارٍ عكس … على shared/dark-regression» مع حلّ (Resolve) ومتابعة (Continue) وإيقاف… (Abort…).
4. حدّد الإيداع الجديد. عنوانه Revert "style: introduce the rehearsal contrast regression" وأبوه هو الإيداع السيئ. الإيداع السيئ ما زال في المخطط.
5. افتح styles.css: هو CSS_RESTORED، دون القاعدة المضافة.
6. اضغط دفع (Push) في الشريط العلوي. هذا دفع عادي للفرع إلى فرعه المتتبَّع؛ لا تختر دفع قسري آمن (with-lease)… (Force Push (With Lease)…). يقول الإشعار «دُفع shared/dark-regression إلى rehearsal/shared/dark-regression.»
7. افحص النتيجة: مجلد العمل خالٍ، والإيداعان في المخطط، وفرع الخادم على الإيداع الجديد.

إن نقرت إيداع دمج بزر الفأرة الأيمن فإن عكس الإيداع يفتح «عكس إيداع الدمج …» مع الأب الأول (الفرع الذي دُمج فيه) والأب الثاني (الفرع الذي دُمج). لا تنفّذه هنا.

لكل إيداع عادي في الدورة: الملخّص (Summary) هو العنوان المحدد، والوصف (Description) خالٍ، وتبقى الخيارات تعديل الإيداع الأخير وتخطّي الخطّافات وإضافة Signed-off-by ومؤلف مختلف والدفع بعد الإيداع والسماح بإيداع فارغ معطّلة.

في نسخة منفصلة من ناتج الدرس 18:

git switch --create shared/dark-regression

احفظ DOC_DARK_BAD باسم styles.css ثم:

git add -- styles.css
git commit --quiet -m "style: introduce the rehearsal contrast regression"
BAD_SHA="$(git rev-parse HEAD)"
git init --quiet --bare --initial-branch=main ../gittree-revert-origin.git
git remote add rehearsal ../gittree-revert-origin.git
git push --quiet --set-upstream rehearsal shared/dark-regression

الآن اعكس وانشر واقرأ النتيجة:

git revert --no-edit "$BAD_SHA"
git merge-base --is-ancestor "$BAD_SHA" HEAD; echo $?
git log -1 --format=%s
git push --quiet rehearsal shared/dark-regression
git status --short
git ls-remote --heads rehearsal refs/heads/shared/dark-regression
git rev-parse HEAD

0
Revert "style: introduce the rehearsal contrast regression"

يطبع فحص السلف 0: الإيداع السيئ ما زال خلف HEAD. وstyles.css هو CSS_RESTORED، والحالة خالية، والمعرّفان من ls-remote وrev-parse متساويان. ولم يُستخدم أي خيار فرض. وفي نسخة منفصلة يعدّل فيها إيداع لاحق السطر نفسه يتوقف git revert بعبارة «CONFLICT (content)» وتلميحي git revert --continue وgit revert --abort. ويرفض git revert على إيداع دمج بعبارة «is a merge but no -m option was given»؛ و-m 1 يختار الأب الأول.

أين تنتهي: في shared/dark-regression إيداع جديد واحد يلغي الإيداع السيئ. تستخدم الصفحة CSS_RESTORED، والإيداع السيئ ما زال في التاريخ، وفرع الخادم على الإيداع الجديد، ومجلد العمل خالٍ، ولم يُفرض شيء.

• استخدام إعادة التعيين ودفع قسري «لإزالة» إيداع يملكه الآخرون بالفعل.
• توقع أن يختفي الإيداع السيئ من السجل.
• عكس إيداع دمج دون اختيار أبيه عن قصد.
• الدفع قبل النظر في الملف الذي تركه العكس.

إن توقف العكس بتعارض فاقرأ الشريط. حلّ ومتابعة تنهيانه كما في الدرس 23، وإيقاف… يعيد الفرع إلى حيث كان. وإن كان العكس نفسه خطأً بعد أن انتهى فاعكس العكس: هو إيداع آخر فقط.

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

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

   السؤال 1 من 6

   ماذا يفعل العكس بالإيداع السيئ؟

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

   ينقل الفرع إلى الإيداع الذي قبله

   يحذفه من الفرع

   يتركه في التاريخ ويضيف إيداعًا جديدًا يلغي تغييره

   يخفيه عن الزملاء

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

   السؤال 2 من 6

   بعد العكس، أي مما يلي صحيح؟

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

   أُعيدت كتابة تاريخ الخادم

   أب الإيداع الجديد هو الإيداع السيئ

   الإيداع السيئ ما زال سلفًا لـ HEAD

   عاد styles.css إلى ما كان عليه قبل الإيداع السيئ

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

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

   تعكس الإيداع السيئ وتدفع دفعًا عاديًا. أين فرع الخادم بعد ذلك؟

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

   على إيداع العكس الجديد، والإيداع السيئ ما زال خلفه

   على الإيداع الذي قبل السيئ

   ما زال على الإيداع السيئ: يُرفض الدفع

   يُحذف الفرع ويُنشأ من جديد

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

   السؤال 4 من 6

   غيّر المُدخل: إيداع لاحق يعدّل السطر نفسه الذي أضافه الإيداع السيئ، ثم تعكس الإيداع السيئ. ماذا يحدث؟

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

   يعكس Git الجزء الذي يناسب فقط، بصمت

   يُعكس الإيداع اللاحق بدلًا منه

   يتوقف العكس بتعارض؛ تحلّه وتتابع أو توقف

   ينجح العكس ويتجاهل التعديل اللاحق

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

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

   تحاول عكس إيداع دمج فيقول Git «is a merge but no -m option was given». ما الذي يجري وماذا تفعل؟

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

   استخدم إعادة تعيين كاملة بدلًا منه لتتجنب السؤال

   العكس لا يعمل على إيداعات الدمج أبدًا

   الإيداع تالف. احذف الفرع

   لإيداع الدمج أبوان، فيحتاج Git أن يعرف أيهما تُقاس به التغييرات. اختر أبًا عن قصد، وعادةً الأول

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

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

   بعد العكس والدفع، أي قراءات تبيّن أنه فعل ما يقوله الدرس؟

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

   يطبع git merge-base --is-ancestor "$BAD_SHA" HEAD; echo $? الرقم 0

   يطبع git log -1 --format=%s العنوان Revert "style: introduce the rehearsal contrast regression"

   يساوي المعرّف من git ls-remote --heads rehearsal refs/heads/shared/dark-regression ناتج git rev-parse HEAD

   لم يعد git log --oneline يسرد الإيداع السيئ

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

اذكر عنوان الإيداع المعاكس وأباه، وهل الإيداع السيئ ما زال سلفًا، وهل فرع الخادم يساوي HEAD. ثم توقّع ماذا يحدث لو كان إيداع لاحق قد غيّر السطر نفسه قبل أن تعكس.

• العكس يضيف إيداعًا يلغي إيداعًا آخر.
• يبقى التاريخ ويعود الملف.
• يكفي دفع عادي.

• ادمج فرعين تباعد سجلهما (الدرس 18)
• حلّ تعارضات الدمج وإعادة التأسيس (الدرس 23)
• إعادة التعيين: ناعمة ومختلطة وكاملة (الدرس 27)
• تنزيل GitTree

Revert — عكس; inverse change — تغيير معاكس; mainline parent — الأب الرئيسي.