RINK(5) Rink Manual RINK(5)

rink - قالب فایل پیکربندی TOML

فایل پیکربندی Rink از قالب TOML استفاده می‌کند.

انواع مدت‌زمان پسوندهای متداول مانند ms، s، h، d، y را می‌پذیرند. انواع اندازه پسوندهایی مانند MB را می‌پذیرند.

رشته‌های رنگ مجموعه‌ای از کلیدواژه‌ها هستند که با فاصله از یکدیگر جدا می‌شوند. کلیدواژه‌های زیر شناخته‌شده و معتبر هستند:

black, red, green, yellow, blue, purple, cyan, white, dark_gray, light_red, light_green, light_yellow, light_blue, light_purple, magenta, light_magenta, light_cyan, light_gray

رنگ را روی آن رنگ ANSI تنظیم می‌کند.

dim/dimmed

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

bold, italic, underline/under, strikethrough

قالب‌بندی.

hidden/none

متن را نامرئی می‌کند.

on

کلیدواژه رنگ پس از این، به‌جای پیش‌زمینه بر روی پس‌زمینه اعمال خواهد شد. مثال: black on red.

default/plain

منجر به متن ساده و بدون استایل می‌شود.

اعداد صحیح 0 تا 255

کدهای جدول رنگ گسترده پایانه.

# <6 hex letters>

کدهای هگزادسیمال می‌توانند برای تعیین رنگ واقعی (truecolor) استفاده شوند. مثال: #000000

rgb( <red> , <green> , <blue> )

مقادیر RGB می‌توانند برای تعیین رنگ واقعی (truecolor) استفاده شوند. درج فاصله مجاز نیست. مثال: rgb(10,10,10)

بخش [rink].

prompt = <string>

متنی که برای نشان دادن حالت تعاملی پیش از مکان‌نما نمایش داده می‌شود. باید شامل نویسه فاصله باشد. پیش‌فرض: "> "

long_output = <bool>

فهرست‌ها، مانند نتایج جستجو، را در چند خط می‌شکند. نیازمند پایانه‌ای با قابلیت پشتیبانی از یونیکد (Unicode) است. پیش‌فرض: false

show_interpretation = <bool>

پرس‌وجوی ورودی را بازقالب‌بندی‌شده بر اساس نحوه تفسیر آن توسط Rink نمایش می‌دهد. از برجسته‌سازی نحو پشتیبانی می‌کند. پیش‌فرض: true

بخش [currency].

enabled = <bool>

پشتیبانی از ارز می‌تواند به طور کامل غیرفعال شود. وقتی روی false تنظیم شود، currency.json بارگذاری نخواهد شد و تلاش برای استفاده از واحدهای ارزی خطای "یافت نشد" را برمی‌گرداند. پیش‌فرض: true

behavior = <"prompt" | "always">

پیش‌فرض: "prompt". هنگام تلاش برای استفاده از یک واحد ارزی، Rink می‌پرسد که آیا مایل به بارگیری داده‌های ارزی هستید یا خیر.

تنظیم آن روی "always" باعث می‌شود به محض استفاده از یک واحد ارزی، بارگیری بی‌درنگ انجام شود.

cache_expiration_enabled = <bool>

پیش‌فرض: true. تنظیم این مقدار روی false باعث می‌شود rink طوری عمل کند که گویا cache_duration بی‌نهایت است. اگر فایل ارز وجود نداشته باشد، آن را دریافت می‌کند؛ در غیر این صورت، نامحدود از آن استفاده خواهد کرد. Rink می‌تواند با --fetch-currency برای بارگیری تازه‌ترین نسخه فراخوانی شود.

این تنظیم ممکن است برای دسترسی مقطعی و ناپیوسته به اینترنت مفید باشد. می‌توانید یک کرون‌جاب (cron job) تنظیم کنید تا داده‌های ارزی را در زمان برقراری اتصال شبکه دریافت کند، تا بعداً هنگام استفاده آفلاین از rink در دسترس باشند.

endpoint = <url>

امکان اشاره به نمونه‌های جایگزین Rink-Web یا هر API دیگری را که قالبی سازگار ارائه می‌دهد فراهم می‌کند. پیش‌فرض: "https://rinkcalc.app/data/currency.json"

timeout = <duration>

مدت‌زمانی که پیش از انصراف باید برای دریافت داده‌های ارزی منتظر ماند. پیش‌فرض: "15s"

cache_duration = <duration>

مدت‌زمانی که پیش از کهنه در نظر گرفتن داده‌های ارزی ذخیره‌شده در حافظه پنهان باید سپری شود. پیش‌فرض: "1h"

بخش [colors].

enabled = <bool>

برای فعال کردن خروجی رنگی روی true تنظیم کنید. پیش‌فرض: true، یا اگر متغیر محیطی NO_COLOR تنظیم شده باشد، false.

theme = <string>

پوسته فعال را تعیین می‌کند. بخش "پوسته‌ها (Themes)" را ببینید. پیش‌فرض: "default"

بخش [themes]. این بخش یک دیکشنری است؛ هر پوسته باید به صورت [themes.my_theme] ایجاد شود. این گزینه‌ها مختص هر پوسته هستند.

plain = <color>

متن عمومی. این گزینه بسیار استفاده خواهد شد. پیش‌فرض: "default"

error = <color>

پیام‌های خطا. پیش‌فرض: "red"

unit = <color>

نام واحدها، مانند kilogram. پیش‌فرض: "cyan"

quantity = <color>

نام کمیت‌های فیزیکی، مانند length و time. این نام‌ها در هر پرس‌وجو داخل پرانتز نمایش داده می‌شوند. پیش‌فرض: "dimmed cyan"

number = <color>

اعدادی که در خروجی‌ها ظاهر می‌شوند. پیش‌فرض: "default"

user_input = <color>

هنگامی استفاده می‌شود که rink ورودی کاربر را بازگو می‌کند، مانند خطاهای پیدا نشدن واحد. پیش‌فرض: "bold"

doc_string = <color>

هنگامی استفاده می‌شود که rink متن توضیحی مربوط به تعریف یک واحد، مانند meter، را نمایش می‌دهد. پیش‌فرض: "italic"

pow = <color>

بخش ^2 در m/s^2. پیش‌فرض: "default"

prop_name = <color>

نام ویژگی‌ها در مواد، مانند speed در speed of light. پیش‌فرض: "cyan"

date_time = <color>

اشیای تاریخ و زمان، که می‌توان با نماد هش (#) یا now به آن‌ها دست یافت. پیش‌فرض: "default"

link = <color>

یک ابرپیوند، که معمولاً داخل رشته‌های مستندات یافت می‌شود. پیش‌فرض: "cyan"

keyword = <color>

کلمات کلیدی در زبان پرس‌وجوی Rink، مانند of، digits و غیره. پیش‌فرض: "yellow"

timezone = <color>

منطقه‌های زمانی، مانند [US/Pacific]. پیش‌فرض: "cyan"

لینوکس (Linux)

__$XDG_CONFIG_DIR__/rink/config.toml

ویندوز (Windows)

__{FOLDERID_RoamingAppData}__\rink\config.toml

مک‌اواس (macOS)

__$HOME__/Library/Application Support/rink/config.toml

rink(1), rink(7), rink-defs(5), rink-dates(5)

2026-08-30 Rink Manual