'\" t .\" 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-choose-files" 1 "Jul 30, 2026" "0.48.2" "kitty" .SH "نام (NAME)" kitten-choose-files \- ابزار انتخاب سریع پرونده‌ها و پوشه‌ها در ترمینال Kitty .SH "نمای کلی (OVERVIEW)" .sp افزوده‌شده در نسخه 0.45.0. .sp کیتن choose\-files به منظور فراهم ساختن امکان انتخاب بسیار سریع پرونده‌ها تنها با چند فشردن کلید طراحی شده است. عملکرد آن مانند fzf % و سایر یابنده‌های فازی (fuzzy finders) است، با این تفاوت که به طور خاص برای یافتن پرونده‌ها تخصص یافته است. از این رو، به صورت پیش‌فرض از ویژگی‌هایی نظیر پالایش بر اساس نوع پرونده، آیکون انواع پرونده، پیش‌نمایش محتوا و مواردی از این دست پشتیبانی می‌کند. این ابزار می‌تواند به عنوان جایگزینی سرراست (اما بسیار کارآمدتر و سازگارتر با صفحه‌کلید) برای کادرهای محاوره‌ای متداول باز کردن و ذخیره پرونده در برنامه‌های گرافیکی (GUI) استفاده شود. در لینوکس، با کمک کیتن desktop\-ui %<> حتی می‌توانید اکثر برنامه‌های گرافیکی رایانه خود را وادار کنید به جای کادرهای گفتگوی معمولی پرونده از این کیتن استفاده کنند. .sp تنها کافی است آن را به صورت زیر اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX kitten choose\-files .EE .UNINDENT .UNINDENT .sp تا یک پرونده واحد را از درخت ریشه‌گرفته از دایرکتوری کاری جاری انتخاب کنید. .sp چند حرف از نام پرونده را تایپ کنید و هنگامی که به بالاترین گزینه انتخابی تبدیل شد، کلید \fBEnter\fP را بفشارید. می‌توانید با انتخاب یک دایرکتوری و زدن کلید \fBTab\fP دایرکتوری جاری را تغییر دهید. فشردن \fBShift\fP+\fBTab\fP یک سطح دایرکتوری به بالا می‌رود. .sp اگر مایلید پرونده‌ای را انتخاب کرده و آن را در اعلان شل در موقعیت مکان‌نمای جاری درج نمایید، برای پرونده‌ها \fBctrl+shift+p>c\fP %<#\:shortcut-kitty\:.Insert-chosen-file> یا برای دایرکتوری‌ها \fBctrl+shift+p>d\fP %<#\:shortcut-kitty\:.Insert-chosen-directory> را بفشارید. به طور مشابه، برای درج پرونده انتخاب‌شده در یک خط فرمان، به عنوان مثال استفاده کنید از: .INDENT 0.0 .INDENT 3.5 .sp .EX some\-command $(kitten choose\-file) .EE .UNINDENT .UNINDENT .sp توجه داشته باشید که مورد بالا ممکن است در پایپ‌لاین‌های پیچیده کار نکند، چرا که ورودی/خروجی ترمینال انجام می‌دهد و هنگام انتخاب پرونده نیازمند دسترسی انحصاری به دستگاه tty است. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 برای پیش‌نمایش محتوا، این کیتن از برخی برنامه‌های خارجی استفاده می‌کند. به طور مشخص ffmpeg % برای پیش‌نمایش‌های ویدیو و calibre % برای متادیتا و پیش‌نمایش جلد کتاب‌های الکترونیکی مورد نیاز است. .UNINDENT .UNINDENT .SH "ایجاد میان‌بر برای دایرکتوری‌های برگزیده/پرکاربرد (Creating shortcuts to favorite/frequently used directories)" .sp می‌توانید در \fBchoose\-files.conf\fP میان‌برهای صفحه‌کلید ایجاد کنید تا به سرعت به هر دایرکتوری دلخواه جابه‌جا شوید. به عنوان مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+t cd /tmp map alt+p cd ~/my/project .EE .UNINDENT .UNINDENT .SH "انتخاب چندین پرونده (Selecting multiple files)" .sp هنگامی که مایل به انتخاب چند پرونده هستید، کیتن را با \fB\-\-mode\fP\fB=files\fP اجرا کنید. سپس به جای فشردن \fBEnter\fP، کلید \fBShift\fP+\fBEnter\fP را بفشارید تا پرونده به فهرست انتخاب‌ها اضافه شود. همچنین می‌توانید کلید \fBCtrl\fP را نگه داشته و روی پرونده‌ها کلیک کنید تا به گزینه‌های انتخابی افزوده شوند. به طور مشابه، می‌توانید کلید \fBAlt\fP را نگه داشته و کلیک کنید تا دامنه‌ای از پرونده‌ها انتخاب شوند (مشابه استفاده از \fBShift\fP+\fBclick\fP در برنامه‌های گرافیکی). برای پایان کار، روی آخرین پرونده انتخاب‌شده \fBEnter\fP را بفشارید. فهرست پرونده‌های انتخاب‌شده در پایین کیتن نمایش داده می‌شود و می‌توانید با کلیک روی هر یک، آن را از حالت انتخاب خارج کنید. به طور مشابه، فشردن \fBShift\fP+\fBEnter\fP پرونده‌ای را که قبلاً انتخاب شده از حالت انتخاب خارج می‌کند. .SH "پرونده‌های پنهان و نادیده‌گرفته‌شده (Hidden and ignored files)" .sp به صورت پیش‌فرض، این کیتن پرونده‌ها و دایرکتوری‌های پنهان (که نام آن‌ها با یک نقطه آغاز می‌شود) را پردازش نمی‌کند. این رفتار را می‌توان \fBدر پیکربندی تغییر داد\fP و همچنین در حین اجرا از طریق پیوند قابل‌کلیک در سمت راست ورودی جستجو تغییر داد. .sp به طور مشابه، این کیتن به طور پیش‌فرض پرونده‌های \fB\&.gitignore\fP و \fB\&.ignore\fP را رعایت می‌کند. این مورد نیز هم \fBدر پیکربندی\fP و هم در حین اجرا قابل تغییر است. توجه داشته باشید که پرونده‌های \fB\&.gitignore\fP تنها در صورتی رعایت می‌شوند که یک دایرکتوری \fB\&.git\fP نیز وجود داشته باشد. این کیتن همچنین از پرونده سراسری \fB\&.gitignore\fP پشتیبانی می‌کند، هرچند فقط در درخت‌های کاری گیت اعمال می‌شود. می‌توانید \fBالگوهای نادیده‌گیری سراسری\fP را که در همه‌جا اعمال می‌شوند در \fBchoose\-files.conf\fP مشخص کنید. .SH "انتخاب پرونده‌های ناموجود (نام‌های ذخیره پرونده) (Selecting non-existent files (save file names))" .sp از این کیتن همچنین می‌توان برای انتخاب پرونده‌های ناموجود استفاده کرد، یعنی پرونده‌ای جدید برای کادر محاوره‌ای نوع «ذخیره پرونده» با استفاده از \fB\-\-mode\fP\fB=save\-file\fP\&. پس از رفتن به دایرکتوری مورد نظر (با استفاده از کلید \fBTab\fP)، کلید \fBCtrl\fP+\fBEnter\fP را بفشارید تا بتوانید نام پرونده را تایپ کنید. اگر می‌خواهید نام یک پرونده موجود را ویرایش کنید، به جای آن از \fBAlt\fP+\fBEnter\fP استفاده کنید تا نام منطبق‌ترین گزینه فعلی ویرایش شود. .SH "انتخاب دایرکتوری‌ها (Selecting directories)" .sp از این کیتن می‌توان برای انتخاب دایرکتوری‌ها نیز استفاده کرد، برای کادر محاوره‌ای نوع «باز کردن دایرکتوری» با استفاده از \fB\-\-mode\fP\fB=dir\fP\&. پس از رفتن به دایرکتوری مورد نظر، کلید \fBCtrl\fP+\fBEnter\fP را بفشارید تا پذیرفته شود. یا اگر در دایرکتوری والد هستید، می‌توانید با فشردن \fBEnter\fP یک زیردایرکتوری را انتخاب کنید، دقیقاً همانند انتخاب پرونده برای باز کردن. .SH "انتخاب پرونده‌ها یا دایرکتوری‌ها (Selecting files or directories)" .sp برای انتخاب هر مسیر موجودی، خواه پرونده باشد یا دایرکتوری، از \fB\-\-mode\fP\fB=all\fP استفاده کنید. برای انتخاب مسیر برجسته‌شده، کلید \fBEnter\fP را بفشارید. همچنان می‌توانید از \fBTab\fP برای ورود به دایرکتوری برجسته‌شده و از \fBCtrl\fP+\fBEnter\fP برای انتخاب خود دایرکتوری جاری استفاده کنید. .SH "ویرایش متن جستجو (Editing the search text)" .sp کادر متن جستجو/پالایش از همان موتور ویرایش خط کیتن اعلان شل استفاده می‌کند و از میان‌برهای ویرایشی متداول به سبک Emacs پشتیبانی می‌کند، مانند \fBCtrl\fP+\fBA\fP/\fBCtrl\fP+\fBE\fP برای رفتن به ابتدا/انتهای متن، \fBCtrl\fP+\fBLeft\fP/\fBCtrl\fP+\fBRight\fP برای حرکت به اندازه یک کلمه، \fBCtrl\fP+\fBK\fP/\fBCtrl\fP+\fBU\fP برای حذف تا انتها/ابتدای خط، \fBCtrl\fP+\fBW\fP/\fBAlt\fP+\fBD\fP برای حذف کلمه قبلی/بعدی و مواردی از این دست. .sp با این حال، به طور پیش‌فرض کلیدهای جهت‌نما و همچنین \fBHome\fP، \fBEnd\fP، \fBCtrl\fP+\fBHome\fP و \fBCtrl\fP+\fBEnd\fP به عملیات پیمایش فهرست نتایج منطبق مقید شده‌اند، نه جابه‌جایی مکان‌نما در متن جستجو، چرا که این رفتار هنگام پالایش سریع فهرست پرونده‌ها کاربرد بیشتری دارد. اگر ترجیح می‌دهید این کلیدها به جای آن متن جستجو را ویرایش کنند (همانند یک ورودی متنی معمولی)، می‌توانید آن‌ها را در \fBchoose\-files.conf\fP به یکی از کنش‌های زیر مقید کنید که فشردن کلید را به ویرایشگر متن جستجو ارسال می‌کند: .TS box center; l|l. T{ کنش (Action) T} T{ عملیات ویرایشی انجام‌شده T} _ T{ \fBedit_cursor_left\fP T} T{ انتقال مکان‌نما یک نویسه به سمت چپ T} _ T{ \fBedit_cursor_right\fP T} T{ انتقال مکان‌نما یک نویسه به سمت راست T} _ T{ \fBedit_start_of_line\fP T} T{ انتقال مکان‌نما به ابتدای متن جستجو T} _ T{ \fBedit_end_of_line\fP T} T{ انتقال مکان‌نما به انتهای متن جستجو T} _ T{ \fBedit_start_of_document\fP T} T{ همانند \fBedit_start_of_line\fP، برای هماهنگی با ویرایشگر خط اعلان شل T} _ T{ \fBedit_end_of_document\fP T} T{ همانند \fBedit_end_of_line\fP، برای هماهنگی با ویرایشگر خط اعلان شل T} _ T{ \fBedit_forward_word\fP T} T{ انتقال مکان‌نما به اندازه یک کلمه به جلو T} _ T{ \fBedit_backward_word\fP T} T{ انتقال مکان‌نما به اندازه یک کلمه به عقب T} _ T{ \fBedit_backspace\fP T} T{ حذف نویسه قبل از مکان‌نما T} _ T{ \fBedit_delete\fP T} T{ حذف نویسه بعد از مکان‌نما T} _ T{ \fBedit_kill_to_start_of_line\fP T} T{ حذف همه چیز از ابتدای خط تا مکان‌نما T} _ T{ \fBedit_kill_to_end_of_line\fP T} T{ حذف همه چیز از مکان‌نما تا انتهای خط T} _ T{ \fBedit_kill_word_left\fP T} T{ حذف کلمه قبل از مکان‌نما T} _ T{ \fBedit_kill_word_right\fP T} T{ حذف کلمه بعد از مکان‌نما T} _ T{ \fBedit_yank\fP T} T{ درج آخرین متن حذف‌شده T} .TE .sp به عنوان مثال، برای اینکه کلیدهای جهت‌نما، \fBHome\fP و \fBEnd\fP به جای پیمایش فهرست نتایج، متن جستجو را ویرایش کنند: .INDENT 0.0 .INDENT 3.5 .sp .EX map left edit_cursor_left map right edit_cursor_right map home edit_start_of_line map end edit_end_of_line map ctrl+home edit_start_of_document map ctrl+end edit_end_of_document .EE .UNINDENT .UNINDENT .sp توجه داشته باشید که \fBUp\fP، \fBDown\fP و سایر کلیدهایی که در بالا ذکر نشده‌اند، حتی پس از اعمال بازتعریف‌های فوق همچنان برای پیمایش فهرست نتایج قابل استفاده هستند. همچنین توجه داشته باشید که هر کلیدی که به هیچ کنشی مقید نشده باشد به طور خودکار به ویرایشگر متن جستجو هدایت می‌شود؛ به همین دلیل کلیدهایی نظیر \fBBackspace\fP، \fBDelete\fP، \fBCtrl\fP+\fBK\fP، \fBCtrl\fP+\fBW\fP و غیره از قبل متن جستجو را بدون نیاز به هیچ‌یک از کنش‌های بالا ویرایش می‌کنند. .SH "پیکربندی (CONFIGURATION)" .sp می‌توانید جنبه‌های گوناگون عملکرد کیتن را با ایجاد یک \fBchoose\-files.conf\fP در پوشه پیکربندی kitty خود %<#\:confloc> پیکربندی کنید. برای دستورالعمل‌های پیکربندی پشتیبانی‌شده به موارد زیر مراجعه کنید. .SH "پویش سیستم پرونده (Filesystem scanning)" .INDENT 0.0 .TP .B show_hidden .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX show_hidden last .EE .UNINDENT .UNINDENT .sp نمایش یا عدم نمایش پرونده‌های پنهان. مقدار پیش‌فرض \fBlast\fP به معنای به‌خاطرسپاری آخرین مقدار استفاده‌شده است. این تنظیم را می‌توان در داخل برنامه تغییر وضعیت داد (toggle). .INDENT 0.0 .TP .B sort_by_last_modified .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX sort_by_last_modified last .EE .UNINDENT .UNINDENT .sp مرتب‌سازی فهرست ورودی‌ها بر اساس آخرین تاریخ تغییر، به جای نام. توجه داشته باشید که مرتب‌سازی فقط پیش از وارد کردن هرگونه عبارت جستجو اعمال می‌شود. به محض وارد شدن عبارت، ورودی‌ها بر اساس امتیاز تطابق مرتب می‌شوند. مقدار پیش‌فرض \fBlast\fP به معنای به‌خاطرسپاری آخرین مقدار استفاده‌شده است. این تنظیم را می‌توان در داخل برنامه تغییر وضعیت داد. .INDENT 0.0 .TP .B respect_ignores .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX respect_ignores last .EE .UNINDENT .UNINDENT .sp رعایت یا عدم رعایت پرونده‌های gitignore. و ignore. و تنظیم \fBignore\fP\&. مقدار پیش‌فرض \fBlast\fP به معنای به‌خاطرسپاری آخرین مقدار استفاده‌شده است. این تنظیم را می‌توان در داخل برنامه تغییر وضعیت داد. .INDENT 0.0 .TP .B ignore .UNINDENT .sp یک الگوی نادیده‌گیری برای نادیده گرفتن پرونده‌های منطبق. از ساختار مشابه پرونده‌های \fB\&.gitignore\fP استفاده می‌کند (به \fBman gitignore\fP مراجعه کنید). الگوهای مقید (Anchored) با توجه به هر دایرکتوری که در حال حاضر نمایش داده می‌شود مطابقت داده می‌شوند. برای استفاده از چندین الگو می‌توان این گزینه را چندین بار مشخص کرد. توجه داشته باشید که هر الگو باید در برابر تک‌تک پرونده‌ها بررسی شود، بنابراین در استفاده از آن صرفه‌جویی کنید. .SH "ظاهر (Appearance)" .INDENT 0.0 .TP .B show_preview .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX show_preview last .EE .UNINDENT .UNINDENT .sp نمایش یا عدم نمایش پیش‌نمایش پرونده/دایرکتوری جاری. مقدار پیش‌فرض \fBlast\fP به معنای به‌خاطرسپاری آخرین مقدار استفاده‌شده است. این تنظیم را می‌توان در داخل برنامه تغییر وضعیت داد. .INDENT 0.0 .TP .B pygments_style .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX pygments_style default .EE .UNINDENT .UNINDENT .sp طرح‌واره رنگی pygments برای برجسته‌سازی نحوی (syntax highlighting) پیش‌نمایش پرونده‌ها. برای فهرست طرح‌واره‌ها به سبک‌های درونی pygments % مراجعه کنید. این گزینه رنگ‌های مورد استفاده برای طرح‌واره‌های روشن را تنظیم می‌کند؛ از \fBdark_pygments_style\fP برای تغییر رنگ‌ها در طرح‌واره‌های تیره استفاده کنید. .INDENT 0.0 .TP .B dark_pygments_style .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX dark_pygments_style github\-dark .EE .UNINDENT .UNINDENT .sp طرح‌واره رنگی pygments برای برجسته‌سازی نحوی با رنگ‌های تیره. برای فهرست طرح‌واره‌ها به سبک‌های درونی pygments % مراجعه کنید. این گزینه رنگ‌های مورد استفاده برای طرح‌واره‌های تیره را تنظیم می‌کند؛ از \fBpygments_style\fP برای تغییر رنگ‌ها در طرح‌واره‌های روشن استفاده کنید. .INDENT 0.0 .TP .B cache_size .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX cache_size 0.5 .EE .UNINDENT .UNINDENT .sp حداکثر اندازه حافظه موقت (کش) دیسک بر حسب گیگابایت برای پیش‌نمایش‌ها. مقادیر صفر یا منفی به معنای بدون محدودیت است. .INDENT 0.0 .TP .B syntax_aliases .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX syntax_aliases pyj:py pyi:py recipe:py .EE .UNINDENT .UNINDENT .sp نام‌های مستعار پسوند پرونده برای برجسته‌سازی نحوی. به عنوان مثال، برای برجسته‌سازی نحوی \fBfile.xyz\fP همانند \fBfile.abc\fP از تنظیم \fBxyz:abc\fP استفاده کنید. چندین نام مستعار باید با فاصله جدا شوند. .INDENT 0.0 .TP .B video_preview .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX video_preview width=480 fps=10 duration=5 .EE .UNINDENT .UNINDENT .sp کنترل نحوه نمونه‌برداری از ویدیوها برای پیش‌نمایش. گزینه width اندازه بندانگشتی تولیدشده از ویدیو را کنترل می‌کند. گزینه duration مشخص می‌کند که بندانگشتی تولیدشده چند ثانیه پخش شود. توجه داشته باشید که هنگام تغییر این مقادیر باید از فلگ \fB\-\-clear\-cache\fP نیز استفاده کنید، در غیر این صورت روی پیش‌نمایش‌هایی که از قبل کش شده‌اند اعمال نخواهد شد. .INDENT 0.0 .TP .B previewer .UNINDENT .sp مشخص کردن یک برنامه دلخواه به عنوان تولیدکننده پیش‌نمایش. ساختار دستوری به صورت زیر است: .INDENT 0.0 .INDENT 3.5 .sp .EX pattern program arguments... .EE .UNINDENT .UNINDENT .sp در اینجا، pattern می‌تواند برای تطابق نام پرونده‌ها یا انواع MIME استفاده شود. به عنوان مثال: \fBname:*.doc\fP پرونده‌های دارای پسوند \fB\&.doc\fP را تطبیق می‌دهد. به طور مشابه، \fBmime:image/*\fP تمام پرونده‌های تصویری را تطبیق می‌دهد. گزینه \fBprogram\fP می‌تواند هر برنامه اجرایی موجود در PATH باشد. این برنامه با آرگومان‌های داده‌شده اجرا خواهد شد. آخرین آرگومان مسیر پرونده‌ای خواهد بود که باید پیش‌نمایش برای آن تولید شود. .sp این گزینه را می‌توان چندین بار مشخص کرد تا پیش‌نمایش‌گرهای مختلف برای انواع مختلف پرونده‌ها تنظیم شوند. توجه داشته باشید که پیش‌نمایش‌گرهای مشخص‌شده با این گزینه بر پیش‌نمایش‌گرهای درونی اولویت دارند. .sp دستور باید داده‌های پیش‌نمایش را به عنوان یک شیء JSON در STDOUT خروجی دهد: .INDENT 0.0 .INDENT 3.5 .sp .EX { \(dqlines\(dq: [\(dqline1\(dq, \(dqline2\(dq, \(dq...\(dq], \(dqimage\(dq: \(dqabsolute path to generated image preview\(dq, \(dqtitle_extra\(dq: \(dqsome text to show on the first line\(dq, } .EE .UNINDENT .UNINDENT .sp خطوط می‌توانند شامل کدهای گریز قالب‌بندی SGR باشند و به همان صورت در بالای پانل پیش‌نمایش نمایش داده خواهند شد. تصویر اختیاری است و باید در یکی از قالب‌های JPEG، PNG، GIF، WEBP یا APNG باشد. .SH "کلیدهای میان‌بر (Keyboard shortcuts)" .INDENT 0.0 .TP .B خروج (Quit) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map esc quit map ctrl+c quit .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B پذیرش نتیجه جاری (Accept current result) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map enter accept .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B انتخاب نتیجه جاری (Select current result) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map shift+enter select .EE .UNINDENT .UNINDENT .sp هنگام انتخاب چندین پرونده، این کار پرونده جاری را به فهرست پرونده‌های انتخاب‌شده اضافه می‌کند. همچنین می‌توانید با نگه داشتن کلید \fBCtrl\fP و کلیک روی یک پرونده، وضعیت انتخاب آن را تغییر دهید. به طور مشابه، می‌توان کلید \fBAlt\fP را نگه داشت و با کلیک، دامنه پرونده‌های انتخابی را گسترش داد. .INDENT 0.0 .TP .B تایپ نام پرونده (Type file name) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+enter typename .EE .UNINDENT .UNINDENT .sp تایپ یک نام/مسیر پرونده به جای پالایش فهرست پرونده‌های موجود. هنگام تعیین نام پرونده یا دایرکتوری برای ذخیره‌سازی که هنوز وجود ندارد مفید است. هنگام انتخاب دایرکتوری‌های موجود، دایرکتوری‌ای را که محتویات آن در حال حاضر نمایش داده می‌شود به عنوان انتخاب می‌پذیرد. هنگام انتخاب پرونده‌ها برای باز کردن (به جای ذخیره) کارایی ندارد. .INDENT 0.0 .TP .B ویرایش نام پرونده (Modify file name) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map alt+enter modifyname .EE .UNINDENT .UNINDENT .sp ویرایش نام یک پرونده موجود و انتخاب آن برای ذخیره‌سازی. هنگام تعیین نام پرونده یا دایرکتوری برای ذخیره‌سازی که هنوز وجود ندارد اما بر اساس نام یک پرونده موجود است، مفید خواهد بود. هنگام انتخاب پرونده‌ها برای باز کردن (به جای ذخیره) کارایی ندارد. .INDENT 0.0 .TP .B نتیجه بعدی (Next result) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map down next 1 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B نتیجه قبلی (Previous result) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map up next \-1 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B نتیجه سمت چپ (Left result) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map left next left .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B نتیجه سمت راست (Right result) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map right next right .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B اولین نتیجه روی صفحه (First result on screen) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map home next first_on_screen map ctrl+home next first .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B آخرین نتیجه روی صفحه (Last result on screen) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map end next last_on_screen map ctrl+end next last .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B رفتن به دایرکتوری انتخاب‌شده فعلی (Change to currently selected dir) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map tab cd . .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B رفتن به دایرکتوری والد (Change to parent directory) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map shift+tab cd .. .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B رفتن به دایرکتوری ریشه (Change to root directory) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+/ cd / .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B رفتن به دایرکتوری خانگی (Change to home directory) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map ctrl+~ cd ~ map ctrl+\(ga cd ~ map ctrl+shift+\(ga cd ~ .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B رفتن به دایرکتوری موقت (Change to temp directory) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+t cd /tmp .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B فیلتر بعدی (Next filter) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii ctrl+f 1 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B فیلتر قبلی (Previous filter) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii alt+f \-1 .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B تغییر وضعیت نمایش پرونده‌های نقطه‌دار (Toggle showing dotfiles) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii alt+h toggle dotfiles .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B تغییر وضعیت نمایش پرونده‌های نادیده‌گرفته‌شده (Toggle showing ignored files) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii alt+i toggle ignorefiles .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B تغییر وضعیت مرتب‌سازی بر اساس تاریخ (Toggle sorting by dates) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii alt+d toggle sort_by_dates .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B تغییر وضعیت نمایش پیش‌نمایش (Toggle showing preview) .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX map \-\-allow\-fallback=shifted,ascii alt+p toggle preview .EE .UNINDENT .UNINDENT .SH "کد منبع choose_files (Source code for choose_files)" .sp کد منبع این کیتن در گیت‌هاب % در دسترس است. .SH "رابط خط فرمان (Command line interface)" .INDENT 0.0 .INDENT 3.5 .sp .EX kitten choose_files [گزینه‌ها] [دایرکتوری شروع برای انتخاب پرونده‌ها] .EE .UNINDENT .UNINDENT .sp انتخاب سریع یک یا چند پرونده با استفاده از جستجوی فازی، تنها با تایپ چند نویسه از نام پرونده. مرور پرونده‌های منطبق با استفاده از کلیدهای جهت‌نما برای پیمایش و فشردن \fBEnter\fP برای انتخاب. کلید \fBTab\fP می‌تواند برای رفتن به یک زیرپوشه استفاده شود. برای جزئیات کامل به اسناد برخط %<> مراجعه کنید. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-mode نوع شیء (اشیای) انتخابی پیش‌فرض: \fBfile\fP انتخاب‌ها: \fBall\fP, \fBdir\fP, \fBdirs\fP, \fBfile\fP, \fBfiles\fP, \fBsave\-dir\fP, \fBsave\-file\fP, \fBsave\-files\fP .UNINDENT .INDENT 0.0 .TP .B \-\-file\-filter فهرستی از فیلترها برای محدود کردن پرونده‌های نمایش‌داده‌شده. می‌تواند نوع MIME یا الگوهای سبک glob باشد. می‌تواند چندین بار مشخص شود. ساختار دستوری \fBtype:expression:Descriptive Name\fP است. به عنوان مثال: \fBmime:image/png:Images\fP و \fBmime:image/gif:Images\fP و \fBglob:*.[tT][xX][Tt]:Text files\fP\&. توجه داشته باشید که الگوهای glob حساس به حروف کوچک و بزرگ هستند. مشخصه نوع MIME نیز همانند عبارات glob در نظر گرفته می‌شود، بنابراین می‌توانید به عنوان مثال از \fBmime:text/*\fP برای تطابق با همه پرونده‌های متنی استفاده کنید. اولین فیلتر در فهرست به صورت پیش‌فرض اعمال خواهد شد. از فیلتری مانند \fBglob:*:All\fP برای مطابقت با همه پرونده‌ها استفاده کنید. توجه داشته باشید که پالایش فقط روی پرونده‌ها اعمال می‌شود، نه دایرکتوری‌ها. .UNINDENT .INDENT 0.0 .TP .B \-\-suggested\-save\-file\-name یک نام پیشنهادی هنگام انتخاب پرونده برای ذخیره‌سازی. .UNINDENT .INDENT 0.0 .TP .B \-\-suggested\-save\-file\-path مسیر یک پرونده موجود برای استفاده به عنوان پرونده ذخیره. .UNINDENT .INDENT 0.0 .TP .B \-\-title عنوان پنجره مورد استفاده برای این انتخاب‌گر. .UNINDENT .INDENT 0.0 .TP .B \-\-display\-title [=no] نمایش عنوان پنجره در بالا، مفید زمانی که این کیتن در یک پنجره سیستم‌عامل بدون نوار عنوان استفاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-override <OVERRIDE>, \-o <OVERRIDE> بازتعریف گزینه‌های پیکربندی منفرد، قابل تعیین به صورت چندباره. ساختار: name=value\&. .UNINDENT .INDENT 0.0 .TP .B \-\-config <CONFIG> مشخص کردن مسیر پرونده(های) پیکربندی برای استفاده. تمام پرونده‌های پیکربندی روی \fBchoose\-files.conf\fP درونی ادغام شده و مقادیر درونی را لغو می‌کنند. این گزینه می‌تواند چندین بار برای خواندن پیاپی چندین پرونده پیکربندی مشخص شود که با یکدیگر ادغام می‌شوند. از مقدار ویژه \fBNONE\fP برای بارگیری نکردن هیچ پرونده پیکربندی استفاده کنید. .sp اگر این گزینه مشخص نشود، پرونده‌های پیکربندی به این ترتیب جستجو می‌شوند: \fB$XDG_CONFIG_HOME/kitty/choose\-files.conf\fP، \fB~/.config/kitty/choose\-files.conf\fP، \fB$XDG_CONFIG_DIRS/kitty/choose\-files.conf\fP\&. اولین موردی که وجود داشته باشد به عنوان پرونده پیکربندی استفاده می‌شود. .sp اگر متغیر محیطی \fBKITTY_CONFIG_DIRECTORY\fP %<#\:envvar-KITTY_CONFIG_DIRECTORY> مشخص شده باشد، همواره از آن دایرکتوری استفاده می‌شود و جستجوی فوق انجام نخواهد شد. .sp اگر \fB/etc/xdg/kitty/choose\-files.conf\fP وجود داشته باشد، پیش از پرونده‌های پیکربندی کاربر (یعنی با اولویت کمتر) ادغام می‌شود. این مورد می‌تواند برای تعیین پیش‌فرض‌های سراسری سیستم برای همه کاربران استفاده شود. می‌توانید از \fB\-\fP یا \fB/dev/stdin\fP برای خواندن پیکربندی از STDIN استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-write\-output\-to <WRITE_OUTPUT_TO> مسیر پرونده‌ای که خروجی علاوه بر STDOUT در آن نیز نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-format <OUTPUT_FORMAT> قالبی که خروجی در آن نوشته می‌شود. قالب \fBtext\fP مسیرهای مطلق جداشده با خط جدید است که با یک خط جدید به پایان می‌رسد. قالب \fBshell\fP مسیرهای مطلق نقل‌قول‌شده و جداشده با فاصله است؛ نقل‌قول فقط در صورت نیاز انجام می‌شود. قالب \fBshell\-relative\fP مانند \fBshell\fP است، با این تفاوت که مسیرها را نسبت به دایرکتوری شروع بازمی‌گرداند. توجه داشته باشید که در صورت فراخوانی از یک نگاشت (mapping)، این گزینه نادیده گرفته می‌شود و قالب text یا shell بر اساس اینکه مکان‌نما در اعلان شل قرار دارد یا نه، به صورت خودکار استفاده خواهد شد. پیش‌فرض: \fBtext\fP انتخاب‌ها: \fBjson\fP, \fBshell\fP, \fBshell\-relative\fP, \fBtext\fP .UNINDENT .INDENT 0.0 .TP .B \-\-write\-pid\-to <WRITE_PID_TO> مسیر پرونده‌ای برای ثبت شناسه فرایند (PID) این فرایند در آن. .UNINDENT .INDENT 0.0 .TP .B \-\-clear\-cache [=no] پاک‌سازی حافظه‌های موقت (کش) مورد استفاده این کیتن. .UNINDENT .SH "نویسنده (AUTHOR)" Kovid Goyal .SH "حق نشر (COPYRIGHT)" 2026, Kovid Goyal .\" End of generated man page.