نام (NAME)

kitten-@-scroll-window - پیمایش صفحه اسکرول پنجره‌های مشخص‌شده ترمینال kitty

نحوه استفاده (USAGE)

kitten @ scroll-window SCROLL_AMOUNT

توضیحات (DESCRIPTION)

پیمایش (اسکرول) پنجره‌های مشخص‌شده؛ اگر هیچ پنجره‌ای مشخص نشود، پنجره‌ای که این دستور درون آن اجرا شده است پیمایش می‌شود. SCROLL_AMOUNT می‌تواند یکی از کلمات کلیدی start یا end یا آرگومانی به شکل <number>[unit][+-] باشد. unit می‌تواند l برای خطوط (lines)، p برای صفحات (pages)، u برای بازگردانی پیمایش (unscroll) و r برای پیمایش به پرامپت (scroll to prompt) باشد. در صورت مشخص نشدن، پیش‌فرض l است. برای نمونه، 30.5 به اندازه ۳۰ و نیم خط به پایین پیمایش می‌کند، 2p- به اندازه ۲ صفحه به بالا پیمایش می‌کند و 0.5p به اندازه نیم صفحه به پایین پیمایش می‌کند. 3u به اندازه ۳ خط عمل unscroll را انجام می‌دهد، به این معنی که ۳ خط از بافر اسکرول‌بک به بالای صفحه منتقل می‌شود. 1r- به پرامپت قبلی و 1r به پرامپت بعدی پیمایش می‌کند. برای جزئیات نحوه کارکرد پیمایش به پرامپت، scroll_to_prompt را ببینید.

گزینه‌ها (OPTIONS)

--match, -m

پنجره مورد نظر برای تطبیق. مشخصات تطبیق به صورت field:query هستند، که در آن field می‌تواند یکی از موارد زیر باشد: id، title، pid، cwd، cmdline، num، env، var، state، neighbor، session و recent. عبارت query الگوی مورد نظر برای تطبیق است. عبارت‌ها می‌توانند عدد یا عبارت منظم (regular expression) باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.

مقدار ویژه all با تمامی پنجره‌ها تطبیق می‌یابد.

برای فیلدهای عددی: id، pid، num و recent، عبارت به عنوان عدد تفسیر می‌شود و نه عبارت منظم. مقادیر منفی برای id از بالاترین شماره شناسه به پایین تطبیق داده می‌شوند؛ به ویژه، -1 نشان‌دهنده جدیدترین پنجره ایجادشده است.

فیلد num به موقعیت پنجره در زبانه فعلی اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (مشابه ترتیبی که پنجره‌ها توسط دستور kitten @ ls گزارش می‌شوند).

شناسه پنجره فعلی در متغیر محیطی KITTY_WINDOW_ID در دسترس است.

فیلد recent به پنجره‌های اخیراً فعال در زبانه فعلی اشاره دارد، به طوری که صفر پنجره فعال فعلی، یک پنجره فعال قبلی و به همین ترتیب است.

فیلد neighbor به پنجره همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از مقادیر: left، right، top یا bottom باشد.

فیلد session با پنجره‌هایی که در نشست مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت ^$ برای تطبیق پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از . برای تطبیق با نشست فعال فعلی، و از ~ برای تطبیق با نشست فعال فعلی یا آخرین نشست فعال (در صورتی که هیچ نشستی فعال نباشد) استفاده کنید.

هنگام استفاده از فیلد env برای تطبیق متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید؛ برای نمونه: env:MY_ENV_VAR=2.

به همین ترتیب، فیلد var با متغیرهای کاربری تنظیم‌شده روی پنجره تطبیق می‌یابد. می‌توانید مشابه فیلد env، نام یا نام و مقدار را مشخص کنید.

فیلد state با وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused، focused_os_window، self، overlay_parent. پنجره‌های active پنجره‌هایی هستند که در زبانه والد خود فعال هستند. تنها یک پنجره focused وجود دارد و آن پنجره‌ای است که رویدادهای صفحه‌کلید به آن ارسال می‌شوند. اگر هیچ پنجره‌ای فوکوس نداشته باشد، آخرین پنجره فوکوس‌شده تطبیق داده می‌شود. مقدار focused_os_window با تمام پنجره‌های موجود در پنجره سیستم‌عامل دارای فوکوس تطبیق می‌یابد. مقدار self با پنجره‌ای که دستور کنترل از راه دور در آن اجرا شده است تطبیق می‌یابد. مقدار overlay_parent با پنجره‌ای که زیر پنجره self قرار دارد (هنگامی که پنجره self یک overlay است) تطبیق می‌یابد.

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرست پنجره‌ها استفاده کنید.

--no-response [=no]

عدم انتظار برای دریافت پاسخ مبنی بر موفقیت عملیات. توجه داشته باشید که استفاده از این گزینه به این معنی است که از خرابی‌ها و خطاها مطلع نخواهید شد.

--help, -h [=no]

نمایش راهنمای این دستور.

گزینه‌های عمومی (GLOBAL OPTIONS)

--to: نشانی نمونه kitty برای کنترل. متناظر با نشانی داده‌شده به نمونه kitty از طریق گزینه --listen-on یا تنظیم listen_on در فایل kitty.conf. در صورت مشخص نشدن، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرایند ارسال می‌شوند؛ یعنی تنها در صورتی عمل خواهند کرد که این فرایند داخل یک پنجره kitty اجرا شده باشد.
--password: رمز عبور مورد استفاده هنگام ارتباط با kitty. این کار باعث می‌شود kitty از کاربر برای انجام عملیات مشخص‌شده اجازه بخواهد، مگر اینکه رمز عبور قبلاً پذیرفته شده باشد یا از پیش در kitty.conf پیکربندی شده باشد. برای استفاده از رمز عبور خالی، --use-password را روی always تنظیم کنید.
--password-file [=rc-pass]: فایلی که رمز عبور از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty سنجیده می‌شوند. برای خواندن از STDIN از - استفاده کنید. برای خواندن از توصیف‌کننده فایل num از fd:num استفاده کنید. در صورتی استفاده می‌شود که گزینه --password داده نشده باشد. به طور پیش‌فرض به دنبال فایل rc-pass در دایرکتوری پیکربندی kitty می‌گردد.
--password-env [=KITTY_RC_PASSWORD]: نام متغیر محیطی برای خواندن رمز عبور از آن. در صورتی استفاده می‌شود که --password-file داده نشده باشد. به طور پیش‌فرض متغیر محیطی KITTY_RC_PASSWORD را بررسی می‌کند.
--use-password [=if-available]: اگر هیچ رمز عبوری در دسترس نباشد، kitty معمولاً دستور کنترل از راه دور را بدون رمز عبور ارسال می‌کند. از این گزینه می‌توان برای اجبار آن به استفاده همیشگی یا عدم استفاده از رمز عبور ارائه‌شده استفاده کرد. اگر روی always تنظیم شود و هیچ رمز عبوری ارائه نشود، رمز عبور خالی استفاده می‌شود.
انتخاب‌ها: if-available, always, never