.\" Generated by scdoc 1.11.4
.\" 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 "kanshi" "5" "2026-02-01"
.PP
.SH "نام (NAME)"
.PP
kanshi \- فایل پیکربندی kanshi
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
یک فایل پیکربندی kanshi فهرستی از نمایه‌ها (پروفایل‌ها) است\&. هر نمایه دارای یک نام اختیاری است و شامل دستورالعمل‌های نمایه است که با آکولاد (\fB{\fR و \fB}\fR) احاطه شده‌اند\&.
.PP
مثال:
.PP
.nf
.RS 4
include /etc/kanshi/config\&.d/*

profile {
	output LVDS-1 disable
	output "Some Company ASDF 4242" {
		mode 1600x900
		position 0,0
	}
}

profile nomad {
	output LVDS-1 enable scale 2
}
.fi
.RE
.PP
.SH "دستورالعمل‌ها (DIRECTIVES)"
.PP
\fBprofile\fR [<name>] { <دستورالعمل‌های نمایه\&.\&.\&> }
.RS 4
تعریف یک نمایه جدید با استفاده از دستورالعمل‌های محصور در آکولاد مشخص‌شده\&. تعیین یک نام امکان‌پذیر است اما اختیاری می‌باشد\&.
.PP
.RE
\fBoutput\fR <معیار> <دستورالعمل‌های خروجی\&.\&.\&>
.RS 4
تعریف مقادیر پیش‌فرض برای دستورالعمل‌های خروجی درون تعاریف نمایه\&.
.PP
این پیش‌فرض‌ها تنها زمانی اعمال می‌شوند که خروجی مربوطه در یک نمایه خاص ذکر شده باشد\&. برای مثال، دو نمایه زیر معادل یکدیگرند:
.PP
.nf
.RS 4
output eDP-1 scale 2

profile manual {
	output eDP-1 scale 2
}

profile uses-defaults {
	output eDP-1
}
.fi
.RE
.PP
دستورالعمل‌های خروجی ممکن است در یک بلوک محصور در آکولاد نیز مشخص شوند\&.
.PP
.RE
\fBinclude\fR <path>
.RS 4
درج یک فایل دیگر از \fIpath\fR\&. ساختار نحوی شل بسط داده می‌شود (برای جزئیات به \fBwordexp\fR(3) مراجعه فرمایید)\&.
.PP
.RE
.SH "دستورالعمل‌های نمایه (PROFILE DIRECTIVES)"
.PP
دستورالعمل‌های نمایه با آرگومان‌هایی که با فاصله جدا شده‌اند همراه هستند\&. آرگومان‌ها در صورتی که حاوی فاصله باشند می‌توانند درون علامت نقل‌قول (با \fB"\fR) قرار گیرند\&.
.PP
\fBoutput\fR <معیار> <دستورالعمل‌های خروجی\&.\&.\&>
.RS 4
یک دستورالعمل خروجی، یک نمایشگر (خروجی) را به نمایه اضافه می‌کند\&.
.PP
معیار می‌تواند یکی از موارد زیر باشد:
.PP
.PD 0
.IP \(bu 4
نام یک خروجی (مانند "DP-1")\&. توجه داشته باشید که نام‌های خروجی ممکن است پایدار نباشند: آن‌ها ممکن است در طول راه‌اندازی‌های مجدد سیستم (بسته به ترتیب کاوش درایورهای هسته) یا ترتیب اتصال (معمولاً برای داک‌های USB-C) تغییر کنند\&.
.IP \(bu 4
یک رشته جداشده با فاصله شامل سازنده خروجی، مدل و شماره سریال (مانند "Foocorp ASDF 1234")\&. می‌توان از یک الگوی نویسه عمومی (wildcard) استفاده کرد (مانند "Foocorp ASDF *")؛ به \fBglob\fR(7) مراجعه کنید\&. اگر یکی از این فیلدها موجود نباشد، باید با رشته "Unknown" پر شود (مانند "Foocorp ASDF Unknown")\&.
.IP \(bu 4
یک نام مستعار خروجی (مانند "$work-desk3") که توسط دستورالعمل alias تعریف شده باشد\&. نام‌های مستعار خروجی فقط در حوزه نمایه قابل استفاده هستند\&.
.IP \(bu 4
یک نویسه عمومی "*"، برای تطبیق با هر خروجی\&.
نویسه‌های عمومی فقط در حوزه نمایه قابل استفاده هستند و تنها با یک خروجی تطبیق خواهند یافت\&.
.PD
.PP
دستورالعمل‌های خروجی ممکن است در یک بلوک محصور در آکولاد نیز مشخص شوند\&.
.PP
در \fBsway\fR(1)، نام‌ها و شناسه‌های خروجی را می‌توان از طریق دستور "swaymsg -t get_outputs" به دست آورد\&.
.PP
.RE
\fB\&.\&.\&.\&output\fR <معیار> <دستورالعمل‌های خروجی\&.\&.\&>
.RS 4
مشابه \fIoutput\fR، اما هر تعداد از خروجی‌ها را به نمایه اضافه می‌کند\&. این دستورالعمل معمولاً با معیار نویسه عمومی ترکیب می‌شود\&.
.PP
.RE
\fBexec\fR <دستور>
.RS 4
یک دستورالعمل exec پس از اعمال موفقیت‌آمیز نمایه، دستوری را اجرا می‌کند\&. از این گزینه می‌توان برای به‌روزرسانی وضعیت کامپوزیتور متناسب با نمایه در صورت عدم انجام خودکار استفاده کرد\&.
.PP
دستورات به صورت ناهمگام اجرا می‌شوند و ممکن است ترتیب آن‌ها حفظ نشود\&. اگر نیاز به اجرای متوالی دستورات دارید، باید آن‌ها را در یک دستور exec واحد یا در یک اسکریپت جداگانه تجمیع کنید\&.
.PP
به عنوان مثال در \fBsway\fR(1)، می‌توان از \fBexec\fR برای انتقال فضاهای کاری به خروجی مناسب بهره گرفت:
.PP
.nf
.RS 4
profile multihead {
	output eDP-1 enable
	output DP-1 enable transform 270
	exec swaymsg workspace 1, move workspace to eDP-1
}
.fi
.RE
.PP
توجه داشته باشید که در مورد خروجی‌هایی که با توضیحات خروجی مشخص شده‌اند باید دقت بیشتری کرد، زیرا ممکن است نام واقعی تغییر کند:
.PP
.nf
.RS 4
profile complex {
	output "Some Other Company GTBZ 2525" mode 1920x1200
	exec swaymsg workspace 1, move workspace to output '"Some Other Company GTBZ 2525"'
}
.fi
.RE
.PP
.RE
.SH "دستورالعمل‌های خروجی (OUTPUT DIRECTIVES)"
.PP
\fBenable\fR|\fBdisable\fR
.RS 4
خروجی مشخص‌شده را فعال یا غیرفعال می‌کند\&.
.PP
.RE
\fBmode\fR preferred
.RS 4
خروجی مشخص‌شده را برای استفاده از حالت ترجیحی آن پیکربندی می‌کند\&.
.PP
.RE
\fBmode\fR [--custom] <width>x<height>[@<rate>[Hz]]
.RS 4
خروجی مشخص‌شده را برای استفاده از حالت تعیین‌شده پیکربندی می‌کند\&. حالت‌ها ترکیبی از عرض و ارتفاع (به پیکسل) و نرخ نوسازی (به هرتز) هستند که نمایشگر شما می‌تواند برای استفاده از آن‌ها تنظیم شود\&.
.PP
مثال‌ها:
.PP
.nf
.RS 4
output HDMI-A-1 mode 1920x1080
output HDMI-A-1 mode 1920x1080@60Hz
output HDMI-A-1 mode --custom 1280x720@60Hz
.fi
.RE
.PP
.RE
\fBposition\fR <x>,<y>
.RS 4
خروجی را در موقعیت مشخص‌شده در فضای مختصات سراسری قرار می‌دهد\&.
.PP
مثال:
.PP
.nf
.RS 4
output HDMI-A-1 position 1600,0
.fi
.RE
.PP
.RE
\fBscale\fR <ضریب>
.RS 4
خروجی را با ضریب مقیاس مشخص‌شده مقیاس‌بندی می‌کند\&.
.PP
.RE
\fBtransform\fR <تبدیل>
.RS 4
تبدیل هندسی خروجی را تنظیم می‌کند\&. می‌تواند یکی از مقادیر "90"، "180"، "270" برای چرخش؛ یا "flipped"، "flipped-90"، "flipped-180"، "flipped-270" برای چرخش و بازتاب؛ یا "normal" برای بدون تبدیل باشد\&.
.PP
.RE
\fBadaptive_sync\fR on|off
.RS 4
همگام‌سازی تطبیقی (یا همان نرخ نوسازی متغیر / VRR) را فعال یا غیرفعال می‌کند\&.
.PP
.RE
\fBalias\fR $<name>
.RS 4
یک نام مستعار برای این خروجی تعریف می‌کند\&. نام‌های مستعار خروجی فقط در حوزه سراسری قابل تعریف هستند\&.
.PP
.RE
.SH "نویسندگان (AUTHORS)"
.PP
نگهداری توسط Simon Ser <contact@emersion\&.fr> به همراه مشارکت دیگر توسعه‌دهندگان متن‌باز انجام می‌شود\&. برای اطلاعات بیشتر درباره توسعه kanshi، پیوند زیر را ببینید:
<https://gitlab\&.freedesktop\&.org/emersion/kanshi>\&.
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBkanshi\fR(1)