.nh
.TH "GH-ALIAS-IMPORT" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-alias-import \- درون‌ریزی نام‌های مستعار از یک فایل پیکربندی


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


.SH "توضیحات (DESCRIPTION)"
درون‌ریزی نام‌های مستعار از محتویات یک فایل YAML.

.PP
نام‌های مستعار باید به‌صورت یک نگاشت (map) در YAML تعریف شوند، به این صورت که کلیدها نشان‌دهنده نام‌های مستعار و مقادیر نشان‌دهنده عبارت‌های معادل آن‌ها (expansions) هستند. یک فایل نمونه باید به شکل زیر باشد:

.EX
bugs: issue list --label=bug
igrep: '!gh issue list --label="$1" | grep "$2"'
features: |-
    issue list
    --label=enhancement
.EE

.PP
برای خواندن نام‌های مستعار (در قالب YAML) از ورودی استاندارد، از
.B \-
استفاده کنید.

.PP
از خروجی دستور
.B gh alias list
می‌توان برای تولید یک فایل YAML حاوی نام‌های مستعار خود استفاده کرد که امکان درون‌ریزی آن‌ها از یک سامانه به سامانه دیگر را فراهم می‌کند. برای کسب اطلاعات بیشتر، دستور
.B gh help alias list
را اجرا کنید.


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


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

.PP
.BR 1 :
خطا

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

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

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


.SH "مثال (EXAMPLE)"
.EX
# درون‌ریزی نام‌های مستعار از یک فایل
$ gh alias import aliases.yml

# درون‌ریزی نام‌های مستعار از ورودی استاندارد
$ gh alias import -
.EE


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