نام (NAME)

gh-issue-edit - ویرایش شماره‌ها یا ایشیوهای گیت‌هاب

خلاصه دستور (SYNOPSIS)

gh issue edit {<numbers> | <urls>} [flags]

توضیحات (DESCRIPTION)

ویرایش یک یا چند ایشیو در همان مخزن.

ویرایش پروژه‌های ایشیوها نیازمند مجوز با دامنه دسترسی (scope) project است. برای اعطای مجوز، دستور gh auth refresh -s project را اجرا کنید.

از گزینه --attach برای بارگذاری تصویر یا ویدیو در یک ایشیو استفاده کنید. بدون فلگ متن بدنه، ایشیو همان متن کنونی خود را حفظ می‌کند و پیوست به انتهای آن افزوده می‌شود. اگر متن بدنه به یک فایل پیوست‌شده ارجاع دهد، مانند ![alt](./login.png)، آن ارجاع بازنویسی می‌شود تا به‌جای آن به فایل بارگذاری‌شده اشاره کند. در هر دستور می‌توانید تا ۵۰ فایل پیوست کنید.

متن جایگزین (Alt text) برای یک تصویر پس از علامت # در انتهای مسیر می‌آید، مانند --attach './login.png#The login error state'. بدون آن، از نام فایل استفاده می‌شود. ارجاعی که از قبل در بدنه موجود باشد، همان متن جایگزین نوشته‌شده در آنجا را حفظ می‌کند. ویدیو به‌صورت یک پخش‌کننده نمایش داده می‌شود و فاقد متن جایگزین است، بنابراین امکان تعیین متن جایگزین برای آن وجود ندارد.

اگر برخی از پیوست‌ها با موفقیت بارگذاری شوند و برخی دیگر با شکست مواجه شوند، ایشیو همچنان با موارد موفقیت‌آمیز به‌روزرسانی می‌شود. سپس دستور با وضعیت غیر صفر خارج می‌شود، اما نشانی‌های URL ایشیوهای ویرایش‌شده همچنان در خروجی استاندارد (stdout) چاپ می‌شوند.

فلگ‌های --add-assignee و --remove-assignee هر دو از مقادیر ویژه زیر پشتیبانی می‌کنند:

@me: اختصاص دادن یا لغو اختصاص به خودتان
@copilot: اختصاص دادن یا لغو اختصاص به Copilot (در GitHub Enterprise Server پشتیبانی نمی‌شود)

گزینه‌ها (OPTIONS)

--add-assignee <login>: افزودن کاربران محول‌شده با نام کاربری آن‌ها. برای اختصاص به خود از "@me" یا برای اختصاص به Copilot از "@copilot" استفاده کنید.
--add-blocked-by <number>: افزودن روابط «مسدودشده توسط» (blocked by) با شماره ایشیو یا نشانی اینترنتی (URL)
--add-blocking <number>: افزودن روابط «مسدودکننده» (blocking) با شماره ایشیو یا نشانی اینترنتی (URL)
--add-label <name>: افزودن برچسب‌ها بر اساس نام
--add-project <title>: افزودن ایشیو به پروژه‌ها بر اساس عنوان
--add-sub-issue <number>: افزودن زیرایشیوها با شماره یا نشانی اینترنتی (URL)
--attach <file>: پیوست کردن یک فایل تصویری یا ویدیویی، در قالب '#'
-b, --body <string>: تنظیم متن بدنه جدید.
-F, --body-file <file>: خواندن متن بدنه از فایل (برای خواندن از ورودی استاندارد از "-" استفاده کنید)
-m, --milestone <name>: ویرایش مایل‌استون (مرحله عطف) مربوط به ایشیو بر اساس نام
--parent <number>: تنظیم ایشیوی والد با شماره یا نشانی اینترنتی (URL)
--remove-assignee <login>: حذف کاربران محول‌شده با نام کاربری آن‌ها. برای لغو اختصاص از خود از "@me" یا برای لغو اختصاص از Copilot از "@copilot" استفاده کنید.
--remove-blocked-by <number>: حذف روابط «مسدودشده توسط» (blocked by) با شماره ایشیو یا نشانی اینترنتی (URL)
--remove-blocking <number>: حذف روابط «مسدودکننده» (blocking) با شماره ایشیو یا نشانی اینترنتی (URL)
--remove-label <name>: حذف برچسب‌ها بر اساس نام
--remove-milestone: حذف وابستگی مایل‌استون (مرحله عطف) از ایشیو
--remove-parent: حذف ایشیوی والد
--remove-project <title>: حذف ایشیو از پروژه‌ها بر اساس عنوان
--remove-sub-issue <number>: حذف زیرایشیوها با شماره یا نشانی اینترنتی (URL)
--remove-type: حذف نوع ایشیو از آن
-t, --title <string>: تنظیم عنوان جدید.
--type <name>: تنظیم نوع ایشیو بر اساس نام

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

-R, --repo <[HOST/]OWNER/REPO>: انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO

کدهای خروج (EXIT CODES)

0: اجرای موفقیت‌آمیز

1: خطا

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

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

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

مثال‌ها (EXAMPLES)

$ gh issue edit 23 --title "I found a bug" --body "Nothing works"
$ gh issue edit 23 --add-label "bug,help wanted" --remove-label "core"
$ gh issue edit 23 --add-assignee "@me" --remove-assignee monalisa,hubot
$ gh issue edit 23 --add-assignee "@copilot"
$ gh issue edit 23 --add-project "Roadmap" --remove-project v1,v2
$ gh issue edit 23 --milestone "Version 1"
$ gh issue edit 23 --remove-milestone
$ gh issue edit 23 --body-file body.txt
$ gh issue edit 23 --attach './login.png#The login error state'
$ gh issue edit 23 --attach ./before.png --attach ./after.png
$ gh issue edit 23 34 --add-label "help wanted"
$ gh issue edit 23 --type Bug
$ gh issue edit 23 --remove-type
$ gh issue edit 23 --parent 100
$ gh issue edit 23 --remove-parent
$ gh issue edit 100 --add-sub-issue 123,124
$ gh issue edit 123 --add-blocked-by 200 --add-blocking 300,301

همچنین ببینید (SEE ALSO)

gh-issue(1)