.nh
.TH "GH-REPO-READ-FILE" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-repo-read-file \- خواندن یک فایل از مخزن (پیش‌نمایش)


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh repo read-file <path> [flags]\fR


.SH "توضیحات (DESCRIPTION)"
خواندن محتویات یک فایل در یک مخزن گیت‌هاب بدون کلون کردن آن.

.PP
این دستور در مرحله پیش‌نمایش قرار دارد و ممکن است بدون اطلاع قبلی تغییر کند.

.PP
به‌طور پیش‌فرض، فایل از شاخه پیش‌فرض خوانده می‌شود. از گزینه
\fB--ref\fR
برای خواندن از یک شاخه، برچسب (tag) یا کامیت مشخص استفاده کنید.

.PP
هنگام اجرا در حالت TTY (ترمینال)، محتوا از طریق صفحه‌بندی‌کننده (pager) شما نمایش داده می‌شود. هنگامی که stdout پایپ یا هدایت مجدد شود، محتوای خام مستقیماً نوشته می‌شود. برای ذخیره فایل روی دیسک به جای آن، از گزینه
\fB--output\fR
استفاده کنید.

.PP
به‌طور پیش‌فرض، این دستور از خروجی دادن فایلی که حاوی توالی‌های فرار ترمینال (escape sequences) است خودداری می‌کند، زیرا ممکن است ترمینال شما را دستکاری کنند. برای خواندن فایل در هر صورت، گزینه
\fB--allow-escape-sequences\fR
را ارسال کنید. این بررسی تنها برای خروجی ترمینال و پایپ‌شده اعمال می‌شود؛ نوشتن روی دیسک با
\fB--output\fR
همیشه شامل بایت‌های خام است، درست مانند اینکه
\fB--allow-escape-sequences\fR
ارائه شده باشد.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--allow-escape-sequences\fR
مجاز کردن چاپ توالی‌های فرار ترمینال

.TP
\fB--clobber\fR
بازنویسی مسیر خروجی در صورتی که از قبل وجود داشته باشد

.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
فیلتر کردن خروجی JSON با استفاده از یک عبارت jq

.TP
\fB--json\fR \fB<fields>\fR
تولید خروجی JSON با فیلدهای مشخص‌شده

.TP
\fB-o\fR, \fB--output\fR \fB<path>\fR
نوشتن فایل در یک مسیر به جای خروجی استاندارد (stdout)

.TP
\fB--ref\fR \fB<string>\fR
شاخه، برچسب یا کامیتی که باید از آن خوانده شود

.TP
\fB-R\fR, \fB--repo\fR \fB<[HOST/]OWNER/REPO>\fR
انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
قالب‌بندی خروجی JSON با استفاده از یک الگوی Go؛ دستور "gh help formatting" را ببینید


.SH "فیلدهای JSON (JSON FIELDS)"
\fBcontent\fR, \fBdownloadUrl\fR, \fBencoding\fR, \fBgitSHA\fR, \fBgitUrl\fR, \fBhtmlUrl\fR, \fBname\fR, \fBpath\fR, \fBsize\fR, \fBtype\fR, \fBurl\fR


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

.PP
1: خطا

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

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

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


.SH "مثال (EXAMPLE)"
.EX
# خواندن یک فایل از شاخه پیش‌فرض
$ gh repo read-file README.md --repo cli/cli

# خواندن یک فایل در یک ref مشخص
$ gh repo read-file README.md --repo cli/cli --ref v2.50.0

# ذخیره یک فایل روی دیسک
$ gh repo read-file README.md --repo cli/cli --output download/README.md

# چاپ فیلدهای انتخاب‌شده به صورت JSON
$ gh repo read-file README.md --repo cli/cli --json name,path,size,type

# خواندن فایلی که حاوی توالی‌های فرار ترمینال است
$ gh repo read-file path/to/file --repo OWNER/REPO --allow-escape-sequences

.EE


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