RIO(5)                        File Formats Manual                       RIO(5)

نام (NAME)
       Rio - قالب فایل پیکربندی TOML.

نحو (SYNTAX)
       فایل پیکربندی Rio از قالب TOML استفاده می‌کند. مشخصات این قالب را
       می‌توانید در https://toml.io/en/v1.0.0 بیابید.

مکان (LOCATION)
       Rio فایل پیکربندی را به‌طور خودکار برای شما ایجاد نمی‌کند، اما در
       سیستم‌های یونیکس در مسیرهای زیر به دنبال آن می‌گردد:

       1.  $RIO_CONFIG_HOME/config.toml
       2.  $XDG_CONFIG_HOME/rio/config.toml
       3.  $HOME/.config/rio/config.toml

       در ویندوز، فایل پیکربندی در مسیر زیر جستجو خواهد شد:

       1.  %USERPROFILE%\AppData\Local\rio\config.toml

عمومی (GENERAL)
       theme = "<string>"

           نام تم مورد استفاده. در صورت تعیین، رنگ‌های تعریف‌شده در فایل
           پیکربندی نادیده گرفته خواهند شد.

           پیش‌فرض: None

       confirm-before-quit = true | false

           درخواست تأیید پیش از خروج.

           پیش‌فرض: true

       draw-bold-text-with-light-colors = true | false

           هنگامی که روی true تنظیم شود، متن درشت (bold) با استفاده از گونه‌های
           رنگ روشن رسم می‌شود.

           پیش‌فرض: false

       env-vars = ["<string>",]

           متغیرهای محیطی جهت تنظیم برای فرآیندهای ایجادشده.

           مثال:
               env-vars = ["TERM=xterm-256color", "COLORTERM=truecolor"]

پنجره (WINDOW)
       این بخش به مستندسازی جدول [window] در فایل پیکربندی می‌پردازد.

       width = <integer>

           عرض پنجره بر حسب پیکسل.

           پیش‌فرض: 600

       height = <integer>

           ارتفاع پنجره بر حسب پیکسل.

           پیش‌فرض: 400

       mode = "Windowed" | "Maximized" | "Fullscreen"

           حالت راه‌اندازی پنجره.

           پیش‌فرض: "Windowed"

       opacity = <float>

           شفافیت پس‌زمینه به صورت یک عدد اعشاری از 0.0 تا 1.0.

           پیش‌فرض: 1.0

       blur = true | false

           درخواست از کامپوزیتور جهت تار (محو) کردن محتوای پشت پنجره‌های شفاف.

           پیش‌فرض: false

       decorations = "Enabled" | "Disabled" | "Transparent" | "Buttonless"

           تزیینات پنجره.

           Enabled
               تزیینات عادی پنجره.
           Disabled
               بدون تزیینات پنجره.
           Transparent (تنها در macOS)
               نوار عنوان شفاف.
           Buttonless (تنها در macOS)
               نوار عنوان بدون دکمه.

           پیش‌فرض: "Enabled"

       background-image = { path = "<string>", opacity = <float> }

           تصویر پس‌زمینه پنجره. تصویر یک بار در یک بافت (texture) اختصاصی GPU
           بارگذاری شده و برای پوشش کامل پنجره کشیده می‌شود.

           path
               مسیر فایل تصویر پس‌زمینه.
           opacity
               شفافیت تصویر از 0.0 تا 1.0. پیش‌فرض: 1.0.

فونت‌ها (FONTS)
       این بخش به مستندسازی جدول [fonts] در فایل پیکربندی می‌پردازد.

       size = <float>

           اندازه فونت بر حسب پوینت.

           پیش‌فرض: 18.0

       family = "<string>"

           نام خانواده فونت. در صورت تنظیم، تمام خانواده‌های گونه‌های فونت را
           بازنویسی می‌کند.

           پیش‌فرض: "cascadiacode"

       features = ["<string>",]

           ویژگی‌های فونت OpenType جهت فعال‌سازی.

           مثال:
               features = ["ss02", "ss03", "liga"]

       use-drawable-chars = true | false

           استفاده از نویسه‌های توکار قابل رسم برای کشیدن جعبه‌ها (box drawing).

           پیش‌فرض: true

       disable-warnings-not-found = true | false

           غیرفعال‌سازی هشدارها در صورت پیدا نشدن فونت‌ها.

           پیش‌فرض: false

       additional-dirs = ["<string>",]

           دایرکتوری‌های اضافی برای جستجوی فونت‌ها.

       regular = { family = "<string>", style = "<string>", width =
       "<string>", weight = <integer> }

           پیکربندی فونت عادی (Regular).

           پیش‌فرض: { family = "cascadiacode", style = "Normal", width =
           "Normal", weight = 400 }

       bold = { family = "<string>", style = "<string>", width = "<string>",
       weight = <integer> }

           پیکربندی فونت توپر (Bold).

           پیش‌فرض: { family = "cascadiacode", style = "Normal", width =
           "Normal", weight = 800 }

       italic = { family = "<string>", style = "<string>", width = "<string>",
       weight = <integer> }

           پیکربندی فونت خوابیده (Italic).

           پیش‌فرض: { family = "cascadiacode", style = "Italic", width =
           "Normal", weight = 400 }

       bold-italic = { family = "<string>", style = "<string>", width =
       "<string>", weight = <integer> }

           پیکربندی فونت توپر خوابیده (Bold Italic).

           پیش‌فرض: { family = "cascadiacode", style = "Italic", width =
           "Normal", weight = 800 }

       extras = [{ family = "<string>" },]

           فونت‌های اضافی جهت بارگذاری.

       emoji = { family = "<string>" }

           پیکربندی فونت ایموجی.

           پیش‌فرض: فونت درونی Twemoji

       hinting = true | false

           فعال‌سازی هینتینگ (hinting) فونت.

           پیش‌فرض: true

       symbol-map = [{ chars = "<string>", family = "<string>" },]

           نگاشت محدوده‌های نویسه‌ای مشخص به فونت‌ها.

رنگ‌ها (COLORS)
       این بخش به مستندسازی جدول [colors] در فایل پیکربندی می‌پردازد.

       رنگ‌ها با استفاده از مقادیر هگزادسیمال همراه با پیشوند # مشخص می‌شوند:
       #RRGGBB یا #RRGGBBAA.

       background = "<string>"

           رنگ پیش‌فرض پس‌زمینه.

       foreground = "<string>"

           رنگ پیش‌فرض پیش‌زمینه (متن).

       cursor = "<string>"

           رنگ مکان‌نما.

       vi-cursor = "<string>"

           رنگ مکان‌نما در حالت Vi.

       black, red, green, yellow, blue, magenta, cyan, white = "<string>"

           رنگ‌های استاندارد ANSI.

       light-black, light-red, light-green, light-yellow, light-blue,
       light-magenta, light-cyan, light-white = "<string>"

           رنگ‌های روشن ANSI.

       dim-black, dim-red, dim-green, dim-yellow, dim-blue, dim-magenta,
       dim-cyan, dim-white = "<string>"

           رنگ‌های کم‌رنگ ANSI.

       tabs = "<string>"

           رنگ عنوان زبانه‌های غیرفعال. پس‌زمینه جزیره‌ای زبانه‌ها به‌طور خودکار از
           رنگ پس‌زمینه پنجره مشتق می‌شود.

       tabs-active = "<string>"

           رنگ عنوان زبانه فعال.

       split = "<string>"

           رنگ جداکننده بخش‌های تقسیم‌شده پنجره.

       search-match-background = "<string>"

           رنگ پس‌زمینه مورد تطابق‌یافته در جستجو.

       search-match-foreground = "<string>"

           رنگ متن مورد تطابق‌یافته در جستجو.

       search-focused-match-background = "<string>"

           رنگ پس‌زمینه مورد تطابق‌یافته دارای فوکوس در جستجو.

       search-focused-match-foreground = "<string>"

           رنگ متن مورد تطابق‌یافته دارای فوکوس در جستجو.

       selection-background = "<string>"

           رنگ پس‌زمینه متن انتخاب‌شده.

       selection-foreground = "<string>"

           رنگ متن انتخاب‌شده.

مکان‌نما (CURSOR)
       این بخش به مستندسازی جدول [cursor] در فایل پیکربندی می‌پردازد.

       shape = "block" | "underline" | "beam"

           شکل مکان‌نما.

           پیش‌فرض: "block"

       blinking = true | false

           فعال‌سازی چشمک‌زدن مکان‌نما.

           پیش‌فرض: false

       blinking-interval = <integer>

           فاصله زمانی چشمک‌زدن مکان‌نما بر حسب میلی‌ثانیه. محدوده: 350-1200.

           پیش‌فرض: 800

پیمایش (SCROLL)
       این بخش به مستندسازی جدول [scroll] در فایل پیکربندی می‌پردازد.

       multiplier = <float>

           ضریب سرعت پیمایش.

           پیش‌فرض: 3.0

       divider = <float>

           تقسیم‌کننده پیمایش برای تنظیم دقیق.

           پیش‌فرض: 1.0

ناوبری (NAVIGATION)
       این بخش به مستندسازی جدول [navigation] در فایل پیکربندی می‌پردازد.

       mode = "NativeTab" | "Tab" | "Plain"

       حالت نمایش ناوبری.

       پیش‌فرض: "Tab"

       clickable = true | false

           فعال‌سازی عناصر ناوبری قابل کلیک.

           پیش‌فرض: false

       use-current-path = true | false

           نمایش دایرکتوری کاری فعلی در ناوبری.

           پیش‌فرض: false

       color-automation = [{ program = "<string>", path = "<string>", color =
       "<string>" },]

           تخصیص خودکار رنگ بر اساس برنامه یا مسیر.

پوسته (SHELL)
       این بخش به مستندسازی جدول [shell] در فایل پیکربندی می‌پردازد.

       program = "<string>"

           برنامه پوسته جهت اجرا.

           پیش‌فرض: پوسته پیش‌فرض سیستم

       args = ["<string>",]

           آرگومان‌هایی که به پوسته ارسال می‌شوند.

ویرایشگر (EDITOR)
       این بخش به مستندسازی جدول [editor] در فایل پیکربندی می‌پردازد.

       program = "<string>"

           برنامه ویرایشگر جهت باز کردن فایل‌های پیکربندی.

           پیش‌فرض: "vi"

       args = ["<string>",]

           آرگومان‌هایی که به ویرایشگر ارسال می‌شوند.

کلیدهای میانبر (BINDINGS)
       این بخش به مستندسازی جدول [bindings] در فایل پیکربندی می‌پردازد.

       keys = [{ key = "<string>", with = "<string>", action = "<string>" },]

           پیکربندی کلیدهای میانبر.

           key
               نام کلید (مانند "q"، "Enter"، "F1").

           with
               کلیدهای تغییردهنده (modifier): "super"، "alt"، "ctrl"، "shift".
               چندین کلید تغییردهنده را می‌توان با | با یکدیگر ترکیب کرد.

           action
               عملیاتی که باید انجام شود. اقدامات موجود عبارتند از: "Quit"،
               "CreateWindow"، "CloseWindow"، "Copy"، "Paste"، "ScrollUp"،
               "ScrollDown"، "ToggleViMode"، "OpenConfigEditor"، و موارد متعدد
               دیگر.

رندرکننده (RENDERER)
       این بخش به مستندسازی جدول [renderer] در فایل پیکربندی می‌پردازد.

       performance = "High" | "Low"

           حالت کارایی رندرینگ.

           پیش‌فرض: "High"

       backend = "Automatic" | "GL" | "Vulkan" | "DX12" | "Metal"

           بک‌اند گرافیکی مورد استفاده.

           پیش‌فرض: "Automatic"

       disable-renderer-when-unfocused = true | false

           غیرفعال‌سازی رندرینگ در هنگام عدم فوکوس پنجره جهت صرفه‌جویی در مصرف
           انرژی.

           پیش‌فرض: false

       level = <integer>

           سطح رندرینگ (0-3).

           پیش‌فرض: 3

توسعه‌دهنده (DEVELOPER)
       این بخش به مستندسازی جدول [developer] در فایل پیکربندی می‌پردازد.

       log-level = "OFF" | "ERROR" | "WARN" | "INFO" | "DEBUG" | "TRACE"

           سطح ثبت گزارش (log) جهت اشکال‌زدایی.

           پیش‌فرض: "OFF"

       enable-log-file = true | false

           نوشتن گزارش‌ها در فایل.

           پیش‌فرض: false

       enable-fps-counter = true | false

           نمایش شمارنده نرخ فریم (FPS).

           پیش‌فرض: false

همچنین ببینید (SEE ALSO)
       rio(1)

گزارش باگ‌ها (BUGS)
       باگی پیدا کردید؟ لطفاً آن را در https://github.com/raphamorim/rio/issues
       گزارش دهید.

نگه‌دارندگان (MAINTAINERS)
       •   Raphael Amorim <rapha850@gmail.com>

                                  2026-08-31                            RIO(5)