.\" Generated by scdoc 1.11.5 .\" Complete documentation for this program is not available as a GNU info page .ie \n(.g .ds Aq \(aq .el .ds Aq ' .nh .ad l .\" Begin generated content: .TH "fuzzel.ini" "5" "2026\-09\-03" .PP .SH "نام (NAME)" fuzzel.ini \- فایل پیکربندی لانچر برنامه Fuzzel .PP .PP .SH "توضیحات (DESCRIPTION)" .PP برنامه \fBfuzzel\fR از \fIقالب استاندارد پیکربندی یونیکس\fR بر پایه جفت‌های کلید/مقدار در بخش‌های مختلف استفاده می‌کند.\& بخش پیش‌فرض معمولاً بدون نام است، یعنی پیشوند \fI[section]\fR ندارد.\& با این حال، در صورتی که نیاز باشد پس از هر یک از بخش‌های دیگر مجدداً باز شود، می‌توان آن را صراحتاً \fI[main]\fR نامید.\& .PP برنامه fuzzel پرونده پیکربندی را به ترتیب در مکان‌های زیر جستجو می‌کند: .PP .RS 4 .PD 0 .IP \(bu 4 \fBXDG_CONFIG_HOME/fuzzel/fuzzel.\&ini\fR (در صورت تنظیم نشدن، به صورت پیش‌فرض \fB\(ti/.\&config/fuzzel/fuzzel.\&ini\fR) .IP \(bu 4 \fBXDG_CONFIG_DIRS/fuzzel/fuzzel.\&ini\fR (در صورت تنظیم نشدن، به صورت پیش‌فرض \fB/etc/xdg/fuzzel/fuzzel.\&ini\fR) .PD .PP .RE یک نمونه پرونده پیکربندی که شامل تمام گزینه‌ها با مقادیر پیش‌فرض آن‌ها به صورت کامنت‌شده است، معمولاً در مسیر \fB/etc/xdg/fuzzel/fuzzel.\&ini\fR نصب می‌شود.\& .PP .SH SECTION: main .PP \fBinclude\fR .RS 4 مسیر مطلق به پرونده پیکربندی برای وارد کردن (import).\& .PP پرونده واردشده محدوده بخش (section scope) مختص به خود را دارد.\& به این معنی که پیکربندی فراخوانی‌کننده، بدون توجه به اینکه پرونده واردشده در چه بخشی به پایان می‌رسد، پس از include همچنان در بخش پیش‌فرض باقی می‌ماند.\& .PP .RS 4 .PD 0 .IP \(bu 4 مسیر باید یک مسیر مطلق باشد، یا با \fB\(ti/\fR آغاز شود.\& .IP \(bu 4 استفاده از چندین دستور include مجاز است، اما در هر دستور فقط یک مسیر مجاز می‌باشد.\& .IP \(bu 4 وارد کردن تودرتو (Nested imports) مجاز است.\& .PD .PP .RE پیش‌فرض: \fIتنظیم نشده (not set)\fR.\& .PP .RE \fBnamespace\fR .RS 4 فضای نام (Namespace) برای سطح پوسته لایه‌ای (layer shell surface) ایجادشده.\& این گزینه برای جلوگیری از ضبط شدن پنجره fuzzel در اسکرین‌کست‌های کامپوزیتور در صورت نمایش اطلاعات حساس، مانند گذرواژه‌ها، مفید است.\& .PP پیش‌فرض: \fIlauncher\fR .PP .RE \fBoutput\fR .RS 4 خروجی (نمایشگر) برای نمایش برنامه.\& می‌توانید خروجی‌های موجود را با دستور \fBwlr\-randr\fR یا در Sway با دستور \fBswaymsg \-t get_outputs\fR فهرست کنید.\& .PP مثال: \fIDP\-1\fR .PP پیش‌فرض: تنظیم نشده \-\- به کامپوزیتور اجازه داده می‌شود خروجی را انتخاب کند.\& .PP .RE \fBfont\fR .RS 4 فهرستی از قلم‌های مورد استفاده که با کاما از هم جدا شده‌اند، در قالب fontconfig.\& به این صورت که نام قلم با فهرستی از گزینه‌ها که با دونقطه از هم جدا شده‌اند، دنبال می‌شود.\& مهم‌ترین آن‌ها \fB:size=n\fR است که برای تعیین اندازه قلم استفاده می‌شود.\& توجه داشته باشید که اندازه قلم تحت تأثیر گزینه \fBdpi\-aware\fR نیز قرار می‌گیرد.\& برای جزئیات، بخش \fBFONT CONFIG\fR را در زیر ببینید.\& .PP مثال‌ها: .RS 4 .PD 0 .IP \(bu 4 Dina:weight=bold:slant=italic .IP \(bu 4 Courier New:size=12 .IP \(bu 4 Fantasque Sans Mono:fontfeatures=ss01 .PD .PP .RE پیش‌فرض: \fImonospace\fR.\& .PP .RE \fBuse\-bold\fR .RS 4 بولی.\& در صورت تنظیم، fuzzel می‌تواند از قلم‌های توپر (bold) استفاده کند؛ مثلاً برای موردی که در حال حاضر انتخاب شده است.\& پیش‌فرض: \fIno\fR .PP .RE \fBdpi\-aware\fR .RS 4 \fBauto\fR، \fByes\fR یا \fBno\fR.\& .PP هنگامی که روی \fByes\fR تنظیم شود، اندازه قلم با استفاده از DPI نمایشگر تعیین می‌شود، به طوری که یک قلم با اندازه مشخص، بدون توجه به نمایشگر، اندازه فیزیکی یکسانی خواهد داشت.\& .PP در این حالت، ضریب مقیاس (scaling factor) نمایشگر نادیده گرفته می‌شود؛ دو برابر شدن ضریب مقیاس، اندازه قلم را دو برابر \fBنخواهد\fR کرد.\& .PP هنگامی که روی \fBno\fR تنظیم شود، DPI نمایشگر نادیده گرفته می‌شود.\& در عوض، اندازه قلم با استفاده از ضریب مقیاس نمایشگر تعیین می‌شود؛ دو برابر شدن ضریب مقیاس، اندازه قلم را دو برابر \fBمی‌کند\fR.\& .PP در نهایت، اگر روی \fBauto\fR تنظیم شود، در صورتی که \fIهمه\fR نمایشگرها ضریب مقیاس ۱ داشته باشند، اندازه قلم با استفاده از DPI نمایشگر تعیین می‌شود.\& اگر حداقل یک نمایشگر ضریب مقیاسی بزرگتر از ۱ داشته باشد (صرف‌نظر از اینکه پنجره fuzzel روی آن نمایشگر قرار گرفته باشد یا خیر)، اندازه قلم‌ها بر اساس ضریب مقیاس تغییر خواهد کرد.\& .PP توجه داشته باشید که این گزینه معمولاً با قلم‌های بیتی (bitmap) که فقط شامل مجموعه‌ای از اندازه‌های از پیش تعریف‌شده هستند و نمی‌توان آن‌ها را به صورت پویا مقیاس‌بندی کرد، کار نمی‌کند.\& از بین اندازه‌های موجود، هر اندازه‌ای که بهترین تطابق را با DPI یا ضریب مقیاس داشته باشد، استفاده خواهد شد.\& .PP همچنین توجه داشته باشید که اگر اندازه قلم بر حسب پیکسل مشخص شده باشد (\fB:pixelsize=\fR\fIN\fR به‌جای \fB:size=\fR\fIN\fR)، مقیاس‌بندی DPI (\fBdpi\-aware=yes\fR) هیچ تأثیری نخواهد داشت (اندازه پیکسلی مشخص‌شده بدون تغییر استفاده می‌شود).\& اما اگر ضریب مقیاس نمایشگر برای تعیین اندازه قلم استفاده شود (\fBdpi\-aware=no\fR)، اندازه پیکسلی قلم در ضریب مقیاس ضرب خواهد شد.\& .PP پیش‌فرض: \fIauto\fR.\& .PP .RE \fBgamma\-correct\-blending\fR .RS 4 بولی.\& در صورت فعال بودن، fuzzel ترکیب تصحیح گاما (gamma\-correct blending) را در فضای رنگی خطی انجام می‌دهد.\& گلیف‌های قلم در اصل باید این‌گونه رندر شوند، اما از آنجا که تقریباً هیچ برنامه یا ابزار گرافیکی (toolkit) در لینوکس این کار را انجام نمی‌دهد، ممکن است نتیجه شبیه آنچه به آن عادت کرده‌اید نباشد.\& .PP در مقایسه با حالت پیش‌فرض (غیرفعال)، گلیف‌های روشن روی پس‌زمینه تیره ضخیم‌تر به نظر می‌رسند و گلیف‌های تیره روی پس‌زمینه روشن نازک‌تر دیده خواهند شد.\& .PP فناوری FreeType می‌تواند با روشی به نام «تیره‌سازی ساقه‌ها» (stem darkening) تأثیر مورد دوم را محدود کند.\& این قابلیت فقط برای قلم‌های CFF (فرمت‌های OpenType و .\&otf) در دسترس است و به طور پیش‌فرض (در FreeType) غیرفعال است.\& می‌توانید قبل از اجرای fuzzel با تنظیم متغیر محیطی \fBFREETYPE_PROPERTIES="cff:no\-stem\-darkening=0"\fR آن را فعال کنید.\& .PP همچنین آگاه باشید که بسیاری از قلم‌ها روی سیستم‌هایی طراحی شده‌اند که ترکیب تصحیح گاما را انجام نمی‌دهند، بنابراین ممکن است هنگام رندر با ترکیب تصحیح گاما ضخیم‌تر از حد انتظار دیده شوند، زیرا طراح قلم وزن خطوط را بر اساس رندر نادرست تنظیم کرده است.\& .PP برای نمایش دقیق رنگ‌ها، به بافرهای تصویر با دقت بالاتر نیاز است.\& به همین دلیل، fuzzel هنگام فعال بودن ترکیب تصحیح گاما، از بافرهای تصویر ۱۶ بیتی (به‌جای ۸ بیتی) استفاده می‌کند.\& .PP در نسخه‌های کامپایل‌شده fuzzel با پشتیبانی از cairo امکان فعال‌سازی ترکیب تصحیح گاما وجود ندارد، زیرا cairo از بافرهای تصویر ۱۶ بیتی پشتیبانی نمی‌کند.\& .PP .RE \fBplaceholder\fR .RS 4 متنی که به عنوان جای‌نگهدار در جعبه ورودی نمایش داده می‌شود.\& پیش‌فرض: خالی.\& .PP .RE \fBprompt\fR .RS 4 رشته‌ای که به عنوان اعلان ورودی استفاده می‌شود.\& توجه داشته باشید که فاصله‌های انتهایی حذف می‌شوند، مگر اینکه رشته داخل گیومه قرار گیرد.\& پیش‌فرض: \fI"> "\fR.\& .PP .RE \fBmessage\fR .RS 4 پیامی که بالای اعلان ورودی نمایش داده می‌شود.\& می‌تواند حاوی پیامی اطلاعاتی باشد، یا برای قرار دادن اعلان در بالای ورودی به جای جلوی آن استفاده شود.\& از خط جدید پشتیبانی می‌کند.\& برای جزئیات درباره نحوه برخورد با خطوط طولانی، گزینه \fBmessage\-mode\fR را ببینید.\& .PP .RE \fBmessage\-mode\fR .RS 4 یکی از مقادیر \fBwrap\fR و \fBexpand\fR.\& .PP \fBwrap\fR: هر خطی که طولانی‌تر از \fBwidth\fR باشد به خط بعدی شکسته می‌شود.\& در صورت امکان روی مرز فاصله‌ها شکسته می‌شود و فاصله‌های ابتدایی ناشی از برش خط حذف می‌گردند.\& در صورتی که فاصله‌ای وجود نداشته باشد، خط پس از تعداد نویسه‌های مشخص‌شده در \fBwidth\fR شکسته می‌شود.\& .PP \fBexpand\fR: اگر طولانی‌ترین خط در \fBmessage\fR طولانی‌تر از \fBwidth\fR باشد، کادر محاوره عریض‌تر می‌شود تا پیام \fBmessage\fR در آن جا گیرد.\& .PP .RE \fBicon\-theme\fR .RS 4 تم آیکون.\& توجه داشته باشید که نام به حروف بزرگ و کوچک حساس است.\& پیش‌فرض: \fIdefault\fR.\& .PP .RE \fBicons\-enabled\fR .RS 4 بولی.\& در صورت فعال بودن، آیکون برنامه‌ها (از تم انتخاب‌شده در \fBicon\-theme\fR) رندر خواهد شد.\& پیش‌فرض: \fIyes\fR.\& .PP .RE \fBhide\-before\-typing\fR .RS 4 بولی.\& در صورت فعال بودن، فهرست برنامه‌ها تا زمانی که اولین حرف تایپ شود پنهان خواهد ماند.\& با پاک شدن دوباره اعلان، فهرست دوباره نمایان می‌شود.\& پیش‌فرض: \fIno\fR.\& .PP .RE \fBfields\fR .RS 4 فهرستی از فیلدهای مدخل دسکتاپ XDG که با کاما از هم جدا شده‌اند و برای تطبیق استفاده می‌شوند.\& .PP اگرچه fuzzel فقط نام برنامه‌ها را نمایش می‌دهد، عملیات تطبیق می‌تواند (و به صورت پیش‌فرض نیز چنین است) بر روی فیلدهای دیگر نیز انجام شود.\& فیلدهای پشتیبانی‌شده عبارتند از: .PP .PD 0 .IP \(bu 4 filename .IP \(bu 4 name .IP \(bu 4 generic .IP \(bu 4 exec .IP \(bu 4 categories .IP \(bu 4 keywords .IP \(bu 4 comment .PD .PP فیلد "filename" نام فایل ".\&desktop" است.\& .PP پیش‌فرض: \fIfilename,name,generic\fR.\& .PP .RE \fBpassword\-character\fR .RS 4 نویسه پیش‌فرض برای استفاده به همراه گزینه خط فرمان \fB\-\-password\fR.\& توجه داشته باشید که می‌توان این گزینه را در خط فرمان با تعیین صریح نویسه به صورت \fB\-\-password=X\fR بازنویسی کرد.\& پیش‌فرض: \fI*\fR.\& .PP .RE \fBmatch\-mode\fR .RS 4 یکی از مقادیر \fBexact\fR، \fBfzf\fR و \fBfuzzy\fR.\& .PP \fBexact\fR: آنچه تایپ می‌کنید به طور دقیق با هر یک از فیلدهای موجود در فهرست \fBfields\fR تطبیق داده می‌شود.\& .PP \fBfzf\fR: تطبیق به سبک fzf، که در آن زیررشته‌های متن تایپ‌شده با هر فیلد در فهرست \fBfields\fR مطابقت داده می‌شوند.\& .PP \fBfuzzy\fR: تطبیق فازی مبتنی بر الگوریتم لون‌اشتاین (levenshtein) برای متن تایپ‌شده در برابر هر فیلد در فهرست \fBfields\fR.\& .PP پیش‌فرض: \fIfzf\fR .PP .RE \fBsort\-result\fR .RS 4 بولی.\& تعیین می‌کند که آیا نتایج مرتب‌سازی شوند یا خیر.\& غیرفعال کردن مرتب‌سازی به این معنی است که هیچ مقایسه‌ای بین نتایج منطبق صورت نخواهد گرفت؛ یعنی تعداد دفعات اجرا، طول تطابق و غیره نادیده گرفته می‌شوند.\& این کار عملاً حافظه موقت (cache) را غیرفعال می‌کند (اگرچه حافظه موقت همچنان هنگام خروج به‌روزرسانی می‌شود).\& .PP غیرفعال کردن این گزینه می‌تواند زمان تأخیر جستجو را هنگام جستجو در مجموعه‌های داده بسیار بزرگ بهبود بخشد.\& .PP پیش‌فرض: \fIyes\fR .PP .RE \fBmatch\-counter\fR .RS 4 بولی.\& در صورت فعال بودن، تعداد موارد منطبق و تعداد کل در سمت راست اعلان ورودی نمایش داده می‌شود.\& غیرفعال کردن این شمارنده همچنین عملکرد بارگذاری تعداد بسیار زیادی از مدخل‌های dmenu را از ورودی استاندارد (STDIN) بهبود می‌بخشد.\& .PP پیش‌فرض: \fIno\fR.\& .PP .RE \fBfilter\-desktop\fR .RS 4 بولی.\& فیلتر کردن پرونده‌های دسکتاپ بر اساس مقدار متغیر محیطی XDG_CURRENT_DESKTOP.\& پیش‌فرض: \fIno\fR.\& .PP .RE \fBshow\-actions\fR .RS 4 بولی.\& برخی از پرونده‌های دسکتاپ علاوه بر خود برنامه، «اقدامات» (actions) را نیز تعریف می‌کنند؛ مانند «new window» (پنجره جدید)، «preferences» (ترجیحات) و غیره.\& هنگامی که این گزینه فعال باشد، این اقدامات توسط fuzzel فهرست خواهند شد.\& پیش‌فرض: \fIno\fR.\& .PP .RE \fBterminal\fR .RS 4 دستور ترمینال برای استفاده هنگام اجرای برنامه‌های «ترمینالی».\& .PP دستور می‌تواند حاوی جای‌نگهدار \fI{cmd}\fR باشد که با دستور واقعی برای اجرا جایگزین خواهد شد.\& هنگامی که \fI{cmd}\fR وجود داشته باشد، دستور \fBتنها\fR در همان مکان‌ها جایگزین می‌شود و به انتهای آن اضافه \fBنمی‌شود\fR.\& .PP مثال‌ها: .PD 0 .IP \(bu 4 \fIfoot \-a '\&{cmd}'\& \-T '\&{cmd}'\& {cmd}\fR شناسه برنامه (app\-id) و عنوان را روی نام دستور تنظیم کرده و سپس آن را اجرا می‌کند .IP \(bu 4 \fIxterm \-e {cmd}\fR دستور را در xterm اجرا می‌کند .IP \(bu 4 \fIxterm \-e\fR (بدون {cmd}) از رفتار قدیمی استفاده می‌کند: دستور را پس از آرگومان‌های ترمینال می‌افزاید .PD .PP پیش‌فرض: \fI$TERMINAL \-e\fR.\& .PP .RE \fBlist\-executables\-in\-path\fR .RS 4 بولی.\& در صورت فعال بودن، فهرست شامل برنامه‌های اجرایی از متغیر محیطی PATH خواهد بود.\& پیش‌فرض: \fIno\fR.\& .PP .RE \fBlaunch\-prefix\fR .RS 4 پیشوندی که قبل از argv برنامه اجراشده افزوده می‌شود.\& در صورت تنظیم، fuzzel فراداده‌های پرونده دسکتاپ را از طریق متغیرهای محیطی منتقل می‌کند: .PP .PD 0 .IP \(bu 4 DESKTOP_ENTRY_ID (همچنین برای سازگاری با نسخه‌های پیشین با نام FUZZEL_DESKTOP_FILE_ID صادر می‌شود) .IP \(bu 4 DESKTOP_ENTRY_PATH .IP \(bu 4 DESKTOP_ENTRY_NAME .IP \(bu 4 DESKTOP_ENTRY_COMMENT .IP \(bu 4 DESKTOP_ENTRY_NAME_L (بومی‌سازی‌شده) .IP \(bu 4 DESKTOP_ENTRY_COMMENT_L (بومی‌سازی‌شده) .IP \(bu 4 DESKTOP_ENTRY_ICON .PD .RE و در صورت اجرای یک اقدام: .RS 4 .PD 0 .IP \(bu 4 DESKTOP_ENTRY_ACTION (شناسه اقدام) .IP \(bu 4 DESKTOP_ENTRY_ACTION_NAME .IP \(bu 4 DESKTOP_ENTRY_ACTION_NAME_L (بومی‌سازی‌شده) .IP \(bu 4 DESKTOP_ENTRY_ACTION_ICON .PD .PP پیش‌فرض: \fIتنظیم نشده (not set)\fR.\& .PP .RE \fBanchor\fR .RS 4 تنظیم مهار یا لنگرگاه (anchor) پنجره، یعنی موقعیتی روی صفحه نمایش که پنجره در آنجا نمایش داده می‌شود.\& می‌توانید یکی از موارد زیر را انتخاب کنید: .PP .PD 0 .IP \(bu 4 top\-left .IP \(bu 4 top .IP \(bu 4 top\-right .IP \(bu 4 left .IP \(bu 4 center .IP \(bu 4 right .IP \(bu 4 bottom\-left .IP \(bu 4 bottom .IP \(bu 4 bottom\-right .PD .PP پیش‌فرض: \fIcenter\fR .PP .RE \fBx\-margin\fR .RS 4 حاشیه افقی از نقطه لنگرگاه بر حسب پیکسل.\& پیش‌فرض: \fI0\fR.\& .PP نکته: این گزینه هنگامی که anchor برابر با center، top یا bottom باشد تأثیری ندارد.\& .PP .RE \fBy\-margin\fR .RS 4 حاشیه عمودی از نقطه لنگرگاه بر حسب پیکسل.\& پیش‌فرض: \fI0\fR.\& .PP نکته: این گزینه هنگامی که anchor برابر با center، left یا right باشد تأثیری ندارد.\& .PP .RE \fBlines\fR .RS 4 تعداد موارد منطبق برای نمایش.\& پیش‌فرض: \fI15\fR.\& .PP .RE \fBhide\-prompt\fR .RS 4 بولی.\& در صورت تنظیم، خط اعلان را پنهان کرده و پنجره را کوچک‌تر می‌کند.\& ورودی همچنان پذیرفته می‌شود، اگرچه خط اعلان نمایش داده نمی‌شود.\& نمی‌توان همراه با \fBprompt\-only\fR استفاده کرد.\& پیش‌فرض: \fIno\fR.\& .PP .RE \fBminimal\-lines\fR .RS 4 بولی.\& تعداد خطوط نمایشی را به حداقلِ مقدار \fIlines\fR و تعداد خطوط ورودی تنظیم می‌کند.\& فقط در حالت dmenu مؤثر است.\& این قابلیت به fuzzel امکان می‌دهد تا به جای نمایش همیشگی تمام سطر‌های \fIlines\fR، اندازه خود را با تعداد واقعی خطوط ورودی تطبیق دهد.\& پیش‌فرض: \fIno\fR.\& .PP .RE \fBwidth\fR .RS 4 عرض پنجره بر حسب نویسه‌ها.\& حاشیه‌ها و کادر دور را شامل نمی‌شود.\& برای قلم‌های با عرض متغیر، این مقدار تقریبی است؛ زیرا تعداد دقیق نویسه‌هایی که جا می‌شوند به نوع نویسه‌های نمایش‌داده‌شده بستگی دارد.\& پیش‌فرض: \fI30\fR.\& .PP .RE \fBtabs\fR .RS 4 تعداد فاصله‌هایی که یک کلید Tab به آن تبدیل می‌شود.\& پیش‌فرض: \fI8\fR.\& .PP .RE \fBhorizontal\-pad\fR .RS 4 فاصله درونی (padding) افقی بین کادر و محتوا بر حسب پیکسل.\& پیش‌فرض: \fI40\fR.\& .PP .RE \fBvertical\-pad\fR .RS 4 فاصله درونی (padding) عمودی بین کادر و محتوا بر حسب پیکسل.\& پیش‌فرض: \fI8\fR.\& .PP .RE \fBinner\-pad\fR .RS 4 فاصله درونی (padding) عمودی بین خط اعلان و فهرست نتایج بر حسب پیکسل.\& پیش‌فرض: \fI0\fR.\& .PP .RE \fBimage\-size\-ratio\fR .RS 4 نسبت تصویر بزرگی که هنگام وجود تنها «چند» مورد منطبق نمایش داده می‌شود، در مقایسه با اندازه کامل پنجره.\& برای غیرفعال کردن تصاویر بزرگ، مقدار آن را روی 0 یا 1 تنظیم کنید.\& پیش‌فرض: \fI0.\&5\fR.\& .PP .RE \fBline\-height\fR .RS 4 بازنویسی ارتفاع خط بر اساس معیارهای قلم (font metrics).\& پیش‌فرض: استفاده از معیارهای قلم.\& .PP .RE \fBletter\-spacing\fR .RS 4 فاصله اضافی بین حروف.\& مقادیر منفی نیز مجاز هستند.\& پیش‌فرض: \fI0\fR.\& .PP .RE \fBlayer\fR .RS 4 لایه‌ای که پنجره fuzzel روی آن رندر می‌شود.\& مقادیر معتبر \fBtop\fR و \fBoverlay\fR هستند.\& .PP مقدار \fBtop\fR پنجره را بالاتر از پنجره‌های عادی، اما معمولاً زیر پنجره‌های تمام‌صفحه و صفحه قفل رندر می‌کند.\& .PP مقدار \fBoverlay\fR پنجره را روی پنجره‌های عادی و همچنین پنجره‌های تمام‌صفحه رندر می‌کند.\& توجه داشته باشید که اگر چندین پنجره از یک لایه مشترک استفاده کنند، ترتیب قرارگیری نامشخص خواهد بود.\& از آنجا که صفحه‌های قفل معمولاً از \fBoverlay\fR استفاده می‌کنند، این بدان معناست که fuzzel ممکن است روی صفحه قفل ظاهر شود یا نشود.\& .PP پیش‌فرض: \fIoverlay\fR .PP .RE \fBkeyboard\-focus\fR .RS 4 حالت فوکوس صفحه‌کلید؛ حالت‌های معتبر عبارتند از \fBexclusive\fR و \fBon\-demand\fR.\& .PP حالت \fBexclusive\fR فوکوس صفحه‌کلید را روی fuzzel قفل می‌کند و تا زمان بسته شدن، تمام ورودی‌های صفحه‌کلید را دریافت می‌نماید.\& .PP حالت \fBon\-demand\fR فوکوس fuzzel را مانند یک پنجره معمولی تنظیم می‌کند و به سایر پنجره‌ها اجازه می‌دهد مثلاً با کلیک کردن روی آن‌ها، فوکوس صفحه‌کلید را به دست آورند.\& به طور پیش‌فرض، تغییر فوکوس صفحه‌کلید بلافاصله باعث بسته شدن fuzzel می‌شود؛ با استفاده از \fBexit\-on\-keyboard\-focus\-loss=no\fR می‌توانید در حین باز بودن fuzzel با سایر پنجره‌ها تعامل داشته باشید.\& .PP پیش‌فرض: \fIexclusive\fR .PP .RE \fBexit\-on\-keyboard\-focus\-loss\fR .RS 4 بولی.\& در صورت فعال بودن (true)، با از دست رفتن فوکوس صفحه‌کلید توسط پنجره fuzzel، برنامه بسته می‌شود.\& .PP غیرفعال کردن این گزینه می‌تواند در کامپوزیتورهایی که در آن‌ها فعال بودن قابلیت «focus\-follows\-mouse» با حرکت موش‌واره روی پنجره دیگر باعث خروج فوری fuzzel می‌شود، مفید باشد.\& به عنوان مثال، در Sway (نسخه ۱٫۷ یا قدیمی‌تر) چنین رفتاری دیده می‌شود.\& .PP پیش‌فرض: \fIyes\fR .PP .RE \fBrender\-workers\fR .RS 4 تعداد نخ‌ها (threads) برای رندرینگ.\& برای غیرفعال کردن چندنخی مقدار آن را روی 0 بگذارید.\& پیش‌فرض: تعداد پردازنده‌های منطقی موجود (شامل SMT).\& توجه داشته باشید که این مقدار همیشه بهترین انتخاب نیست؛ در برخی موارد، تعداد \fIهسته‌های\fR فیزیکی نتیجه بهتری دارد.\& .PP در صورتی که تعداد بسیار زیادی هسته یا نخ پردازشی دارید، محدود کردن تعداد \fBrender\-workers\fR را مد نظر قرار دهید؛ زیرا fuzzel نمی‌تواند بیش از تعداد موارد نمایش‌داده‌شده را به صورت موازی پردازش کند.\& .PP .RE \fBmatch\-workers\fR .RS 4 تعداد نخ‌ها برای عملیات تطبیق.\& برای غیرفعال کردن چندنخی مقدار آن را روی 0 بگذارید.\& پیش‌فرض: تعداد پردازنده‌های منطقی موجود (شامل SMT).\& توجه داشته باشید که این مقدار همیشه بهترین انتخاب نیست؛ در برخی موارد، تعداد \fIهسته‌های\fR فیزیکی نتیجه بهتری دارد.\& .PP در صورتی که تعداد بسیار زیادی هسته یا نخ پردازشی دارید، محدود کردن تعداد \fBmatch\-workers\fR را مد نظر قرار دهید؛ زیرا fuzzel نمی‌تواند بیش از تعداد مدخل‌های موجود را به صورت موازی پردازش کند.\& .PP .RE \fBdelayed\-filter\-ms\fR .RS 4 مدت زمان، بر حسب میلی‌ثانیه، برای تأخیر در فیلتر کردن مجدد زمانی که تعداد نتایج بیشتر از \fBdelayed\-filter\-limit\fR باشد.\& پیش‌فرض: \fI300\fR.\& .PP .RE \fBdelayed\-filter\-limit\fR .RS 4 هنگامی که تعداد موارد منطبق بیشتر از این مقدار باشد، از فیلتر کردن فوری به فیلتر کردن با تأخیر تغییر وضعیت داده می‌شود (گزینه \fBdelayed\-filter\-ms\fR را ببینید).\& پیش‌فرض: \fI20000\fR.\& .PP .RE \fBscaling\-filter\fR .RS 4 فیلتر مقیاس‌بندی برای استفاده هنگام کوچک کردن اندازه تصاویر PNG.\& یکی از مقادیر \fBnone\fR، \fBnearest\fR، \fBbilinear\fR، \fBbox\fR، \fBlinear\fR، \fBcubic\fR، \fBlanczos2\fR، \fBlanczos3\fR و \fBlanczos3\-stretched\fR.\& .PP گزینه‌های \fBnone\fR، \fBnearest\fR و \fBbilinear\fR سریع‌ترین گزینه‌ها هستند، اما کمترین کیفیت خروجی را نیز دارند.\& .PP گزینه‌های \fBcubic\fR، \fBlanczos2\fR، \fBlanczos3\fR و \fBlanczos3\-stretched\fR کندترین گزینه‌ها بوده و بهترین کیفیت خروجی را دارند.\& .PP گزینه \fBbox\fR و تا حدودی \fBlinear\fR از نظر کارایی در حد وسط قرار دارند، در حالی که در بیشتر موارد کیفیت آن‌ها به اندازه یا نزدیک به \fBcubic\fR و فیلترهای lanczos است.\& .PP پیش‌فرض: \fIbox\fR .PP .RE \fBcache\fR .RS 4 تعیین محل پیش‌فرض حافظه موقت (کش).\& در صورت تنظیم نشدن، از \fB$XDG_CACHE_HOME/fuzzel\fR استفاده می‌شود.\& برای غیرفعال کردن حافظه موقت، آن را روی \fB/dev/null\fR قرار دهید.\& پیش‌فرض: \fIتنظیم نشده (not set)\fR.\& .PP .RE \fBauto\-select\fR .RS 4 بولی.\& هنگامی که فقط یک مورد باقی بماند، آن را به طور خودکار انتخاب می‌کند.\& پیش‌فرض: \fIno\fR.\& .PP .RE \fBenable\-mouse\fR .RS 4 بولی.\& فعال‌سازی ورودی موش‌واره.\& پیش‌فرض: \fIyes\fR.\& .PP .RE .SH SECTION: colors .PP تمامی مقادیر رنگ‌ها در قالب RGBA هستند.\& .PP \fBbackground\fR .RS 4 رنگ پس‌زمینه.\& پیش‌فرض: \fIfdf6e3ff\fR.\& .PP .RE \fBtext\fR .RS 4 رنگ متن (پیش‌زمینه) مواردی که انتخاب نشده‌اند.\& پیش‌فرض: \fI657b83ff\fR.\& .PP .RE \fBmessage\fR .RS 4 رنگ متن (پیش‌زمینه) رشته پیام.\& پیش‌فرض: \fI657b83ff\fR.\& .PP .RE \fBprompt\fR .RS 4 رنگ متن (پیش‌زمینه) نویسه(های) اعلان ورودی.\& پیش‌فرض: \fI586e75ff\fR.\& .PP .RE \fBplaceholder\fR .RS 4 رنگ متن (پیش‌زمینه) رشته جای‌نگهدار.\& پیش‌فرض: \fI93a1a1ff\fR.\& .PP .RE \fBinput\fR .RS 4 رنگ متن (پیش‌زمینه) رشته ورودی.\& پیش‌فرض: \fI657b83ff\fR.\& .PP .RE \fBmatch\fR .RS 4 رنگ متن (پیش‌زمینه) زیررشته منطبق.\& پیش‌فرض: \fIcb4b16ff\fR.\& .PP .RE \fBselection\fR .RS 4 رنگ پس‌زمینه مورد انتخاب‌شده.\& پیش‌فرض: \fIeee8d5ff\fR.\& .PP .RE \fBselection\-text\fR .RS 4 رنگ متن (پیش‌زمینه) مورد انتخاب‌شده.\& پیش‌فرض: \fI586e75ff\fR.\& .PP .RE \fBselection\-match\fR .RS 4 رنگ متن (پیش‌زمینه) زیررشته منطبق از مورد انتخاب‌شده.\& پیش‌فرض: \fIcb4b16ff\fR.\& .PP .RE \fBcounter\fR=\fIHEX\fR .RS 4 رنگ آمار تعداد موارد منطبق که در سمت راست اعلان ورودی چاپ می‌شود.\& بخش \fBCOLORS\fR را ببینید.\& پیش‌فرض: \fI93a1a1ff\fR.\& .PP .RE \fBborder\fR .RS 4 رنگ کادر دور.\& پیش‌فرض: \fI002b36ff\fR.\& .PP .PP .RE .SH SECTION: border .PP \fBwidth\fR .RS 4 عرض کادر دور بر حسب پیکسل.\& پیش‌فرض: \fI1\fR.\& .PP .RE \fBradius\fR .RS 4 میزان گردی گوشه‌ها.\& پیش‌فرض: \fI10\fR.\& .PP .RE \fBselection\-radius\fR .RS 4 میزان گردی گوشه‌ها برای مورد انتخاب‌شده.\& پیش‌فرض: \fI0\fR.\& .PP .PP .RE .SH SECTION: dmenu .PP \fBmode\fR .RS 4 یکی از مقادیر \fBtext\fR یا \fBindex\fR.\& تعیین می‌کند که هنگام انتخاب یک مورد، fuzzel چه چیزی را در خروجی استاندارد (stdout) چاپ کند: \fBtext\fR خود مورد را چاپ می‌کند، و \fBindex\fR نمایه (ایندکس) مورد انتخاب‌شده را چاپ می‌نماید.\& مقادیر ایندکس از صفر برای اولین مورد شروع می‌شوند.\& پیش‌فرض: \fItext\fR.\& .PP .RE \fBexit\-immediately\-if\-empty\fR .RS 4 بولی.\& در صورت فعال بودن، اگر چیزی در ورودی استاندارد (stdin) نباشد، fuzzel اصلاً اجرا نخواهد شد (یعنی هیچ پنجره‌ای باز نمی‌کند و هیچ چیزی در stdout چاپ نمی‌کند).\& پیش‌فرض: \fIno\fR.\& .PP .RE .SH SECTION: key\-bindings .PP این بخش به شما امکان می‌دهد کلیدهای میانبر پیش‌فرض را بازنویسی کنید.\& .PP قالب کلی به صورت \fIaction=combo1.\&.\&.\&comboN\fR است.\& یعنی هر عمل (action) می‌تواند یک یا چند ترکیب کلید داشته باشد که با فاصله از هم جدا می‌شوند.\& هر ترکیب به شکل \fImod1+mod2+key\fR است.\& نام کلیدهای تبدیل‌کننده (modifiers) و کلید اصلی \fBباید\fR نام‌های معتبر کلید در XKB باشند.\& .PP توجه داشته باشید که اگر \fBShift\fR یکی از کلیدهای تبدیل‌کننده باشد، نام \fIکلید\fR \fBنباید\fR با حروف بزرگ نوشته شود.\& برای مثال، \fBControl+Shift+V\fR هرگز فعال نخواهد شد، اما \fBControl+Shift+v\fR کار خواهد کرد.\& .PP توجه داشته باشید که کلید \fBAlt\fR معمولاً \fBMod1\fR نامیده می‌شود.\& .PP دستور \fBxkbcli interactive\-wayland\fR می‌تواند برای یافتن نام کلیدها (keysym) مفید باشد.\& .PP یک ترکیب کلید فقط می‌تواند به \fBیک\fR عمل اختصاص یابد.\& فرض کنید می‌خواهید \fBControl+k\fR را به عمل \fBnext\fR اختصاص دهید.\& از آنجا که این کلید میانبر پیش‌فرض برای \fBdelete\-line\-forward\fR است، باید نگاشت پیش‌فرض را لغو کنید.\& این کار با تنظیم \fIaction=none\fR قابل انجام است؛ مثلاً \fBdelete\-line\-forward=none\fR.\& .PP \fBcancel\fR .RS 4 خروج از fuzzel بدون اجرای هیچ چیز.\& پیش‌فرض: \fIControl+g Control+c Control+bracketleft Escape\fR.\& .PP .RE \fBexecute\fR .RS 4 اجرای موردی که در حال حاضر انتخاب شده است.\& یا در حالت dmenu، چاپ مورد انتخاب‌شده در stdout.\& پیش‌فرض: \fIReturn KP_Enter Control+y\fR.\& .PP .RE \fBexecute\-or\-next\fR .RS 4 اگر فقط یک مورد منطبق وجود داشته باشد، آن را اجرا می‌کند.\& یا در حالت dmenu، مورد انتخاب‌شده را در stdout چاپ می‌کند.\& اگر بیش از یک مورد منطبق وجود داشته باشد، مورد بعدی را انتخاب می‌کند.\& هنگامی که به آخرین مورد برسد، دوباره از ابتدا شروع می‌کند (wrap around).\& پیش‌فرض: \fITab\fR.\& .PP .RE \fBexecute\-input\fR .RS 4 اجرای مستقیم ورودی خام همان‌طور که هست، صرف‌نظر از اینکه با موردی در فهرست مطابقت داشته باشد یا خیر.\& در حالت dmenu، در عوض مورد انتخاب‌شده را در stdout چاپ می‌کند.\& پیش‌فرض: \fIShift+Return Shift+KP_Enter\fR.\& .PP .RE \fBcursor\-left\fR .RS 4 مکان‌نما را یک \fBنویسه\fR به چپ می‌برد.\& پیش‌فرض: \fILeft Control+b\fR.\& .PP .RE \fBcursor\-left\-word\fR .RS 4 مکان‌نما را یک \fBکلمه\fR به چپ می‌برد.\& پیش‌فرض: \fIControl+Left Mod1+b\fR.\& .PP .RE \fBcursor\-right\fR .RS 4 مکان‌نما را یک \fBنویسه\fR به راست می‌برد.\& پیش‌فرض: \fIRight Control+f\fR.\& .PP .RE \fBcursor\-right\-word\fR .RS 4 مکان‌نما را یک \fBکلمه\fR به راست می‌برد.\& پیش‌فرض: \fIControl+Right Mod1+f\fR.\& .PP .RE \fBcursor\-home\fR .RS 4 مکان‌نما را به ابتدای ورودی می‌برد.\& پیش‌فرض: \fIHome Control+a\fR.\& .PP .RE \fBcursor\-end\fR .RS 4 مکان‌نما را به انتهای ورودی می‌برد.\& پیش‌فرض: \fIEnd Control+e\fR.\& .PP .RE \fBdelete\-line\-backward\fR .RS 4 همه چیز را قبل از مکان‌نما حذف می‌کند.\& پیش‌فرض: \fIControl+u\fR.\& .PP .RE \fBdelete\-line\-forward\fR .RS 4 همه چیز را بعد از مکان‌نما حذف می‌کند.\& پیش‌فرض: \fIControl+k\fR.\& .PP .RE \fBdelete\-line\fR .RS 4 تمام ورودی را حذف می‌کند.\& پیش‌فرض: \fIControl+Shift+BackSpace\fR.\& .PP .RE \fBdelete\-prev\fR .RS 4 \fBنویسه قبل\fR از مکان‌نما را حذف می‌کند.\& پیش‌فرض: \fIBackSpace Control+h\fR.\& .PP .RE \fBdelete\-prev\-word\fR .RS 4 \fBکلمه قبل\fR از مکان‌نما را حذف می‌کند.\& پیش‌فرض: \fIMod1+BackSpace Control+BackSpace Control+w\fR.\& .PP .RE \fBdelete\-next\fR .RS 4 \fBنویسه بعد\fR از مکان‌نما را حذف می‌کند.\& پیش‌فرض: \fIDelete\fR.\& .PP .RE \fBdelete\-next\-word\fR .RS 4 \fBکلمه بعد\fR از مکان‌نما را حذف می‌کند.\& پیش‌فرض: \fIMod1+d Control+Delete\fR.\& .PP .RE \fBinsert\-selected\fR .RS 4 مورد انتخاب‌شده را در اعلان ورودی کپی کرده و جایگزین اعلان فعلی می‌کند.\& در حالت برنامه‌ها، خط \fBExec\fR درج می‌شود، و در حالت dmenu خود مدخل به کار می‌رود.\& پیش‌فرض: \fIControl+Tab\fR.\& .PP .RE \fBexpunge\fR .RS 4 مورد انتخاب‌شده فعلی را از حافظه موقت (برنامه‌هایی که بیشترین اجرا را داشته‌اند) پاک می‌کند.\& پیش‌فرض: \fIShift+Delete\fR.\& .PP .RE \fBclipboard\-paste\fR .RS 4 جای‌گذاری متن از \fIکلیپ‌بورد (clipboard)\fR.\& پیش‌فرض: \fIControl+v\fR \fIXF86Paste\fR.\& .PP .RE \fBprimary\-paste\fR .RS 4 جای‌گذاری متن از \fIانتخاب اولیه (primary selection)\fR.\& این عمل همچنین به کلید میانی موش‌واره اختصاص یافته است (در حال حاضر قابل پیکربندی نیست).\& پیش‌فرض: \fIShift+Insert\fR \fIShift+KP_Insert\fR.\& .PP .RE \fBprev\fR .RS 4 انتخاب مورد قبلی.\& هنگامی که به اولین مورد برسد، به انتها باز \fBنمی‌گردد\fR.\& پیش‌فرض: \fIUp Control+p\fR.\& .PP .RE \fBprev\-with\-wrap\fR .RS 4 انتخاب مورد قبلی.\& هنگامی که به اولین مورد برسد، به انتها بازمی‌گردد (wrap around).\& پیش‌فرض: \fIISO_Left_Tap\fR.\& (Shift+Tab) .PP .RE \fBprev\-page\fR .RS 4 رفتن به صفحه قبلی.\& پیش‌فرض: \fIPageUp KP_PageUp\fR.\& .PP .RE \fBnext\fR .RS 4 انتخاب مورد بعدی.\& هنگامی که به آخرین مورد برسد، به ابتدا باز \fBنمی‌گردد\fR.\& پیش‌فرض: \fIDown Control+n\fR.\& .PP .RE \fBnext\-with\-wrap\fR .RS 4 انتخاب مورد بعدی.\& هنگامی که به آخرین مورد برسد، به ابتدا بازمی‌گردد (wrap around).\& پیش‌فرض: \fIunbound (اختصاص نیافته)\fR.\& .PP .RE \fBnext\-page\fR .RS 4 رفتن به صفحه بعدی.\& پیش‌فرض: \fIPage_Down KP_Page_Down\fR.\& .PP .RE \fBfirst\fR .RS 4 انتخاب اولین مورد در اولین صفحه.\& پیش‌فرض: \fIControl+Home\fR.\& .PP .RE \fBlast\fR .RS 4 انتخاب آخرین مورد در آخرین صفحه.\& پیش‌فرض: \fIControl+End\fR.\& .PP .RE \fBcustom\-1\fR, \fBcustom\-2\fR, .\&.\&.\&, \fBcustom\-19\fR .RS 4 اجرای موردی که در حال حاضر انتخاب شده است، و سپس خروج با یک کد خروج غیرصفر.\& گزینه \fBcustom\-1\fR با کد خروج ۱۰ خارج می‌شود، \fBcustom\-2\fR با ۱۱، \fBcustom\-3\fR با ۱۲، و به همین ترتیب.\& .PP پیش‌فرض: .RS 4 .PD 0 .IP \(bu 4 custom\-1: \fIMod1+1\fR .IP \(bu 4 custom\-2: \fIMod1+2\fR .IP \(bu 4 custom\-3: \fIMod1+3\fR .IP \(bu 4 custom\-4: \fIMod1+4\fR .IP \(bu 4 custom\-5: \fIMod1+5\fR .IP \(bu 4 custom\-6: \fIMod1+6\fR .IP \(bu 4 custom\-7: \fIMod1+7\fR .IP \(bu 4 custom\-8: \fIMod1+8\fR .IP \(bu 4 custom\-9: \fIMod1+9\fR .IP \(bu 4 custom\-10: \fIMod1+10\fR .IP \(bu 4 custom\-11: \fIMod1+11\fR .IP \(bu 4 custom\-12: \fIMod1+12\fR .IP \(bu 4 custom\-13: \fIMod1+13\fR .IP \(bu 4 custom\-14: \fIMod1+14\fR .IP \(bu 4 custom\-15: \fIMod1+15\fR .IP \(bu 4 custom\-16: \fIMod1+16\fR .IP \(bu 4 custom\-17: \fIMod1+17\fR .IP \(bu 4 custom\-18: \fIMod1+18\fR .IP \(bu 4 custom\-19: \fIMod1+19\fR .PD .PP .RE .RE .SH FONT CONFIG .PP فناوری Fontconfig از یک قالب متنی منعطف برای تعیین قلم‌ها استفاده می‌کند که به شما امکان می‌دهد خانواده قلم، سبک‌ها، وزن‌ها و مشخصه‌های گوناگون را تعریف کنید.\& نحو پایه از الگوی زیر پیروی می‌کند: .PP .RS 4 "Family Name:style=Style:weight=Weight:size=Size" .PP .RE مشخصه‌های رایج: .PP .PD 0 .IP \(bu 4 \fBfamily\fR \- نام خانواده قلم .IP \(bu 4 \fBstyle\fR \- italic، oblique، roman .IP \(bu 4 \fBweight\fR \- light، normal، bold، black (یا مقادیر عددی ۱۰۰\-۹۰۰) .IP \(bu 4 \fBsize\fR \- اندازه قلم بر حسب پوینت (Point size) .IP \(bu 4 \fBslant\fR \- italic، oblique، roman .IP \(bu 4 \fBwidth\fR \- condensed، normal، expanded .PD .PP .PP فناوری Fontconfig از قلم‌های جایگزین (fallback fonts) پشتیبانی می‌کند.\& می‌توانید چندین خانواده قلم را که با کاما از هم جدا شده‌اند، مشخص کنید.\& قلم‌های جایگزین به همان ترتیبی که نوشته شده‌اند جستجو می‌شوند.\& اگر گلیفی در هیچ‌یک از قلم‌های جایگزین پیدا نشود، فهرست پویای قلم‌های جایگزین در fontconfig (برای قلم اصلی) جستجو می‌شود.\& مثال: .PP .RS 4 "My Custom Font, DejaVu Sans:weight=bold, sans\-serif" .PP .RE ابزار Fontconfig صرف‌نظر از نام قلمی که به آن می‌دهید، همیشه مقداری را برمی‌گرداند مگر اینکه هیچ قلمی روی سیستم شما نصب نشده باشد.\& با دستور `fc\-match \-s YourFontName` می‌توانید قلم‌هایی را که تطبیق داده می‌شوند، بررسی کنید.\& .PP کتابخانه قلمی که Fuzzel استفاده می‌کند، یعنی fcft، هر زمان گلیفی در قلم اصلی یافت نشود، قلم‌های جایگزین صریح را جستجو خواهد کرد.\& هنگامی که نتواند گلیفی را در قلم‌های جایگزین صریح پیدا کند، قلم‌های جایگزین fontconfig برای اولین قلم در فهرست Fuzzel را جستجو می‌کند.\& .PP این طراحی هم امکان تعیین ترتیب دلخواه برای قلم‌های جایگزین و هم گزینه‌های سفارشی قلم برای هر قلم جایگزین را فراهم می‌کند.\& .PP .SH "همچنین ببینید (SEE ALSO)" .PP .PD 0 .IP \(bu 4 \fBfuzzel\fR(1) .IP \(bu 4 \fBhttps://specifications.\&freedesktop.\&org/desktop\-entry\-spec/desktop\-entry\-spec\-latest.\&html\fR .IP \(bu 4 \fBhttps://codeberg.\&org/dnkl/fuzzel\fR