.\" 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 "RIO" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
Rio \- قالب فایل پیکربندی TOML\&.
.PP
.SH "نحو (SYNTAX)"
.PP
فایل پیکربندی Rio از قالب TOML استفاده می‌کند.\& مشخصات این قالب را می‌توانید در \fIhttps://toml.\&io/en/v1.\&0.\&0\fR بیابید.\&
.PP
.SH "مکان (LOCATION)"
.PP
Rio فایل پیکربندی را به‌طور خودکار برای شما ایجاد نمی‌کند، اما در سیستم‌های یونیکس در مسیرهای زیر به دنبال آن می‌گردد:
.PP
.PD 0
.IP 1. 4
\fI$RIO_CONFIG_HOME/config.\&toml\fR
.IP 2. 4
\fI$XDG_CONFIG_HOME/rio/config.\&toml\fR
.IP 3. 4
\fI$HOME/.\&config/rio/config.\&toml\fR
.PD
.PP
در ویندوز، فایل پیکربندی در مسیر زیر جستجو خواهد شد:
.PP
.PD 0
.IP 1. 4
\fI%USERPROFILE%\eAppData\eLocal\erio\econfig.\&toml\fR
.PD
.PP
.SH "عمومی (GENERAL)"
.PP
\fBtheme\fR = \fI"<string>"\fR
.PP
.RS 4
نام تم مورد استفاده.\& در صورت تعیین، رنگ‌های تعریف‌شده در فایل پیکربندی نادیده گرفته خواهند شد.\&
.PP
پیش‌فرض: \fINone\fR
.PP
.RE
\fBconfirm\-before\-quit\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
درخواست تأیید پیش از خروج.\&
.PP
پیش‌فرض: \fItrue\fR
.PP
.RE
\fBdraw\-bold\-text\-with\-light\-colors\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
هنگامی که روی \fItrue\fR تنظیم شود، متن درشت (bold) با استفاده از گونه‌های رنگ روشن رسم می‌شود.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBenv\-vars\fR = [\fI"<string>"\fR,]
.PP
.RS 4
متغیرهای محیطی جهت تنظیم برای فرآیندهای ایجادشده.\&
.PP
مثال:
.RS 4
env\-vars = [\fI"TERM=xterm\-256color"\fR, \fI"COLORTERM=truecolor"\fR]
.PP
.RE
.RE
.SH "پنجره (WINDOW)"
.PP
این بخش به مستندسازی جدول \fB[window]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBwidth\fR = \fI<integer>\fR
.PP
.RS 4
عرض پنجره بر حسب پیکسل.\&
.PP
پیش‌فرض: \fI600\fR
.PP
.RE
\fBheight\fR = \fI<integer>\fR
.PP
.RS 4
ارتفاع پنجره بر حسب پیکسل.\&
.PP
پیش‌فرض: \fI400\fR
.PP
.RE
\fBmode\fR = \fI"Windowed"\fR | \fI"Maximized"\fR | \fI"Fullscreen"\fR
.PP
.RS 4
حالت راه‌اندازی پنجره.\&
.PP
پیش‌فرض: \fI"Windowed"\fR
.PP
.RE
\fBopacity\fR = \fI<float>\fR
.PP
.RS 4
شفافیت پس‌زمینه به صورت یک عدد اعشاری از \fI0.\&0\fR تا \fI1.\&0\fR.\&
.PP
پیش‌فرض: \fI1.\&0\fR
.PP
.RE
\fBblur\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
درخواست از کامپوزیتور جهت تار (محو) کردن محتوای پشت پنجره‌های شفاف.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBdecorations\fR = \fI"Enabled"\fR | \fI"Disabled"\fR | \fI"Transparent"\fR | \fI"Buttonless"\fR
.PP
.RS 4
تزیینات پنجره.\&
.PP
\fBEnabled\fR
.RS 4
تزیینات عادی پنجره.\&
.RE
\fBDisabled\fR
.RS 4
بدون تزیینات پنجره.\&
.RE
\fBTransparent\fR \fI(تنها در macOS)\fR
.RS 4
نوار عنوان شفاف.\&
.RE
\fBButtonless\fR \fI(تنها در macOS)\fR
.RS 4
نوار عنوان بدون دکمه.\&
.PP
.RE
پیش‌فرض: \fI"Enabled"\fR
.PP
.RE
\fBbackground\-image\fR = { path = \fI"<string>"\fR, opacity = \fI<float>\fR }
.PP
.RS 4
تصویر پس‌زمینه پنجره.\& تصویر یک بار در یک بافت (texture) اختصاصی GPU بارگذاری شده و برای پوشش کامل پنجره کشیده می‌شود.\&
.PP
\fBpath\fR
.RS 4
مسیر فایل تصویر پس‌زمینه.\&
.RE
\fBopacity\fR
.RS 4
شفافیت تصویر از \fI0.\&0\fR تا \fI1.\&0\fR.\& پیش‌فرض: \fI1.\&0\fR.\&
.PP
.RE
.RE
.SH "فونت‌ها (FONTS)"
.PP
این بخش به مستندسازی جدول \fB[fonts]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBsize\fR = \fI<float>\fR
.PP
.RS 4
اندازه فونت بر حسب پوینت.\&
.PP
پیش‌فرض: \fI18.\&0\fR
.PP
.RE
\fBfamily\fR = \fI"<string>"\fR
.PP
.RS 4
نام خانواده فونت.\& در صورت تنظیم، تمام خانواده‌های گونه‌های فونت را بازنویسی می‌کند.\&
.PP
پیش‌فرض: \fI"cascadiacode"\fR
.PP
.RE
\fBfeatures\fR = [\fI"<string>"\fR,]
.PP
.RS 4
ویژگی‌های فونت OpenType جهت فعال‌سازی.\&
.PP
مثال:
.RS 4
features = [\fI"ss02"\fR, \fI"ss03"\fR, \fI"liga"\fR]
.PP
.RE
.RE
\fBuse\-drawable\-chars\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
استفاده از نویسه‌های توکار قابل رسم برای کشیدن جعبه‌ها (box drawing).\&
.PP
پیش‌فرض: \fItrue\fR
.PP
.RE
\fBdisable\-warnings\-not\-found\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
غیرفعال‌سازی هشدارها در صورت پیدا نشدن فونت‌ها.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBadditional\-dirs\fR = [\fI"<string>"\fR,]
.PP
.RS 4
دایرکتوری‌های اضافی برای جستجوی فونت‌ها.\&
.PP
.RE
\fBregular\fR = { family = \fI"<string>"\fR, style = \fI"<string>"\fR, width = \fI"<string>"\fR, weight = \fI<integer>\fR }
.PP
.RS 4
پیکربندی فونت عادی (Regular).\&
.PP
پیش‌فرض: { family = \fI"cascadiacode"\fR, style = \fI"Normal"\fR, width = \fI"Normal"\fR, weight = \fI400\fR }
.PP
.RE
\fBbold\fR = { family = \fI"<string>"\fR, style = \fI"<string>"\fR, width = \fI"<string>"\fR, weight = \fI<integer>\fR }
.PP
.RS 4
پیکربندی فونت توپر (Bold).\&
.PP
پیش‌فرض: { family = \fI"cascadiacode"\fR, style = \fI"Normal"\fR, width = \fI"Normal"\fR, weight = \fI800\fR }
.PP
.RE
\fBitalic\fR = { family = \fI"<string>"\fR, style = \fI"<string>"\fR, width = \fI"<string>"\fR, weight = \fI<integer>\fR }
.PP
.RS 4
پیکربندی فونت خوابیده (Italic).\&
.PP
پیش‌فرض: { family = \fI"cascadiacode"\fR, style = \fI"Italic"\fR, width = \fI"Normal"\fR, weight = \fI400\fR }
.PP
.RE
\fBbold\-italic\fR = { family = \fI"<string>"\fR, style = \fI"<string>"\fR, width = \fI"<string>"\fR, weight = \fI<integer>\fR }
.PP
.RS 4
پیکربندی فونت توپر خوابیده (Bold Italic).\&
.PP
پیش‌فرض: { family = \fI"cascadiacode"\fR, style = \fI"Italic"\fR, width = \fI"Normal"\fR, weight = \fI800\fR }
.PP
.RE
\fBextras\fR = [{ family = \fI"<string>"\fR },]
.PP
.RS 4
فونت‌های اضافی جهت بارگذاری.\&
.PP
.RE
\fBemoji\fR = { family = \fI"<string>"\fR }
.PP
.RS 4
پیکربندی فونت ایموجی.\&
.PP
پیش‌فرض: فونت درونی Twemoji
.PP
.RE
\fBhinting\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
فعال‌سازی هینتینگ (hinting) فونت.\&
.PP
پیش‌فرض: \fItrue\fR
.PP
.RE
\fBsymbol\-map\fR = [{ chars = \fI"<string>"\fR, family = \fI"<string>"\fR },]
.PP
.RS 4
نگاشت محدوده‌های نویسه‌ای مشخص به فونت‌ها.\&
.PP
.RE
.SH "رنگ‌ها (COLORS)"
.PP
این بخش به مستندسازی جدول \fB[colors]\fR در فایل پیکربندی می‌پردازد.\&
.PP
رنگ‌ها با استفاده از مقادیر هگزادسیمال همراه با پیشوند \fI#\fR مشخص می‌شوند: \fI#RRGGBB\fR یا \fI#RRGGBBAA\fR.\&
.PP
\fBbackground\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ پیش‌فرض پس‌زمینه.\&
.PP
.RE
\fBforeground\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ پیش‌فرض پیش‌زمینه (متن).\&
.PP
.RE
\fBcursor\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ مکان‌نما.\&
.PP
.RE
\fBvi\-cursor\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ مکان‌نما در حالت Vi.\&
.PP
.RE
\fBblack\fR, \fBred\fR, \fBgreen\fR, \fByellow\fR, \fBblue\fR, \fBmagenta\fR, \fBcyan\fR, \fBwhite\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ‌های استاندارد ANSI.\&
.PP
.RE
\fBlight\-black\fR, \fBlight\-red\fR, \fBlight\-green\fR, \fBlight\-yellow\fR, \fBlight\-blue\fR, \fBlight\-magenta\fR, \fBlight\-cyan\fR, \fBlight\-white\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ‌های روشن ANSI.\&
.PP
.RE
\fBdim\-black\fR, \fBdim\-red\fR, \fBdim\-green\fR, \fBdim\-yellow\fR, \fBdim\-blue\fR, \fBdim\-magenta\fR, \fBdim\-cyan\fR, \fBdim\-white\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ‌های کم‌رنگ ANSI.\&
.PP
.RE
\fBtabs\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ عنوان زبانه‌های غیرفعال.\& پس‌زمینه جزیره‌ای زبانه‌ها به‌طور خودکار از رنگ پس‌زمینه پنجره مشتق می‌شود.\&
.PP
.RE
\fBtabs\-active\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ عنوان زبانه فعال.\&
.PP
.RE
\fBsplit\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ جداکننده بخش‌های تقسیم‌شده پنجره.\&
.PP
.RE
\fBsearch\-match\-background\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ پس‌زمینه مورد تطابق‌یافته در جستجو.\&
.PP
.RE
\fBsearch\-match\-foreground\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ متن مورد تطابق‌یافته در جستجو.\&
.PP
.RE
\fBsearch\-focused\-match\-background\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ پس‌زمینه مورد تطابق‌یافته دارای فوکوس در جستجو.\&
.PP
.RE
\fBsearch\-focused\-match\-foreground\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ متن مورد تطابق‌یافته دارای فوکوس در جستجو.\&
.PP
.RE
\fBselection\-background\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ پس‌زمینه متن انتخاب‌شده.\&
.PP
.RE
\fBselection\-foreground\fR = \fI"<string>"\fR
.PP
.RS 4
رنگ متن انتخاب‌شده.\&
.PP
.RE
.SH "مکان‌نما (CURSOR)"
.PP
این بخش به مستندسازی جدول \fB[cursor]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBshape\fR = \fI"block"\fR | \fI"underline"\fR | \fI"beam"\fR
.PP
.RS 4
شکل مکان‌نما.\&
.PP
پیش‌فرض: \fI"block"\fR
.PP
.RE
\fBblinking\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
فعال‌سازی چشمک‌زدن مکان‌نما.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBblinking\-interval\fR = \fI<integer>\fR
.PP
.RS 4
فاصله زمانی چشمک‌زدن مکان‌نما بر حسب میلی‌ثانیه.\& محدوده: 350\-1200.\&
.PP
پیش‌فرض: \fI800\fR
.PP
.RE
.SH "پیمایش (SCROLL)"
.PP
این بخش به مستندسازی جدول \fB[scroll]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBmultiplier\fR = \fI<float>\fR
.PP
.RS 4
ضریب سرعت پیمایش.\&
.PP
پیش‌فرض: \fI3.\&0\fR
.PP
.RE
\fBdivider\fR = \fI<float>\fR
.PP
.RS 4
تقسیم‌کننده پیمایش برای تنظیم دقیق.\&
.PP
پیش‌فرض: \fI1.\&0\fR
.PP
.RE
.SH "ناوبری (NAVIGATION)"
.PP
این بخش به مستندسازی جدول \fB[navigation]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBmode\fR = \fI"NativeTab"\fR | \fI"Tab"\fR | \fI"Plain"\fR
.PP
حالت نمایش ناوبری.\&
.PP
پیش‌فرض: \fI"Tab"\fR
.PP
\fBclickable\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
فعال‌سازی عناصر ناوبری قابل کلیک.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBuse\-current\-path\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
نمایش دایرکتوری کاری فعلی در ناوبری.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBcolor\-automation\fR = [{ program = \fI"<string>"\fR, path = \fI"<string>"\fR, color = \fI"<string>"\fR },]
.PP
.RS 4
تخصیص خودکار رنگ بر اساس برنامه یا مسیر.\&
.PP
.RE
.SH "پوسته (SHELL)"
.PP
این بخش به مستندسازی جدول \fB[shell]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBprogram\fR = \fI"<string>"\fR
.PP
.RS 4
برنامه پوسته جهت اجرا.\&
.PP
پیش‌فرض: پوسته پیش‌فرض سیستم
.PP
.RE
\fBargs\fR = [\fI"<string>"\fR,]
.PP
.RS 4
آرگومان‌هایی که به پوسته ارسال می‌شوند.\&
.PP
.RE
.SH "ویرایشگر (EDITOR)"
.PP
این بخش به مستندسازی جدول \fB[editor]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBprogram\fR = \fI"<string>"\fR
.PP
.RS 4
برنامه ویرایشگر جهت باز کردن فایل‌های پیکربندی.\&
.PP
پیش‌فرض: \fI"vi"\fR
.PP
.RE
\fBargs\fR = [\fI"<string>"\fR,]
.PP
.RS 4
آرگومان‌هایی که به ویرایشگر ارسال می‌شوند.\&
.PP
.RE
.SH "کلیدهای میانبر (BINDINGS)"
.PP
این بخش به مستندسازی جدول \fB[bindings]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBkeys\fR = [{ key = \fI"<string>"\fR, with = \fI"<string>"\fR, action = \fI"<string>"\fR },]
.PP
.RS 4
پیکربندی کلیدهای میانبر.\&
.PP
\fBkey\fR
.RS 4
نام کلید (مانند \fI"q"\fR، \fI"Enter"\fR، \fI"F1"\fR).\&
.PP
.RE
\fBwith\fR
.RS 4
کلیدهای تغییردهنده (modifier): \fI"super"\fR، \fI"alt"\fR، \fI"ctrl"\fR، \fI"shift"\fR.\&
چندین کلید تغییردهنده را می‌توان با \fI|\fR با یکدیگر ترکیب کرد.\&
.PP
.RE
\fBaction\fR
.RS 4
عملیاتی که باید انجام شود.\& اقدامات موجود عبارتند از:
\fI"Quit"\fR، \fI"CreateWindow"\fR، \fI"CloseWindow"\fR، \fI"Copy"\fR، \fI"Paste"\fR،
\fI"ScrollUp"\fR، \fI"ScrollDown"\fR، \fI"ToggleViMode"\fR، \fI"OpenConfigEditor"\fR،
و موارد متعدد دیگر.\&
.PP
.RE
.RE
.SH "رندرکننده (RENDERER)"
.PP
این بخش به مستندسازی جدول \fB[renderer]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBperformance\fR = \fI"High"\fR | \fI"Low"\fR
.PP
.RS 4
حالت کارایی رندرینگ.\&
.PP
پیش‌فرض: \fI"High"\fR
.PP
.RE
\fBbackend\fR = \fI"Automatic"\fR | \fI"GL"\fR | \fI"Vulkan"\fR | \fI"DX12"\fR | \fI"Metal"\fR
.PP
.RS 4
بک‌اند گرافیکی مورد استفاده.\&
.PP
پیش‌فرض: \fI"Automatic"\fR
.PP
.RE
\fBdisable\-renderer\-when\-unfocused\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
غیرفعال‌سازی رندرینگ در هنگام عدم فوکوس پنجره جهت صرفه‌جویی در مصرف انرژی.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBlevel\fR = \fI<integer>\fR
.PP
.RS 4
سطح رندرینگ (0\-3).\&
.PP
پیش‌فرض: \fI3\fR
.PP
.RE
.SH "توسعه‌دهنده (DEVELOPER)"
.PP
این بخش به مستندسازی جدول \fB[developer]\fR در فایل پیکربندی می‌پردازد.\&
.PP
\fBlog\-level\fR = \fI"OFF"\fR | \fI"ERROR"\fR | \fI"WARN"\fR | \fI"INFO"\fR | \fI"DEBUG"\fR | \fI"TRACE"\fR
.PP
.RS 4
سطح ثبت گزارش (log) جهت اشکال‌زدایی.\&
.PP
پیش‌فرض: \fI"OFF"\fR
.PP
.RE
\fBenable\-log\-file\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
نوشتن گزارش‌ها در فایل.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBenable\-fps\-counter\fR = \fItrue\fR | \fIfalse\fR
.PP
.RS 4
نمایش شمارنده نرخ فریم (FPS).\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBrio\fR(1)
.PP
.SH "گزارش باگ‌ها (BUGS)"
.PP
باگی پیدا کردید؟\& لطفاً آن را در \fIhttps://github.\&com/raphamorim/rio/issues\fR گزارش دهید.\&
.PP
.SH "نگه‌دارندگان (MAINTAINERS)"
.PP
.PD 0
.IP \(bu 4
Raphael Amorim <rapha850@gmail.\&com>
.PD