STALONETRAY(1) User Commands STALONETRAY(1)

stalonetray - پیاده‌سازی سینی سیستم (ناحیه اعلان) مستقل (stand-alone). این مستند نسخه 1.5.0 از stalonetray را پوشش می‌دهد.


.HP 288u


stalonetray
[گزینه...]


.PP برنامه Stalonetray یک سینی سیستم (ناحیه اعلان) مستقل (stand-alone) برای سامانه پنجره X/X11 (مانند XOrg یا XFree86) است. این برنامه وابستگی‌های ساخت و زمان اجرای کمینه‌ای دارد: تنها یک کتابخانه X11. پشتیبانی کامل از XEMBED در دست توسعه است. Stalonetray تقریباً با هر مدیر پنجره سازگار با EWMH کار می‌کند.


.PP رفتار و ظاهر stalonetray را می‌توان هم از طریق گزینه‌های خط فرمان و هم از طریق فایل پیکربندی تنظیم کرد. طبق معمول، گزینه‌های خط فرمان بر گزینه‌های مشخص‌شده در فایل پیکربندی اولویت دارند.


.PP نام‌های پارامتر خط فرمان ممکن است دارای دو حالت باشند: کوتاه (-o) و بلند (--option). برای ارسال مقدار با استفاده از نام کوتاه یک پارامتر، -ovalue یا -o value را بنویسید؛ برای ارسال مقدار با استفاده از نام بلند، --option value یا --option=value را بنویسید. تمام پارامترهای پرچم‌گونه دارای یک مقدار بولی اختیاری هستند که در صورت حذف شدن، "true" فرض می‌شود. برای مقادیر بولی مثبت، "true" ،"yes" و "1" و برای مقادیر منفی، "false" ،"no" و "0" را بنویسید.


.PP فایل پیکربندی پیش‌فرض $HOME/.stalonetrayrc است. اگر این فایل یافت نشود، مسیر $XDG_CONFIG_HOME/stalonetrayrc بررسی می‌شود. فایل پیکربندی حاوی جفت‌های کلیدواژه-آرگومان غیرحساس به حروف کوچک و بزرگ است، یک جفت در هر خط. خطوطی که با '#' شروع می‌شوند و خطوط خالی نادیده گرفته می‌شوند. از طرف دیگر، فایل پیکربندی را می‌توان از طریق گزینه‌های خط فرمان -c یا --config نیز مشخص کرد.


.PP می‌توان stalonetray را به گونه‌ای پیکربندی کرد که پیام‌های گزارش عیب‌یابی را در جریان خطای استاندارد بنویسد.


.PP در زیر فهرستی از گزینه‌های ممکن خط فرمان/فایل پیکربندی آمده است. گزینه‌هایی که با خط پیوند شروع می‌شوند پارامترهای خط فرمان هستند و سایر موارد کلیدواژه‌های فایل پیکربندی می‌باشند. گزینه‌هایی که در نسخه 1.5.0 جدید هستند با "NEW in 1.5.0" علامت‌گذاری شده‌اند..SH "گزینه‌ها (OPTIONS)"

-bg color, --background color, background color

استفاده از color برای پس‌زمینهٔ سینی اعلان. color می‌تواند به صورت سه‌تایی هگزادسیمال HTML یا نامی از rgb.txt مشخص شود (توجه داشته باشید که '#' باید درون نقل‌قول قرار گیرد). مقدار پیش‌فرض: #777777.

-c filename, --config filename

خواندن پیکربندی از filename به جای پیش‌فرض $HOME/.stalonetrayrc.

-d decspec, --decorations decspec, decorations decspec

مشخص کردن تزیینات نمایان پنجرهٔ سینی اعلان. مقادیر ممکن برای decspec عبارتند از: all، title، border، none (پیش‌فرض).

-display display, display display

استفاده از نمایشگر X به نشانی display.

--dockapp-mode [mode], dockapp_mode [mode]

تنظیم حالت dockapp، که می‌تواند simple برای نمونه برای OpenBox، wmaker برای WindowMaker یا none (پیش‌فرض) باشد.

-f [level], --fuzzy-edges [level], fuzzy_edges [level]

فعال‌سازی لبه‌های محو (fuzzy) پنجرهٔ سینی اعلان و تنظیم سطح محوشدگی که می‌تواند در بازهٔ 0 (غیرفعال، پیش‌فرض) تا 3 باشد. در صورت ذکر نشدن، مقدار level به طور پیش‌فرض 2 است.

--geometry geometry_spec, geometry geometry_spec

تنظیم ابعاد و موقعیت (geometry) اولیهٔ سینی با geometry_spec، مشخص‌شده در قالب استاندارد نشانه‌گذاری X: widthxheight[+x[+y]]، که در آن عرض و ارتفاع بر حسب مضاربی از خانه‌های آیکون مشخص می‌شوند. مقدار پیش‌فرض: 1x1+0-0.

--grow-gravity gravity, grow_gravity gravity

مشخص کردن جهت‌گیری قرارگیری آیکون‌ها (یکی از N، S، W، E، NW، NE، SW، SE). جهت‌گیری گسترش، جهاتی را مشخص می‌کند که پنجرهٔ سینی اعلان ممکن است در آن‌ها رشد کند. برای نمونه، اگر NW را مشخص کنید، پنجرهٔ سینی به صورت عمودی به سمت پایین و به صورت افقی به سمت راست گسترش خواهد یافت (این‌ها جهت‌های مخالف گوشهٔ بالا-چپ یا شمال‌غربی پنجره هستند)؛ با W پنجرهٔ سینی به صورت افقی تنها به سمت چپ گسترش می‌یابد، و به صورت عمودی هم‌زمان رو به بالا و پایین رشد خواهد کرد تا موقعیت مرکز خود را حفظ کند. لطفاً توجه داشته باشید که رفتار اخیر در نسخهٔ 0.8 جدید است. مقدار پیش‌فرض: NW.

--icon-gravity gravity, icon_gravity gravity

مشخص کردن جهت‌گیری قرارگیری آیکون‌ها (یکی از NW، NE، SW، SE). اگر به عنوان نمونه SW را مشخص کنید، آیکون‌ها با شروع از گوشهٔ پایین-چپ پنجرهٔ سینی ظاهر خواهند شد. مقدار پیش‌فرض: NW.

-i n, --icon-size n, icon_size n

تنظیم اندازهٔ پیش‌فرض آیکون به n. مقدار پیش‌فرض: 24. حداقل: 16.

-h, --help

نمایش پیام راهنما.

ignore_classes classes

تنظیم نام‌های کلاس پنجره در X11 جهت نادیده گرفته شدن توسط stalonetray. نام‌های کلاس، آرگومان‌های جداگانه هستند: class1 class2 ....

--log-level level, log_level level

تنظیم میزان اطلاعات خروجی فرستاده‌شده توسط stalonetray به خروجی استاندارد. مقادیر ممکن برای level: err (پیش‌فرض)، info و trace. برای در دسترس بودن گزینهٔ trace، باید stalonetray در زمان ساخت با --enable-debug پیکربندی شده باشد.

--kludges kludge [,kludge...]

فعال‌سازی راه‌کارهای ترمیمی (kludges) خاص جهت سازگاری با مدیر پنجره‌های (WM) غیرمنطبق با استاندارد و/یا دور زدن باگ‌های stalonetray. آرگومان فهرستی جداشده با کاما از موارد زیر است:.sp
•fix_window_pos — تصحیح موقعیت پنجرهٔ سینی در صورت جابه‌جایی‌های نادرست توسط WM
•force_icons_size — نادیده گرفتن رویدادهای تغییر اندازه برای تمام آیکون‌ها؛ اجبار اندازهٔ آن‌ها به برابر بودن با icon_size
•use_icons_hints — استفاده از هینت‌های (hints) پنجرهٔ آیکون برای تعیین اندازهٔ آیکون
.sp


.RE


.PP --max-geometry geometry_spec, max_geometry geometry_spec


تنظیم حداکثر هندسهٔ سینی روی geometry_spec مقدار پیش‌فرض: 0x0، بدون محدودیت.


.RE


.PP -m n, --monitor n, monitor n


تنظیم مانیتور هدف روی n. مقدار پیش‌فرض: 0.


.RE


.PP --no-shrink, no_shrink [bool]


کوچک نکردن مجدد پنجرهٔ سینی پس از حذف آیکون. هنگام قرارگیری یا بلعیده شدن (swallow) سینی توسط پنجره‌ای دیگر مانند FvwmButtons مفید است. مقدار پیش‌فرض: false.


.RE


.PP -p, --parent-bg, parent_bg [bool]


استفاده از پنجرهٔ والد به عنوان پس‌زمینهٔ پنجرهٔ سینی. مقدار پیش‌فرض: false.


.RE


.PP --pixmap-bg path_to_xpm, pixmap_bg path_to_xpm


استفاده از پیکس‌مپ (pixmap) فایل XPM مشخص‌شده توسط path_to_xpm برای پس‌زمینهٔ پنجرهٔ سینی (پیکس‌مپ برای پر کردن کل پنجره کاشی‌کاری خواهد شد).


.RE


.PP -r name, --remote-click-icon name


کنترل/کلیک از راه دور. هنگامی که این گزینه مشخص شود، stalonetray یک کلیک ساختگی به آیکونی با نام پنجرهٔ name ارسال کرده و خارج می‌شود. آیکون در سینی فعال فعلی برای صفحهٔ نمایش جاری جستجو می‌شود. به‌طور پیش‌فرض، stalonetray یک تک‌کلیک با دکمهٔ ۱ ماوس به مرکز آیکون ارسال می‌کند. برای اطلاعات بیشتر دربارهٔ نحوهٔ تغییر مقادیر پیش‌فرض، گزینه‌های زیر را ببینید.


.RE


.PP --remote-click-button n


تنظیم شماره دکمه برای کلیک از راه دور به n (بر اساس ترتیب شماره‌گذاری X11).


.RE


.PP --remote-click-position xxy


موقعیت کلیک از راه دور را تنظیم می‌کند.


.RE


.PP --remote-click-type type


نوع کلیک از راه دور را تنظیم می‌کند. مقادیر ممکن: single و double.


.RE


.PP -s n, --slot-size w[xw], slot_size w[xw]


عرض خانهٔ شبکه را روی w و ارتفاع آن را روی b تنظیم می‌کند، که هیچ‌کدام نمی‌توانند کمتر از icon_size باشند. به‌طور پیش‌فرض، اندازهٔ خانه برابر با اندازهٔ آیکون است. در صورت عدم ذکر، ارتفاع برابر با عرض در نظر گرفته می‌شود.


.RE


.PP --scrollbars mode, scrollbars mode


تنظیم حالت نوار لغزش (scrollbar). مقادیر ممکن: vertical، horizontal، all، یا none (پیش‌فرض). نوارهای لغزش به صورت فضای اضافی در لبه‌های سینی ظاهر می‌شوند که با کلیک روی آن‌ها می‌توان ناحیهٔ آیکون‌ها را پیمایش کرد. چرخ ماوس نیز کار می‌کند.


.RE


.PP --scrollbars-highlight mode, scrollbars_highlight mode


تنظیم حالت برجسته‌سازی نوارهای لغزش. مقادیر ممکن: مشخصات یک رنگ (color spec)، یا disable.


.RE


.PP --scrollbars-size n, scrollbars_size n


تنظیم اندازهٔ نوار لغزش روی n پیکسل. به‌طور پیش‌فرض، اندازه ۱/۴ slot_size است.


.RE


.PP --scrollbars-step n, scrollbars_step n


تنظیم گام نوار لغزش روی n پیکسل. پیش‌فرض ۱/۲ slot_size است.


.RE


.PP --scroll-everywhere, scroll_everywhere [bool]


فعال‌سازی پیمایش در خارج از نوارهای لغزش نیز. مقدار پیش‌فرض: false.


.RE


.PP --drag-reorder [bool], drag_reorder [bool]


اجازه به بازآرایی آیکون‌ها با نگه داشتن کلید تبدیلِ کشیدن و کشیدن آن‌ها با دکمهٔ چپ ماوس. مقدار پیش‌فرض: true.


.RE


.PP --drag-modifier mod, drag_modifier mod


کلید تبدیل صفحه‌کلید که برای شروع کشیدن (drag) باید نگه داشته شود. مقادیر پذیرفته‌شده: alt، shift، ctrl، super، یا none. مقدار پیش‌فرض: alt. تنظیم این گزینه روی none به هر کشیدنی با Button1 اجازه می‌دهد که بازآرایی را شروع کند، که در این حالت یک کلیک نیز روی آیکون ارسال خواهد شد..RE


.PP --remember-icon-order [bool], remember_icon_order [bool]


ترتیب آیکون‌ها را در طول راه‌اندازی‌های مجدد سینی حفظ می‌کند. هنگام راه‌اندازی، هم‌گام با اتصال مجدد آیکون‌ها، ترتیب قبلی بازیابی می‌شود؛ برنامه‌هایی که دیگر در حال اجرا نیستند کنار گذاشته می‌شوند و آیکون‌هایی که پس از آن ظاهر می‌شوند از جهت‌گیری (gravity) سینی پیروی می‌کنند. این ترتیب بر اساس WM_CLASS کلیدگذاری می‌شود (شناسه‌های پنجره پس از یک راه‌اندازی مجدد پایدار نیستند)، و _NET_WM_PID چندین آیکون دارای کلاس یکسان را از هم متمایز می‌کند، و به نشست فعلی X وابسته است، بنابراین پس از راه‌اندازی مجدد کامل X نادیده گرفته می‌شود. مقدار پیش‌فرض: true.


.RE


.PP --icon-order-file path, icon_order_file path


مسیر فایل وضعیت ترتیب آیکون‌ها. مقدار پیش‌فرض: $XDG_STATE_HOME/stalonetray/order-screen (با بازگشت به ~/.local/state/stalonetray/).


.RE


.PP --icon-order-timeout n, icon_order_timeout n


مدت زمان انتظار به ثانیه در هنگام راه‌اندازی برای اتصال مجدد آیکون‌ها پیش از تثبیت ترتیب بازیابی‌شده. به محض بازگشت تمام آیکون‌های به‌خاطرسپرده‌شده، این انتظار زودتر به پایان می‌رسد. مقدار پیش‌فرض: 10.


.RE


.PP --skip-taskbar, skip_taskbar [bool]


پنهان کردن پنجره سینی از نوار وظیفه (taskbar). مقدار پیش‌فرض: false.


.RE


.PP --sticky, sticky [bool]


چسبان کردن پنجره سینی در میان چندین میزکار/صفحه (نمایش در تمام میزکارها). مقدار پیش‌فرض: false.


.RE


.PP --tint-color, tint_color [bool]


تنظیم رنگ ته‌رنگ (tinting). مقدار پیش‌فرض: white.


.RE


.PP --tint-level, tint_level [level]


تنظیم شدت ته‌رنگ (tinting). مقدار پیش‌فرض: 0 (ته‌رنگ غیرفعال است).


.RE


.PP -t, --transparent, transparent [bool]


فعال‌سازی شفافیت ریشه (root transparency). مقدار پیش‌فرض: false.


.RE


.PP -v, --vertical, vertical [bool]


استفاده از چیدمان عمودی برای آیکون‌ها (به‌طور پیش‌فرض چیدمان افقی استفاده می‌شود).


.RE


.PP --window-layer layer, window_layer layer


تنظیم لایه منطبق با استانداردهای EWMH برای پنجره سینی. مقادیر ممکن برای layer: bottom، normal، top. مقدار پیش‌فرض: normal.


.RE


.PP --window-strut mode, window_strut mode


فعال‌سازی حاشیه‌های رزرو شده پنجره (struts) برای پنجره سینی (جهت جلوگیری از پوشانده شدن پنجره سینی توسط پنجره‌های بیشینه‌شده). حالت مشخص می‌کند پنجره سینی به کدام لبه صفحه متصل خواهد شد. این مقدار می‌تواند top، bottom، left، right، none، یا auto (پیش‌فرض) باشد.


.RE


.PP --window-type type, window_type type


تنظیم نوع منطبق با استانداردهای EWMH برای پنجره سینی. مقادیر ممکن برای type: desktop، dock، normal، toolbar، utility. مقدار پیش‌فرض: dock.


.RE


.PP --xsync, xsync [bool]


اجرای همگام عملیات بر روی کارساز X (SLOW، به‌طور پیش‌فرض غیرفعال است).


.RE.SH "موارد منسوخ‌شده (DEPRECATIONS)"

از stalonetray 0.8 به بعد، پارامترهای خط فرمان و فایل پیکربندی زیر منسوخ شده‌اند:

--dbg-level, dbg_level

لطفاً به جای آن از --log-level استفاده کنید.

--max-tray-width, --max-tray-height, max_tray_width, max_tray_height

لطفاً به جای آن از --max-geometry استفاده کنید.

-w, --withdrawn, withdrawn

لطفاً به جای آن از --dockapp-mode استفاده کنید.

--respect-icon-hints, respect_icon_hints

لطفاً به جای آن از --kludges به همراه پارامتر use_icon_hints استفاده کنید.

$HOME/.stalonetrayrc — فایل پیکربندی پیش‌فرض.

قطعاً چندتایی وجود دارد.

اگر به پشتیبانی نیاز دارید، بهترین راه باز کردن یک issue در صفحه github[1] برنامه stalonetray یا ارسال مستقیم ایمیل به <busa_ru@users.sourceforge.net> است.

اگر باگی پیدا کرده‌اید، لطفاً تلاش کنید با تنظیم سطح گزارش روی trace و هدایت جریان خطای استاندارد به یک فایل، آن را بازتولید کنید. سپس آن فایل را به یک issue در github یا به ایمیل پیوست نمایید. اگر مشکل متناوب و گاه‌به‌گاه است، دو فایل لاگ پیوست کنید -- یکی با رفتار درست و دیگری با رفتار نادرست. اگر stalonetray را از مخزن بسته‌ها نصب کرده‌اید، می‌توانید باگ را در سیستم ردیابی باگ مربوط به همان توزیع نیز ثبت کنید..SH "نویسنده (AUTHOR)"

Roman Dubtsov

1.
صفحه گیت‌هاب
https://github.com/kolbusa/stalonetray
06/04/2026 stalonetray 1.5.0