استخدم الوسوم وتسميات الإصدارات

• أنشئ وسمًا مشروحًا برسالة مقصودة.
• افحص كائن الوسم وإيداعه المحسوم مستقلين.
• ادفع وسمًا صريحًا دون نشر كل الوسوم.
• افصل إنشاء الوسم عن إصدار المضيف.

تبدأ من حيث انتهى الدرس الثالث عشر: main/H7 خالٍ، والخادم main عند H7، والميزة منشورة F1، ولا وسم v0.1.0. لا نطلب توقيع الوسم.

سُجّل الفيديو باستخدام 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؛ لا تنفذ الدرس في مستودع مصدر.

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

يتقدم الفرع عادةً مع الإيداعات؛ الوسم اسم مقصود الثبات. يشير الخفيف مباشرةً إلى كائن، ويضيف المشروح كائن وسم وهوية ورسالة.

يشير v0.1.0 هنا إلى كائن وسم؛ ويحسمه v0.1.0^{} إلى الإيداع. اختلاف المعرّفين متوقع ولا يعني إصدارين.

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

ينشئ الفعل مرجع الوسم وكائنه؛ ويضيف الدفع وسم الوجهة المختار دون تحريك HEAD أو الفروع أو الملفات.

استخدم main بعد الدرس الثالث عشر وافحص معرّف H7 وغياب الوسم. لا تضف دفترًا بعد الوسم.

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

1. حدّد صف main/H7 الفعلي في المخطط (docs: add Leo's review reminder)، وتأكد من تغيير التذييل والهوية، ثم انقر الصف بزر الفأرة الأيمن.
2. افتح وسم هنا (Tag Here) واختر إنشاء وسم مشروح هنا… (Create Annotated Tag Here…؛ تعرض قائمة الصف أيضًا إنشاء وسم هنا… (Create Tag Here…) الذي ينشئ وسمًا خفيفًا). عنوان الحوار «إنشاء وسم مشروح عند» ومعرّف الإيداع المختصر (Create an annotated tag at).
3. اكتب في اسم الوسم (Tag name) القيمة v0.1.0، وفي الرسالة النص المحدد للدرس.
4. تحت التوقيع (Signing) ثلاثة خيارات: اتّباع إعدادات Git (Follow Git config) وتوقيع هذا الوسم (Sign this tag) وعدم توقيع هذا الوسم (Don’t sign this tag)؛ ويذكر الحوار أن إعدادات Git لا توقّع الوسوم (tag.gpgSign غير مضبوط). اختر عدم توقيع هذا الوسم لهذا الدرس غير الموقَّع صراحةً، ولا تغيّر إعداد التوقيع العام.
5. انقر إنشاء وسم (Create Tag) مرة واحدة وانتظر؛ تأكد أن v0.1.0 يشير إلى الإيداع المقصود دون تبديل الفرع المسحوب.
6. في مجموعة الوسوم (Tags) بالشريط الجانبي انقر v0.1.0 بزر الفأرة الأيمن ← دفع الوسم (Push Tag) (تعرض القائمة أيضًا حذف الوسم… (Delete Tag…) وحذف الوسم من المستودع البعيد… (Delete Tag from Remote…) ولا يستخدمهما هذا الدرس). يقرأ الإشعار «دُفع الوسم v0.1.0.» (Pushed tag v0.1.0.).
7. تحقق بالطرفية من نوع كائن الوسم ورسالته والإيداع الذي يشير إليه، ومن هوية الوسم على الخادم؛ لا تخلط الشرح بالتوقيع.
8. اترك main خاليًا والوسم دون تغيير. لا تستخدم دفع كل الوسوم… (Push All Tags) ولا تنشئ إصدارًا لدى مزوّد الاستضافة.

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

البديل الأصلي عند main خالٍ:

git tag --annotate --no-sign v0.1.0 --message "First usable GitTree Features course checkpoint"
git cat-file -t v0.1.0
git for-each-ref --format='%(contents:subject)' refs/tags/v0.1.0
git rev-parse 'v0.1.0^{}'
git push --quiet origin refs/tags/v0.1.0
git ls-remote --tags origin refs/tags/v0.1.0 'refs/tags/v0.1.0^{}'
git status --short

للخيار --annotate صيغة قصيرة هي -a (git tag -a v0.1.0 -m "message")، وللخيار --message الصيغة -m؛ وفي الحالتين يخزّن Git كائن وسم له رسالته، بخلاف الوسم الخفيف git tag v0.1.0.

نجح الإنشاء والدفع؛ ناتج النوع والرسالة:

tag
First usable GitTree Features course checkpoint

يطابق الإيداع المحسوم main. يعرض ls-remote معرّف كائن الوسم وإيداعه الفعليين؛ سجلهما دون رموز تعليمية مصطنعة. الحالة النهائية خالية. محاولة اسم مكرر منفصلة:

git tag v0.1.0

stderr الفعلي، خروج 128:

fatal: tag 'v0.1.0' already exists

يبقى الوسم الأول؛ لا تستخدم -f لإخفاء التصادم.

حيث تنتهي: يوجد v0.1.0 مشروح محليًا وفي الوجهة برسالته المحددة ويحسم إلى H7. main وHEAD والملفات ثابتة؛ لا إصدار مستضافًا أو توقيعًا مزعومًا.

• وصف الوسم المشروح بأنه موقع.
• وسم صف قديم بدل main.
• دفع كل الوسوم دون قصد.

ألغِ الإنشاء الخاطئ قبل التأكيد. افحص هدف الوسم ونشره قبل حذف صريح؛ يحافظ رفض التكرار على المرجع القائم.

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

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

   السؤال 1 من 6

   ما هو v0.1.0 هنا؟

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

   فرع متحرك

   رفع أصل مستضاف

   كائن وسم مشروح

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

   السؤال 2 من 6

   أي الادعاءات ثابتة؟

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

   للشرح رسالة

   الشرح يثبت التوقيع

   يبقى HEAD ثابتًا

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

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

   هل ينشئ الوسم إيداع main جديدًا؟

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

   لا

   نعم إيداع دمج

   فقط إن دُفع

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

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

   كرر الاسم دون قوة: النتيجة؟

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

   توقيع تلقائي

   استبدال صامت

   رفض وبقاء الوسم

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

   السؤال 5 من 6

   يختلف معرّفا الوسم وmain: تلف؟

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

   تلف دائمًا

   يجب حذف main

   ليس بالضرورة؛ احسم الوسم

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

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

   ما الذي يثبت النتيجة؟

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

   النوع والرسالة واتفاق الإيداع

   صفحة إصدار وحدها

   تتفق هويات الوسم محليًا وبعيدًا

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

أثبت النوع والرسالة واتفاق الإيداع مع main وطبقتي وسم الوجهة. توقع رفض التكرار مع بقاء الوسم والعمل.

• يضيف الشرح كائن وسم.
• ادفع الوسم المختار وحده.
• تختلف الوسوم عن إصدارات المضيف.

• ادفع الإيداعات وانشر فرعًا (الدرس الثالث عشر)
• اقرأ التاريخ دون تحريك HEAD (الدرس الثامن)
• تنزيل GitTree

Annotated tag — وسم مشروح; lightweight tag — وسم خفيف; tagger — منشئ الوسم; peeled commit — الإيداع المحسوم.