| GH-ISSUE-CREATE(1) | GitHub CLI manual | GH-ISSUE-CREATE(1) |
نام (NAME)
gh-issue-create - ایجاد یک ایشیو جدید در گیتهاب
خلاصه دستور (SYNOPSIS)
gh issue create [flags]
توضیحات (DESCRIPTION)
ایجاد یک ایشیو در گیتهاب.
از گزینه --attach برای بارگذاری تصویر یا ویدیو استفاده کنید. پیوست به انتهای بدنه افزوده میشود. اگر بدنه به یک فایل پیوستشده ارجاع دهد، مانند ، آن ارجاع بازنویسی میشود تا بهجای آن به فایل بارگذاریشده اشاره کند. میتوانید در هر دستور تا ۵۰ فایل پیوست کنید.
متن جایگزین (Alt text) برای یک تصویر پس از علامت # در انتهای مسیر میآید، مانند --attach './login.png#The login error state'. بدون آن، از نام فایل استفاده میشود. ارجاعی که از قبل در بدنه موجود باشد، همان متن جایگزین نوشتهشده در آنجا را حفظ میکند. ویدیو بهصورت یک پخشکننده نمایش داده میشود و فاقد متن جایگزین است، بنابراین امکان تعیین متن جایگزین برای آن وجود ندارد.
اگر برخی از پیوستها بارگذاری شوند و برخی دیگر با شکست مواجه شوند، ایشیو همچنان با مواردی که با موفقیت بارگذاری شدهاند ایجاد میشود. سپس دستور با وضعیت غیر صفر خارج میشود، اما نشانی اینترنتی (URL) ایشیو جدید همچنان در خروجی استاندارد (stdout) چاپ میشود.
افزودن یک ایشیو به پروژهها نیازمند مجوز با دامنه دسترسی (scope) project است. برای اعطای مجوز، دستور gh auth refresh -s project را اجرا کنید.
فلگ --assignee از مقادیر ویژه زیر پشتیبانی میکند:
- @me: اختصاص دادن به خودتان
- @copilot: اختصاص دادن به Copilot (در GitHub Enterprise Server پشتیبانی نمیشود)
گزینهها (OPTIONS)
- -a, --assignee <login>
- اختصاص دادن افراد بر اساس نام کاربری آنها. برای اختصاص به خودتان از "@me" استفاده کنید.
- --attach <file>
- پیوست کردن یک فایل تصویر یا ویدیو، در قالب '#'
- --blocked-by <numbers>
- علامتگذاری ایشیو جدید بهعنوان مسدودشده توسط این شمارههای ایشیو یا نشانیهای اینترنتی (URLs)
- --blocking <numbers>
- علامتگذاری ایشیو جدید بهعنوان مسدودکننده این شمارههای ایشیو یا نشانیهای اینترنتی (URLs)
- -b, --body <string>
- ارائه متن بدنه. در غیر این صورت برای وارد کردن آن درخواست خواهد شد.
- -F, --body-file <file>
- خواندن متن بدنه از فایل (از "-" برای خواندن از ورودی استاندارد استفاده کنید)
- -e, --editor
- صرفنظر از اعلانها و باز کردن ویرایشگر متن برای نوشتن عنوان و بدنه. سطر اول عنوان و متن باقیمانده بدنه خواهد بود.
- -l, --label <name>
- افزودن برچسبها با نام
- -m, --milestone <name>
- افزودن ایشیو به یک مایلستون بر اساس نام
- --parent <number>
- افزودن ایشیو جدید بهعنوان زیرایشیو (sub-issue) برای شماره یا نشانی اینترنتی (URL) والد مشخصشده
- -p, --project <title>
- افزودن ایشیو به پروژهها بر اساس عنوان
- --recover <string>
- بازیابی ورودی از یک اجرای ناموفق create
- -T, --template <name>
- نام الگو برای استفاده بهعنوان متن اولیه بدنه
- -t, --title <string>
- ارائه یک عنوان. در غیر این صورت برای وارد کردن آن درخواست خواهد شد.
- --type <name>
- تعیین نوع ایشیو بر اساس نام
- -w, --web
- باز کردن مرورگر وب برای ایجاد ایشیو
گزینههای به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)
- -R, --repo <[HOST/]OWNER/REPO>
- انتخاب مخزنی دیگر با استفاده از قالب [HOST/]OWNER/REPO
نامهای مستعار (ALIASES)
gh issue new
کدهای خروج (EXIT CODES)
0: اجرای موفقیتآمیز
1: خطا
2: دستور لغو شد
4: نیاز به احراز هویت است
نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.
مثالها (EXAMPLES)
$ gh issue create --title "I found a bug" --body "Nothing works" $ gh issue create --attach './login.png#The login error state' $ gh issue create --attach ./before.png --attach ./after.png $ gh issue create --label "bug,help wanted" $ gh issue create --label bug --label "help wanted" $ gh issue create --assignee monalisa,hubot $ gh issue create --assignee "@me" $ gh issue create --assignee "@copilot" $ gh issue create --project "Roadmap" $ gh issue create --template "Bug Report" $ gh issue create --type Bug $ gh issue create --parent 100 $ gh issue create --parent https://github.com/cli/go-gh/issues/42 $ gh issue create --blocked-by 200,201 --blocking 300
همچنین ببینید (SEE ALSO)
| Sep 2026 |