نام (NAME)

gh-pr-edit - ویرایش و به‌روزرسانی مشخصات یک پول‌ریکوئست

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

gh pr edit [<number> | <url> | <branch>] [flags]

توضیحات (DESCRIPTION)

ویرایش یک پول‌ریکوئست (درخواست ادغام).

بدون مشخص کردن آرگومان، پول‌ریکوئست متعلق به شاخه جاری انتخاب می‌شود.

ویرایش پروژه‌های یک پول‌ریکوئست نیازمند احراز هویت با محدوده دسترسی project است. برای احراز هویت، دستور gh auth refresh -s project را اجرا کنید.

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

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

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

هر دو گزینه --add-assignee و --remove-assignee از مقادیر ویژه زیر پشتیبانی می‌کنند:
- @me: واگذاری به خود یا لغو واگذاری از خود
- @copilot: واگذاری به Copilot یا لغو واگذاری از Copilot (در GitHub Enterprise Server پشتیبانی نمی‌شود)

هر دو گزینه --add-reviewer و --remove-reviewer از مقدار ویژه زیر پشتیبانی می‌کنند:
- @copilot: درخواست بررسی یا لغو درخواست بررسی از Copilot (در GitHub Enterprise Server پشتیبانی نمی‌شود)

گزینه‌ها (OPTIONS)

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

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

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

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

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

1: خطا

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

4: احراز هویت لازم است

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

مثال‌ها (EXAMPLES)

# ویرایش عنوان و بدنه یک پول‌ریکوئست
$ gh pr edit 23 --title "I found a bug" --body "Nothing works"
# استفاده از یک فایل به عنوان بدنه
$ gh pr edit 23 --body-file body.txt
# افزودن اسکرین‌شات به بدنه، با متن جایگزین پس از "#"
$ gh pr edit 23 --attach './login.png#The login error state'
# افزودن چند فایل با تکرار فلگ
$ gh pr edit 23 --attach ./before.png --attach ./after.png
# مدیریت برچسب‌ها
$ gh pr edit 23 --add-label "bug,help wanted" --remove-label "core"
# مدیریت بازبین‌ها
$ gh pr edit 23 --add-reviewer monalisa,hubot --remove-reviewer myorg/team-name
# درخواست مجدد بازبینی
$ gh pr edit 23 --add-reviewer monalisa
# درخواست بازبینی از GitHub Copilot
$ gh pr edit 23 --add-reviewer "@copilot"
# مدیریت افراد واگذارشده
$ gh pr edit 23 --add-assignee "@me" --remove-assignee monalisa,hubot
# واگذاری به GitHub Copilot
$ gh pr edit 23 --add-assignee "@copilot"
# مدیریت پروژه‌ها و مایل‌استون‌ها
$ gh pr edit 23 --add-project "Roadmap" --remove-project v1,v2
$ gh pr edit 23 --milestone "Version 1"
$ gh pr edit 23 --remove-milestone

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

gh-pr(1)