ICEWM-TOOLBAR(5) استانداردها، محیط‌ها و ماکروها ICEWM-TOOLBAR(5)

icewm-toolbar - پرونده پیکربندی نوار ابزار icewm

$ICEWM_PRIVCFG/toolbar
$XDG_CONFIG_HOME/icewm/toolbar
$HOME/.icewm/toolbar
/usr/etc/icewm/toolbar
/usr/share/icewm/toolbar

پرونده toolbar مسئول پیکربندی آیکون‌های راه‌اندازی سریع برنامه‌ها است که روی پانل icewm(1) قرار می‌گیرند. این پرونده شامل نام برنامه‌های راه‌اندازی سریع همراه با آیکون‌های نوار وظیفه است. هر سطر غیرخالی و غیرتوضیحی با کلیدواژه prog آغاز می‌شود. پس از یک یا چند فاصله، نامی می‌آید که هنگام قرار گرفتن نشانگر موش بر روی آیکون نوار ابزار، در یک راهنمای متنی (tool tip) نمایش داده می‌شود. این نام می‌تواند یک رشته داخل گیومه دوتایی باشد. سپس نام ساده آیکون مورد استفاده بدون پسوند می‌آید. این آیکون در نوار ابزار نمایش داده خواهد شد. آخرین بخش، یک سطر دستور پوسته است که هر بار کاربر آیکون موجود در نوار ابزار را بفشارد اجرا خواهد شد. برای نمونه، سطر زیر در پرونده toolbar دکمه‌ای با راهنمای متنی "Mozilla Firefox" همراه با آیکون firefox ایجاد می‌کند که هنگام کلیک شدن، firefox(1) را اجرا می‌نماید:

prog  "Mozilla Firefox"  firefox  /usr/bin/firefox --private-window

قالب پرونده شامل یکی از نحوهای سطری زیر است:

prog "title" icon program options

که در آن،

رشته تحت‌اللفظی prog.
"title"
عنوان مورد نوار ابزار، که به عنوان راهنمای متنی (tool-tip) دکمه برنامه ظاهر خواهد شد و در گیومه دوتایی (""") قرار می‌گیرد.
آیکونی که باید روی دکمه نوار ابزار نمایش داده شود. در صورتی که آیکونی ارائه نشود، می‌تواند به صورت یک خط تیره تک ("-") مشخص شود. هنگامی که هیچ آیکونی ارائه نشود، متن title به جای آیکون بر روی دکمه نمایش داده خواهد شد.
برنامه اجرایی (مسیر کامل یا نام فایل اجرایی) که هنگام فشرده شدن دکمه اجرا می‌شود.
گزینه‌ها و آرگومان‌هایی که به program پاس داده می‌شوند.

سطرهایی که با هش ("#") شروع می‌شوند، سطرهای توضیحی هستند. سطرهای توضیحی و سطرهای خالی نادیده گرفته می‌شوند.

لطفاً توجه داشته باشید که تمام کلیدواژه‌های icewm-menu(5) نیز در اینجا مجاز هستند.

در ادامه مثالی آورده شده است که تعدادی دکمه نوار ابزار را روی پانل icewm(1) قرار می‌دهد:

prog "File Manager" file-manager.png pcmanfm
prog "Web Browser" web-browser.png /usr/lib/firefox/firefox
prog "Terminal" terminal.png roxterm
prog "Graphical Editor" text-editor.png gvim -f
prog "Calculator" accessories-calculator.png calculator
prog "Run Command" gtk-execute.png xde-run
prog "Network" gtk-network.png pcmanfm ~/Network
prog "Logout" system-log-out.png xde-logout

مکان‌های پرونده toolbar به شرح زیر است:

$ICEWM_PRIVCFG/toolbar
$XDG_CONFIG_HOME/icewm/toolbar
$HOME/.icewm/toolbar
/usr/etc/icewm/toolbar
/usr/share/icewm/toolbar

مکان‌ها به ترتیبی که فهرست شده‌اند جستجو می‌شوند؛ اولین پرونده یافت‌شده خوانده شده و باقی نادیده گرفته می‌شوند.

icewm(1), icewm-programs(5), icewm-menu(5), icewm-menu-fdo(1).

Brian Bidulock <mailto:bidulock@openss7.org>.

IceWM تحت مجوز GNU Library General Public License منتشر شده است. پرونده COPYING را در توزیع ببینید.

2026-08-06 icewm 4.1.0