نام (NAME)

gtkgreet - یک خوش‌آمدگوی مبتنی بر Gtk برای greetd

خلاصه دستور (SYNOPSIS)

gtkgreet [options]

گزینه‌ها (OPTIONS)

-h, --help

نمایش پیام راهنما و خروج.

-c, --command <command>

مشخص کردن دستوری که در صورت ورود موفقیت‌آمیز اجرا شود. اگر دستوری مشخص نشود، gtkgreet سؤال خواهد کرد.

-l, --layer-shell

استفاده از wlr-layer-shell برای نمایش یک پنجره روی تمام خروجی‌ها. باید در زمان کامپایل فعال شده باشد.

-b, --background

مشخص کردن یک تصویر پس‌زمینه برای استفاده توسط gtkgreet. قالب‌های JPG و PNG به‌خوبی کار می‌کنند. تصویر در گوشه بالا-چپ مهار شده و هنگام مقیاس‌بندی DPI برابر با 1، با نسبت 1:1 رندر می‌شود.

نکته: این گزینه مقادیر مقیاس‌بندی غیر از 1 را به‌درستی مدیریت نمی‌کند. برای رندر انعطاف‌پذیرتر و صحیح‌تر تصویر پس‌زمینه از یک شیوه‌نامه (stylesheet) استفاده کنید.

-s, --style <file.css>

تعیین یک شیوه‌نامه سفارشی CSS حاوی استایل‌های اضافی برای پنجره gtkgreet. برای شرح زیرمجموعه CSS پشتیبانی‌شده در GTK، به نشانی https://developer.gnome.org/gtk3/stable/theming.html مراجعه کنید.

نکته: این گزینه قادر به بارگذاری شیوه‌نامه‌های تم Gtk نیست و صرفاً برای تغییرات در سطح برنامه است. برای انتخاب یک تم، از سازوکارهای معمول انتخاب تم Gtk استفاده کنید.

توضیحات (DESCRIPTION)

دستور gtkgreet یک خوش‌آمدگوی گرافیکی و مبتنی بر Gtk برای greetd(1) است.

دستور gtkgreet امکان انتخاب برنامه‌ای که هنگام ورود آغاز شود را فراهم می‌کند. برای اطلاعات بیشتر درباره نحوه پیکربندی گزینه‌های ارائه‌شده، بخش محیط‌ها (ENVIRONMENTS) را ببینید. کاربر همچنین می‌تواند با نوشتن خط فرمان مورد نظر خود، برنامه را مستقیماً هنگام ورود مشخص کند.

اجرای gtkgreet نیازمند یک کامپوزیتور Wayland مانند cage(1) یا sway(1) است.

راه‌اندازی (SETUP)

برای استفاده از gtkgreet، یک کامپوزیتور Wayland دلخواه را به عنوان خوش‌آمدگوی خود پیکربندی کنید. کامپوزیتور را طوری تنظیم کنید که gtkgreet را اجرا کند، و نکته مهم اینکه پس از خاتمه gtkgreet، کامپوزیتور نیز بسته شود.

با استفاده از cage، خط فرمان به‌سادگی به‌صورت "cage gtkgreet" درمی‌آید.

با استفاده از sway(1)، می‌توان از پیکربندی sway حاوی "exec 'gtkgreet; swaymsg exit'" و خط فرمانی مشابه "sway --config /etc/greetd/sway-config" استفاده کرد. مؤلفه "; swaymsg exit" مهم است، چرا که باعث می‌شود پس از نهایی شدن ورود توسط gtkgreet، کامپوزیتور sway خاتمه یابد.

برای اطلاعات درباره نحوه پیکربندی greetd، به greetd(5) مراجعه کنید. برای اطلاعات در مورد نحوه استفاده صحیح از کامپوزیتور انتخابی خود، مستندات آن را مطالعه کنید.

استایل‌دهی (STYLING)

از شیوه‌نامه می‌توان برای تغییر سبک و ظاهر عناصر gtkgreet، از جمله پس‌زمینه پنجره، فونت‌ها، کادر اعلان ورود و موارد دیگر استفاده کرد.

یک نمونه شیوه‌نامه را می‌توان در اینجا مشاهده کرد:

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;
}

محیط‌ها (ENVIRONMENTS)

دستور gtkgreet گزینه‌های کاربری برنامه‌ها را برای اجرا در هنگام ورود، هم با استفاده از یک فایل پیکربندی و هم با استفاده از آرگومان خط فرمان '-c' مقداردهی می‌کند.

فایل پیکربندی از مسیر /etc/greetd/environments خوانده می‌شود و فهرستی از گزینه‌ها است که با خط جدید از هم جدا شده‌اند، و هر کدام نشان‌دهنده یک خط فرمان برای اجرا در هنگام ورود در صورت انتخاب شدن هستند.

نویسندگان (AUTHORS)

نگهداری‌شده توسط Kenny Levinsen <contact@kl.wtf>. برای اطلاعات بیشتر پیرامون توسعه gtkgreet، به نشانی https://git.sr.ht/~kennylevinsen/gtkgreet مراجعه کنید.

همچنین ببینید (SEE ALSO)

greetd(1)