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

.SH "نام (NAME)"
gh-pr-create \- ایجاد یک پول‌ریکوئست جدید در یک مخزن گیت‌هاب


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh pr create [flags]\fR


.SH "توضیحات (DESCRIPTION)"
ایجاد یک پول‌ریکوئست در گیت‌هاب.

.PP
در صورت موفقیت، نشانی اینترنتی (URL) پول‌ریکوئست ایجادشده چاپ خواهد شد.

.PP
هنگامی که شاخه فعلی به طور کامل به یک مخزن ریموت گیت push نشده باشد، اعلانی نمایش داده می‌شود که می‌پرسد شاخه کجا ارسال شود و گزینه‌ای برای فورک کردن مخزن مبنا پیشنهاد می‌دهد. هر فورکی که از این طریق ایجاد شود، تنها شامل شاخه پیش‌فرض مخزن بالادستی خواهد بود. از \fB--head\fR برای صرف‌نظر کردن صریح از هرگونه عملیات فورک یا push استفاده کنید.

.PP
گزینه \fB--head\fR از ساختار \fB<user>:<branch>\fR برای انتخاب مخزن مبدا متعلق به \fB<user>\fR پشتیبانی می‌کند.
استفاده از یک سازمان به عنوان \fB<user>\fR در حال حاضر پشتیبانی نمی‌شود.
برای اطلاعات بیشتر، ببینید:
\[la]https://github.com/cli/cli/issues/10093\[ra]

.PP
اعلانی نیز عنوان و بدنه پول‌ریکوئست را درخواست خواهد کرد. از \fB--title\fR و \fB--body\fR برای صرف‌نظر کردن از این اعلان استفاده کنید، یا از \fB--fill\fR برای پر کردن خودکار این مقادیر از کامیت‌های گیت بهره ببرید.
توجه به این نکته مهم است که اگر \fB--title\fR و/یا \fB--body\fR نیز در کنار \fB--fill\fR ارائه شوند، مقادیر مشخص‌شده با \fB--title\fR و/یا \fB--body\fR اولویت خواهند داشت و هر محتوای پرشده به صورت خودکار را بازنویسی می‌کنند.

.PP
شاخه مبنا (base) برای پول‌ریکوئست ایجادشده را می‌توان با استفاده از فلگ \fB--base\fR مشخص کرد. در صورت عدم ارائه، مقدار پیکربندی شاخه گیت \fBgh-merge-base\fR استفاده خواهد شد. در صورت عدم پیکربندی، شاخه پیش‌فرض مخزن استفاده خواهد شد. دستور \fBgit config branch.{current}.gh-merge-base {base}\fR را اجرا کنید تا شاخه فعلی برای استفاده از مبنای ادغام مشخص‌شده پیکربندی شود.

.PP
با ارجاع دادن به یک ایشو (issue) در بدنه پول‌ریکوئست، آن را به پول‌ریکوئست پیوند دهید. اگر متن بدنه شامل \fBFixes #123\fR یا \fBCloses #123\fR باشد، ایشوی ارجاع داده شده پس از ادغام شدن پول‌ریکوئست به صورت خودکار بسته خواهد شد.

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

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

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

.PP
به‌طور پیش‌فرض، کاربرانی که دسترسی نوشتن به مخزن مبنا دارند می‌توانند کامیت‌های جدیدی را به شاخه هد پول‌ریکوئست push کنند. این امکان را با \fB--no-maintainer-edit\fR غیرفعال کنید.

.PP
افزودن یک پول‌ریکوئست به پروژه‌ها نیازمند مجوز با حوزه (scope) \fBproject\fR است.
برای اعطای مجوز، دستور \fBgh auth refresh -s project\fR را اجرا کنید.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-a\fR, \fB--assignee\fR \fB<login>\fR
تخصیص افراد بر اساس نام کاربری (login). از "@me" برای تخصیص به خود استفاده کنید.

.TP
\fB--attach\fR \fB<file>\fR
پیوست کردن یک فایل تصویر یا ویدیو، در قالب '#\&'

.TP
\fB-B\fR, \fB--base\fR \fB<branch>\fR
شاخه‌ای که می‌خواهید کد شما در آن ادغام شود

.TP
\fB-b\fR, \fB--body\fR \fB<string>\fR
بدنه پول‌ریکوئست

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

.TP
\fB-d\fR, \fB--draft\fR
علامت‌گذاری پول‌ریکوئست به عنوان پیش‌نویس (draft)

.TP
\fB--dry-run\fR
چاپ جزئیات به جای ایجاد پول‌ریکوئست. ممکن است همچنان تغییرات گیت push شوند.

.TP
\fB-e\fR, \fB--editor\fR
صرف‌نظر کردن از اعلان‌ها و باز کردن ویرایشگر متن برای نوشتن عنوان و بدنه در آن. خط اول عنوان و باقی متن بدنه است.

.TP
\fB-f\fR, \fB--fill\fR
استفاده از اطلاعات کامیت برای عنوان و بدنه

.TP
\fB--fill-first\fR
استفاده از اطلاعات اولین کامیت برای عنوان و بدنه

.TP
\fB--fill-verbose\fR
استفاده از پیام و بدنه کامیت‌ها برای توضیحات

.TP
\fB-H\fR, \fB--head\fR \fB<branch>\fR
شاخه‌ای که حاوی کامیت‌های پول‌ریکوئست شماست (پیش‌فرض [شاخه فعلی])

.TP
\fB-l\fR, \fB--label\fR \fB<name>\fR
افزودن برچسب‌ها با نام

.TP
\fB-m\fR, \fB--milestone\fR \fB<name>\fR
افزودن پول‌ریکوئست به یک مایلستون بر اساس نام

.TP
\fB--no-maintainer-edit\fR
غیرفعال کردن امکان ویرایش پول‌ریکوئست توسط نگهدارنده

.TP
\fB-p\fR, \fB--project\fR \fB<title>\fR
افزودن پول‌ریکوئست به پروژه‌ها بر اساس عنوان

.TP
\fB--recover\fR \fB<string>\fR
بازیابی ورودی از یک اجرای ناموفق create

.TP
\fB-r\fR, \fB--reviewer\fR \fB<handle>\fR
درخواست بررسی از افراد یا تیم‌ها با نام کاربری آن‌ها

.TP
\fB-T\fR, \fB--template\fR \fB<file>\fR
فایل الگو برای استفاده به عنوان متن اولیه بدنه

.TP
\fB-t\fR, \fB--title\fR \fB<string>\fR
عنوان برای پول‌ریکوئست

.TP
\fB-w\fR, \fB--web\fR
باز کردن مرورگر وب برای ایجاد پول‌ریکوئست


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


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


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
$ gh pr create --title "The bug is fixed" --body "Everything works again"
$ gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name
$ gh pr create --project "Roadmap"
$ gh pr create --base develop --head monalisa:feature
$ gh pr create --template "pull_request_template.md"
$ gh pr create --attach './login.png#The login error state'
$ gh pr create --attach ./before.png --attach ./after.png

.EE


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