.nh
.TH "GH-RELEASE-CREATE" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-release-create \- ایجاد یک انتشار جدید


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh release create [<tag>] [<filename>... | <pattern>...]\fR


.SH "توضیحات (DESCRIPTION)"
ایجاد یک انتشار جدید گیت‌هاب (GitHub Release) برای یک مخزن.

.PP
می‌توان فهرستی از فایل‌های دارایی (asset) را برای بارگذاری در انتشار جدید مشخص کرد. برای تعیین یک برچسب نمایشی برای دارایی، متنی را که با
.B #
شروع می‌شود پس از نام فایل درج کنید.

.PP
اگر تگ گیت منطبق از قبل وجود نداشته باشد، یک تگ به‌طور خودکار بر اساس آخرین وضعیت شاخه پیش‌فرض ایجاد می‌شود.
از گزینه
.B \-\-target
برای اشاره به شاخه یا کامیت متفاوتی جهت ساخت خودکار تگ استفاده کنید.
از گزینه
.B \-\-verify-tag
برای انصراف از فرآیند انتشار در صورتی که تگ از قبل وجود نداشته باشد استفاده کنید.
برای دریافت تگ جدید به‌صورت محلی پس از انتشار، دستور
.B git fetch \-\-tags origin
را اجرا کنید.

.PP
برای ایجاد انتشار از روی یک تگ توضیحی گیت (annotated git tag)، ابتدا آن را به‌صورت محلی با گیت بسازید، تگ را به گیت‌هاب ارسال (push) کنید، و سپس این دستور را اجرا نمایید.
از گزینه
.B \-\-notes-from-tag
برای استخراج یادداشت‌های انتشار از تگ توضیحی گیت استفاده کنید.
اگر تگ توضیحی نباشد، پیام کامیت به‌جای آن استفاده خواهد شد.

.PP
از گزینه
.B \-\-generate-notes
برای تولید خودکار یادداشت‌ها با استفاده از API یادداشت‌های انتشار گیت‌هاب استفاده کنید.
هنگام استفاده از یادداشت‌های انتشار تولیدشده به‌صورت خودکار، عنوان انتشار نیز به‌طور خودکار تولید خواهد شد مگر آن‌که عنوانی صریحاً مشخص شده باشد. با استفاده از گزینه
.B \-\-notes
می‌توانید یادداشت‌های اضافی را به ابتدای یادداشت‌های خودکار اضافه کنید.

.PP
به‌طور پیش‌فرض، انتشار حتی در صورت نبود کامیت جدید پس از آخرین انتشار ایجاد می‌شود.
این موضوع ممکن است منجر به انتشار تکراری یا یکسان شود که در برخی موارد مطلوب نیست.
از گزینه
.B \-\-fail-on-no-commits
برای متوقف کردن عملیات در صورت نبود کامیت جدید استفاده کنید. این گزینه در صورتی که هیچ انتشاری وجود نداشته باشد یا این نخستین انتشار باشد، اثری ندارد.


.SH "انتشارهای تغییرناپذیر (Immutable Releases)"
هنگامی که قابلیت تغییرناپذیری انتشار برای یک مخزن فعال باشد، محافظت‌های زیر اعمال می‌شوند:
.IP \(bu 2
تگ‌های گیت مرتبط با انتشار قابل تغییر یا حذف نیستند.
.IP \(bu 2
دارایی‌های انتشار قابل تغییر یا حذف نیستند.

.PP
تغییرناپذیری تنها پس از انتشار عمومی اعمال می‌شود. انتشارهای پیش‌نویس (draft) قابل ویرایش یا حذف هستند و تگ‌های گیت مرتبط با آن‌ها نیز می‌توانند ویرایش یا حذف شوند.

.PP
هنگام استفاده از دستور
.B create
برای پیوست کردن دارایی‌ها به انتشار، فراخوانی‌های جداگانه API برای ایجاد انتشار به‌صورت پیش‌نویس، بارگذاری دارایی‌ها و سپس انتشار عمومی آن انجام می‌شود.
محافظت‌های تغییرناپذیری صرفاً پس از عمومی شدن انتشار اعمال خواهند شد.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-discussion-category\fR \fB<string>\fR
شروع یک بحث در دسته‌بندی مشخص‌شده

.TP
\fB\-d\fR, \fB\-\-draft\fR
ذخیره انتشار به‌صورت پیش‌نویس به‌جای انتشار عمومی آن

.TP
\fB\-\-fail-on-no-commits\fR
توقف با خطا در صورت نبود کامیت جدید از زمان آخرین انتشار (روی اولین انتشار بی‌اثر است)

.TP
\fB\-\-generate-notes\fR
تولید خودکار عنوان و یادداشت‌های انتشار از طریق API یادداشت‌های انتشار گیت‌هاب

.TP
\fB\-\-latest\fR
علامت‌گذاری این انتشار به‌عنوان "Latest" (آخرین نسخه) (پیش‌فرض [خودکار بر اساس تاریخ و نسخه]). برای عدم تنظیم صریح به‌عنوان آخرین نسخه از latest=false-- استفاده کنید

.TP
\fB\-n\fR, \fB\-\-notes\fR \fB<string>\fR
یادداشت‌های انتشار

.TP
\fB\-F\fR, \fB\-\-notes-file\fR \fB<file>\fR
خواندن یادداشت‌های انتشار از فایل (از "-" برای خواندن از ورودی استاندارد استفاده کنید)

.TP
\fB\-\-notes-from-tag\fR
واکشی یادداشت‌ها از توضیحات تگ یا پیام کامیت مرتبط با تگ

.TP
\fB\-\-notes-start-tag\fR \fB<string>\fR
تگی که باید به‌عنوان نقطه شروع تولید یادداشت‌های انتشار استفاده شود

.TP
\fB\-p\fR, \fB\-\-prerelease\fR
علامت‌گذاری انتشار به‌عنوان نسخه پیش‌انتشار

.TP
\fB\-\-target\fR \fB<branch>\fR
شاخه مقصد یا شناسه SHA کامل کامیت (پیش‌فرض [شاخه اصلی main])

.TP
\fB\-t\fR, \fB\-\-title\fR \fB<string>\fR
عنوان انتشار

.TP
\fB\-\-verify-tag\fR
انصراف از عملیات در صورتی که تگ گیت از قبل در مخزن راه دور (remote) وجود نداشته باشد


.SH "گزینه‌های موروثی از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
.TP
\fB\-R\fR, \fB\-\-repo\fR \fB<[HOST/]OWNER/REPO>\fR
انتخاب مخزنی دیگر با استفاده از قالب [HOST/]OWNER/REPO


.SH "نام‌های مستعار (ALIASES)"
gh release new


.SH "کدهای خروج (EXIT CODES)"
0: اجرای موفقیت‌آمیز

.PP
1: خطا

.PP
2: دستور لغو شد

.PP
4: نیاز به احراز هویت است

.PP
نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.


.SH "مثال‌ها (EXAMPLES)"
.EX
# ایجاد یک انتشار به‌صورت تعاملی
$ gh release create

# ایجاد یک انتشار به‌صورت تعاملی از یک تگ مشخص
$ gh release create v1.2.3

# ایجاد یک انتشار به‌صورت غیرتعاملی
$ gh release create v1.2.3 --notes "bugfix release"

# استفاده از یادداشت‌های تولیدشده به‌صورت خودکار از طریق API یادداشت‌های انتشار گیت‌هاب
$ gh release create v1.2.3 --generate-notes

# استفاده از یادداشت‌های انتشار از یک فایل
$ gh release create v1.2.3 -F release-notes.md

# استفاده از توضیحات تگ یا پیام کامیت مرتبط به‌عنوان یادداشت انتشار
$ gh release create v1.2.3 --notes-from-tag

# عدم علامت‌گذاری انتشار به‌عنوان آخرین نسخه
$ gh release create v1.2.3 --latest=false

# بارگذاری تمام فایل‌های فشرده tarball در یک پوشه به‌عنوان دارایی‌های انتشار
$ gh release create v1.2.3 ./dist/*.tgz

# بارگذاری یک دارایی انتشار به همراه برچسب نمایشی
$ gh release create v1.2.3 '/path/to/asset.zip#My display label'

# ایجاد یک انتشار و شروع یک بحث
$ gh release create v1.2.3 --discussion-category "General"

# ایجاد انتشار تنها در صورتی که کامیت‌های جدیدی پس از آخرین انتشار موجود باشد
$ gh release create v1.2.3 --fail-on-no-commits

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBgh-release(1)\fR