.TH "hub-release" "1" "12 Jul 2024" "hub version 2.14.2" "hub manual"
.nh
.ad l
.SH "نام (NAME)"
hub\-release \- مدیریت انتشارهای GitHub برای مخزن جاری
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fB\fChub release\fR [\-\-include\-drafts] [\-\-exclude\-prereleases] [\-L \fILIMIT\fP] [\-f \fIFORMAT\fP]
.br
\fB\fChub release\fR show [\-f \fIFORMAT\fP] \fITAG\fP
.br
\fB\fChub release\fR create [\-dpoc] [\-a \fIFILE\fP] [\-m \fIMESSAGE\fP|\-F \fIFILE\fP] [\-t \fITARGET\fP] \fITAG\fP
.br
\fB\fChub release\fR edit [\fIoptions\fP] \fITAG\fP
.br
\fB\fChub release\fR download \fITAG\fP [\-i \fIPATTERN\fP]
.br
\fB\fChub release\fR delete \fITAG\fP
.SH "دستورها (COMMANDS)"
.P
بدون هیچ آرگومانی، فهرستی از انتشارهای موجود را نمایش می‌دهد.
.PP
\fIshow\fP
.RS 4
نمایش یادداشت‌های انتشار GitHub برای \fITAG\fP.
.sp
با \fB\fC\-\-show\-downloads\fR، بخش "Downloads" نیز گنجانده می‌شود.
.RE
.PP
\fIcreate\fP
.RS 4
ایجاد یک انتشار GitHub برای نام \fITAG\fP مشخص‌شده. اگر برچسب git با نام \fITAG\fP
وجود نداشته باشد، روی \fITARGET\fP ایجاد خواهد شد (پیش‌فرض: شاخهٔ جاری).
.RE
.PP
\fIedit\fP
.RS 4
ویرایش انتشار GitHub برای نام \fITAG\fP مشخص‌شده. همان گزینه‌های
دستور \fIcreate\fP را می‌پذیرد. انتشار یک پیش‌نویس با \fB\fC\-\-draft=false\fR.
.sp
بدون \fB\fC\-\-message\fR یا \fB\fC\-\-file\fR، یک ویرایشگر متن باز خواهد شد که
از قبل با عنوان و بدنهٔ انتشار فعلی پر شده است. برای استفادهٔ مجدد از عنوان و بدنهٔ
موجود بدون تغییر، \fB\fC\-m ""\fR را ارسال کنید.
.RE
.PP
\fIdownload\fP
.RS 4
بارگیری دارایی‌های (assets) پیوست‌شده به انتشار برای \fITAG\fP مشخص‌شده.
.RE
.PP
\fIdelete\fP
.RS 4
حذف انتشار و دارایی‌های مرتبط با آن برای \fITAG\fP مشخص‌شده. توجه داشته باشید
که این دستور برچسب git با نام \fITAG\fP را حذف \fBنمی‌کند\fP.
.RE
.br
.SH "گزینه‌ها (OPTIONS)"
.PP
\-d, \-\-include\-drafts
.RS 4
فهرست کردن پیش‌نویس‌ها در کنار انتشارهای منتشرشده.
.RE
.PP
\-p, \-\-exclude\-prereleases
.RS 4
مستثنی کردن پیش‌انتشارها از فهرست.
.RE
.PP
\-L, \-\-limit
.RS 4
نمایش تنها به تعداد \fILIMIT\fP انتشار اول.
.RE
.PP
\-d, \-\-draft
.RS 4
ایجاد یک انتشار پیش‌نویس.
.RE
.PP
\-p, \-\-prerelease
.RS 4
ایجاد یک پیش‌انتشار.
.RE
.PP
\-a, \-\-attach \fIFILE\fP
.RS 4
پیوست کردن یک فایل به عنوان دارایی (asset) برای این انتشار.
.sp
اگر \fIFILE\fP در قالب "\fIfilename\fP#\fItext\fP" باشد، متن پس از نویسهٔ "#"
به عنوان برچسب دارایی در نظر گرفته می‌شود.
.RE
.PP
\-m, \-\-message \fIMESSAGE\fP
.RS 4
متن تا نخستین خط خالی در \fIMESSAGE\fP به عنوان عنوان انتشار در نظر گرفته
شده و مابقی آن به عنوان توضیحات انتشار در قالب Markdown استفاده می‌شود.
.sp
هنگامی که چندین \fB\fC\-\-message\fR ارسال شود، مقادیر آن‌ها با یک خط خالی
در میانشان به یکدیگر متصل می‌شوند.
.sp
اگر نه \fB\fC\-\-message\fR و نه \fB\fC\-\-file\fR به \fB\fCrelease create\fR داده نشوند، یک
ویرایشگر متن برای نوشتن عنوان و توضیحات باز خواهد شد.
.RE
.PP
\-F, \-\-file \fIFILE\fP
.RS 4
خواندن عنوان و توضیحات انتشار از \fIFILE\fP. برای خواندن از ورودی استاندارد
به جای فایل، "\-" را ارسال کنید. برای قواعد قالب‌بندی به \fB\fC\-\-message\fR مراجعه کنید.
.RE
.PP
\-e, \-\-edit
.RS 4
باز کردن عنوان و توضیحات انتشار در یک ویرایشگر متن پیش از ارسال نهایی.
این گزینه می‌تواند در ترکیب با \fB\fC\-\-message\fR یا \fB\fC\-\-file\fR استفاده شود.
.RE
.PP
\-o, \-\-browse
.RS 4
باز کردن انتشار جدید در مرورگر وب.
.RE
.PP
\-c, \-\-copy
.RS 4
قرار دادن نشانی (URL) انتشار جدید در کلیپ‌بورد به جای چاپ کردن آن.
.RE
.PP
\-t, \-\-commitish \fITARGET\fP
.RS 4
یک SHA کامیت یا نام شاخه برای پیوست کردن انتشار به آن؛ تنها در صورتی
استفاده می‌شود که \fITAG\fP از قبل وجود نداشته باشد (پیش‌فرض: شاخهٔ اصلی).
.RE
.PP
\-i, \-\-include \fIPATTERN\fP
.RS 4
پالایش فایل‌های انتشار به مواردی که با الگوی تطابق \fIPATTERN\fP همخوانی دارند.
.RE
.PP
\-f, \-\-format \fIFORMAT\fP
.RS 4
چاپ زیبای انتشارها با استفاده از \fIFORMAT\fP (پیش‌فرض: "%T%n"). برای جزئیات
بیشتر در مورد چگونگی استفاده از جای‌نگه‌دارها در قالب، بخش "PRETTY FORMATS"
از git\-log(1) را ببینید. جای‌نگه‌دارهای موجود عبارتند از:
.sp
%U: نشانی (URL) این انتشار
.sp
%uT: نشانی tarball
.sp
%uZ: نشانی zipball
.sp
%uA: نشانی بارگذاری دارایی
.sp
%S: وضعیت (مانند "draft"، "pre\-release")
.sp
%sC: تنظیم رنگ به زرد یا قرمز، بسته به وضعیت
.sp
%t: نام انتشار
.sp
%T: برچسب انتشار
.sp
%b: بدنه
.sp
%as: فهرست دارایی‌های پیوست‌شده به این انتشار
.sp
%cD: فقط تاریخ ایجاد (بدون زمان و ساعت روز)
.sp
%cr: تاریخ ایجاد، نسبی
.sp
%ct: تاریخ ایجاد، برچسب زمانی UNIX
.sp
%cI: تاریخ ایجاد، در قالب ISO 8601
.sp
%pD: فقط تاریخ انتشار (بدون زمان و ساعت روز)
.sp
%pr: تاریخ انتشار، نسبی
.sp
%pt: تاریخ انتشار، برچسب زمانی UNIX
.sp
%pI: تاریخ انتشار، در قالب ISO 8601
.sp
%n: خط جدید
.sp
%%: نویسهٔ خود %
.RE
.PP
\-\-color[=\fIWHEN\fP]
.RS 4
فعال کردن خروجی رنگی حتی اگر stdout یک ترمینال نباشد. \fIWHEN\fP می‌تواند یکی
از مقادیر "always" (پیش‌فرض برای \fB\fC\-\-color\fR)، "never"، یا "auto" (پیش‌فرض) باشد.
.RE
.PP
\fITAG\fP
.RS 4
نام برچسب git برای این انتشار.
.RE
.br
.SH "همچنین ببینید (SEE ALSO)"
.P
hub(1), git\-tag(1)