.TH "kitten-@-get-text" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-@-get-text \- استخراج متن از بافر اسکرول پنجره‌های ترمینال kitty
.SH "خلاصه دستور (SYNOPSIS)"
.SY "kitten @ get-text "
.YS
.SH "توضیحات (DESCRIPTION)"
استخراج متن از پنجره مشخص‌شده.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--match, -m"
پنجره مورد نظر برای تطبیق. مشخصات تطبیق به صورت
.I field:query
هستند، که در آن
.I field
می‌تواند یکی از موارد زیر باشد:
.BR id ،
.BR title ،
.BR pid ،
.BR cwd ،
.BR cmdline ،
.BR num ،
.BR env ،
.BR var ،
.BR state ،
.BR neighbor ،
.B session
و
.BR recent .
مقدار
.I query
عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم (Regex) باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.
.PP
مقدار ویژه
.B all
با تمام پنجره‌ها تطبیق می‌یابد.
.PP
برای فیلدهای عددی شامل
.BR id ،
.BR pid ،
.B num
و
.BR recent ،
عبارت به عنوان یک عدد تفسیر می‌شود، نه یک عبارت منظم. مقادیر منفی برای
.B id
از بالاترین شناسه به سمت پایین تطبیق داده می‌شوند؛ به‌ویژه مقدار
.B \-1
بیانگر جدیدترین پنجره ایجادشده است.
.PP
فیلد
.B num
به موقعیت پنجره در زبانه جاری اشاره دارد که از صفر و در جهت عقربه‌های ساعت شمارش می‌شود (این ترتیب دقیقاً همان ترتیبی است که پنجره‌ها توسط دستور
.B kitten @ ls
گزارش می‌شوند).
.PP
شناسه پنجره جاری در متغیر محیطی
.B KITTY_WINDOW_ID
در دسترس است.
.PP
فیلد
.B recent
به پنجره‌های اخیراً فعال در زبانه فعال جاری اشاره دارد؛ به طوری که صفر پنجره در حال حاضر فعال، یک پنجره فعال قبلی و به همین ترتیب است.
.PP
فیلد
.B neighbor
به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد
.BR left ،
.BR right ،
.B top
یا
.B bottom
باشد.
.PP
فیلد
.B session
با پنجره‌هایی که در نشست مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت
\(ha$
برای تطبیق با پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از
.B .
برای تطبیق با نشست فعال جاری و از
\(ti
برای تطبیق با نشست فعال جاری یا آخرین نشست فعال (در صورتی که هیچ نشستی فعال نباشد) استفاده کنید.
.PP
هنگام استفاده از فیلد
.B env
برای تطبیق با متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید؛ به عنوان مثال:
.BR env:MY_ENV_VAR=2 .
.PP
به همین ترتیب، فیلد
.B var
با متغیرهای کاربری تنظیم‌شده روی پنجره تطبیق می‌یابد. همانند فیلد
.BR env ،
می‌توانید تنها نام یا نام و مقدار را مشخص کنید.
.PP
فیلد
.B state
با وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از:
.BR active ،
.BR focused ،
.BR needs_attention ،
.BR parent_active ،
.BR parent_focused ،
.BR focused_os_window ،
.B self
و
.BR overlay_parent .
پنجره‌های فعال پنجره‌هایی هستند که در زبانه والد خود فعال می‌باشند. تنها یک پنجره فوکوس‌شده وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن ارسال می‌شوند. اگر هیچ پنجره‌ای فوکوس نشده باشد، آخرین پنجره فوکوس‌شده تطبیق داده می‌شود. مقدار
.B focused_os_window
با تمام پنجره‌های موجود در پنجره سیستم‌عامل فعلیِ فوکوس‌شده تطبیق می‌یابد. مقدار
.B self
با پنجره‌ای که دستور کنترل از راه دور در آن اجرا می‌شود تطبیق می‌یابد. مقدار
.B overlay_parent
با پنجره‌ای که زیر پنجره
.B self
قرار دارد (زمانی که پنجره
.B self
یک لایه رویی یا overlay است) تطبیق می‌یابد.
.PP
توجه داشته باشید که می‌توانید از دستور
.B kitten @ ls
برای دریافت فهرست پنجره‌ها استفاده کنید.
.TP
.BI "--extent" " [=screen]"
چه متنی دریافت شود. مقدار پیش‌فرض
.B screen
به معنای تمام متنی است که در حال حاضر روی صفحه نمایش قرار دارد. مقدار
.B all
به معنای کل صفحه به همراه بافر اسکرول (scrollback) است و مقدار
.B selection
متن انتخاب‌شده جاری را برمی‌گرداند. مقدار
.B first_cmd_output_on_screen
خروجی نخستین دستوری است که در پنجره جاری روی صفحه اجرا شده است. مقدار
.B last_cmd_output
خروجی آخرین دستوری است که در پنجره اجرا شده است. مقدار
.B last_visited_cmd_output
نخستین خروجی دستور در زیر آخرین موقعیت اسکرول‌شده از طریق
.B scroll_to_prompt
است. مقدار
.B last_non_empty_output
خروجی آخرین دستور اجرا شده در پنجره است که دارای خروجی غیرخالی بوده است. چهار مورد آخر نیازمند فعال بودن
.B shell_integration
هستند. مقدار
.B alternate
به معنای متنی در صفحه است که در حال حاضر قابل مشاهده نیست (اگر ترمینال در صفحه اصلی باشد، این مقدار صفحه دوم/جایگزین است و برعکس). مقدار
.B alternate_scrollback
مشابه حالت قبل است اما بافر اسکرول را نیز (در صورت وجود) شامل می‌شود.
.sp
گزینه‌های مجاز:
.BR screen ،
.BR all ،
.BR alternate ،
.BR alternate_scrollback ،
.BR first_cmd_output_on_screen ،
.BR last_cmd_output ،
.BR last_non_empty_output ،
.B last_visited_cmd_output
و
.B selection
.TP
.BI "--ansi" " [=no]"
به صورت پیش‌فرض، تنها متن ساده برگردانده می‌شود. با این فلگ، متن شامل کدهای اسکیپ قالب‌بندی ANSI برای رنگ‌ها، توپر (bold)، مورب (italic) و غیره خواهد بود.
.TP
.BI "--add-cursor" " [=no]"
افزودن کدهای اسکیپ ANSI مشخص‌کننده موقعیت و سبک مکان‌نما به انتهای متن.
.TP
.BI "--add-wrap-markers" " [=no]"
افزودن نویسه بازگشت به ابتدای سطر (carriage return) در هر نقطه شکستگی خط (جایی که خطوط طولانی در لبه‌های صفحه شکسته می‌شوند).
.TP
.BI "--clear-selection" " [=no]"
پاک کردن متن انتخاب‌شده در پنجره تطبیق‌یافته، در صورت وجود.
.TP
.BI "--self" " [=no]"
دریافت متن از پنجره‌ای که این دستور در آن اجرا می‌شود، به جای پنجره فعال.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنمای این دستور.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.TP
.BI "--to"
آدرسی برای نمونه kitty مورد نظر جهت کنترل. متناظر با آدرسی است که از طریق گزینه
.B \-\-listen\-on
یا تنظیم
.B listen_on
در فایل
.I kitty.conf
به نمونه kitty داده شده است. در صورت عدم تعیین، متغیر محیطی
.B KITTY_LISTEN_ON
بررسی می‌شود. اگر آن هم یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند ارسال می‌شوند، بدین معنا که تنها در صورتی کار خواهند کرد که این فرآیند درون یک پنجره kitty اجرا شود.
.TP
.BI "--password"
گذرواژه‌ای برای استفاده هنگام برقراری ارتباط با kitty. این کار باعث می‌شود kitty از کاربر برای انجام عملیات مشخص‌شده مجوز درخواست کند، مگر اینکه گذرواژه از قبل پذیرفته شده باشد یا در فایل
.I kitty.conf
از پیش پیکربندی شده باشد. برای استفاده از گذرواژه خالی، گزینه
.B \-\-use\-password
را برابر با
.B always
قرار دهید.
.TP
.BI "--password-file" " [=rc\-pass]"
فایلی که گذرواژه از آن خوانده می‌شود. فاصله‌های خالی انتهای خط نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty سنجیده می‌شوند. برای خواندن از ورودی استاندارد (STDIN) از
.B \-
استفاده کنید. برای خواندن از توصیف‌گر فایل
.I num
از
.BI fd: num
استفاده کنید. در صورت عدم ارائه گزینه
.B \-\-password
استفاده می‌شود. به طور پیش‌فرض فایل
.I rc\-pass
در دایرکتوری پیکربندی kitty بررسی می‌شود.
.TP
.BI "--password-env" " [=KITTY_RC_PASSWORD]"
نام متغیر محیطی برای خواندن گذرواژه. در صورت عدم ارائه گزینه
.B \-\-password\-file
استفاده می‌شود. به طور پیش‌فرض متغیر محیطی
.B KITTY_RC_PASSWORD
بررسی می‌شود.
.TP
.BI "--use-password" " [=if\-available]"
اگر گذرواژه‌ای در دسترس نباشد، kitty معمولاً دستور کنترل از راه دور را بدون گذرواژه ارسال می‌کند. از این گزینه می‌توان برای اجبار آن به استفاده همیشگی یا عدم استفاده از گذرواژه ارائه‌شده استفاده کرد. اگر روی
.B always
تنظیم شود و گذرواژه‌ای ارائه نشده باشد، از گذرواژه خالی استفاده می‌شود.
.sp
گزینه‌های مجاز:
.BR if-available ،
.B always
و
.B never