.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "kitten-desktop-ui" 1 "Jul 30, 2026" "0.48.2" "kitty"
.SH "نام (NAME)"
kitten-desktop-ui \- اجزای رابط کاربری میزکار سازگار با ترمینال و صفحه‌کلید
.SH "نمای کلی (OVERVIEW)"
.sp
افزوده‌شده در نسخه 0.43.0.

.sp
کاربران حرفه‌ای ترمینال در لینوکس معمولاً ترجیح می‌دهند به‌جای محیط‌های میزکار کامل، از مدیر پنجره‌های حداقلی و ساده (bare bones) استفاده کنند. این kitten کمک می‌کند تا بخش‌هایی از محیط میزکار که در این‌گونه پیکربندی‌ها وجود ندارند فراهم شوند؛ این کار با استفاده از اجزای رابط کاربری متمرکز بر ترمینال و سازگار با صفحه‌کلید انجام می‌شود. برخی از ویژگی‌های آن عبارتند از:
.INDENT 0.0
.IP \(bu 2
جایگزینی دیالوگ‌های متداول باز کردن/ذخیره فایل در برنامه‌های گرافیکی (GUI) با برنامه پرسرعت و صفحه‌کلیدمحور \fIchoose\-files\fP \%<> که در یک لایه نیمه‌شفاف کیتی اجرا می‌شود.
.IP \(bu 2
امکان مدیریت ساده حالت روشن/تاریک (light/dark) میزکار از طریق خط فرمان.
.UNINDENT
.SH "نحوه نصب (HOW TO INSTALL)"
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این kitten در پس‌زمینه برای ارائه اجزای رابط کاربری بر برنامه جانبی \fIpanel\fP \%<> متکی است. مستندات \%<#\:panel-compat> آن kitten را بررسی کنید تا ببینید آیا مدیر پنجره شما با آن کار می‌کند یا خیر.
.UNINDENT
.UNINDENT
.sp
ابتدا دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kitten desktop\-ui enable\-portal
.EE
.UNINDENT
.UNINDENT
.sp
سپس، دو متغیر محیطی زیر را به صورت \fIسراسری در سیستم\fP تنظیم کنید، یعنی در فایل \fB/etc/environment\fP یا معادل آن در توزیع خود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QT_QPA_PLATFORMTHEME=xdgdesktopportal
GTK_USE_PORTAL=1
.EE
.UNINDENT
.UNINDENT
.sp
در پایان، سیستم را راه‌اندازی مجدد کنید. اکنون، هنگامی که کادر محاوره‌ای فایل را در اکثر برنامه‌های گرافیکی باز می‌کنید، باید به‌جای دیالوگ معمولی باز کردن فایل، برنامه \fIchoose\-files\fP \%<> باز شود. می‌توانید با اجرای دستورات زیر حالت روشن/تاریک کنونی میزکار خود را تغییر دهید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kitten desktop\-ui set\-color\-scheme dark
kitten desktop\-ui set\-color\-scheme light
.EE
.UNINDENT
.UNINDENT
.sp
مقدار فعلی را با استفاده از دستور زیر بررسی کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dbus\-send \-\-session \-\-print\-reply \-\-dest=org.freedesktop.portal.Desktop /org/freedesktop/portal/desktop org.freedesktop.portal.Settings.Read string:org.freedesktop.appearance string:color\-scheme
.EE
.UNINDENT
.UNINDENT
.SH "نحوه کارکرد (HOW IT WORKS)"
.sp
میزکارهای مدرن لینوکس دارای سازوکاری موسوم به پورتال‌ها (portals) \%<https://\:flatpak\:.github\:.io/\:xdg-desktop-portal/\:docs/\:index\:.html> هستند که برای برنامه‌های ایزوله (sandboxed) ابداع شدند و امکانات مختلفی را از طریق DBUS در اختیار چنین برنامه‌هایی قرار می‌دهند، از جمله دیالوگ‌های باز کردن فایل، تنظیمات مشترک میزکار و غیره. این kitten با پیاده‌سازی یک بک‌اند برای برخی از این سرویس‌ها کار می‌کند.
.sp
سپس می‌توان به برنامه‌های معمولی گرافیکی اعلام کرد که از این سرویس‌ها استفاده کنند، و در نتیجه به ما این امکان را می‌دهد که بخش‌هایی از تجربه میزکار را در صورت نیاز جایگزین نماییم.
.sp
چندین پیاده‌سازی رقیب برای این بک‌اندها وجود دارد. هر محیط میزکار مانند KDE یا GNOME بک‌اند مخصوص به خود را دارد و بسیاری از مدیر پنجره‌ها نیز پیاده‌سازی‌هایی را برای برخی بک‌اندها ارائه می‌دهند. شناسایی سرویس‌ها و پیکربندی اینکه از کدام بک‌اند استفاده شود، از طریق برنامه \fBxdg\-desktop\-portal\fP انجام می‌گیرد که معمولاً در مسیر \fB/usr/lib/xdg\-desktop\-portal\fP یافت می‌شود.
.sp
این برنامه را می‌توان با فایل‌هایی در پوشه \fB~/.local/share/xdg\-desktop\-portal\fP پیکربندی کرد. به صفحه راهنمای portals.conf \%<https://\:man\:.archlinux\:.org/\:man/\:portals\:.conf.5> مراجعه فرمایید. دستور \fBkitten desktop\-ui enable\-portal\fP تنظیمات اولیه را به‌طور خودکار برای شما انجام می‌دهد. اگر می‌خواهید مشخص کنید دقیقاً برای کدام سرویس‌ها از این kitten استفاده شود، دستور را اجرا کرده و سپس فایل پیکربندی‌ای را که دستور اعلام می‌کند وصله (patch) کرده است، ویرایش کنید.
.SH "عیب‌یابی (TROUBLESHOOTING)"
.sp
ابتدا مطمئن شوید که DBUS قادر است در صورت نیاز این kitten را به صورت خودکار اجرا کند. اگر kitten از قبل در حال اجرا نیست، دستور زیر را امتحان کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dbus\-send \-\-session \-\-print\-reply \-\-dest=org.freedesktop.impl.portal.desktop.kitty \e
    /net/kovidgoyal/kitty/portal org.freedesktop.DBus.Properties.GetAll \e
    string:net.kovidgoyal.kitty.settings
.EE
.UNINDENT
.UNINDENT
.sp
اگر DBUS قادر به اجرای kitten باشد یا اگر از قبل در حال اجرا باشد، ویژگی نسخه را چاپ خواهد کرد، در غیر این صورت با خطا مواجه خواهد شد. در صورت بروز خطا، فایل زیر را بررسی کنید:
\fB~/.local/share/dbus\-1/services/org.freedesktop.impl.portal.desktop.kitty.service\fP
که باید توسط دستور \fBenable\-portal\fP ایجاد شده باشد. کلید \fBExec\fP آن باید به مسیر کامل فایل اجرایی kitten اشاره کند.
.sp
سپس بررسی کنید که آیا سامانه پورتال XDG واقعاً از این kitten به عنوان بک‌اند تنظیمات خود استفاده می‌کند یا خیر. دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dbus\-send \-\-session \-\-print\-reply \-\-dest=org.freedesktop.portal.Desktop \e
    /org/freedesktop/portal/desktop org.freedesktop.portal.Settings.Read \e
    string:net.kovidgoyal.kitty string:status
.EE
.UNINDENT
.UNINDENT
.sp
اگر این دستور پاسخی برگرداند، kitten طبق انتظار استفاده می‌شود. اگر خطای پیدا نشدن (not found) برگرداند، بک‌اند دیگری برای تنظیمات در حال استفاده است.
.sp
صفحه راهنمای \fBportals.conf\fP را مطالعه کرده و دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
/usr/lib/xdg\-desktop\-portal \-r v
.EE
.UNINDENT
.UNINDENT
.sp
این دستور حجم زیادی از اطلاعات اشکال‌زدایی را چاپ می‌کند که مشخص می‌سازد کدام بک‌اند برای کدام سرویس انتخاب شده است. خروجی اشکال‌زدایی را به دقت بررسی کنید تا علت انتخاب نشدن kitten را مشخص نمایید.
.sp
اگر برخی برنامه‌های گرافیکی برای کادرهای انتخاب فایل از برنامه choose\-files استفاده نمی‌کنند، مطمئن شوید متغیرهای محیطی ذکرشده در بالا تنظیم شده‌اند؛ همچنین می‌توانید برنامه گرافیکی را با تنظیم صریح این متغیرها اجرا کنید، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QT_QPA_PLATFORMTHEME=xdgdesktopportal GTK_USE_PORTAL=1 my\-gui\-app
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که همه برنامه‌ها از پورتال‌ها استفاده نمی‌کنند؛ بنابراین اگر برنامه خاصی در استفاده از پورتال ناموفق است اما بقیه کار می‌کنند، موضوع را به توسعه‌دهندگان آن برنامه گزارش دهید.
.SH "پیکربندی (CONFIGURATION)"
.sp
می‌توانید جنبه‌های مختلف عملکرد kitten را با ایجاد فایل \fBdesktop\-ui\-portal.conf\fP در پوشه پیکربندی kitty خود \%<#\:confloc> تنظیم کنید. در ادامه دستورالعمل‌های پیکربندی پشتیبانی‌شده آورده شده است.
.SH "ظاهر (APPEARANCE)"
.INDENT 0.0
.TP
.B color_scheme
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
color_scheme no\-preference
.EE
.UNINDENT
.UNINDENT
.sp
طرح رنگ برای سیستم شما. این گزینه مقدار اولیه طرح رنگ را تنظیم می‌کند. بعداً می‌توان آن را با استفاده از \fBkitten desktop\-ui color\-scheme\fP تغییر داد.
.INDENT 0.0
.TP
.B accent_color
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
accent_color cyan
.EE
.UNINDENT
.UNINDENT
.sp
رنگ تاکیدی (RGB) برای سیستم شما؛ می‌تواند به صورت نام رنگ یا در قالب هگزادسیمال مشخص شود.
.INDENT 0.0
.TP
.B contrast
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
contrast normal
.EE
.UNINDENT
.UNINDENT
.sp
سطح کنتراست ترجیحی.
.INDENT 0.0
.TP
.B file_chooser_size
.UNINDENT
.sp
اندازه پنجره بازشوی انتخاب‌گر فایل بر حسب سطر و ستون. به صورت پیش‌فرض تمام‌صفحه است. برای نمونه: \fBfile_chooser_size 25 80\fP باعث می‌شود اندازه پنجره بازشو ۲۵ سطر و ۸۰ ستون باشد. توجه داشته باشید در صورت استفاده از این گزینه، بسته به کامپوزیتور در حال اجرا، ممکن است پنجره بازشو به درستی مودال (modal) نباشد.
.INDENT 0.0
.TP
.B file_chooser_kitty_conf
.UNINDENT
.sp
مسیر فایل پیکربندی مورد استفاده برای kitty هنگام رسم پنجره انتخاب‌گر فایل. می‌تواند چندین بار مشخص شود. به صورت پیش‌فرض از فایل عادی kitty.conf استفاده می‌شود. مسیرهای نسبی نسبت به دایرکتوری پیکربندی kitty سنجیده می‌شوند.
.INDENT 0.0
.TP
.B file_chooser_kitty_override
.UNINDENT
.sp
بازنویسی گزینه‌های پیکربندی تکی kitty برای پنجره انتخاب‌گر فایل. می‌تواند چندین بار مشخص شود. نحو: name=value\&. برای مثال: \fBfont_size=20\fP\&.
.SH "نویسنده (AUTHOR)"

Kovid Goyal
.SH "حق نشر (COPYRIGHT)"

2026, Kovid Goyal
.\" End of generated man page.