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

.SH "نام (NAME)"
gh-gist-create \- ایجاد یک گیست جدید در گیت‌هاب


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh gist create [<filename>... | <pattern>... | -] [flags]\fR


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

.PP
گیست‌ها می‌توانند از یک یا چند فایل ایجاد شوند. همچنین، برای خواندن از ورودی استاندارد، می‌توانید
.B \-
را به‌عنوان نام فایل ارسال کنید.

.PP
به‌طور پیش‌فرض، گیست‌ها مخفی (secret) هستند؛ برای قرار دادن گیست در فهرست‌های عمومی از گزینه
.B \-\-public
استفاده کنید.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-d\fR, \fB--desc\fR \fB<string>\fR
توضیحی برای این گیست

.TP
\fB-f\fR, \fB--filename\fR \fB<string>\fR
ارائه یک نام فایل برای استفاده هنگام خواندن از ورودی استاندارد

.TP
\fB-p\fR, \fB--public\fR
فهرست کردن گیست به‌صورت عمومی (پیش‌فرض: "secret")

.TP
\fB-w\fR, \fB--web\fR
باز کردن مرورگر وب با گیست ایجادشده


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


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# انتشار فایل 'hello.py' به‌عنوان یک گیست عمومی
$ gh gist create --public hello.py

# ایجاد یک گیست همراه با توضیحات
$ gh gist create hello.py -d "my Hello-World program in Python"

# ایجاد یک گیست شامل چند فایل
$ gh gist create hello.py world.py cool.txt

# ایجاد یک گیست شامل چند فایل با استفاده از الگوها
$ gh gist create *.md *.txt artifact.*

# خواندن از ورودی استاندارد برای ایجاد یک گیست
$ gh gist create -

# ایجاد یک گیست از خروجی هدایت‌شده (piped) از دستوری دیگر
$ cat cool.txt | gh gist create

.EE


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