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] در فایل پیکربندی می‌پردازد.

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"، و موارد متعدد دیگر.