.\"
.\" budgie-session manual page.
.\" (C) 2000 Miguel de Icaza (miguel@helixcode.com)
.\" (C) 2009-2010 Vincent Untz (vuntz@gnome.org)
.\" (C) 2019 Benjamin Berg (bberg@redhat.com)
.\" (C) 2020 Sebastian Geiger (sbastig@gmx.net)
.\" (C) 2023 BuddiesOfBudgie
.\"
.TH budgie-session 1 "Oct 2023" "BUDGIE"
.SH "نام (NAME)"
budgie-session \- مدیریت نشست محیط رومیزی Budgie
.SH "خلاصه دستور (SYNOPSIS)"
.B budgie-session [\-a|\-\-autostart=DIR] [\-\-session=SESSION] [\-\-failsafe|\-f] [\-\-debug] [\-\-whale]
.SH "توضیحات (DESCRIPTION)"
برنامه
\fIbudgie-session\fP
محیط رومیزی budgie را راه‌اندازی می‌کند. این دستور معمولاً توسط مدیر ورود شما
(مانند gdm، xdm یا از طریق اسکریپت‌های راه‌اندازی X) اجرا می‌شود. این برنامه نشست
ذخیره‌شده شما یا نصب پیش‌فرض budgie را بر روی سیستمتان بارگذاری خواهد کرد. توجه داشته باشید
که
\fIbudgie-session\fP
یک اسکریپت واسط (wrapper) برای
\fIbudgie-session-binary\fP
است.
.PP
\fB$XDG_CONFIG_HOME/budgie-session/sessions\fP،
\fB$XDG_CONFIG_DIRS/budgie-session/sessions\fP
و
\fB$XDG_DATA_DIRS/budgie-session/sessions\fP.
.PP
هنگام ذخیره یک نشست،
\fIbudgie-session\fP
برنامه‌های در حال اجرا را در دایرکتوری
\fB$XDG_CONFIG_HOME/budgie-session/saved-session\fP
ذخیره می‌کند. ذخیره‌سازی نشست‌ها تنها با روش راه‌اندازی قدیمی غیر-systemd پشتیبانی می‌شود.
.PP
برنامه
\fIbudgie-session\fP
یک مدیر نشست X11R6 است. این برنامه می‌تواند برنامه‌های کاربردی budgie و همچنین هر برنامه سازگار با SM در X11R6 را مدیریت کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
.I "--autostart=DIR"
دایرکتوری
\fBDIR\fP
که باید برای فایل‌های .desktop شروع خودکار (autostart) جستجو شود. از این گزینه می‌توان چندین بار استفاده کرد.
در صورت وجود این گزینه، دایرکتوری‌های پیش‌فرض شروع خودکار جستجو نخواهند شد.
.TP
.I "--session=SESSION"
استفاده از برنامه‌های تعریف‌شده در
\fBSESSION.session\fP.
در صورت مشخص نشدن، از
\fBbudgie.session\fP
استفاده خواهد شد.
.TP
.I "--builtin"
استفاده از روش قدیمی غیر-systemd برای مدیریت نشست کاربر.
.TP
.I "--failsafe"
اجرا در حالت امن (fail-safe). برنامه‌های مشخص‌شده توسط کاربر راه‌اندازی نخواهند شد.
.TP
.I "--debug"
فعال‌سازی کدهای اشکال‌زدایی (debugging).
.TP
.I "--whale"
نمایش نهنگ خطا (fail whale) در یک کادر محاوره‌ای جهت اشکال‌زدایی آن.
.SH "تعریف نشست (SESSION DEFINITION)"
نشست‌ها در فایل‌های
\fB.session\fP
تعریف می‌شوند که از فرمتی شبیه به .desktop استفاده می‌کنند، با کلیدهای زیر در گروه
\fBbudgie Session\fP:
.TP
.I Name
نام نشست. این مقدار می‌تواند بومی‌سازی شود.
.TP
.I RequiredComponents
فهرستی از شناسه‌های مؤلفه‌ها (فایل‌های desktop) که توسط نشست مورد نیاز هستند. مؤلفه‌های مورد نیاز همیشه در نشست اجرا خواهند شد.
.PP
در اینجا یک مثال از تعریف نشست آورده شده است:
.PP
.in +4n
.nf
[budgie Session]
Name=budgie
RequiredComponents=budgie-desktop;gnome-settings-daemon;
.in
.fi
.PP
فایل‌های
\fB.session\fP
در مسیرهای زیر جستجو می‌شوند:
\fB$XDG_CONFIG_HOME/budgie-session/sessions\fP،
\fB$XDG_CONFIG_DIRS/budgie-session/sessions\fP
و
\fB$XDG_DATA_DIRS/budgie-session/sessions\fP.
.PP
اگر سفارشی‌سازی نشست مورد نیاز باشد، بهتر است از
\fI--builtin\fP
استفاده شود. این امر به دلیل نحوه تعریف مؤلفه‌هایی است که budgie در حال حاضر برای اجرا در هر نوع نشست مشخص می‌کند.
.SH "محیط (ENVIRONMENT)"
برنامه
\fIbudgie-session\fP
چندین متغیر محیطی را برای استفاده فرآیندهای فرزند خود تنظیم می‌کند:
.PP
.B SESSION_MANAGER
.IP
این متغیر توسط کلاینت‌های آگاه از مدیر نشست (session-manager) برای برقراری ارتباط با
budgie-session
استفاده می‌شود.
.PP
.B DISPLAY
.IP
این متغیر با نمایشگر X مورد استفاده توسط
\fIbudgie-session\fP
تنظیم می‌شود. توجه داشته باشید که در صورت استفاده از گزینه
\fI--display\fP
ممکن است این مقدار با تنظیمات متغیر محیطی هنگام فراخوانی budgie-session متفاوت باشد.
.PP
رفتار خود
\fIbudgie-session\fP
می‌تواند از طریق متغیر محیطی زیر تغییر یابد:
.PP
.B GNOME_SESSION_AUTOSTART_DIR
.IP
این متغیر فهرستی از دایرکتوری‌ها را برای جستجوی فایل‌های شروع خودکار مشخص می‌کند. این متغیر بر تمامی دایرکتوری‌های مشخص‌شده از طریق گزینه
\fI--autostart\fP
و همچنین همه دایرکتوری‌های پیش‌فرض شروع خودکار اولویت دارد.
.SH "فایل‌ها (FILES)"
.PP
.B $XDG_CONFIG_HOME/autostart
.B $XDG_CONFIG_DIRS/autostart
.B /usr/share/gnome/autostart
.IP
برنامه‌های تعریف‌شده از طریق فایل‌های .desktop در این دایرکتوری‌ها هنگام ورود به سیستم اجرا خواهند شد.
.PP
.B $XDG_CONFIG_HOME/budgie-session/sessions
.B $XDG_CONFIG_DIRS/budgie-session/sessions
.B $XDG_DATA_DIRS/budgie-session/sessions
.IP
این دایرکتوری‌ها حاوی فایل‌های
\fB.session\fP
هستند که می‌توانند با گزینه
\fI--session\fP
استفاده شوند.
.PP
.B $XDG_CONFIG_HOME/budgie-session/saved-session
.IP
این دایرکتوری شامل فهرست برنامه‌های کاربردی نشست ذخیره‌شده است.
.SH "اشکالات (BUGS)"
اگر اشکالی در برنامه
\fIbudgie-session\fP
پیدا کردید، لطفاً آن را در
https://github.com/buddiesofbudgie/budgie-session/issues
گزارش کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR budgie-session-quit (1)