.\" Generated by scdoc 1.11.3
.\" 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 "gtkgreet" "1" "2025-11-01"
.PP
.SH "نام (NAME)"
.PP
gtkgreet \- یک خوش‌آمدگوی مبتنی بر Gtk برای greetd
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBgtkgreet\fR [options]
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h, --help\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB-c, --command <command>\fR
.RS 4
مشخص کردن دستوری که در صورت ورود موفقیت‌آمیز اجرا شود.\& اگر دستوری مشخص نشود، gtkgreet سؤال خواهد کرد.\&
.PP
.RE
\fB-l, --layer-shell\fR
.RS 4
استفاده از wlr-layer-shell برای نمایش یک پنجره روی تمام خروجی‌ها.\& باید در زمان کامپایل فعال شده باشد.\&
.PP
.RE
\fB-b, --background\fR
.RS 4
مشخص کردن یک تصویر پس‌زمینه برای استفاده توسط gtkgreet.\& قالب‌های JPG و PNG به‌خوبی کار می‌کنند.\& تصویر در گوشه بالا-چپ مهار شده و هنگام مقیاس‌بندی DPI برابر با 1، با نسبت 1:1 رندر می‌شود.\&
.PP
\fBنکته:\fR این گزینه مقادیر مقیاس‌بندی غیر از 1 را به‌درستی مدیریت نمی‌کند.\& برای رندر انعطاف‌پذیرتر و صحیح‌تر تصویر پس‌زمینه از یک شیوه‌نامه (stylesheet) استفاده کنید.\&
.PP
.RE
\fB-s, --style <file.\&css>\fR
.RS 4
تعیین یک شیوه‌نامه سفارشی CSS حاوی استایل‌های اضافی برای پنجره gtkgreet.\& برای شرح زیرمجموعه CSS پشتیبانی‌شده در GTK، به نشانی https://developer.\&gnome.\&org/gtk3/stable/theming.\&html مراجعه کنید.\&
.PP
\fBنکته:\fR این گزینه قادر به بارگذاری شیوه‌نامه‌های تم Gtk نیست و صرفاً برای تغییرات در سطح برنامه است.\& برای انتخاب یک تم، از سازوکارهای معمول انتخاب تم Gtk استفاده کنید.\&
.PP
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
دستور gtkgreet یک خوش‌آمدگوی گرافیکی و مبتنی بر Gtk برای \fBgreetd\fR(1) است.\&
.PP
دستور gtkgreet امکان انتخاب برنامه‌ای که هنگام ورود آغاز شود را فراهم می‌کند.\& برای اطلاعات بیشتر درباره نحوه پیکربندی گزینه‌های ارائه‌شده، بخش \fBمحیط‌ها (ENVIRONMENTS)\fR را ببینید.\& کاربر همچنین می‌تواند با نوشتن خط فرمان مورد نظر خود، برنامه را مستقیماً هنگام ورود مشخص کند.\&
.PP
اجرای gtkgreet نیازمند یک کامپوزیتور Wayland مانند \fBcage\fR(1) یا \fBsway\fR(1) است.\&
.PP
.SH "راه‌اندازی (SETUP)"
.PP
برای استفاده از gtkgreet، یک کامپوزیتور Wayland دلخواه را به عنوان خوش‌آمدگوی خود پیکربندی کنید.\& کامپوزیتور را طوری تنظیم کنید که gtkgreet را اجرا کند، و نکته مهم اینکه پس از خاتمه gtkgreet، کامپوزیتور نیز بسته شود.\&
.PP
با استفاده از \fBcage\fR، خط فرمان به‌سادگی به‌صورت "cage gtkgreet" درمی‌آید.\&
.PP
با استفاده از \fBsway\fR(1)، می‌توان از پیکربندی sway حاوی "exec '\&gtkgreet; swaymsg exit'\&" و خط فرمانی مشابه "sway --config /etc/greetd/sway-config" استفاده کرد.\& مؤلفه "; swaymsg exit" مهم است، چرا که باعث می‌شود پس از نهایی شدن ورود توسط gtkgreet، کامپوزیتور sway خاتمه یابد.\&
.PP
برای اطلاعات درباره نحوه پیکربندی greetd، به \fBgreetd\fR(5) مراجعه کنید.\& برای اطلاعات در مورد نحوه استفاده صحیح از کامپوزیتور انتخابی خود، مستندات آن را مطالعه کنید.\&
.PP
.SH "استایل‌دهی (STYLING)"
.PP
از شیوه‌نامه می‌توان برای تغییر سبک و ظاهر عناصر gtkgreet، از جمله پس‌زمینه پنجره، فونت‌ها، کادر اعلان ورود و موارد دیگر استفاده کرد.\&
.PP
یک نمونه شیوه‌نامه را می‌توان در اینجا مشاهده کرد:
.PP
.nf
.RS 4
window {
        background-image: url("file:///etc/greetd/gtkgreet-background\&.jpg");
        background-size: cover;
        background-position: center;
}

box#body {
        background-color: rgba(50, 50, 50, 0\&.5);
        border-radius: 10px;
        padding: 50px;
}
.fi
.RE
.PP
.SH "محیط‌ها (ENVIRONMENTS)"
.PP
دستور gtkgreet گزینه‌های کاربری برنامه‌ها را برای اجرا در هنگام ورود، هم با استفاده از یک فایل پیکربندی و هم با استفاده از آرگومان خط فرمان '\&-c'\& مقداردهی می‌کند.\&
.PP
فایل پیکربندی از مسیر /etc/greetd/environments خوانده می‌شود و فهرستی از گزینه‌ها است که با خط جدید از هم جدا شده‌اند، و هر کدام نشان‌دهنده یک خط فرمان برای اجرا در هنگام ورود در صورت انتخاب شدن هستند.\&
.PP
.SH "نویسندگان (AUTHORS)"
.PP
نگهداری‌شده توسط Kenny Levinsen <contact@kl.\&wtf>.\& برای اطلاعات بیشتر پیرامون توسعه gtkgreet، به نشانی https://git.\&sr.\&ht/~kennylevinsen/gtkgreet مراجعه کنید.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
\fBgreetd\fR(1)