هذا هو الأمر git-tag الذي يمكن تشغيله في مزود الاستضافة المجانية OnWorks باستخدام إحدى محطات العمل المجانية المتعددة على الإنترنت مثل Ubuntu Online أو Fedora Online أو محاكي Windows عبر الإنترنت أو محاكي MAC OS عبر الإنترنت
برنامج:
اسم
git-tag - إنشاء أو سرد أو حذف أو التحقق من كائن علامة موقّع مع GPG
موجز
طائرة نفاثة بطاقة [-a | -s | -u ] [-f] [-m | -F ]
[ | ]
طائرة نفاثة بطاقة -د ...
طائرة نفاثة بطاقة [-ن[ ]] -l [- يحتوي على ] [- نقاط في ]
[- العمود [= ] | --لا عمود] [- إنشاء إعادة سجل] [- فرز = ]
[- تنسيق = ] [- [لا] مدمجة [ ]] [ ...]
طائرة نفاثة بطاقة -الخامس ...
الوصف
أضف مرجع علامة في refs / tags / ، ما لم يُعطى -d / -l / -v للحذف أو القائمة أو التحقق
العلامات.
ما لم يتم إعطاء -f ، يجب ألا تكون العلامة المسماة موجودة بعد.
إذا كانت واحدة من -a أو -s أو -u يتم تمرير الأمر بإنشاء ملف بطاقة وجوه ، ويتطلب
رسالة علامة. ما لم - م أو -F يتم تشغيل محرر للمستخدم
اكتب في رسالة العلامة.
إذا كان- م أو -F يتم إعطاء و -a و -s و -u غائبون ، ضمنيًا - أ.
وبخلاف ذلك ، يتم إنشاء مرجع علامة لاسم كائن SHA-1 لكائن الالتزام
(أي علامة خفيفة الوزن).
سيتم إنشاء كائن علامة GnuPG موقّع عندما -s أو -u يستخدم. متى -u
لم يتم استخدامه ، يتم استخدام هوية المرسل للمستخدم الحالي للعثور على مفتاح GnuPG لـ
التوقيع. يتم استخدام متغير التكوين gpg.program لتحديد برنامج GnuPG الثنائي المخصص.
تسمى كائنات العلامات (التي تم إنشاؤها باستخدام -a أو -s أو -u) بالعلامات "المشروحة" ؛ أنها تحتوي على
تاريخ الإنشاء واسم الوسم والبريد الإلكتروني ورسالة وضع العلامات و GnuPG اختياري
التوقيع. في حين أن العلامة "lightweight" هي مجرد اسم لكائن (عادةً ما يكون التزامًا
موضوع).
العلامات التوضيحية مخصصة للإصدار بينما العلامات خفيفة الوزن مخصصة للخاصة أو
تسميات الكائن المؤقتة. لهذا السبب ، فإن بعض أوامر git لتسمية الكائنات (مثل git
Description) ستتجاهل العلامات الخفيفة افتراضيًا.
OPTIONS
- أ ، - علق
جعل كائن علامة غير موقعة ومشروح
-s ، - تسجيل
قم بعمل علامة موقعة من GPG ، باستخدام مفتاح عنوان البريد الإلكتروني الافتراضي.
-u ، --المستخدم المحلي =
قم بعمل علامة موقعة من GPG ، باستخدام المفتاح المحدد.
-f ، - القوة
استبدال علامة موجودة بالاسم المحدد (بدلاً من الفشل)
- د ، - حذف
حذف العلامات الموجودة مع الأسماء المحددة.
-v ، - تحقق
تحقق من توقيع gpg لأسماء العلامات المحددة.
-ن
يحدد عدد الأسطر من التعليق التوضيحي ، إن وجد ، التي تتم طباعتها عند استخدام -l.
الإعداد الافتراضي هو عدم طباعة أي سطور من التعليقات التوضيحية. إذا لم يتم إعطاء أي رقم لـ -n ، فقط
تتم طباعة السطر الأول. إذا لم يتم إضافة تعليق توضيحي على العلامة ، تكون رسالة التنفيذ
عرض بدلا من ذلك.
-ل ، --قائمة
سرد العلامات ذات الأسماء التي تتطابق مع النمط المحدد (أو جميعها إذا لم يتم تقديم نمط).
يؤدي تشغيل "git tag" بدون وسيطات إلى إدراج جميع العلامات أيضًا. النمط هو قذيفة
wildcard (على سبيل المثال ، المطابقة باستخدام com.fnmatch(3)). يمكن إعطاء أنماط متعددة ؛ إذا كان أي من
تطابقهم ، يتم عرض العلامة.
- فرز =
فرز على أساس المفتاح المعطى. بادئة - للفرز بترتيب تنازلي للقيمة. أنت
قد تستخدم --sort = الخيار عدة مرات ، وفي هذه الحالة يصبح المفتاح الأخير هو
المفتاح الأساسي. يدعم أيضًا "الإصدار: refname" أو "v: refname" (يتم التعامل مع أسماء العلامات على أنها
الإصدارات). يمكن أيضًا أن يتأثر ترتيب الفرز "version: refname" بامتداد
متغير تكوين "versionort.prereleaseSuffix". المفاتيح المدعومة هي نفسها
مثل تلك الموجودة في git for-each-ref. ترتيب الفرز الافتراضي هو القيمة المكونة لملف
الوسم متغير إذا كان موجودًا ، أو ترتيب معجمي بطريقة أخرى. ارى بوابة التكوين(1).
- العمود [= ] ، - بلا عمود
عرض قائمة العلامات في الأعمدة. انظر متغير التكوين column.tag للخيار
بناء الجملة. - عمود و - بلا عمود بدون خيارات يكافئ دائما و أبدا
على التوالي.
هذا الخيار قابل للتطبيق فقط عند سرد العلامات بدون سطور التعليقات التوضيحية.
--يحتوي على [ ]
قم فقط بإدراج العلامات التي تحتوي على الالتزام المحدد (إذا لم يتم تحديد HEAD).
- نقاط في
فقط قائمة علامات الكائن المحدد.
م ، - الرسالة =
استخدم رسالة العلامة المحددة (بدلاً من المطالبة). إذا تم إعطاء خيارات متعددة ،
قيمها متسلسلة كفقرات منفصلة. يشير إلى -a في حالة عدم وجود أي من -a أو -s أو
-u معطى.
-F ، - ملف =
خذ رسالة العلامة من الملف المحدد. يستخدم - لقراءة الرسالة من المعيار
إدخال. يشير إلى -a في حالة عدم وجود أي من -a أو -s أو -u معطى.
- تنظيف =
يحدد هذا الخيار كيفية تنظيف رسالة العلامة. ال يمكن أن تكون واحدة من حرفيا,
بيضاء و قطاع. قطاع الوضع الافتراضي. ال حرفيا الوضع لا يتغير
الرسالة على الإطلاق ، بيضاء يزيل فقط خطوط المسافات البيضاء البادئة / اللاحقة و قطاع
يزيل كل من المسافة البيضاء والتعليق.
--إنشاء إعادة التدوين
إنشاء إعادة تسجيل للعلامة.
اسم العلامة المراد إنشاؤها أو حذفها أو وصفها. يجب أن يمر اسم العلامة الجديد بكل شيء
الشيكات المحددة من قبل git-check-ref-format(1). بعض هذه الفحوصات قد تقيد
الأحرف المسموح بها في اسم العلامة.
و
الكائن الذي ستشير إليه العلامة الجديدة ، عادة ما يكون التزامًا. افتراضات إلى HEAD.
سلسلة تقحم٪ (اسم الحقل) من الكائن المشار إليه بواسطة مرجع
مبين. التنسيق هو نفسه تنسيق بوابة لكل المرجع(1). عندما غير محدد ،
الافتراضيات إلى٪ (اسم المرجع: الشريط = 2).
- [لا] مدمجة [ ]
قم فقط بإدراج العلامات التي يمكن الوصول إلى نصائحها ، أو التي لا يمكن الوصول إليها إذا كان --لا مندمجة يستخدم من
الالتزام المحدد (هيد إذا لم يتم تحديدها).
CONFIGURATION
افتراضيا، طائرة نفاثة بطاقة in Sign-with-default mode (-s) سوف تستخدم هوية المتعهد الخاصة بك (من
شكل اسمك[البريد الإلكتروني محمي]>) للعثور على مفتاح. إذا كنت تريد استخدام ملف
المفتاح الافتراضي ، يمكنك تحديده في تكوين المستودع على النحو التالي:
[العضو]
مفتاح التوقيع =
مناقشة
On إعادة وضع العلامات
ما الذي يجب عليك فعله عند وضع علامة على التزام خاطئ وتريد إعادة وضع علامة عليه؟
إذا لم تدفع أي شيء للخارج ، فما عليك سوى إعادة وضع علامة عليه. استخدم "-f" لتحل محل القديم. و
انت انتهيت.
ولكن إذا قمت بإخراج الأشياء (أو كان بإمكان الآخرين قراءة المستودع الخاص بك مباشرةً) ،
ثم سيكون الآخرون قد رأوا بالفعل العلامة القديمة. في هذه الحالة ، يمكنك القيام بأحد أمرين:
1. الشيء العاقل. فقط اعترف أنك أخطأت واستخدم اسمًا مختلفًا. البعض الآخر
رأيت بالفعل اسمًا واحدًا ، وإذا احتفظت بنفس الاسم ، فقد تكون في الموقف
أن كلاهما لديه "الإصدار X" ، لكنهما يمتلكان بالفعل مختلف "X". اذن فقط
أطلق عليها اسم "X.1" وانتهى من الأمر.
2. الشيء المجنون. تريد حقًا استدعاء الإصدار الجديد "X" أيضًا ، حتى رغم أن وغيرها
لقد رأيت بالفعل القديم. لذا فقط استخدم طائرة نفاثة بطاقة -f مرة أخرى ، كما لو كنت لم تفعل ذلك بالفعل
نشر القديم.
ومع ذلك ، يفعل Git ليست (ولا ينبغي) تغيير العلامات الموجودة خلف المستخدمين. لذلك إذا كان شخص ما
حصلت بالفعل على العلامة القديمة ، وأداء طائرة نفاثة سحب على شجرتك لا يجب فقط استبدالها
القديم.
إذا حصل شخص ما على علامة تحرير منك ، فلا يمكنك فقط تغيير العلامة الخاصة به
تحديث واحد الخاص بك. هذه مشكلة أمنية كبيرة ، حيث يجب أن يكون الناس قادرين على الثقة
أسماء العلامات الخاصة بهم. إذا كنت تريد فعل الشيء المجنون حقًا ، فأنت بحاجة إلى الاعتراف بذلك
وأخبر الناس أنك أخطأت. يمكنك القيام بذلك عن طريق جعل الجمهور
إعلان يقول:
حسنًا ، لقد أخطأت ، ودفعت إصدارًا سابقًا يحمل علامة X.
ثم أصلح شيئًا ما ، وأعد وضع علامة على الشجرة * الثابتة * كـ X مرة أخرى.
إذا حصلت على العلامة الخاطئة ، وتريد العلامة الجديدة ، يرجى حذفها
القديم وجلب الجديد من خلال القيام بما يلي:
بوابة العلامة -d X
git جلب علامة الأصل X
للحصول على علامتي المحدثة.
يمكنك اختبار العلامة التي لديك عن طريق العمل
بوابة rev-parse X
والتي يجب أن ترجع 0123456789abcdef .. إذا كان لديك الإصدار الجديد.
نأسف للإزعاج.
هل يبدو هذا معقدًا بعض الشيء؟ هو - هي ينبغي يكون. لا توجد طريقة أن يكون ذلك صحيحًا
لمجرد "إصلاحه" تلقائيًا. يحتاج الناس إلى معرفة أن علاماتهم ربما كانت كذلك
تغيرت.
On أوتوماتيك متابعيك
إذا كنت تتبع شجرة شخص آخر ، فأنت على الأرجح تستخدم التتبع عن بعد
الفروع (المراجع / الرؤوس / الأصل في التخطيط التقليدي ، أو المراجع / أجهزة التحكم عن بعد / الأصل / الماجستير في
تخطيط منفصل عن بعد). عادة ما تريد العلامات من الطرف الآخر.
من ناحية أخرى ، إذا كنت تقوم بالجلب لأنك تريد دمج طلقة واحدة من
شخصًا آخر ، لا تريد عادةً الحصول على علامات من هناك. هذا يحدث في كثير من الأحيان
للأشخاص بالقرب من المستوى الأعلى ولكن لا يقتصر عليهم. مجرد بشر عند الانسحاب من كل
البعض الآخر لا يريد بالضرورة الحصول تلقائيًا على علامات نقطة ربط خاصة من ملف
شخص آخر.
في كثير من الأحيان ، "الرجاء سحب" الرسائل الموجودة في القائمة البريدية فقط قم بتوفير نوعين من المعلومات:
عنوان URL للريبو واسم الفرع ؛ تم تصميم هذا ليتم قصه ولصقه بسهولة في نهاية ملف طائرة نفاثة
جلب سطر الأوامر:
لينوس ، من فضلك اسحب من
بوابة: //git..../proj.git سيد
للحصول على التحديثات التالية ...
يصبح:
git pull git $: //git..../proj.git master
في مثل هذه الحالة ، لا تريد أن تتبع علامات الشخص الآخر تلقائيًا.
أحد الجوانب المهمة لـ Git هو طبيعتها الموزعة ، والتي تعني إلى حد كبير عدم وجودها
متأصل "المنبع" أو "المصب" في النظام. في ظاهرها ، المثال أعلاه
قد يبدو أنه يشير إلى أن مساحة اسم العلامة مملوكة للطبقة العليا من الأشخاص و
تتدفق العلامات إلى الأسفل فقط ، ولكن هذا ليس هو الحال. يظهر فقط أن الاستخدام
يحدد النمط الأشخاص المهتمين بعلاماتهم.
السحب بجرعة واحدة هو علامة على أن تاريخ الالتزام يتجاوز الآن الحد الفاصل بين أحدهما
دائرة من الأشخاص (على سبيل المثال ، "الأشخاص المهتمون بشكل أساسي بجزء الشبكات من
kernel ") الذين قد يكون لديهم مجموعة من العلامات الخاصة بهم (على سبيل المثال ،" هذا هو الإصدار الثالث المرشح
من مجموعة الشبكات التي سيتم اقتراحها للاستهلاك العام مع إصدار 2.6.21 ") إلى
دائرة أخرى من الناس (على سبيل المثال "الأشخاص الذين يقومون بدمج تحسينات النظام الفرعي المختلفة"). ال
لا يهتم الأخيرون عادةً بالعلامات التفصيلية المستخدمة داخليًا في المجموعة الأولى
(هذا ما تعنيه كلمة "داخلي"). هذا هو السبب في أنه من المستحسن عدم اتباع العلامات
تلقائيًا في هذه الحالة.
قد يكون من الجيد أنه من بين الأشخاص المتصلين بالشبكة ، قد يرغبون في تبادل العلامات الداخلية
لمجموعتهم ، ولكن في سير العمل هذا ، من المرجح أن يتتبعوا تقدم بعضهم البعض
من خلال وجود فروع تتبع عن بعد. مرة أخرى ، مجريات الأمور لمتابعة هذه العلامات تلقائيًا
هو شيء جيد.
On رجوع مصطلحات البحث
إذا قمت باستيراد بعض التغييرات من VCS آخر وترغب في إضافة علامات لـ major
إصدارات من عملك ، من المفيد أن تكون قادرًا على تحديد التاريخ المراد تضمينه داخل ملف
كائن العلامة تؤثر هذه البيانات في كائن العلامة ، على سبيل المثال ، على ترتيب العلامات في
واجهة gitweb.
لتعيين التاريخ المستخدم في كائنات العلامات المستقبلية ، قم بتعيين متغير البيئة
GIT_COMMITTER_DATE (راجع المناقشة اللاحقة للقيم المحتملة ؛ النموذج الأكثر شيوعًا هو
"YYYY-MM-DD HH: MM").
فمثلا:
$ GIT_COMMITTER_DATE = "2006-10-02 10:31" git tag -s v1.0.1
تاريخ صيغ
تدعم متغيرات البيئة GIT_AUTHOR_DATE و GIT_COMMITTER_DATE التاريخ التالي
الأشكال:
تنسيق Git الداخلي
إنها ، أين هو عدد
ثوانٍ منذ حقبة UNIX. هو تعويض إيجابي أو سلبي
من UTC. على سبيل المثال توقيت وسط أوروبا (الذي يتقدم بساعتين بالتوقيت العالمي المنسق) هو +2.
RFC 2822
تنسيق البريد الإلكتروني القياسي كما هو موضح بواسطة RFC 2822 ، على سبيل المثال الخميس ، 07 أبريل 2005
22:13:13 +0200.
ISO 8601
الوقت والتاريخ المحددين بواسطة معيار ISO 8601 ، على سبيل المثال 2005-04-07T22: 13: 13. ال
يقبل المحلل اللغوي مسافة بدلاً من حرف T أيضًا.
ملاحظات
بالإضافة إلى ذلك ، يتم قبول جزء التاريخ بالتنسيقات التالية: YYYY.MM.DD،
MM / DD / YYYY و DD.MM.YYYY.
استخدم git-tag عبر الإنترنت باستخدام خدمات onworks.net
