.TH TINT2 1 "2021\-12\-04" 17.0.2 .SH "نام (NAME)" .PP tint2 \- پنل/نوار وظیفه سبک .SH "توضیحات (DESCRIPTION)" .PP برنامه tint2 یک پنل/نوار وظیفه ساده است که برای مدیر پنجره‌های مدرن X طراحی شده است. این ابزار به طور خاص برای Openbox ساخته شده، اما باید با سایر مدیر پنجره‌ها (مانند GNOME، KDE، XFCE و غیره) نیز به خوبی کار کند. .PP ویژگی‌ها: .RS .IP \(bu 2 پنل به همراه نوار وظیفه، سینی سیستم (system tray)، ساعت و آیکون‌های راه‌انداز (launcher)؛ .IP \(bu 2 سفارشی‌سازی آسان: رنگ و شفافیت در قلم‌ها، آیکون‌ها، حاشیه‌ها و پس‌زمینه‌ها؛ .IP \(bu 2 قابلیتی مشابه پیجر (Pager): جابه‌جایی برنامه‌ها میان فضاهای کاری (میزکارهای مجازی)، تغییر فضای کاری جاری؛ .IP \(bu 2 پشتیبانی از چند نمایشگر: ایجاد یک پنل به ازای هر نمایشگر، با نمایش وظایف مختص به همان نمایشگر؛ .IP \(bu 2 رویدادهای ماوس با قابلیت شخصی‌سازی کامل. .RE .PP اهداف: .RS .IP \(bu 2 کم‌مزاحمت و سبک بودن (از نظر مصرف حافظه، پردازنده و جلوه بصری)؛ .IP \(bu 2 پیروی از استانداردهای freedesktop.org؛ .IP \(bu 2 تسهیل استفاده از جریان‌های کاری خاص، از قبیل پیکربندی‌های چند میزه و چند نمایشگره. .RE .SH "خلاصه دستور (SYNOPSIS)" .PP \fB\fCtint2 [OPTION...]\fR .SH "گزینه‌ها (OPTIONS)" .TP \fB\fC\-c path_to_config_file\fR مشخص می‌کند که به جای فایل پیکربندی پیش‌فرض، از چه فایلی استفاده شود. .TP \fB\fC\-v, \-\-version\fR اطلاعات نسخه برنامه را نمایش داده و خارج می‌شود. .TP \fB\fC\-h, \-\-help\fR این راهنما را نمایش داده و خارج می‌شود. .SH "پیکربندی (CONFIGURATION)" .SS فهرست مطالب .RS .IP \(bu 2 مقدمه \[la]#introduction\[ra] .IP \(bu 2 پس‌زمینه‌ها و حاشیه‌ها \[la]#backgrounds-and-borders\[ra] .IP \(bu 2 گرادیان‌ها \[la]#gradients\[ra] .IP \(bu 2 پنل \[la]#panel\[ra] .IP \(bu 2 راه‌انداز \[la]#launcher\[ra] .IP \(bu 2 نوار وظیفه/پیجر \[la]#taskbar-pager\[ra] .IP \(bu 2 دکمه‌های نوار وظیفه \[la]#taskbar-buttons\[ra] .IP \(bu 2 کنش‌های ماوس برای دکمه‌های نوار وظیفه \[la]#mouse-actions-for-taskbar-buttons\[ra] .IP \(bu 2 سینی سیستم \[la]#system-tray\[ra] .IP \(bu 2 ساعت \[la]#clock\[ra] .IP \(bu 2 راهنمای ابزار (Tooltip) \[la]#tooltip\[ra] .IP \(bu 2 باتری \[la]#battery\[ra] .IP \(bu 2 اجراکننده (Executor) \[la]#executor\[ra] .IP \(bu 2 دکمه \[la]#button\[ra] .IP \(bu 2 جداکننده \[la]#separator\[ra] .IP \(bu 2 نمونه پیکربندی \[la]#example-configuration\[ra] .RE.SS "مقدمه (Introduction)" .PP این دستورالعمل‌ها برای پیکربندی مستقیم tint2 از طریق ویرایش فایل پیکربندی آن هستند. همچنین می‌توانید در عوض از رابط گرافیکی \fB\fCtint2conf\fR\& استفاده کنید. .PP نخستین باری که tint2 را اجرا می‌کنید، فایل پیکربندی در مسیر \fB\fC$HOME/.config/tint2/tint2rc\fR ایجاد خواهد شد (این موضوع در صورتی صدق می‌کند که یک نصب تمیز انجام داده باشید. اجرای tint2 در پوشه کد منبع بدون اجرای 'make install' فایل پیکربندی را ایجاد نخواهد کرد). .PP همچنین می‌توانید با گزینه \-c فایل دیگری را در خط فرمان مشخص کنید، مانند: \fB\fCtint2 \-c $HOME/tint2.conf\fR\&. این کار می‌تواند برای اجرای چند نمونه از tint2 که از تنظیمات متفاوتی استفاده می‌کنند به کار رود. .PP اگر فایل پیکربندی را در حین اجرای tint2 تغییر دهید، دستور \fB\fCkillall \-SIGUSR1 tint2\fR برنامه tint2 را وادار به بارگذاری مجدد آن خواهد کرد. .PP تمام گزینه‌های پیکربندی پشتیبانی‌شده در فایل پیکربندی در زیر فهرست شده‌اند. سعی کنید تا جای ممکن ترتیب گزینه‌ها را به همان صورتی که در زیر آمده است رعایت کنید. .SS "پس‌زمینه‌ها و حاشیه‌ها (Backgrounds and borders)" .PP فایل پیکربندی tint2 با گزینه‌هایی شروع می‌شود که عناصر پس‌زمینه را همراه با حاشیه‌ها تعریف می‌کنند: .RS .IP \(bu 2 \fB\fCrounded = number_of_pixels\fR : شعاع گردی گوشه‌ها .IP \(bu 2 \fB\fCborder_width = integer\fR : پهنای حاشیه بر حسب پیکسل .IP \(bu 2 \fB\fCborder_sides = LRTB\fR : جهت‌هایی که حاشیه در آن‌ها رسم می‌شود (چپ، راست، بالا، پایین). در صورت عدم تعیین، از تمام جهت‌ها استفاده می‌شود. \fI(از 0.12.12)\fP .IP \(bu 2 \fB\fCbackground_color = color opacity\fR .RS .IP \(bu 2 \fB\fCcolor\fR به صورت RGB در مبنای شانزده مشخص می‌شود، مثلاً #ff0000 قرمز است .IP \(bu 2 \fB\fCopacity\fR بین (0 تا 100) متغیر است، که در آن 0 کاملاً شفاف و 100 کاملاً کدر است. توجه داشته باشید که برای داشتن یک پنل شفاف، باید یک کامپوزیتور میزکار (مانند compton یا compiz) را فعال کنید. .RE .IP \(bu 2 \fB\fCborder_color = color opacity\fR .RS .IP \(bu 2 \fB\fCcolor\fR به صورت RGB در مبنای شانزده مشخص می‌شود، مثلاً #ff0000 قرمز است .IP \(bu 2 \fB\fCopacity\fR بین (0 تا 100) متغیر است، که در آن 0 کاملاً شفاف و 100 کاملاً کدر است .RE .IP \(bu 2 \fB\fCbackground_color_hover = color opacity\fR (پیش‌فرض: همانند \fB\fCbackground_color\fR) \fI(از 0.12.3)\fP .RS .IP \(bu 2 \fB\fCcolor\fR به صورت RGB در مبنای شانزده مشخص می‌شود، مثلاً #ff0000 قرمز است .IP \(bu 2 \fB\fCopacity\fR بین (0 تا 100) متغیر است، که در آن 0 کاملاً شفاف و 100 کاملاً کدر است. توجه داشته باشید که برای داشتن یک پنل شفاف، باید یک کامپوزیتور میزکار (مانند compton یا compiz) را فعال کنید .RE .IP \(bu 2 \fB\fCborder_color_hover = color opacity\fR (پیش‌فرض: همانند \fB\fCborder_color\fR) \fI(از 0.12.3)\fP .RS .IP \(bu 2 \fB\fCcolor\fR به صورت RGB در مبنای شانزده مشخص می‌شود، مثلاً #ff0000 قرمز است .IP \(bu 2 \fB\fCopacity\fR بین (0 تا 100) متغیر است، که در آن 0 کاملاً شفاف و 100 کاملاً کدر است .RE .IP \(bu 2 \fB\fCbackground_color_pressed = color opacity\fR (پیش‌فرض: همانند \fB\fCbackground_color_hover\fR) \fI(از 0.12.3)\fP .RS .IP \(bu 2 \fB\fCcolor\fR به صورت RGB در مبنای شانزده مشخص می‌شود، مثلاً #ff0000 قرمز است .IP \(bu 2 \fB\fCopacity\fR بین (0 تا 100) متغیر است، که در آن 0 کاملاً شفاف و 100 کاملاً کدر است. توجه داشته باشید که برای داشتن یک پنل شفاف، باید یک کامپوزیتور میزکار (مانند compton یا compiz) را فعال کنید .RE .IP \(bu 2 \fB\fCborder_color_pressed = color opacity\fR (پیش‌فرض: همانند \fB\fCborder_color_hover\fR) \fI(از 0.12.3)\fP .RS .IP \(bu 2 \fB\fCcolor\fR به صورت RGB در مبنای شانزده مشخص می‌شود، مثلاً #ff0000 قرمز است .IP \(bu 2 \fB\fCopacity\fR بین (0 تا 100) متغیر است، که در آن 0 کاملاً شفاف و 100 کاملاً کدر است .RE .IP \(bu 2 \fB\fCborder_content_tint_weight = integer\fR : رنگ حاشیه را با رنگ محتوا ترکیب می‌کند (برای وظایف، این مقدار میانگین رنگ آیکون پنجره است). مقادیر باید بین 0 (بدون ترکیب) و 100 (جایگزینی کامل رنگ) باشند. \fI(از 16.0)\fP .IP \(bu 2 \fB\fCbackground_content_tint_weight = integer\fR : رنگ پس‌زمینه را با رنگ محتوا ترکیب می‌کند (برای وظایف، این مقدار میانگین رنگ آیکون پنجره است). مقادیر باید بین 0 (بدون ترکیب) و 100 (جایگزینی کامل رنگ) باشند. \fI(از 16.0)\fP .RE .PP می‌توانید هر تعداد پس‌زمینه که می‌خواهید تعریف کنید. به عنوان مثال، پیکربندی زیر دو پس‌زمینه را تعریف می‌کند: .PP .RS .nf rounded = 1 border_width = 0 background_color = #282828 100 border_color = #000000 0 rounded = 1 border_width = 0 background_color = #f6b655 90 border_color = #cccccc 40 .fi .RE .PP برنامه tint2 به طور خودکار هر پس‌زمینه را با عددی که از 1 شروع می‌شود (1، 2، ...) شناسایی می‌کند. پس از آن، می‌توانید با استفاده از شناسه پس‌زمینه، یک پس‌زمینه را به اشیاء (panel، taskbar، task، clock، systray) اعمال کنید، برای مثال: .PP .RS .nf panel_background_id = 1 taskbar_background_id = 0 task_background_id = 0 task_active_background_id = 2 systray_background_id = 0 clock_background_id = 0 .fi .RE .PP شناسه 0 به یک پس‌زمینه خاص اشاره دارد که کاملاً شفاف است، شناسه 1 اولین پس‌زمینه تعریف‌شده در فایل پیکربندی را اعمال می‌کند و به همین ترتیب..SS گرادیان‌ها .PP (موجود از نسخه 0.13.0) .PP پس‌زمینه‌ها همچنین امکان تعیین لایه‌های گرادیان را فراهم می‌کنند که روی پس‌زمینهٔ تک‌رنگ رسم می‌شوند. .PP ابتدا کاربر باید یک یا چند گرادیان را در فایل پیکربندی تعریف کند، که هر کدام با \fB\fCgradient = TYPE\fR\& آغاز می‌شوند. این موارد باید پیش از پس‌زمینه‌ها اضافه شوند. .PP سپس می‌توان گرادیان‌ها را با استفاده از اندیس به پس‌زمینه‌ها اضافه کرد؛ با به‌کارگیری \fB\fCgradient_id = INDEX\fR، \fB\fCgradient_id_hover = INDEX\fR و \fB\fCgradient_id_pressed = INDEX\fR، که در آن \fB\fCINDEX\fR اندیس گرادیان است و از 1 شروع می‌شود. .SS انواع گرادیان .PP گرادیان‌ها رنگ را میان نقاط کنترلی ثابت تغییر می‌دهند: * گرادیان‌های عمودی: بالا به پایین؛ * گرادیان‌های افقی: چپ به راست؛ * گرادیان‌های شعاعی: مرکز به گوشه‌ها. .PP کاربر باید رنگ‌های آغازین و پایانی را مشخص کند، و می‌تواند به‌صورت اختیاری با استفاده از گزینهٔ \fB\fCcolor_stop\fR، همان‌طور که در ادامه توضیح داده شده است، نقاط توقف رنگ بیشتری را در این میان اضافه کند. .SS گرادیان عمودی، با تغییر رنگ از لبهٔ بالایی به لبهٔ پایینی، دو رنگ .PP .RS .nf gradient = vertical start_color = #rrggbb opacity end_color = #rrggbb opacity .fi .RE .SS گرادیان افقی، با تغییر رنگ از لبهٔ چپ به لبهٔ راست، دو رنگ .PP .RS .nf gradient = horizontal start_color = #rrggbb opacity end_color = #rrggbb opacity .fi .RE .SS گرادیان شعاعی، با تغییر رنگ از مرکز به گوشه، دو رنگ: .PP .RS .nf gradient = radial start_color = #rrggbb opacity end_color = #rrggbb opacity .fi .RE .SS افزودن نقاط توقف رنگ اضافی (0% و 100% ثابت می‌مانند، رنگ‌های بیشتر در x% بین نقاط کنترلی آغاز و پایان) .PP .RS .nf color_stop = percentage #rrggbb opacity .fi .RE .SS مثال‌های گرادیان .PP .RS .nf # Gradient 1: thin film effect gradient = horizontal start_color = #111122 30 end_color = #112211 30 color_stop = 60 #221111 30 # Gradient 2: radial glow gradient = radial start_color = #ffffff 20 end_color = #ffffff 0 # Gradient 3: elegant black gradient = vertical start_color = #444444 100 end_color = #222222 100 # Gradient 4: elegant black gradient = horizontal start_color = #111111 100 end_color = #222222 100 # Background 1: Active desktop name rounded = 2 border_width = 1 border_sides = TBLR background_color = #555555 10 border_color = #ffffff 60 background_color_hover = #555555 10 border_color_hover = #ffffff 60 background_color_pressed = #555555 10 border_color_pressed = #ffffff 60 gradient_id = 3 gradient_id_hover = 4 gradient_id_pressed = 2 [...] .fi .RE.SS "پنل (Panel)" .RS .IP \(bu 2 \fB\fCpanel_items = LTSBC\fR مواردی را که tint2 نمایش می‌دهد و ترتیب آن‌ها را مشخص می‌کند. هر حرف به یک مورد اشاره دارد که به شرح زیر تعریف می‌شود: .RS .IP \(bu 2 \fB\fCL\fR راه‌انداز برنامه‌ها (Launcher) را نمایش می‌دهد .IP \(bu 2 \fB\fCT\fR نوار وظیفه (Taskbar) را نمایش می‌دهد .IP \(bu 2 \fB\fCS\fR سینی سیستم (Systray، با عنوان ناحیه اعلان نیز شناخته می‌شود) را نمایش می‌دهد .IP \(bu 2 \fB\fCB\fR وضعیت باتری را نمایش می‌دهد .IP \(bu 2 \fB\fCC\fR ساعت را نمایش می‌دهد .IP \(bu 2 \fB\fCF\fR یک فاصله‌انداز گسترش‌پذیر (freespace) اضافه می‌کند. می‌توانید بیش از یک مورد را مشخص کنید. اگر \fB\fCT\fR نیز وجود داشته باشد هیچ تأثیری ندارد. \fI(از نگارش 0.12)\fP .IP \(bu 2 \fB\fCE\fR یک افزونه اجراکننده (executor) اضافه می‌کند. می‌توانید بیش از یک مورد را مشخص کنید. \fI(از نگارش 0.12.4)\fP .IP \(bu 2 \fB\fCP\fR یک دکمه فشاری اضافه می‌کند. می‌توانید بیش از یک مورد را مشخص کنید. \fI(از نگارش 0.14)\fP .IP \(bu 2 \fB\fC:\fR یک جداکننده اضافه می‌کند. می‌توانید بیش از یک مورد را مشخص کنید. \fI(از نگارش 0.13.0)\fP .RE .PP برای مثال، \fB\fCpanel_items = STC\fR سینی سیستم، نوار وظیفه و ساعت را (از چپ به راست) نمایش می‌دهد. .IP \(bu 2 \fB\fCpanel_monitor = monitor (all or primary or 1 or 2 or ...)\fR : نمایشگری که tint2 پنل را روی آن رسم می‌کند .RS .IP \(bu 2 نخستین نمایشگر \fB\fC1\fR است .IP \(bu 2 برای داشتن یک پنل مجزا به ازای هر نمایشگر، از \fB\fCpanel_monitor = all\fR استفاده کنید .RE .IP \(bu 2 \fB\fCprimary_monitor_first = boolean (0 or 1)\fR : قرار دادن نمایشگر اصلی قبل از تمام نمایشگرهای دیگر در فهرست. \fI(از نگارش 0.12.4؛ در 1.0 حذف شد، به جای آن از \fB\fCprimary\fR استفاده کنید)\fP .RE .PP [](images/panel_padding.jpg) .RS .IP \(bu 2 \fB\fCpanel_position = vertical_position horizontal_position orientation\fR .RS .IP \(bu 2 \fB\fCvertical_position\fR یکی از این موارد است: \fB\fCbottom\fR، \fB\fCtop\fR، \fB\fCcenter\fR .IP \(bu 2 \fB\fChorizontal_position\fR یکی از این موارد است: \fB\fCleft\fR، \fB\fCright\fR، \fB\fCcenter\fR .IP \(bu 2 \fB\fCorientation\fR یکی از این موارد است: \fB\fChorizontal\fR، \fB\fCvertical\fR .RE .IP \(bu 2 \fB\fCpanel_size = width height\fR .RS .IP \(bu 2 \fB\fCwidth\fR و \fB\fCheight\fR می‌توانند بدون واحد (مانند \fB\fC123\fR) به عنوان پیکسل، یا همراه با \fB\fC%\fR به عنوان درصدی از اندازه نمایشگر (مانند \fB\fC50%\fR) مشخص شوند. برای عرض/ارتفاع کامل نمایشگر از \fB\fC100%\fR استفاده کنید. مثال: .RE .IP \(bu 2 \fB\fCscale_relative_to_dpi = integer\fR : در صورت تنظیم روی یک مقدار غیرصفر، مقیاس‌بندی HiDPI فعال می‌شود. هر پنل روی یک نمایشگر متفاوت قابل مشاهده است؛ بنابراین هر پنل ضریب مقیاس‌بندی مشخصی دارد. این ضریب مقیاس‌بندی به عنوان نسبت بین DPI نمایشگر (به‌دست‌آمده از ابعاد بر حسب پیکسل و میلی‌متر از RandR) و یک DPI مرجع پیکربندی‌شده محاسبه می‌شود \- این همان DPI است که پیکربندی‌های موجود کاربر با آن عادی به نظر می‌رسیدند، جهت سازگاری با گذشته. .IP \(bu 2 \fB\fCscale_relative_to_screen_height = integer\fR : مشابه \fB\fCscale_relative_to_dpi\fR است، با این تفاوت که ضریب مقیاس‌بندی به صورت نسبت بین ارتفاع نمایشگر و \fB\fCscale_relative_to_screen_height\fR محاسبه می‌شود\&. این اثر با \fB\fCscale_relative_to_dpi\fR تجمعی است، یعنی اگر هر دو گزینه وجود داشته باشند، ضرایب در یکدیگر ضرب می‌شوند. .RE .PP .RS .nf # عرض پنل 94% اندازه نمایشگر و ارتفاع آن 30 پیکسل است: panel_size = 94% 30 .fi .RE .RS .IP \(bu 2 \fB\fCpanel_shrink = boolean (0 or 1)\fR : اگر روی 1 تنظیم شود، پنل به صورت پویا به اندازه‌ای جمع‌وجور کوچک می‌شود. \fI(از نگارش 0.13)\fP .IP \(bu 2 \fB\fCpanel_margin = horizontal_margin vertical_margin\fR : حاشیه‌ها فاصله بین پنل و لبه افقی/عمودی نمایشگر را مشخص می‌کنند. برای داشتن پنلی هم‌اندازه با لبه نمایشگر (بدون حاشیه) از \fB\fC0\fR استفاده کنید. .RE .PP [](images/panel\fIsize\fPmargin.jpg) .RS .IP \(bu 2 \fB\fCpanel_padding = horizontal_padding vertical_padding spacing\fR : لطفاً به تصویر زیر مراجعه کنید. .RE .PP [](images/panel_padding.jpg) .RS .IP \(bu 2 \fB\fCfont_shadow = boolean (0 or 1)\fR .IP \(bu 2 \fB\fCpanel_background_id = integer\fR : مشخص می‌کند از کدام پس‌زمینه برای پنل استفاده شود. .IP \(bu 2 \fB\fCwm_menu = boolean (0 or 1)\fR : مشخص می‌کند که آیا tint2 رویدادهای مدیریت‌نشده موشواره را به مدیر پنجره هدایت کند یا خیر. برای مدیر پنجره‌هایی مانند openbox که با کلیک راست روی میزکار منوی استارت را نمایش می‌دهند کاربردی است. .IP \(bu 2 \fB\fCpanel_dock = boolean (0 or 1)\fR : مشخص می‌کند که آیا tint2 در داک (dock) مدیر پنجره قرار گیرد یا خیر. برای مدیر پنجره openbox توصیه می‌شود یک کلید تبدیل (modifier) برای گزینه moveButton نیز تعریف شود، در غیر این صورت کلیک موشواره به tint2 هدایت نمی‌شود (در ~/.config/openbox/rc.xml). .IP \(bu 2 \fB\fCpanel_pivot_struts = boolean (0 or 1)\fR : مشخص می‌کند که آیا tint2 هنگام درخواست فضای رزروشده با STRUTها، جهت خود (افقی در برابر عمودی) را به مدیر پنجره خلاف واقع گزارش دهد یا خیر (گزینه \fB\fCstrut_policy\fR را در زیر ببینید). در برخی مدیر پنجره‌ها، این کار امکان قرار دادن پنل در میانه صفحه مجازی را فراهم می‌سازد، برای مثال در لبه پایینی نمایشگر بالایی در یک پیکربندی عمودی دو نمایشگره. .IP \(bu 2 \fB\fCpanel_layer = bottom/normal/top\fR : برنامه tint2 را در لایه bottom/normal/top قرار می‌دهد. این گزینه برای تعیین این‌که آیا پنجره‌های دیگر می‌توانند روی پنل را بپوشانند یا خیر مفید است. مقدار پیش‌فرض لایه bottom است، اما با شفافیت واقعی، لایه normal یا top می‌تواند جایگزین مناسبی باشد. .IP \(bu 2 \fB\fCstrut_policy = follow_size/minimum/none\fR : مقادیر STRUT توسط مدیر پنجره برای تعیین اندازه پنجره‌های بیشینه‌شده (maximized) استفاده می‌شوند. نکته: در پیکربندی‌های چند نمایشگره (Xinerama)، پنل معمولاً باید در لبه (و نه در وسط) صفحه مجازی قرار گیرد تا این ویژگی به درستی کار کند (اگرچه در برخی مدیر پنجره‌ها، تنظیم \fB\fCpanel_pivot_struts\fR می‌تواند این محدودیت را دور بزند). .RS .IP \(bu 2 \fB\fCfollow_size\fR به این معنی است که اندازه پنجره‌های بیشینه‌شده همواره به گونه‌ای تغییر می‌کند که یک لبه مشترک با tint2 داشته باشند. .IP \(bu 2 \fB\fCminimum\fR به این معنی است که پنجره‌های بیشینه‌شده همواره گسترش می‌یابند تا لبه مشترکی با پنل پنهان‌شده داشته باشند. این حالت زمانی که گزینه \fB\fCautohide\fR فعال باشد کاربردی است. .IP \(bu 2 \fB\fCnone\fR به این معنی است که پنجره‌های بیشینه‌شده از اندازه تمام‌صفحه استفاده می‌کنند. .RE .IP \(bu 2 \fB\fCpanel_window_name = string\fR : نام پنجره پنل را مشخص می‌کند. پیش‌فرض: \(aqtint2\(aq. \fI(از نگارش 0.12)\fP .IP \(bu 2 \fB\fCdisable_transparency = boolean (0 or 1)\fR : غیرفعال کردن شفافیت به جای بررسی این‌که آیا پشتیبانی می‌شود یا خیر. روی پشته‌های گرافیکی معیوب مفید است. \fI(از نگارش 0.12)\fP .IP \(bu 2 \fB\fCmouse_effects = boolean (0 or 1)\fR : تعیین فعال بودن جلوه‌های شناوری موشواره (hover) برای موارد قابل کلیک. \fI(از نگارش 0.12.3)\fP .IP \(bu 2 \fB\fCmouse_hover_icon_asb = alpha (0 to 100) saturation (\-100 to 100) brightness (\-100 to 100)\fR : رنگ و شفافیت آیکون را هنگام شناوری موشواره تنظیم می‌کند (تنها زمانی کار می‌کند که mouse_effects = 1 باشد). \fI(از نگارش 0.12.3)\fP .IP \(bu 2 \fB\fCmouse_pressed_icon_asb = alpha (0 to 100) saturation (\-100 to 100) brightness (\-100 to 100)\fR : رنگ و شفافیت آیکون را هنگام فشرده شدن موشواره تنظیم می‌کند (تنها زمانی کار می‌کند که mouse_effects = 1 باشد). \fI(از نگارش 0.12.3)\fP .IP \(bu 2 \fB\fCautohide = boolean (0 or 1)\fR : تعیین فعال بودن پنهان‌سازی پنل هنگام خروج نشانگر موشواره از پنل. .IP \(bu 2 \fB\fCautohide_show_timeout = float\fR : مهلت زمانی نمایش بر حسب ثانیه پس از ورود نشانگر موشواره به پنل. از \(aq.\(aq به عنوان جداکننده اعشار استفاده کنید. .IP \(bu 2 \fB\fCautohide_hide_timeout = float\fR : مهلت زمانی پنهان‌سازی بر حسب ثانیه پس از خروج نشانگر موشواره از پنل. از \(aq.\(aq به عنوان جداکننده اعشار استفاده کنید. .IP \(bu 2 \fB\fCautohide_height = integer\fR : ارتفاع پنل (عرض برای پنل‌های عمودی) در حالت پنهان. .RE.SS "راه‌انداز (Launcher)" .RS .IP \(bu 2 \fB\fClauncher_item_app = path_to_application\fR : هر \fB\fClauncher_item_app\fR باید یک مسیر فایل به یک فایل .desktop مطابق با مشخصات freedesktop.org \[la]http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html\[ra]\& باشد. مسیرها ممکن است با \fB\fC~\fR شروع شوند، که به مسیر دایرکتوری خانگی کاربر گسترش می‌یابد. اگر فقط یک نام فایل مشخص شده باشد، فایل در دایرکتوری‌های استاندارد برنامه‌ها جستجو می‌شود (\fB\fC$XDG_DATA_HOME/applications\fR، \fB\fC~/.local/share/applications\fR، \fB\fC$XDG_DATA_DIRS/applications\fR، \fB\fC/usr/local/share/applications\fR، \fB\fC/usr/share/applications\fR، \fB\fC/opt/share/applications\fR). .IP \(bu 2 \fB\fClauncher_apps_dir = path_to_directory\fR : مسیری به یک دایرکتوری را مشخص می‌کند که راه‌انداز تمام فایل‌های .desktop را از آن بارگذاری می‌کند (تمام زیردایرکتوری‌ها به صورت بازگشتی کاوش می‌شوند). می‌تواند چندین بار استفاده شود. مسیر ممکن است با \fB\fC~\fR شروع شود، که به مسیر دایرکتوری خانگی کاربر گسترش می‌یابد. \fI(از نسخه 0.12)\fP .IP \(bu 2 \fB\fClauncher_background_id = integer\fR : مشخص می‌کند از کدام پس‌زمینه استفاده شود. .IP \(bu 2 \fB\fClauncher_icon_background_id = integer\fR : مشخص می‌کند از کدام پس‌زمینه برای آیکون‌ها استفاده شود. .IP \(bu 2 \fB\fClauncher_padding = horizontal_padding vertical_padding spacing\fR .IP \(bu 2 \fB\fClauncher_icon_size = integer\fR : اندازه آیکون راه‌انداز، بر حسب پیکسل. .IP \(bu 2 \fB\fClauncher_icon_theme = name_of_theme\fR : (اختیاری) از تم آیکون مشخص‌شده برای نمایش آیکون‌های میانبر استفاده می‌کند. توجه داشته باشید که اگر یک مدیر XSETTINGS در حال اجرا داشته باشید (که احتمالاً دارید)، tint2 تم آیکون میزکار شما را شناسایی کرده و به کار می‌برد، مگر اینکه \fB\fClauncher_icon_theme_override = 1\fR باشد. .IP \(bu 2 \fB\fClauncher_icon_theme_override = boolean (0 or 1)\fR : مشخص می‌کند که آیا \fB\fClauncher_icon_theme\fR مقدار به‌دست‌آمده از مدیر XSETTINGS را لغو (override) می‌کند یا خیر. \fI(از نسخه 0.12)\fP .IP \(bu 2 \fB\fClauncher_icon_asb = alpha (0 to 100) saturation (\-100 to 100) brightness (\-100 to 100)\fR : رنگ و شفافیت آیکون را تنظیم می‌کند. .IP \(bu 2 \fB\fClauncher_tooltip = boolean (0 or 1)\fR : نمایش یا عدم نمایش راهنمای شناور (tooltip) برای آیکون‌های راه‌انداز. .IP \(bu 2 \fB\fCstartup_notifications = boolean (0 or 1)\fR : نمایش یا عدم نمایش اعلان‌های راه‌اندازی هنگام اجرای برنامه‌ها از راه‌انداز. \fI(از نسخه 0.12)\fP .RE .SS "نوار وظیفه / پیجر (Taskbar / Pager)" .RS .IP \(bu 2 \fB\fCtaskbar_mode = single_desktop/multi_desktop\fR .RS .IP \(bu 2 \fB\fCsingle_desktop\fR : یک نوار وظیفه معمولی را نشان می‌دهد که وظایف در حال اجرا در میزکار مجازی فعلی (که با عنوان «فضای کاری» یا workspace نیز شناخته می‌شود) را فهرست می‌کند؛ .IP \(bu 2 \fB\fCmulti_desktop\fR : قابلیتی شبیه به پیجر (pager). چندین نوار وظیفه را نشان می‌دهد، یکی برای هر میزکار مجازی، که با آن: .RS .IP \(bu 2 می‌توانید وظایف را بین میزکارهای مجازی بکشید و رها کنید (drag\-and\-drop)؛ .IP \(bu 2 می‌توانید بین میزکارهای مجازی جابه‌جا شوید. .RE .RE .IP \(bu 2 \fB\fCtaskbar_hide_if_empty = boolean (0 or 1)\fR : در صورت فعال بودن، در حالت multi\-desktop نوارهای وظیفه مربوط به میزکارهای خالی غیر از میزکار فعلی، پنهان می‌شوند. \fI(از نسخه 0.13)\fP .IP \(bu 2 \fB\fCtaskbar_distribute_size = boolean (0 or 1)\fR : در صورت فعال بودن، در حالت multi\-desktop اندازه موجود را به تناسب تعداد وظایف بین نوارهای وظیفه توزیع می‌کند. پیش‌فرض: غیرفعال (disabled). \fI(از نسخه 0.12)\fP .IP \(bu 2 \fB\fCtaskbar_padding = horizontal_padding vertical_padding spacing\fR .RE .PP [](images/taskbar_padding.jpg) .RS .IP \(bu 2 \fB\fCtaskbar_background_id = integer\fR : از کدام پس‌زمینه استفاده شود. .IP \(bu 2 \fB\fCtaskbar_active_background_id = integer\fR : از کدام پس‌زمینه برای نوار وظیفه میزکار مجازی فعلی استفاده شود. .IP \(bu 2 \fB\fCtaskbar_hide_inactive_tasks = boolean (0 or 1)\fR : در صورت فعال بودن، نوار وظیفه تنها وظیفه فعال را نشان می‌دهد. \fI(از نسخه 0.12)\fP .IP \(bu 2 \fB\fCtaskbar_hide_different_monitor = boolean (0 or 1)\fR : در صورت فعال بودن، نوار وظیفه تنها وظایف نمایشگر فعلی را نشان می‌دهد. هنگام اجرای نمونه‌های مختلف tint2 روی نمایشگرهای گوناگون، که هر یک پیکربندی مخصوص به خود را دارند، کاربردی است. \fI(از نسخه 0.12)\fP .IP \(bu 2 \fB\fCtaskbar_hide_different_desktop = boolean (0 or 1)\fR : در صورت فعال بودن، نوار وظیفه تنها وظایف میزکار فعلی را نشان می‌دهد. برای جمع‌وجورتر کردن نوارهای وظیفه multi\-desktop مفید است، در حالی که همچنان امکان جابه‌جایی میزکار را با کلیک موشواره فراهم می‌سازد. \fI(از نسخه 1.0)\fP .IP \(bu 2 \fB\fCtaskbar_always_show_all_desktop_tasks = boolean (0 or 1)\fR : تنها زمانی تأثیر دارد که \fB\fCtaskbar_mode = multi_desktop\fR باشد. در صورت فعال بودن، وظایفی که در تمام میزکارها حضور دارند در همه نوارهای وظیفه نمایش داده می‌شوند. در غیر این صورت، تنها در نوار وظیفه میزکار فعلی نمایش می‌یابند. \fI(از نسخه 0.12.4)\fP .IP \(bu 2 \fB\fCtaskbar_sort_order = none/title/center\fR : ترتیب مرتب‌سازی وظایف را در نوار وظیفه مشخص می‌کند. \fI(از نسخه 0.12)\fP .RS .IP \(bu 2 \fB\fCnone\fR : بدون مرتب‌سازی. وظایف جدید هنگام ظاهر شدن، به سادگی به انتهای نوار وظیفه افزوده می‌شوند. .IP \(bu 2 \fB\fCtitle\fR : وظایف را بر اساس عنوان مرتب می‌کند. .IP \(bu 2 \fB\fCapplication\fR : وظایف را بر اساس نام برنامه مرتب می‌کند. \fI(از نسخه 16.3)\fP .IP \(bu 2 \fB\fCcenter\fR : وظایف را بر اساس مرکز پنجره‌هایشان مرتب می‌کند. .IP \(bu 2 \fB\fCmru\fR : وظایفی را که اخیراً استفاده شده‌اند (MRU) در ابتدا نشان می‌دهد. \fI(از نسخه 0.12.4)\fP .IP \(bu 2 \fB\fClru\fR : وظایفی را که اخیراً استفاده شده‌اند، در انتها نشان می‌دهد. \fI(از نسخه 0.12.4)\fP .RE .IP \(bu 2 \fB\fCtask_align = left/center/right\fR : تراز کردن وظایف را در نوار وظیفه مشخص می‌کند. پیش‌فرض: left. .IP \(bu 2 \fB\fCtaskbar_name = boolean (0 or 1)\fR : نمایش یا عدم نمایش نام میزکار مجازی در نوار وظیفه. .IP \(bu 2 \fB\fCtaskbar_name_padding = padding\fR : فاصله‌گذاری درونی (padding) برای نام میزکار مجازی. .IP \(bu 2 \fB\fCtaskbar_name_background_id = integer\fR : از کدام پس‌زمینه برای نام میزکار استفاده شود. .IP \(bu 2 \fB\fCtaskbar_name_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR : پیکربندی فونت برای نام میزکار. .IP \(bu 2 \fB\fCtaskbar_name_font_color = color opacity (0 to 100)\fR : رنگ فونت برای نام میزکار. .IP \(bu 2 \fB\fCtaskbar_name_active_background_id = integer\fR : از کدام پس‌زمینه برای نام میزکار فعلی استفاده شود. .IP \(bu 2 \fB\fCtaskbar_name_active_font_color = color opacity (0 to 100)\fR : رنگ فونت برای نام میزکار فعلی. .RE.SH "دکمه‌های نوار وظیفه (Taskbar buttons)" .PP گزینه‌های زیر دکمه‌های وظیفه را در نوار وظیفه پیکربندی می‌کنند: .RS .IP \(bu 2 \fB\fCtask_icon = boolean (0 or 1)\fR : نمایش دادن یا ندادن نماد وظیفه. هیچ گزینهٔ صریحی برای کنترل اندازهٔ نماد وظیفه وجود ندارد؛ این اندازه به فاصلهٔ درونی عمودی تنظیم‌شده با \fB\fCtask_padding\fR بستگی دارد\&. .IP \(bu 2 \fB\fCtask_text = boolean (0 or 1)\fR : نمایش دادن یا ندادن متن وظیفه. .IP \(bu 2 \fB\fCtask_centered = boolean (0 or 1)\fR : وسط‌چین بودن یا نبودن متن وظیفه. .IP \(bu 2 \fB\fCtask_tooltip = boolean (0 or 1)\fR : نمایش دادن یا ندادن پیش‌نمایش متنی (tooltip) برای وظایف. .IP \(bu 2 \fB\fCtask_thumbnail = boolean (0 or 1)\fR : نمایش دادن یا ندادن پیش‌نمایش بندانگشتی برای وظایف. \fI(از نسخهٔ 16.0)\fP .IP \(bu 2 \fB\fCtask_thumbnail_size = width\fR : اندازهٔ تصویر بندانگشتی. \fI(از نسخهٔ 16.0)\fP .IP \(bu 2 \fB\fCtask_maximum_size = width height\fR .RS .IP \(bu 2 \fB\fCwidth\fR در پنل‌های افقی برای محدود کردن اندازهٔ وظایف استفاده می‌شود. برای اختصاص تمام پهنای نوار وظیفه، از \fB\fCwidth = 0\fR استفاده کنید. .IP \(bu 2 \fB\fCheight\fR برای پنل‌های عمودی استفاده می‌شود. .RE .IP \(bu 2 \fB\fCtask_padding = horizontal_padding vertical_padding spacing\fR .IP \(bu 2 \fB\fCurgent_nb_of_blink = integer\fR : تعداد چشمک‌زدن‌ها در رویدادهای «جلب توجه» (get attention). .RE .PP [](images/task_padding.jpg) .RS .IP \(bu 2 \fB\fCtask_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR .IP \(bu 2 \fB\fCtask_font_color = color opacity (0 to 100)\fR .IP \(bu 2 \fB\fCtask_icon_asb = alpha (0 to 100) saturation (\-100 to 100) brightness (\-100 to 100)\fR : تنظیم رنگ و شفافیت نماد وظیفه. .IP \(bu 2 \fB\fCtask_background_id = integer\fR : پس‌زمینه‌ای که باید برای وظایف انتخاب‌نشده استفاده شود. .RE .TP برای ۳ گزینهٔ بعدی، \fB\fCSTATUS\fR می‌تواند \fB\fCactive\fR / \fB\fCiconified\fR / \fB\fCurgent\fR باشد: * \fB\fCtask_STATUS_font_color = color opacity (0 to 100)\fR .RS .IP \(bu 2 \fB\fCtask_STATUS_icon_asb = alpha (0 to 100) saturation (\-100 to 100) brightness (\-100 to 100)\fR : رنگ و شفافیت نماد وظیفه را تنظیم می‌کند. .IP \(bu 2 \fB\fCtask_STATUS_background_id = integer\fR : پس‌زمینه‌ای که باید برای وظیفه استفاده شود. .RE .SS "اقدامات موشواره برای دکمه‌های نوار وظیفه (Mouse actions for taskbar buttons)" .PP رویدادهای ممکن موشواره عبارتند از: \fB\fCleft, middle, right, scroll_up, scroll_down\fR\&. .PP اقدامات ممکن موشواره عبارتند از: \fB\fCnone, close, toggle, iconify, shade, toggle_iconify, maximize_restore, desktop_left, desktop_right, next_task, prev_task\fR\&. .PP برای سفارشی‌سازی اقدامات موشواره از \fB\fCmouse_event = action\fR استفاده کنید. مثال: \fB\fC mouse_middle = none mouse_right = close mouse_scroll_up = toggle mouse_scroll_down = iconify \fR .TP مفاهیم اقدامات: * \fB\fCnone\fR : اگر \fB\fCwm_menu = 1\fR تنظیم شده باشد، رویداد موشواره به مدیر پنجره فرستاده می‌شود؛ در غیر این صورت نادیده گرفته می‌شود. * \fB\fCclose\fR : بستن وظیفه * \fB\fCtoggle\fR : تغییر وضعیت وظیفه * \fB\fCiconify\fR : کمینه‌سازی (minimize) وظیفه * \fB\fCtoggle_iconify\fR : تغییر وضعیت یا کمینه‌سازی وظیفه * \fB\fCmaximize_restore\fR : بیشینه‌سازی یا بازگردانی اندازهٔ وظیفه * \fB\fCshade\fR : جمع کردن (shade) پنجرهٔ وظیفه * \fB\fCdesktop_left\fR : فرستادن وظیفه به میزکار سمت چپ * \fB\fCdesktop_right\fR : فرستادن وظیفه به میزکار سمت راست * \fB\fCnext_task\fR : انتقال تمرکز به وظیفهٔ بعدی * \fB\fCprev_task\fR : انتقال تمرکز به وظیفهٔ قبلی .SS "سینی سیستم (System Tray)" .RS .IP \(bu 2 \fB\fCsystray_padding = horizontal_padding vertical_padding spacing\fR .IP \(bu 2 \fB\fCsystray_background_id = integer\fR : کدام پس‌زمینه استفاده شود. .IP \(bu 2 \fB\fCsystray_sort = ascending/descending/left2right/right2left\fR : ترتیب مرتب‌سازی نمادها در سینی سیستم را تعیین می‌کند: به ترتیب الفبایی صعودی/نزولی عنوان نماد، یا افزودن همیشگی نمادها به سمت راست/چپ (توجه داشته باشید که با \fB\fCleft2right\fR یا \fB\fCright2left\fR ممکن است این ترتیب هنگام راه‌اندازی دوبارهٔ پنل تغییر کند). .IP \(bu 2 \fB\fCsystray_icon_size = max_icon_size\fR : بیشینه اندازهٔ نماد سینی سیستم را به \fB\fCnumber\fR تنظیم می‌کند. برای اندازه‌بندی خودکار نماد، آن را روی \fB\fC0\fR قرار دهید\&. .IP \(bu 2 \fB\fCsystray_icon_asb = alpha (0 to 100) saturation (\-100 to 100) brightness (\-100 to 100)\fR : رنگ و شفافیت نمادهای سینی سیستم را تنظیم می‌کند. .IP \(bu 2 \fB\fCsystray_monitor = integer (1, 2, ...) or primary\fR : سینی سیستم روی کدام نمایشگر رسم شود. نخستین نمایشگر \fB\fC1\fR است\&. \fI(از نسخهٔ 0.12)\fP .IP \(bu 2 \fB\fCsystray_name_filter = string\fR : عبارت باقاعده برای شناسایی نام نمادهایی که باید پنهان شوند. برای نمونه، \fB\fC^audacious$\fR نمادهایی با نام دقیق \fB\fCaudacious\fR را پنهان می‌کند، در حالی که \fB\fCaud\fR هر نمادی را که \fB\fCaud\fR در نامش وجود داشته باشد پنهان خواهد کرد\&. \fI(از نسخهٔ 0.13.1)\fP .RE.SS "ساعت (Clock)" .RS .IP \(bu 2 \fB\fCtime1_format = %H:%M\fR : قالبی که توسط خط نخست ساعت استفاده می‌شود. .RS .IP \(bu 2 \fB\fCtime1_format\fR، \fB\fCtime2_format\fR و \fB\fCclock_tooltip\fR از نحو 'strftime' استفاده می‌کنند. اطلاعات بیشتر را می‌توانید در اینجا بیابید: \[la]http://www.manpagez.com/man/3/strftime\[ra] .IP \(bu 2 برای پنهان کردن ساعت، \fB\fCtime1_format\fR و \fB\fCtime2_format\fR را کامنت کنید\&. .RE .IP \(bu 2 \fB\fCtime1_timezone = :US/Hawaii\fR .RS .IP \(bu 2 \fB\fCtime1_timezone\fR، \fB\fCtime2_timezone\fR و \fB\fCclock_tooltip_timezone\fR می‌توانند برای تعیین یک منطقه زمانی استفاده شوند. اگر مقداری مشخص نکنید، منطقه زمانی سراسری سیستم استفاده می‌شود. مناطق زمانی معمولاً در دایرکتوری \fB\fC/usr/share/zoneinfo\fR یافت می‌شوند\&. اگر مناطق زمانی شما در دایرکتوری متفاوتی قرار دارند، باید مسیر مطلق را مشخص کنید؛ مانند \fB\fCtime1_timezone = :/different/zoneinfo/dir/US/Hawaii\fR. همیشه در ابتدای منطقه زمانی یک ':' قرار دهید. .RE .IP \(bu 2 \fB\fCtime1_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR .IP \(bu 2 \fB\fCtime2_format = %A %d %B\fR .IP \(bu 2 \fB\fCtime2_timezone = :Europe/Berlin\fR .IP \(bu 2 \fB\fCtime2_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR .IP \(bu 2 \fB\fCclock_font_color = color opacity (0 to 100)\fR .IP \(bu 2 \fB\fCclock_padding = horizontal_padding vertical_padding\fR .IP \(bu 2 \fB\fCclock_background_id = integer\fR : کدام پس‌زمینه استفاده شود. .IP \(bu 2 \fB\fCclock_tooltip = %a, %d. %b %Y\fR : قالب برای راهنمای شناور ساعت. .IP \(bu 2 \fB\fCclock_tooltip_timezone = :UTC\fR .IP \(bu 2 \fB\fCclock_lclick_command = text\fR : دستوری که با کلیک چپ اجرا می‌شود. .IP \(bu 2 \fB\fCclock_rclick_command = text\fR : دستوری که با کلیک راست اجرا می‌شود. .IP \(bu 2 \fB\fCclock_mclick_command = text\fR : دستوری که با کلیک میانی اجرا می‌شود. \fI(از نسخه 0.12.1)\fP .IP \(bu 2 \fB\fCclock_uwheel_command = text\fR : دستوری که با چرخش غلتک ماوس به بالا اجرا می‌شود. \fI(از نسخه 0.12.1)\fP .IP \(bu 2 \fB\fCclock_dwheel_command = text\fR : دستوری که با چرخش غلتک ماوس به پایین اجرا می‌شود. \fI(از نسخه 0.12.1)\fP .RE .SS "راهنمای شناور (Tooltip)" .RS .IP \(bu 2 \fB\fCtooltip_padding = horizontal_padding vertical_padding\fR .IP \(bu 2 \fB\fCtooltip_show_timeout = float\fR : تأخیر در نمایش راهنمای شناور بر حسب ثانیه. از \fB\fC\&.\fR به عنوان جداکننده اعشار استفاده کنید. .IP \(bu 2 \fB\fCtooltip_hide_timeout = float\fR : تأخیر در پنهان کردن راهنمای شناور بر حسب ثانیه. از \fB\fC\&.\fR به عنوان جداکننده اعشار استفاده کنید. .IP \(bu 2 \fB\fCtooltip_background_id = integer\fR : کدام پس‌زمینه برای راهنماهای شناور استفاده شود. توجه داشته باشید که با شفافیت کاذب، گزینه‌های کانال آلفا و شعاع گوشه رعایت نمی‌شوند. .IP \(bu 2 \fB\fCtooltip_font_color = color opacity (0 to 100)\fR .IP \(bu 2 \fB\fCtooltip_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR .RE .SS "باتری (Battery)" .RS .IP \(bu 2 \fB\fCbattery_hide = never/integer (0 to 100)\fR : در چه درصدی از باتری، آیتم باتری پنهان شود. .IP \(bu 2 \fB\fCbattery_low_status = integer\fR: در چه درصدی از باتری دستور وضعیت کم بودن شارژ اجرا شود. .IP \(bu 2 \fB\fCbattery_low_cmd = xmessage 'tint2: Battery low!'\fR : دستوری که هنگام کم بودن شارژ باتری اجرا می‌شود. .IP \(bu 2 \fB\fCbattery_full_cmd = notify\-send "battery full"\fR : دستوری که هنگام پر شدن باتری اجرا می‌شود. .IP \(bu 2 \fB\fCbat1_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR .IP \(bu 2 \fB\fCbat2_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR .IP \(bu 2 \fB\fCbattery_font_color = color opacity (0 to 100)\fR .IP \(bu 2 \fB\fCbat1_format = FORMAT_STRING\fR : قالب خط ۱ باتری. پیش‌فرض: %p. \fI(از نسخه 1.0)\fP مشخصات قالب: .RS .IP \(bu 2 %s: وضعیت (charging، discharging، full، unknown). .IP \(bu 2 %m: دقایق باقی‌مانده تا شارژ یا تخلیه کامل (تخمینی). .IP \(bu 2 %h: ساعت‌های باقی‌مانده تا شارژ یا تخلیه کامل (تخمینی). .IP \(bu 2 %t: زمان باقی‌مانده. در زمان شارژ/تخلیه "hrs:mins" یا در زمان پر بودن "Ful\[rs]" را نشان می‌دهد. .IP \(bu 2 %p: درصد. شامل علامت % است. .IP \(bu 2 %P: درصد. بدون علامت %. .RE .IP \(bu 2 \fB\fCbat2_format = FORMAT_STRING\fR : قالب خط ۲ باتری. پیش‌فرض: %t. \fI(از نسخه 1.0)\fP .IP \(bu 2 \fB\fCbattery_padding = horizontal_padding vertical_padding\fR .IP \(bu 2 \fB\fCbattery_background_id = integer\fR : کدام پس‌زمینه برای باتری استفاده شود. .IP \(bu 2 \fB\fCbattery_tooltip_enabled = boolean (0 or 1)\fR : فعال/غیرفعال کردن راهنماهای شناور باتری. \fI(از نسخه 0.12.3)\fP .IP \(bu 2 \fB\fCbattery_lclick_command = text\fR : دستوری که با کلیک چپ اجرا می‌شود. \fI(از نسخه 0.12.1)\fP .IP \(bu 2 \fB\fCbattery_rclick_command = text\fR : دستوری که با کلیک راست اجرا می‌شود. \fI(از نسخه 0.12.1)\fP .IP \(bu 2 \fB\fCbattery_mclick_command = text\fR : دستوری که با کلیک میانی اجرا می‌شود. \fI(از نسخه 0.12.1)\fP .IP \(bu 2 \fB\fCbattery_uwheel_command = text\fR : دستوری که با چرخش غلتک ماوس به بالا اجرا می‌شود. \fI(از نسخه 0.12.1)\fP .IP \(bu 2 \fB\fCbattery_dwheel_command = text\fR : دستوری که با چرخش غلتک ماوس به پایین اجرا می‌شود. \fI(از نسخه 0.12.1)\fP .IP \(bu 2 \fB\fCac_connected_cmd = text\fR : دستوری که هنگام اتصال آداپتور برق اجرا می‌شود. \fI(از نسخه 0.12.3)\fP .IP \(bu 2 \fB\fCac_disconnected_cmd = text\fR : دستوری که هنگام جدا شدن آداپتور برق اجرا می‌شود. \fI(از نسخه 0.12.3)\fP .RE.SS مجری (Executor) .RS .IP \(bu 2 \fB\fCexecp = new\fR : پیکربندی یک افزونهٔ مجری جدید را آغاز می‌کند. چندین مورد از این افزونه‌ها پشتیبانی می‌شوند؛ تنها کافی است چند حرف \fB\fCE\fR در \fB\fCpanel_items\fR به کار رود. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_command = text\fR : دستوری که باید اجرا شود. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_interval = integer\fR : این دستور مجدداً پس از \fB\fCexecp_interval\fR ثانیه از لحظهٔ خروج، اجرا می‌شود. در صورت صفر بودن، دستور تنها یک بار اجرا خواهد شد. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_continuous = integer\fR : در صورت غیرصفر بودن، آخرین \fB\fCexecp_continuous\fR سطر از خروجی دستور، در هر \fB\fCexecp_continuous\fR سطر نمایش داده می‌شود؛ این ویژگی برای نمایش خروجی دستوراتی که به‌طور مداوم اجرا می‌شوند، مانند \fB\fCping 127.0.0.1\fR مفید است. در صورت صفر بودن، خروجی دستور پس از پایان اجرای آن نمایش داده می‌شود. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_has_icon = boolean (0 or 1)\fR : اگر \fB\fCexecp_has_icon = 1\fR باشد، نخستین سطر چاپ‌شده توسط دستور به عنوان مسیر یک فایل تصویری تفسیر می‌شود. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_cache_icon = boolean (0 or 1)\fR : اگر \fB\fCexecp_cache_icon = 0\fR باشد، تصویر با هر بار اجرای دستور دوباره بارگذاری می‌شود (در صورتی که فایل تصویر روی دیسک توسط برنامهٔ اجراشده با \fB\fCexecp_command\fR تغییر کند، مفید است). \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_icon_w = integer\fR : می‌توانید از \fB\fCexecp_icon_w\fR و \fB\fCexecp_icon_h\fR برای تغییر اندازهٔ تصویر استفاده کنید. اگر یکی از آن‌ها صفر یا ناموجود باشد، مقیاس تصویر به‌طور متناسب تغییر می‌کند. اگر هر دوی آن‌ها صفر یا ناموجود باشند، مقیاس تصویر تغییر نخواهد کرد. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_icon_h = integer\fR : به \fB\fCexecp_icon_w\fR مراجعه کنید. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_tooltip = text\fR : متن راهنما (tooltip). اگر خالی رها شود، هیچ راهنمایی نمایش داده نمی‌شود. اگر تعیین نشده باشد، خطای استاندارد (stderr) دستور به عنوان راهنما نشان داده می‌شود (یک توالی پاک‌کردن صفحه ANSI می‌تواند محتوا را بازنشانی کند، در bash: \fB\fCprintf '\\e[2J'\fR، در C: \fB\fCprintf("\\x1b[2J");\fR). اگر خطای استاندارد خالی باشد، راهنما اطلاعاتی دربارهٔ زمان آخرین اجرای دستور را نشان خواهد داد. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR : قلم مورد استفاده برای رسم متن. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_font_color = color opacity\fR : رنگ قلم. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_markup = boolean (0 or 1)\fR : در صورت غیرصفر بودن، با خروجی دستور همانند نشانه‌گذاری Pango برخورد می‌شود که امکان قالب‌بندی متن غنی (rich text) را فراهم می‌کند. ساختار آن در نشانی \[la]https://developer.gnome.org/pygtk/stable/pango-markup-language.html\[ra] مستند شده است. توجه داشته باشید که استفاده از این مورد با دستوراتی که داده‌های بارگیری‌شده از اینترنت را چاپ می‌کنند، یک خطر امنیتی بالقوه است. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_background_id = integer\fR : کدام پس‌زمینه استفاده شود. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_centered = boolean (0 or 1)\fR : تعیین می‌کند که آیا متن در مرکز قرار گیرد یا خیر. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_padding = horizontal_padding vertical_padding spacing_between_icon_and_text\fR \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_monitor = integer (1, 2, ...), primary or all\fR : مجری روی کدام نمایشگر رسم شود. نخستین نمایشگر \fB\fC1\fR است. \fI(از نسخهٔ 17.0)\fP .IP \(bu 2 \fB\fCexecp_lclick_command = text\fR : دستوری که هنگام کلیک چپ اجرا می‌شود. در صورت عدم تعیین، \fB\fCexecp_command\fR بلافاصله اجرا خواهد شد، مگر اینکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_mclick_command = text\fR : دستوری که هنگام کلیک راست اجرا می‌شود. در صورت عدم تعیین، \fB\fCexecp_command\fR بلافاصله اجرا خواهد شد، مگر اینکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_rclick_command = text\fR : دستوری که هنگام کلیک وسط اجرا می‌شود. در صورت عدم تعیین، \fB\fCexecp_command\fR بلافاصله اجرا خواهد شد، مگر اینکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_uwheel_command = text\fR : دستوری که هنگام چرخش چرخ ماوس به بالا اجرا می‌شود. در صورت عدم تعیین، \fB\fCexecp_command\fR بلافاصله اجرا خواهد شد، مگر اینکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.12.4)\fP .IP \(bu 2 \fB\fCexecp_dwheel_command = text\fR : دستوری که هنگام چرخش چرخ ماوس به پایین اجرا می‌شود. در صورت عدم تعیین، \fB\fCexecp_command\fR بلافاصله اجرا خواهد شد، مگر اینکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.12.4)\fP .RE .SS نمونه‌های مجری (Executor samples) .SS چاپ نام میزبان .PP .RS .nf execp = new execp_command = hostname execp_interval = 0 .fi .RE .SS چاپ میزان مصرف دیسک برای پارتیشن ریشه هر ۱۰ ثانیه .PP .RS .nf execp = new execp_command = df \-h | awk '/\\/$/ { print $6 ": " $2 " " $5}' execp_interval = 10 .fi .RE .SS دکمه با آیکون و متن غنی، که هنگام کلیک دستور را اجرا می‌کند .PP .RS .nf execp = new execp_command = echo /usr/share/icons/elementary\-xfce/emblems/24/emblem\-colors\-blue.png; echo 'Click me pls' execp_has_icon = 1 execp_interval = 0 execp_centered = 1 execp_font = sans 9 execp_markup = 1 execp_font_color = #aaffaa 100 execp_padding = 2 0 execp_tooltip = I will tell you a secret... execp_lclick_command = zenity \-\-info "\-\-text=$(uname \-sr)" execp_background_id = 2 .fi .RE.SS پیجر میزکار با متن .PP .RS .nf execp = new execp_command = xprop \-root \-spy | awk '/^_NET_CURRENT_DESKTOP/ { print "Workspace " ($3 + 1) ; fflush(); }' execp_interval = 1 execp_continuous = 1 .fi .RE .SS پیجر میزکار با آیکون .PP .RS .nf execp_command = xprop \-root \-spy | awk \-v home="$HOME" '/^_NET_CURRENT_DESKTOP/ { print home "/.config/myPager/" ($3 + 1) ".png\\n" ; fflush(); }' execp_interval = 1 execp_has_icon = 1 execp_cache_icon = 1 execp_continuous = 2 .fi .RE .SS زمان رفت‌وبرگشت به دروازه، تازه‌سازی در هر ثانیه .PP .RS .nf execp = new execp_command = ping \-i 1 \-c 1 \-W 1 \-O \-D \-n $(ip route | grep default | grep via | grep \-o '[0\-9]*\\.[0\-9]*\\.[0\-9]*\\.[0\-9]*') | awk '/no/ { print "timeout"; fflush(); }; /time=/ { gsub(/time=/, "", $8); printf "%3.0f %s\\n", $8, $9; fflush(); } ' execp_continuous = 0 execp_interval = 1 execp_markup = 1 .fi .RE .SS مصرف حافظه .PP .RS .nf # به استفاده از "stdbuf \-oL" برای وادار کردن برنامه به تخلیه خط‌به‌خط خروجی دقت کنید. execp = new execp_command = free \-b \-s1 | stdbuf \-oL awk '/^Mem:/ { printf "Mem: %s %.0f%%\\n", $2, 100 * ($2 \- $7) / $2 }' | stdbuf \-oL numfmt \-\-to=iec\-i \-\-field=2 \-d' ' execp_interval = 1 execp_continuous = 1 .fi .RE .SS بار شبکه .PP .RS .nf execp = new execp_command = stdbuf \-oL bwm\-ng \-o csv \-t 1000 | stdbuf \-oL awk \-F ';' '/total/ { printf "Net: %.0f Mb/s\\n", ($5*8/1.0e6) }' execp_continuous = 1 execp_interval = 1 .fi .RE .SS دکمه (Button) .RS .IP \(bu 2 \fB\fCbutton = new\fR : پیکربندی یک دکمهٔ جدید را آغاز می‌کند. چندین مورد از این افزونه پشتیبانی می‌شوند؛ کافی است از چند \fB\fCP\fR در \fB\fCpanel_items\fR استفاده کنید.\& \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_icon = text\fR : نام یا مسیر آیکون (یا خالی). \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_text = text\fR : متن برای نمایش (یا خالی). \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_tooltip = text\fR : راهنمای ابزار (tooltip) (یا خالی). \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR : قلم استفاده‌شده برای رسم متن. \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_font_color = color opacity\fR : رنگ قلم. \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_background_id = integer\fR : کدام پس‌زمینه استفاده شود. \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_centered = boolean (0 or 1)\fR : آیا متن در مرکز قرار گیرد یا خیر. \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_padding = horizontal_padding vertical_padding spacing_between_icon_and_text\fR \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_max_icon_size = integer\fR : محدودیتی برای اندازهٔ آیکون تعیین می‌کند. در غیر این صورت، آیکون تا لبه‌ها گسترش می‌یابد. \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_lclick_command = text\fR : دستور برای اجرا هنگام کلیک چپ. در صورت عدم تعریف، \fB\fCexecp_command\fR بلافاصله اجرا می‌شود، مگر آنکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_mclick_command = text\fR : دستور برای اجرا هنگام کلیک راست. در صورت عدم تعریف، \fB\fCexecp_command\fR بلافاصله اجرا می‌شود، مگر آنکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_rclick_command = text\fR : دستور برای اجرا هنگام کلیک وسط. در صورت عدم تعریف، \fB\fCexecp_command\fR بلافاصله اجرا می‌شود، مگر آنکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_uwheel_command = text\fR : دستور برای اجرا هنگام چرخش چرخ ماوس به بالا. در صورت عدم تعریف، \fB\fCexecp_command\fR بلافاصله اجرا می‌شود، مگر آنکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.14)\fP .IP \(bu 2 \fB\fCbutton_dwheel_command = text\fR : دستور برای اجرا هنگام چرخش چرخ ماوس به پایین. در صورت عدم تعریف، \fB\fCexecp_command\fR بلافاصله اجرا می‌شود، مگر آنکه در حال حاضر در حال اجرا باشد. \fI(از نسخهٔ 0.14)\fP .RE.SS جداکننده (Separator) .RS .IP \(bu 2 \fB\fCseparator = new\fR : پیکربندی یک جداکنندهٔ جدید را آغاز می‌کند. چندین افزونه از این دست پشتیبانی می‌شوند؛ کافی است از چندین \fB\fC:\fR در \fB\fCpanel_items\fR استفاده کنید. \fI(از نسخهٔ 0.13.0)\fP .IP \(bu 2 \fB\fCseparator_background_id = integer\fR : مشخص می‌کند از کدام پس‌زمینه استفاده شود. \fI(از نسخهٔ 0.13.0)\fP .IP \(bu 2 \fB\fCseparator_color = color opacity\fR : رنگ پیش‌زمینه. \fI(از نسخهٔ 0.13.0)\fP .IP \(bu 2 \fB\fCseparator_style = [empty | line | dots]\fR : سبک جداکننده. \fI(از نسخهٔ 0.13.0)\fP .IP \(bu 2 \fB\fCseparator_size = integer\fR : ضخامت جداکننده. شامل حاشیه و فاصله‌گذاری داخلی (padding) نمی‌شود. برای نمونه، اگر سبک \fB\fCline\fR باشد، این مقدار ضخامت خط است؛ اگر سبک \fB\fCdots\fR باشد، قطر نقطه خواهد بود. \fI(از نسخهٔ 0.13.0)\fP .IP \(bu 2 \fB\fCseparator_padding = side_padding cap_padding\fR : فاصله‌گذاری داخلی برای افزودن به طرفین جداکننده، بر حسب پیکسل. \fI(از نسخهٔ 0.13.0)\fP .RE .SS پیکربندی نمونه (Example configuration) .PP به /etc/xdg/tint2/tint2rc مراجعه کنید. .SH "نویسندگان (AUTHORS)" .PP برنامهٔ tint2 توسط Thierry Lorthiois \[la]lorthiois@bbsoft.fr\[ra] نوشته شده است\&. این برنامه بر پایهٔ ttm است که در اصل توسط Pål Staurland \[la]staura@gmail.com\[ra] نوشته شده بود\&. .PP این صفحهٔ راهنما در ابتدا توسط Daniel Moerner \[la]dmoerner@gmail.com\[ra] برای پروژهٔ دبیان نوشته شده بود (اما ممکن است توسط دیگران نیز استفاده شود). این متن از مستندات tint2 اقتباس شده است. .SH "همچنین ببینید (SEE ALSO)" .PP وبگاه اصلی در \[la]https://gitlab.com/o9000/tint2\[ra] و صفحهٔ ویکی در \[la]https://gitlab.com/o9000/tint2/wikis/home\[ra]\&. .PP این مستندات همچنین در قالب HTML و Markdown در مکان پیش‌فرض سیستم برای پرونده‌های مستندات، معمولاً در \fB\fC/usr/share/doc/tint2\fR یا \fB\fC/usr/local/share/doc/tint2\fR ارائه شده است\&. \&. \&.