.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "ICEWM-TOOLBAR 5"
.TH ICEWM-TOOLBAR 5 2026-08-06 "icewm\ 4.1.0" "استانداردها، محیط‌ها و ماکروها"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
icewm\-toolbar \- پرونده پیکربندی نوار ابزار icewm
.SH "خلاصه ساختار (SYNOPSIS)"
.IX Subsection "SYNOPSIS"
.Vb 5
\& $ICEWM_PRIVCFG/toolbar
\& $XDG_CONFIG_HOME/icewm/toolbar
\& $HOME/.icewm/toolbar
\& /usr/etc/icewm/toolbar
\& /usr/share/icewm/toolbar
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Subsection "DESCRIPTION"
پرونده
.I toolbar
مسئول پیکربندی آیکون‌های راه‌اندازی سریع برنامه‌ها است که روی پانل
.BR icewm (1)
قرار می‌گیرند. این پرونده شامل نام برنامه‌های راه‌اندازی سریع همراه با آیکون‌های نوار وظیفه است. هر سطر غیرخالی و غیرتوضیحی با کلیدواژه
.B prog
آغاز می‌شود. پس از یک یا چند فاصله، نامی می‌آید که هنگام قرار گرفتن نشانگر موش بر روی آیکون نوار ابزار، در یک راهنمای متنی (tool tip) نمایش داده می‌شود. این نام می‌تواند یک رشته داخل گیومه دوتایی باشد. سپس نام ساده آیکون مورد استفاده بدون پسوند می‌آید. این آیکون در نوار ابزار نمایش داده خواهد شد. آخرین بخش، یک سطر دستور پوسته است که هر بار کاربر آیکون موجود در نوار ابزار را بفشارد اجرا خواهد شد. برای نمونه، سطر زیر در پرونده toolbar دکمه‌ای با راهنمای متنی
.nh
\f(CW\*(C`Mozilla Firefox\*(C'\fR
.hy
همراه با آیکون
.I firefox
ایجاد می‌کند که هنگام کلیک شدن،
.BR firefox (1)
را اجرا می‌نماید:
.PP
.Vb 1
\&    prog  "Mozilla Firefox"  firefox  /usr/bin/firefox \-\-private\-window
.Ve
.SH "قالب (FORMAT)"
.IX Subsection "FORMAT"
قالب پرونده شامل یکی از نحوهای سطری زیر است:
.Sp
.RS 4
\&\fBprog\fR \fB"\fR\fItitle\fR\fB"\fR \fIicon\fR \fIprogram\fR \fIoptions\fR
.RE
.PP
که در آن،
.IP \fBprog\fR 4
.IX Item "prog"
رشته تحت‌اللفظی
.BR prog .
.IP "\fB""\fR\fItitle\fR\fB""\fR" 4
.IX Item """title"""
عنوان مورد نوار ابزار، که به عنوان راهنمای متنی (tool-tip) دکمه برنامه ظاهر خواهد شد و در گیومه دوتایی
(\f(CW\*(C`"\*(C'\fR)
قرار می‌گیرد.
.IP \fIicon\fR 4
.IX Item "icon"
آیکونی که باید روی دکمه نوار ابزار نمایش داده شود. در صورتی که آیکونی ارائه نشود، می‌تواند به صورت یک خط تیره تک
(\f(CW\*(C`\-\*(C'\fR)
مشخص شود. هنگامی که هیچ آیکونی ارائه نشود، متن
.I title
به جای آیکون بر روی دکمه نمایش داده خواهد شد.
.IP \fIprogram\fR 4
.IX Item "program"
برنامه اجرایی (مسیر کامل یا نام فایل اجرایی) که هنگام فشرده شدن دکمه اجرا می‌شود.
.IP \fIoptions\fR 4
.IX Item "options"
گزینه‌ها و آرگومان‌هایی که به
.I program
پاس داده می‌شوند.
.PP
سطرهایی که با هش
(\f(CW\*(C`#\*(C'\fR)
شروع می‌شوند، سطرهای توضیحی هستند. سطرهای توضیحی و سطرهای خالی نادیده گرفته می‌شوند.
.PP
لطفاً توجه داشته باشید که تمام کلیدواژه‌های
.BR icewm\-menu (5)
نیز در اینجا مجاز هستند.
.SH "مثال‌ها (EXAMPLES)"
.IX Subsection "EXAMPLES"
در ادامه مثالی آورده شده است که تعدادی دکمه نوار ابزار را روی پانل
.BR icewm (1)
قرار می‌دهد:
.PP
.Vb 8
\&    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
.Ve
.SH "پرونده‌ها (FILES)"
.IX Subsection "FILES"
مکان‌های پرونده
.I toolbar
به شرح زیر است:
.PP
.Vb 5
\& $ICEWM_PRIVCFG/toolbar
\& $XDG_CONFIG_HOME/icewm/toolbar
\& $HOME/.icewm/toolbar
\& /usr/etc/icewm/toolbar
\& /usr/share/icewm/toolbar
.Ve
.PP
مکان‌ها به ترتیبی که فهرست شده‌اند جستجو می‌شوند؛ اولین پرونده یافت‌شده خوانده شده و باقی نادیده گرفته می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Subsection "SEE ALSO"
\&\fBicewm\fR\|(1),
\&\fBicewm\-programs\fR\|(5),
\&\fBicewm\-menu\fR\|(5),
\&\fBicewm\-menu\-fdo\fR\|(1).
.SH "نویسنده (AUTHOR)"
.IX Subsection "AUTHOR"
Brian Bidulock <mailto:bidulock@openss7.org>.
.SH "مجوز (LICENSE)"
.IX Subsection "LICENSE"
\&\fBIceWM\fR تحت مجوز GNU Library General Public License منتشر شده است.
پرونده
.I COPYING
را در توزیع ببینید.