.nh
.TH "GH-ALIAS-SET" "1" "Sep 2026" "" "راهنمای GitHub CLI"

.SH "نام (NAME)"
gh-alias-set \- ایجاد یک میان‌بر یا دستور سفارشی جدید


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh alias set <alias> <expansion> [flags]\fR


.SH "توضیحات (DESCRIPTION)"
تعریف یک واژه که هنگام فراخوانی، به یک دستور کامل
.B gh
گسترش می‌یابد.

.PP
عبارت گسترش می‌تواند آرگومان‌ها و گزینه‌های اضافی را مشخص کند. اگر عبارت گسترش شامل متغیرهای مکانی مانند
.B $1
باشد، آرگومان‌های اضافی که پس از نام مستعار می‌آیند در جایگاه مناسب درج خواهند شد. در غیر این صورت، آرگومان‌های اضافی به انتهای دستور گسترش‌یافته افزوده می‌شوند.

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

.PP
اگر عبارت گسترش با
.B !
شروع شود یا اگر گزینه
.B \-\-shell
مشخص شده باشد، عبارت گسترش یک عبارت شل خواهد بود که هنگام فراخوانی نام مستعار، توسط مفسر
.B sh
ارزیابی و اجرا می‌شود. این قابلیت امکان زنجیره‌سازی چندین دستور را از طریق لوله‌کشی (piping) و هدایت مجدد (redirection) فراهم می‌کند.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-clobber\fR
بازنویسی نام‌های مستعار موجود با همین نام

.TP
\fB\-s\fR, \fB\-\-shell\fR
اعلام این‌که نام مستعار باید از طریق یک مفسر شل اجرا شود


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# نکته: در Command Prompt ویندوز استفاده از علامت نقل‌قول دوتایی (double quotes) برای آرگومان‌ها الزامی است
$ gh alias set pv 'pr view'
$ gh pv -w 123  #=> gh pr view -w 123

$ gh alias set bugs 'issue list --label=bugs'
$ gh bugs

$ gh alias set homework 'issue list --assignee @me'
$ gh homework

$ gh alias set 'issue mine' 'issue list --mention @me'
$ gh issue mine

$ gh alias set epicsBy 'issue list --author="$1" --label="epic"'
$ gh epicsBy vilmibm  #=> gh issue list --author="vilmibm" --label="epic"

$ gh alias set --shell igrep 'gh issue list --label="$1" | grep "$2"'
$ gh igrep epic foo  #=> gh issue list --label="epic" | grep "foo"
.EE


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