.\" Automatically generated by Pandoc 3.6
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.ad l
.TH "shikane" "1" "2026\-05\-31" "shikane 1.1.0"
.nh
.SH "نام (NAME)"
shikane \- پیکربندی پویای قطعی خروجی‌های تصویر
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]shikane\f[R]
.PD 0
.P
.PD
\f[B]shikane\f[R] [\f[B]\-hV\f[R]] [\f[B]\-o\f[R]] [\f[B]\-c\f[R]
\f[I]file\f[R]]
.PD 0
.P
.PD
\f[B]shikane\f[R] [\f[B]\-\-oneshot\f[R]] [\f[B]\-\-config\f[R]
\f[I]file\f[R]]
.SH "توضیحات (DESCRIPTION)"
برنامه shikane (/ʃiˈkaːnə/) یک ابزار پیکربندی پویای خروجی تصویر با تمرکز بر دقت و قطعیت است.
.PP
این ابزار به‌طور خودکار نمایشگرهای متصل را بر اساس مجموعه‌ای از پروفایل‌ها شناسایی و پیکربندی می‌کند.
هر پروفایل مجموعه‌ای از خروجی‌ها را با پارامترهای اضافی (مانند mode، position، scale) مشخص می‌کند.
اگر تمام خروجی‌ها و حالت‌های مشخص‌شده بتوانند دقیقاً با نمایشگرهای متصل فعلی و قابلیت‌های آن‌ها مطابقت یابند، پروفایل به‌طور خودکار اعمال خواهد شد.
(برای جزئیات بیشتر به \f[B]shikane\f[R](5) مراجعه کنید.)
.PP
این یک معادل Wayland برای ابزارهایی مانند autorandr است.
هدف آن جایگزینی کامل kanshi، رفع عدم‌دقت‌های آن و افزودن ویژگی‌های جدید است.
برنامه shikane با کامپوزیتورهای Wayland که از نسخه‌های ۳ یا بالاتر پروتکل wlr\-output\-management پشتیبانی می‌کنند (مانند کامپوزیتورهایی که از wlroots نسخه ۰.۱۶ استفاده می‌کنند) کار می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\f[B]\-h\f[R], \f[B]\-\-help\f[R]
نمایش اطلاعات راهنما
.TP
\f[B]\-c\f[R], \f[B]\-\-config\f[R] \f[I]file\f[R]
مسیر یک فایل پیکربندی (\f[I]file\f[R])
.TP
\f[B]\-o\f[R], \f[B]\-\-oneshot\f[R]
فعال‌سازی حالت یک‌باره (oneshot)
.RS
.PP
خروج پس از اعمال شدن یک پروفایل یا در صورت عدم تطابق هیچ پروفایلی
.RE
.TP
\f[B]\-s\f[R], \f[B]\-\-socket\f[R] \f[I]path\f[R]
بازنویسی مسیر پیش‌فرض سوکت IPC
.TP
\f[B]\-T\f[R], \f[B]\-\-timeout\f[R] \f[I]timeout\f[R]
انتظار به میزان \f[I]timeout\f[R] میلی‌ثانیه قبل از پردازش تغییرات [پیش‌فرض: 0]
.TP
\f[B]\-V\f[R], \f[B]\-\-version\f[R]
نمایش اطلاعات نسخه
.SH "محیط (ENVIRONMENT)"
.TP
\f[B]SHIKANE_LOG\f[R]
کنترل می‌کند که shikane و ماژول‌های آن در چه سطح لاگی پیام‌ها را در stderr چاپ کنند.
سطوح لاگ موجود عبارتند از \f[I]error\f[R]، \f[I]warn\f[R]، \f[I]info\f[R]، \f[I]debug\f[R] و \f[I]trace\f[R]؛ مرتب‌شده از بالاترین تا پایین‌ترین اولویت.
سطح لاگ پایین‌تر شامل پیام‌های سطوح بالاتر نیز می‌شود.
تنظیم \f[B]SHIKANE_LOG\f[R] روی \f[I]trace\f[R] به شما امکان مشاهده همه‌چیز را می‌دهد.
تنظیم آن روی \f[I]off\f[R] تمام لاگ‌گیری را غیرفعال می‌کند.
.RS
.PP
این متغیر امکان فیلتر کردن بر اساس ماژول‌ها را فراهم کرده و فهرستی جداشده با کاما را می‌پذیرد:
\f[B]SHIKANE_LOG\f[R]=\f[I]shikane=warn\f[R],\f[I]shikane::matching=debug\f[R]
تنها هشدارها (\f[I]warn\f[R]) و خطاهای (\f[I]error\f[R]) shikane را نمایش می‌دهد، به جز ماژول matching که در آن پیام‌های لاگ سطح \f[I]debug\f[R] و بالاتر نمایش داده می‌شوند.
.PP
نکته: خروجی لاگ و ساختار فیلترسازی یک رابط پایدار نیست و ممکن است در هر زمان تغییر کند.
.RE
.TP
\f[B]SHIKANE_LOG_STYLE\f[R]
کنترل می‌کند که آیا از رنگ‌ها و استایل‌های دارای نویسه‌های ANSI برای خروجی لاگ استفاده شود یا خیر.
مقادیر ممکن عبارتند از \f[I]auto\f[R]، \f[I]always\f[R] و \f[I]never\f[R].
پیش‌فرض \f[I]auto\f[R] است.
.TP
\f[B]SHIKANE_LOG_TIME\f[R]
در صورت تنظیم روی \f[I]1\f[R]، ثبت برچسب زمانی (timestamp) پیشوندی را فعال می‌کند.
.SH "فایل‌ها (FILES)"
برنامه shikane به‌طور پیش‌فرض پیکربندی خود را از
\f[B]$XDG_CONFIG_HOME/shikane/config.toml\f[R] می‌خواند.
اگر هیچ فایل پیکربندی‌ای (\f[I]file\f[R]) یافت نشود، برنامه با خطا خارج می‌شود.
قالب فایل پیکربندی در \f[B]shikane\f[R](5) مستند شده است.
.SH "گزارش باگ‌ها (BUGS)"
امیدواریم کمتر از ۴ مورد باشد.
.SH "نویسندگان (AUTHORS)"
Hendrik Wolff \c
.MT hendrik.wolff@agdsn.me
.ME \c
.SH "همچنین ببینید (SEE ALSO)"
\f[B]shikane\f[R](5), \f[B]shikanectl\f[R](1)