'\" t
.\"     Title: git-mktag
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-MKTAG" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-mktag \- ایجاد یک شیء تگ با اعتبارسنجی کامل داده‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit mktag\fR
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
محتویات یک تگ را از ورودی استاندارد می‌خواند و یک شیء تگ ایجاد می‌کند\&. خروجی، شناسه <object> تگ جدید است\&.
.sp
این دستور تا حد زیادی معادل اجرای دستور
\fBgit-hash-object\fR(1)
همراه با گزینه‌های
\fB\-t\fR \fBtag\fR \fB\-w\fR \fB\-\-stdin\fR
است؛ به این معنا که هر دوی آن‌ها تگ موجود در
\fBmy\-tag\fR
را ایجاد کرده و می‌نویسند:
.sp
.if n \{\
.RS 4
.\}
.nf
git mktag <my\-tag
git hash\-object \-t tag \-w \-\-stdin <my\-tag
.fi
.if n \{\
.RE
.\}
.sp
تفاوت در این است که اگر تگ از بررسی
\fBgit-fsck\fR(1)
عبور نکند، mktag پیش از نوشتن تگ با خطا متوقف می‌شود\&.
.sp
بررسی "fsck" انجام‌شده توسط mktag سخت‌گیرانه‌تر از آن چیزی است که
\fBgit-fsck\fR(1)
به‌طور پیش‌فرض اجرا می‌کند؛ چرا که تمام پیام‌های
\fBfsck\&.\fR\fI<msg\-id>\fR
از هشدار به خطا ارتقا می‌یابند (به عنوان مثال، نبود سطر "tagger" یک خطا محسوب می‌شود)\&.
.sp
همچنین وجود هدرهای اضافی در شیء، تحت mktag یک خطا محسوب می‌شود، در حالی که توسط
\fBgit-fsck\fR(1)
نادیده گرفته می‌شوند\&. این بررسی اضافی را می‌توان با تنظیم متغیر مناسب
\fBfsck\&.\fR\fI<msg\-id>\fR
غیرفعال کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
git \-c fsck\&.extraHeaderEntry=ignore mktag <my\-tag\-with\-headers
.fi
.if n \{\
.RE
.\}
.SH "گزینه‌ها (OPTIONS)"
.PP
\-\-strict
.RS 4
به‌طور پیش‌فرض mktag معادل حالت
\fB\-\-strict\fR
در
\fBgit-fsck\fR(1)
را فعال می‌کند\&. برای غیرفعال کردن آن از
\fB\-\-no\-strict\fR
استفاده کنید\&.
.RE
.SH "قالب تگ (TAG FORMAT)"
.sp
یک فایل امضای تگ، که به ورودی استاندارد این دستور داده می‌شود، قالبی بسیار ساده و ثابت دارد: چهار سطر شامل
.sp
.if n \{\
.RS 4
.\}
.nf
object <hash>
type <typename>
tag <tagname>
tagger <tagger>
.fi
.if n \{\
.RE
.\}
.sp
که پس از آن یک پیام با قالب دلخواه به‌صورت اختیاری
(\fIoptional\fR)
قرار می‌گیرد (برخی تگ‌های ایجادشده توسط نسخه‌های قدیمی‌تر گیت ممکن است سطر
\fBtagger\fR
را نداشته باشند)\&. پیام، در صورت وجود، با یک سطر خالی از هدر جدا می‌شود\&. بخش پیام ممکن است شامل امضایی باشد که خود گیت به آن اهمیتی نمی‌دهد، اما می‌توان آن را با gpg اعتبارسنجی کرد\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-tag\fR(1), \fBgit-hash-object\fR(1), \fBgit-fsck\fR(1)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)