إنشاء مسودة سجل تغييرات من الإيداعات
تقرأ مسودة سجل التغييرات إيداعات الأب الأول بين نقطتين، وتجمّعها، وتقترح إصدارًا تاليًا، وتتيح نسخ Markdown. تقول الملاحظة إنها مسودة فقط. لا يُنشأ وسم ولا إصدار ولا دفع. تراجع الرسائل قبل مشاركتها.
يعمل في GitTree المجاني: كل ميزات Git المحلية دون حاجة إلى حساب.
في هذه الصفحة
قبل أن تبدأ
- المسودة جزء من الخطة المجانية. يجب أن يكون الطرفان إيداعين. يقول الحوار اختر التزامي بداية النطاق ونهايته حتى يتحققا.
- الرسائل التي تريد تجميعها يفضَّل أن تتبع Conventional Commits (
feat:وfix:وfeat!:). الرسائل العادية تُعد للمراجعة. لا تُخترع لها فئات.
أين تجده
- قائمة إيداع، أو قائمة وسم: مسودة سجل التغييرات.
Alt+L، أو لوحة الأوامر.
| الإجراء | macOS | Windows وLinux |
|---|---|---|
| مسودة سجل التغييرات | ⌥L | Alt+L |
| لوحة الأوامر | ⌘⇧P | Ctrl+Shift+P |
الخطوات
افتح مسودة سجل التغييرات
حدّد الإيداع الذي ينهي النطاق، أو الوسم الذي تكتب له الملاحظات، واختر مسودة سجل التغييرات. يمكنك أيضًا ضغط
Alt+L. العنوان مسودة سجل التغييرات. تقول الملاحظة مسودة فقط. راجع رسائل الالتزامات قبل مشاركتها. لن يُنشر شيء.
مسودة سجل التغييرات في هذه القائمة، وفي قائمة الوسم. اللقطة تعرض قائمة الإيداع.واجهة GitTree مع مستودع للعرض. حدّد النطاق
من (غير مشمول) هو الإيداع أو الوسم الذي أصدرته. إلى (مشمول) هو الطرف الجديد. يقول سطر النطاق إن المسودة تعتمد على مسار الأب الأول. إيداعات فرع مدموج يمثّلها إيداع الدمج، ولا تُسرد واحدة واحدة.
أنشئ المسودة
اضغط إنشاء مسودة. إيقاف يطلب إنهاء قراءة السجل. تظهر المسودة تحت مسودة Markdown قابلة للتحرير، مع الإصدار المقترح حين يُقترح إصدار، ووسم الإصدار الأساسي حين يشير وسم إصدار إلى الطرف المستثنى. نسخ Markdown ينسخها. نُسخ Markdown يؤكّد النسخ.
حرّر ثم قرّر أين تذهب
حرّر Markdown في الصندوق. استبدال المسودة بالمقترح يعيد النص المولَّد بعد التحرير. إن غيّرت الطرفين يقول GitTree إن النهايتين تغيّرتا وإن مسودتك المحرّرة محفوظة. إدراج المسودة في ملاحظات الإصدار يُعرض حين تكتب ملاحظات إصدار. الإغلاق بعد التحرير يسأل تجاهل المسودة المعدّلة؟ انسخ أولًا إن احتجت الكلمات.
النتيجة المتوقعة
عندك Markdown في الحافظة أو في حقل ملاحظات الإصدار. لم يُنشأ وسم ولم يُنشر إصدار. اقرأ المجموعات قبل لصقها في إصدار. الرسائل العادية وعمليات التراجع والدمج مذكورة لتعيد كتابتها.
كيف تُجمَّع الإيداعات
| المجموعة | ما يوضع فيها |
|---|---|
| تغييرات تكسر التوافق | إيداعات معلَّمة بكسر، ومنها ! أو تذييل BREAKING CHANGE |
| ميزات | إيداعات feat |
| إصلاحات | إيداعات fix |
| الأداء | إيداعات perf |
| أخرى | أنواع معروفة ليست مما سبق، ورسائل ما زالت تحتاج نظرة |
سطر الأعداد هو تحتاج إلى مراجعة، مع الرسائل العادية وعمليات التراجع والدمج والرسائل غير المقروءة. هذه الأعداد سبب حجب إصدار أحيانًا. لا توجد التزامات في هذا النطاق؛ لا يُقترح إصدار تعني أن الطرفين يستبعدان كل إيداع.
كيف يُختار الإصدار المقترح
يبدأ الاقتراح من وسم إصدار على الطرف المستثنى. يشرح الحوار السبب: تغييرات تكسر التوافق تقترح زيادة الرقم الرئيسي، أو الثانوي حين يكون الرئيسي صفرًا. الميزات تقترح الثانوي. رسائل Conventional Commits الأخرى المعروفة تقترح إصدارًا تصحيحيًا. يمكنك تجاهل الاقتراح. اختر الإصدار التالي بعد المراجعة يظهر حين لا يختار GitTree واحدًا.
git log --first-parent --pretty=format:%s v1.2.0..HEAD
git tag --points-at v1.2.0^{}النطاق نفسه في الطرفية هو git log --first-parent من الإيداع المستثنى إلى الطرف المشمول. GitTree لا يشغّل git tag عنك. إنشاء الوسم في الوسوم. نشر الملاحظات على مضيف إجراء إصدار منفصل. درس التعلّم عن الوسوم يبيّن كيف يسمّي الوسم إيداعًا.
لا يُنشر شيء
نسخ Markdown ينسخ النص فقط. إدراج المسودة في ملاحظات الإصدار يملأ حقلًا. لا أحدهما ينشئ وسمًا أو إصدار GitHub أو دفعًا. إن فشل النسخ يقول الحوار تعذّر النسخ. حدّد نص المسودة وانسخه. تبقى مسودتك في الصندوق حتى تستبدلها أو تتجاهلها.
إن لم يسر الأمر كما توقعت
«اختر التزامي بداية النطاق ونهايته.»
من أو إلى ليسا إيداعًا بعد. اختر إيداعين، أو وسمًا يشير إلى إيداع. اسم فرع لا يُحسم لن يولّد مسودة.
«لا يشير أي وسم إصدار إلى بداية النطاق المستثناة.»
لا شيء لتزاد. اختر الإصدار التالي بنفسك، أو ضع وسمًا على الإيداع المستثنى وأنشئ المسودة مجددًا.
«تشير وسوم إصدارات مختلفة إلى بداية النطاق المستثناة. اختر الإصدار الأساسي.»
أكثر من وسم إصدار على ذلك الإيداع. اختر الأساس الذي تقصده. GitTree لا يخمّن أي وسم هو إصدار المنتج.
«الإصدار الأساسي تجريبي. اختر قناة الإصدار ورقمه.»
وسم تجريبي لا يفرض الرقم المستقر التالي. اختر القناة والرقم ثم أبقِ المسودة.
«تعذّر النسخ. حدّد نص المسودة وانسخه.»
رُفضت الحافظة. حدّد Markdown في الصندوق وانسخه باختصار النظام. المسودة ما زالت هناك.
أسئلة
هل تنشئ مسودة سجل التغييرات إصدارًا؟
لا. تقول الملاحظة إن شيئًا لن يُنشر. تنسخ Markdown أو تدرجها في ملاحظات الإصدار. أنت من يضع الوسم وينشر.
أي إيداعات تُشمل؟
مسار الأب الأول من الطرف المستثنى حتى الطرف المشمول. إيداعات فرع مدموج يمثّلها إيداع الدمج.
لماذا لا يوجد إصدار مقترح؟
يحجب الحوار الاقتراح حين يغيب وسم الأساس أو يلتبس أو يكون تجريبيًا، أو حين تحتاج الرسائل العادية والتراجع والدمج والرسائل غير المقروءة مراجعة، أو حين لا يمكن زيادة جزء من الرقم.
هل تبقى تعديلاتي مع نطاق جديد؟
نعم حتى تستبدلها. يقول الحوار إن مسودتك المحرّرة محفوظة. استبدال المسودة بالمقترح يكتب النص الجديد فوقها.
هل يجب استخدام Conventional Commits؟
لا. الرسائل العادية تُدرج تحت تحتاج إلى مراجعة. المجموعات والإصدار المقترح أدق حين تستخدم الموضوعات feat وfix وعلامة كسر التوافق.