نام (NAME)

kitten-edit-in-kitty - ویرایش یک فایل در پنجرهٔ هم‌پوشان (overlay) kitty

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

توضیحات (DESCRIPTION)

ویرایش فایل مشخص‌شده در پنجرهٔ هم‌پوشان (overlay) kitty. این قابلیت از طریق SSH نیز کار می‌کند.

برای دستورالعمل‌های استفاده، ببینید: https://sw.kovidgoyal.net/kitty/shell-integration/#edit-file

گزینه‌ها (OPTIONS)

--title, --window-title

عنوانی که برای پنجرهٔ جدید تنظیم می‌شود. به‌طور پیش‌فرض، عنوان توسط فرآیند فرزند کنترل می‌شود. مقدار ویژهٔ current عنوان را از --source-window کپی می‌کند.

--tab-title

عنوان برگهٔ جدید در صورتی که در یک برگهٔ تازه راه‌اندازی شود. به‌طور پیش‌فرض، عنوان پنجرهٔ فعال در برگه به‌عنوان عنوان برگه استفاده می‌شود. مقدار ویژهٔ current عنوان را از برگه‌ای که شامل --source-window است کپی می‌کند.

--type [=window]

محل راه‌اندازی فرآیند فرزند:

window
یک پنجرهٔ جدید kitty در برگهٔ فعلی

tab
یک برگهٔ جدید در پنجرهٔ فعلی سیستم‌عامل. هنگام استفاده از دستور launch <launch> در نشست‌های راه‌اندازی (startup sessions) در دسترس نیست.

os-window
یک پنجرهٔ جدید در سیستم‌عامل. هنگام استفاده از دستور launch <launch> در نشست‌های راه‌اندازی در دسترس نیست.

overlay
یک پنجرهٔ هم‌پوشان (overlay) که پنجرهٔ فعال فعلی kitty را می‌پوشاند

overlay-main
یک پنجرهٔ هم‌پوشان که پنجرهٔ فعال فعلی kitty را می‌پوشاند. برخلاف پنجرهٔ overlay ساده، این پنجره به‌عنوان یک پنجرهٔ اصلی در نظر گرفته می‌شود؛ به این معنی که به‌عنوان پنجرهٔ فعال برای به‌دست آوردن دایرکتوری کاری فعلی، متن ورودی برای kittenها، دستورات launch و غیره استفاده می‌شود. در صورتی که قرار باشد این پنجرهٔ هم‌پوشان برای مدتی طولانی به‌عنوان یک پنجرهٔ اولیه اجرا شود، مفید است.

background
فرآیند در پس‌زمینه و بدون پنجرهٔ kitty اجرا خواهد شد. توجه داشته باشید که در صورت مشخص شدن --allow-remote-control متغیر محیطی KITTY_LISTEN_ON روی یک توصیف‌گر فایل جفت‌سوکت اختصاصی تنظیم می‌شود که فرآیند می‌تواند از آن برای کنترل از راه دور استفاده کند.

clipboard, primary
این دو برای کار با --stdin-source جهت کپی داده‌ها در کلیپ‌بورد سیستم یا انتخاب اولیه (primary selection) در نظر گرفته شده‌اند.

os-panel
مشابه os-window است، با این تفاوت که پنجرهٔ سیستم‌عامل جدید را به‌عنوان یک پنل میزکار ایجاد می‌کند. تنها روی پلتفرم‌هایی که از این قابلیت پشتیبانی می‌کنند کار می‌کند، مانند کامپوزیتورهای Wayland که از پروتکل layer shell پشتیبانی می‌کنند. از گزینهٔ --os-panel برای پیکربندی پنل استفاده کنید.

انتخاب‌ها: window, background, clipboard, os-panel, os-window, overlay, overlay-main, primary, tab

--dont-take-focus, --keep-focus [=no]

نگه‌داشتن تمرکز (focus) روی پنجرهٔ فعال فعلی به‌جای انتقال آن به پنجرهٔ تازه‌بازشده.

--cwd

دایرکتوری کاری برای فرزند تازه‌راه‌اندازی‌شده. از مقدار ویژهٔ current برای استفاده از دایرکتوری کاریِ --source-window استفاده کنید. مقدار ویژهٔ last_reported از آخرین دایرکتوری کاری گزارش‌شده توسط پوسته استفاده می‌کند (برای کارکرد نیاز به shell_integration دارد). مقدار ویژهٔ oldest مانند current عمل می‌کند اما به‌جای جدیدترین فرآیند، از دایرکتوری کاری قدیمی‌ترین فرآیند پیش‌زمینهٔ مرتبط با پنجرهٔ فعال فعلی استفاده می‌کند. در نهایت، مقدار ویژهٔ root به فرآیندی اشاره دارد که در ابتدا هنگام ایجاد پنجره آغاز شده بود.

هنگامی که باز کردن در همان دایرکتوری کاری پنجرهٔ فعلی باعث اتصال پنجرهٔ جدید به یک میزبان راه دور می‌شود، می‌توانید از گزینهٔ --hold-after-ssh برای جلوگیری از بسته‌شدن پنجرهٔ جدید پس از قطع اتصال استفاده کنید.

--var

متغیرهای کاربر برای تنظیم در پنجرهٔ ایجادشده. می‌تواند چندین بار برای تنظیم متغیرهای مختلف کاربر مشخص شود. نحو: name=value. استفاده از name= مقدار را به یک رشتهٔ خالی تنظیم می‌کند.

--hold [=no]

باز نگه‌داشتن پنجره حتی پس از خروج دستور اجراشده، در اعلان پوسته (shell prompt). پوسته پس از خروج دستور راه‌اندازی‌شده اجرا خواهد شد.

--location [=default]

محل قرارگیری پنجرهٔ تازه‌ساخته‌شده هنگام افزودن آن به برگه‌ای که از قبل دارای پنجره است. مقادیر after و before پنجرهٔ جدید را قبل یا بعد از پنجرهٔ فعال قرار می‌دهند. neighbor مترادفی برای after است. همچنین هنگام ایجاد یک برگهٔ جدید نیز کاربرد دارد، که در آن مقدار after باعث می‌شود برگهٔ جدید به‌جای انتها، در کنار برگهٔ فعلی قرار گیرد. مقادیر vsplit ،hsplit و split تنها توسط چیدمان splits استفاده می‌شوند و تعیین می‌کنند که پنجرهٔ جدید به‌صورت عمودی، افقی یا تقسیم خودکار با پنجرهٔ فعال فعلی قرار گیرد. حالت پیش‌فرض، قرار دادن پنجره به شیوه‌ای وابسته به چیدمان است که معمولاً پس از پنجرهٔ فعال فعلی خواهد بود. برای استفاده از پنجره‌ای غیر از پنجرهٔ فعال فعلی، به --next-to مراجعه کنید.

انتخاب‌ها: default, after, before, first, hsplit, last, neighbor, split, vsplit

--next-to

یک عبارت تطبیق برای انتخاب پنجره‌ای که پنجرهٔ جدید در کنار آن ایجاد می‌شود. برای نحو مشخص کردن پنجره‌ها به search_syntax مراجعه کنید. در صورت مشخص نشدن، پیش‌فرض پنجرهٔ فعال است. هنگام استفاده از طریق کنترل از راه دور، این گزینه نادیده گرفته می‌شود مگر اینکه پنجرهٔ مطابقت‌یافته در برگهٔ هدف (پیش‌فرض برگهٔ فعال) باشد. هنگام استفاده از --type با مقدار tab، برگه در پنجرهٔ سیستم‌عامل حاوی پنجرهٔ مطابقت‌یافته ایجاد خواهد شد.

--os-window-class

تنظیم مشخصهٔ WM_CLASS در X11 و مشخصهٔ application id در Wayland برای پنجرهٔ سیستم‌عامل تازه‌ساخته‌شده هنگام استفاده از --type. پیش‌فرض آن هر مقداری است که توسط فرآیند والد kitty استفاده شده باشد، که خود به‌طور پیش‌فرض kitty است.

--os-window-name

تنظیم مشخصهٔ WM_NAME در X11 برای پنجرهٔ سیستم‌عامل تازه‌ساخته‌شده هنگام استفاده از --type. پیش‌فرض آن --os-window-class است.

--os-window-title

تنظیم عنوان پنجرهٔ سیستم‌عامل تازه‌ساخته‌شده. این عنوان بر هر عنوانی که توسط برنامه‌های در حال اجرا در kitty تنظیم شده باشد برتری خواهد داشت. مقدار ویژهٔ current عنوان را از پنجرهٔ سیستم‌عامل حاوی --source-window کپی می‌کند.

--os-window-state [=normal]

وضعیت اولیه پنجرهٔ سیستم‌عامل تازه‌ساخته‌شده.

انتخاب‌ها: normal, fullscreen, maximized, minimized

--os-window-position

موقعیت روی صفحه نمایش، برای مثال 10x20، که پنجرهٔ سیستم‌عامل تازه‌ساخته‌شده در آن قرار گیرد. این گزینه بسته به سیاست‌های محیط میزکار/مدیر پنجره ممکن است عمل کند یا نکند. در Wayland هرگز کار نمی‌کند.

--logo

مسیر فایل تصویری PNG برای استفاده به‌عنوان نشان‌وارهٔ (لوگو) پنجرهٔ تازه‌ساخته‌شده. به window_logo_path مراجعه کنید. مسیرهای نسبی بر اساس دایرکتوری پیکربندی kitty تفسیر می‌شوند.

--logo-position

موقعیت قرارگیری نشان‌وارهٔ پنجره. تنها زمانی اثر دارد که --logo مشخص شده باشد. به window_logo_position مراجعه کنید.

--logo-alpha [=-1]

میزان محوشدن نشان‌وارهٔ پنجره در پس‌زمینه. تنها زمانی اثر دارد که --logo مشخص شده باشد. به window_logo_alpha مراجعه کنید.

--spacing

تنظیم margin (حاشیه بیرونی) و padding (حاشیه درونی) برای پنجرهٔ تازه‌ساخته‌شده. برای مثال: margin=20 یا padding-left=10 یا margin-h=30. شکل خلاصه همهٔ مقادیر را تنظیم می‌کند، و متغیرهای *-h و *-v مقادیر افقی و عمودی را مشخص می‌کنند. می‌تواند چندین بار مشخص شود. توجه داشته باشید که این گزینه برای پنجره‌های هم‌پوشان (overlay) نادیده گرفته می‌شود زیرا آن‌ها از تنظیمات پنجرهٔ پایه استفاده می‌کنند.

--hold-after-ssh [=no]

هنگام استفاده از --cwd=current یا موارد مشابه از پنجره‌ای که در حال اجرای ssh kitten است، در صورت مشخص شدن این گزینه، پنجرهٔ جدید پس از قطع اتصال از میزبان راه دور یک پوستهٔ محلی را اجرا خواهد کرد.

--max-file-size [=8]

حداکثر اندازهٔ مجاز فایل‌ها برای ویرایش (به مگابایت). از آنجا که داده‌های فایل باید به‌صورت base64 کدگذاری شده و از طریق دستگاه tty منتقل شوند، فایل‌های بیش از حد بزرگ عملکرد مناسبی نخواهند داشت.

--help, -h [=no]

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