.TH "hub-issue" "1" "12 Jul 2024" "hub version 2.14.2" "hub manual"
.nh
.ad l
.SH "نام (NAME)"
hub\-issue \- مدیریت Issueهای GitHub برای مخزن جاری.
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fB\fChub issue\fR [\-a \fIASSIGNEE\fP] [\-c \fICREATOR\fP] [\-@ \fIUSER\fP] [\-s \fISTATE\fP] [\-f \fIFORMAT\fP] [\-M \fIMILESTONE\fP] [\-l \fILABELS\fP] [\-d \fIDATE\fP] [\-o \fISORT\_KEY\fP [\fB\fC\-^\fR]] [\-L \fILIMIT\fP]
.br
\fB\fChub issue\fR show [\-f \fIFORMAT\fP] \fINUMBER\fP
.br
\fB\fChub issue\fR create [\-oc] [\-m \fIMESSAGE\fP|\-F \fIFILE\fP] [\-\-edit] [\-a \fIUSERS\fP] [\-M \fIMILESTONE\fP] [\-l \fILABELS\fP]
.br
\fB\fChub issue\fR update \fINUMBER\fP [\-m \fIMESSAGE\fP|\-F \fIFILE\fP] [\-\-edit] [\-a \fIUSERS\fP] [\-M \fIMILESTONE\fP] [\-l \fILABELS\fP] [\-s \fISTATE\fP]
.br
\fB\fChub issue\fR labels [\-\-color]
.br
\fB\fChub issue\fR transfer \fINUMBER\fP \fIREPO\fP
.SH "دستورها (COMMANDS)"
.P
بدون هیچ آرگومانی، فهرستی از issueهای باز را نمایش می‌دهد.
.PP
\fIshow\fP
.RS 4
نمایش یک issue موجود مشخص‌شده با \fINUMBER\fP.
.RE
.PP
\fIcreate\fP
.RS 4
ایجاد یک issue در مخزن جاری.
.RE
.PP
\fIupdate\fP
.RS 4
به‌روزرسانی فیلدهای یک issue موجود مشخص‌شده با \fINUMBER\fP. از \fB\fC\-\-edit\fR
برای ویرایش تعاملی عنوان و پیام در ویرایشگر متن استفاده کنید.
.RE
.PP
\fIlabels\fP
.RS 4
فهرست کردن برچسب‌های موجود در این مخزن.
.RE
.PP
\fItransfer\fP
.RS 4
انتقال یک issue به مخزنی دیگر.
.RE
.br
.SH "گزینه‌ها (OPTIONS)"
.PP
\-a, \-\-assignee \fIASSIGNEE\fP
.RS 4
در حالت فهرست، فقط issueهایی را نمایش می‌دهد که به \fIASSIGNEE\fP واگذار شده‌اند.
.RE
.PP
\-a, \-\-assign \fIUSERS\fP
.RS 4
فهرستی جداشده با کاما از شناسه‌های GitHub برای انتساب به issue ایجادشده.
.RE
.PP
\-c, \-\-creator \fICREATOR\fP
.RS 4
فقط issueهای ایجادشده توسط \fICREATOR\fP را نمایش می‌دهد.
.RE
.PP
\-@, \-\-mentioned \fIUSER\fP
.RS 4
فقط issueهایی را نمایش می‌دهد که در آن‌ها به \fIUSER\fP اشاره شده است.
.RE
.PP
\-s, \-\-state \fISTATE\fP
.RS 4
نمایش issueها با وضعیت \fISTATE\fP (پیش‌فرض: "open").
.RE
.PP
\-f, \-\-format \fIFORMAT\fP
.RS 4
چاپ آراسته محتویات issueها با استفاده از قالب \fIFORMAT\fP (پیش‌فرض:
"%sC%>(8)%i%Creset  %t%  l%n"). برای جزئیات تکمیلی در مورد نحوه استفاده از متغیرهای جانگهدار در
قالب، بخش "PRETTY FORMATS" در git\-log(1) را ببینید. جانگهدارنده‌های موجود برای issueها عبارتند از:
.sp
%I: شماره issue
.sp
%i: شماره issue با پیشوند "#"
.sp
%U: نشانی URL این issue
.sp
%S: وضعیت (مانند "open" یا "closed")
.sp
%sC: تنظیم رنگ به قرمز یا سبز، بسته به وضعیت issue.
.sp
%t: عنوان
.sp
%l: برچسب‌های رنگی
.sp
%L: برچسب‌های خام جداشده با کاما
.sp
%b: متن بدنه
.sp
%au: نام کاربری نویسنده
.sp
%as: فهرست جداشده با کاما از افراد واگذارشده
.sp
%Mn: شماره milestone
.sp
%Mt: عنوان milestone
.sp
%NC: تعداد دیدگاه‌ها
.sp
%Nc: تعداد دیدگاه‌ها درون پرانتز، یا یک رشته خالی در صورت صفر بودن.
.sp
%cD: فقط تاریخ ایجاد (بدون ساعت)
.sp
%cr: تاریخ ایجاد، نسبی
.sp
%ct: تاریخ ایجاد، برچسب زمانی UNIX
.sp
%cI: تاریخ ایجاد، در قالب ISO 8601
.sp
%uD: فقط تاریخ به‌روزرسانی (بدون ساعت)
.sp
%ur: تاریخ به‌روزرسانی، نسبی
.sp
%ut: تاریخ به‌روزرسانی، برچسب زمانی UNIX
.sp
%uI: تاریخ به‌روزرسانی، در قالب ISO 8601
.sp
%n: خط جدید
.sp
%%: نویسه واقعی %
.RE
.PP
\-\-color[=\fIWHEN\fP]
.RS 4
فعال‌سازی خروجی رنگی حتی اگر stdout یک ترمینال نباشد. مقدار \fIWHEN\fP می‌تواند یکی
از "always" (پیش‌فرض برای \fB\fC\-\-color\fR)، "never" یا "auto" (پیش‌فرض) باشد.
.RE
.PP
\-m, \-\-message \fIMESSAGE\fP
.RS 4
متن موجود تا نخستین خط خالی در \fIMESSAGE\fP به عنوان عنوان issue در نظر گرفته می‌شود
و باقی‌مانده به عنوان شرح issue در قالب Markdown استفاده می‌شود.
.sp
هنگامی که چند گزینه \fB\fC\-\-message\fR داده شود، مقادیر آن‌ها با یک خط خالی در میانشان الحاق می‌شوند.
.sp
اگر هیچ‌کدام از گزینه‌های \fB\fC\-\-message\fR یا \fB\fC\-\-file\fR به \fB\fCissue create\fR داده نشوند، یک
ویرایشگر متن برای نوشتن عنوان و شرح باز خواهد شد.
.RE
.PP
\-F, \-\-file \fIFILE\fP
.RS 4
خواندن عنوان و شرح issue از \fIFILE\fP. برای خواندن از ورودی استاندارد، "\-" را ارسال کنید.
برای قواعد قالب‌بندی به \fB\fC\-\-message\fR مراجعه کنید.
.RE
.PP
\-e, \-\-edit
.RS 4
باز کردن عنوان و شرح issue در یک ویرایشگر متن پیش از ارسال نهایی.
این گزینه می‌تواند در ترکیب با \fB\fC\-\-message\fR یا \fB\fC\-\-file\fR استفاده شود.
.RE
.PP
\-o, \-\-browse
.RS 4
باز کردن issue جدید در یک مرورگر وب.
.RE
.PP
\-c, \-\-copy
.RS 4
قرار دادن نشانی URL مربوط به issue جدید در کلیپ‌بورد به جای چاپ آن در خروجی.
.RE
.PP
\-M, \-\-milestone \fINAME\fP
.RS 4
فقط نمایش issueهای متعلق به یک milestone در GitHub با نام \fINAME\fP.
.sp
هنگام ایجاد یک issue، این issue به یک milestone در GitHub با نام \fINAME\fP افزوده می‌شود.
ارسال شماره milestone منسوخ شده است.
.RE
.PP
\-l, \-\-labels \fILABELS\fP
.RS 4
فقط نمایش issueهای دارای برچسب‌های مشخص.
.sp
هنگام ایجاد یک issue، فهرستی جداشده با کاما از برچسب‌ها به این issue افزوده می‌شود.
.RE
.PP
\-d, \-\-since \fIDATE\fP
.RS 4
فقط نمایش issueهایی که در تاریخ \fIDATE\fP یا پس از آن در قالب ISO 8601 به‌روزرسانی شده‌اند.
.RE
.PP
\-o, \-\-sort \fIKEY\fP
.RS 4
مرتب‌سازی issueهای نمایش‌داده‌شده بر اساس "created" (پیش‌فرض)، "updated" یا "comments".
.RE
.PP
\-^ \-\-sort\-ascending
.RS 4
مرتب‌سازی صعودی تاریخ‌ها به جای نزولی.
.RE
.PP
\-L, \-\-limit \fILIMIT\fP
.RS 4
فقط نمایش نخستین \fILIMIT\fP مورد از issueها.
.RE
.PP
\-\-include\-pulls
.RS 4
شامل کردن pull requestها علاوه بر issueها.
.RE
.PP
\-\-color
.RS 4
فعال‌سازی خروجی رنگی برای فهرست برچسب‌ها.
.RE
.br
.SH "همچنین ببینید (SEE ALSO)"
.P
hub\-pr(1), hub(1)