نام (NAME)

labwc-theme - فایل‌های تم در مدیر پنجره labwc

تم (THEME)

موتور تم با هدف سازگاری با openbox طراحی شده است و تم‌ها به ترتیب زیر جستجو خواهند شد:

• ${XDG_DATA_HOME:-$HOME/.local/share}/themes/<theme-name>/labwc/
• $HOME/.themes/<theme-name>/labwc/
• /usr/share/themes/<theme-name>/labwc/
• /usr/local/share/themes/<theme-name>/labwc/
• /opt/share/themes/<theme-name>/labwc/
• ${XDG_DATA_HOME:-$HOME/.local/share}/themes/<theme-name>/openbox-3/
• $HOME/.themes/<theme-name>/openbox-3/
• /usr/share/themes/<theme-name>/openbox-3/
• /usr/local/share/themes/<theme-name>/openbox-3/
• /opt/share/themes/<theme-name>/openbox-3/

هنگامی که متغیر $XDG_DATA_HOME تعریف شده باشد، جایگزین مسیر $HOME/.local/share می‌شود (نه اینکه به آن افزوده شود). همین وضعیت برای $XDG_DATA_DIRS و /usr/share/ نیز برقرار است.

انتخاب تم با ویرایش کلید <name> در بخش <theme> از فایل پیکربندی rc.xml انجام می‌پذیرد (به labwc-config(5) مراجعه کنید).

یک تم شامل یک فایل themerc و در صورت تمایل تعدادی آیکون نوار عنوان (تحت عنوان دکمه‌ها یا buttons) است.

تنظیمات تم مشخص‌شده در themerc را می‌توان با ایجاد فایلی به نام 'themerc-override' در دایرکتوری پیکربندی بازنویسی کرد؛ این دایرکتوری معمولاً $HOME/.config/labwc/ است اما می‌تواند مطابق با توضیحات labwc-config(5) در مکان‌های دیگری نیز باشد.

انواع داده (DATA TYPES)

color

justification

textures

(Solid | Gradient <type>)

window.*.title.bg: Solid
window.*.title.bg.color: #f8f5f2

# Vertical gradient
window.*.title.bg: Gradient Vertical
window.*.title.bg.color: #658fb5
window.*.title.bg.colorTo: #4d6982
# SplitVertical gradient
window.*.title.bg: Gradient SplitVertical
window.*.title.bg.color: #658fb5
window.*.title.bg.color.splitTo: #7595b9
window.*.title.bg.colorTo: #4d6982
window.*.title.bg.colorTo.splitTo: #557485

عناصر تم (THEME ELEMENTS)

border.width

window.titlebar.padding.width

window.titlebar.padding.height

window.active.border.color

window.inactive.border.color

window.active.indicator.toggled-keybind.color

window.active.title.bg

window.active.title.bg.color

window.inactive.title.bg

window.inactive.title.bg.color

window.active.label.text.color

window.inactive.label.text.color

window.label.text.justify

window.button.width

window.button.height

window.button.spacing

نکته: فضانام window.button.hover (در ادامه) به جلوه‌های هم‌پوشانی هاور (hover) دکمه‌ها مربوط می‌شود که با تمام دکمه‌ها از جمله svg، png و xbm کار می‌کند.

جلوه‌های window.button.hover تنها در صورتی نمایش داده می‌شوند که آیکون هاور متناظری مانند close_hover-active.svg وجود نداشته باشد.

ابزار Openbox تنها از جلوه‌های هاور که در پشت دکمه‌ها رندر می‌شوند پشتیبانی می‌کند که برای قالب xbm معقول است اما برای سایر قالب‌ها خیر.

window.button.hover.bg.color

window.button.hover.bg.corner-radius

window.active.button.unpressed.image.color

window.inactive.button.unpressed.image.color

نکته: عناصر دکمه‌ها را می‌توان برای هر نوع دکمه ("menu", "iconify", "max", "shade", "desk" یا "close") با افزودن نوع دکمه بعد از گره "button" به صورت یکتا تعریف کرد؛ برای نمونه:

•

مقدار window.active.button.iconify.unpressed.image.color رنگ دکمه کمینه‌سازی را برای پنجره‌های فعال مشخص می‌کند؛ در حالی که

•

مقدار window.inactive.button.close.unpressed.image.color رنگ دکمه بستن را برای پنجره‌های غیرفعال تعیین می‌نماید.

این نحو در Openbox مستند نشده است، اما پشتیبانی می‌شود و در تم‌های پرطرفدار متعددی استفاده می‌گردد.

window.active.shadow.size

window.inactive.shadow.size

window.active.shadow.color

window.inactive.shadow.color

menu.overlap.x

menu.overlap.y

menu.width.min

menu.width.max

menu.border.width

menu.border.color

menu.items.padding.x

menu.items.padding.y

menu.items.bg.color

menu.items.text.color

menu.items.active.bg.color

menu.items.active.text.color

menu.separator.width

menu.separator.padding.width

menu.separator.padding.height

menu.separator.color

menu.title.bg.color

menu.title.text.justify

menu.title.text.color

osd.bg.color

osd.border.color

osd.border.width

osd.label.text.color

osd.window-switcher.style-classic

osd.window-switcher.style-classic.width

osd.window-switcher.style-classic.padding

osd.window-switcher.style-classic.item.padding.x

osd.window-switcher.style-classic.item.padding.y

osd.window-switcher.style-classic.item.active.border.width

osd.window-switcher.style-classic.item.active.border.color

osd.window-switcher.style-classic.item.active.bg.color

osd.window-switcher.style-classic.item.icon.size

osd.window-switcher.style-thumbnail

osd.window-switcher.style-thumbnail.width.max

osd.window-switcher.style-thumbnail.padding

osd.window-switcher.style-thumbnail.item.width

osd.window-switcher.style-thumbnail.item.height

osd.window-switcher.style-thumbnail.item.padding

osd.window-switcher.style-thumbnail.item.active.border.width

osd.window-switcher.style-thumbnail.item.active.border.color

osd.window-switcher.style-thumbnail.item.active.bg.color

osd.window-switcher.style-thumbnail.item.icon.size

osd.window-switcher.preview.border.width

osd.window-switcher.preview.border.color

osd.workspace-switcher.boxes.width

osd.workspace-switcher.boxes.height

osd.workspace-switcher.boxes.border.width

snapping.overlay.region.bg.enabled [yes|no]

snapping.overlay.edge.bg.enabled [yes|no]

snapping.overlay.region.border.enabled [yes|no]

snapping.overlay.edge.border.enabled [yes|no]

snapping.overlay.region.bg.color

snapping.overlay.edge.bg.color

snapping.overlay.region.border.width

snapping.overlay.edge.border.width

snapping.overlay.region.border.color

snapping.overlay.edge.border.color

border.color

magnifier.border.width

magnifier.border.color

دکمه‌ها (BUTTONS)

تصاویر مورد استفاده برای آیکون‌های نوار عنوان، دکمه‌ها نامیده می‌شوند.

قالب‌های تصویری زیر پشتیبانی می‌شوند و به ترتیب اولویت جستجو فهرست شده‌اند:

• png
• svg
• xbm

به طور پیش‌فرض، دکمه‌ها فایل‌های ۱ بیتی xbm هستند. این‌ها ماسک‌هایی هستند که در آن‌ها 0 به معنی شفاف و 1 به معنای رنگی است. فایل‌های xbm در همان دایرکتوری حاوی فایل themerc در تم قرار می‌گیرند. دکمه‌های xbm زیر پشتیبانی می‌شوند:

• max.xbm
• iconify.xbm
• close.xbm
• menu.xbm
• max_toggled.xbm
• desk.xbm
• desk_toggled.xbm
• shade.xbm
• shade_toggled.xbm

آیکون‌های اضافی را می‌توان برای نمایش در هنگام قرار گرفتن نشانگر ماوس روی دکمه مورد نظر تعریف کرد:

• max_hover.xbm
• iconify_hover.xbm
• close_hover.xbm
• menu_hover.xbm
• max_toggled_hover.xbm
• desk_hover.xbm
• desk_toggle_hover.xbm
• shade_hover.xbm
• shade_toggle_hover.xbm

یک مزیت دکمه‌های xbm نسبت به سایر قالب‌ها این است که رنگ آن‌ها بر اساس تم تغییر می‌کند. قالب‌های دیگر از پسوندهای "-active" و "-inactive" برای هماهنگی با رنگ‌های نوار عنوان متناظر استفاده می‌کنند؛ مانند "close-active.png".

به دلایل سازگاری، نام‌های جایگزین زیر برای فایل‌های xbm پشتیبانی می‌شوند:

•

max_hover_toggled.xbm به جای max_toggled_hover.xbm

هنگام استفاده از آیکون‌های png یا svg، برای داشتن تجربه کامل یک تم، تمام آیکون‌های زیر باید اضافه شوند:

• close-active.[png|svg]
• close_hover-active.[png|svg]
• close_hover-inactive.[png|svg]
• close-inactive.[png|svg]
• iconify-active.[png|svg]
• iconify_hover-active.[png|svg]
• iconify_hover-inactive.[png|svg]
• iconify-inactive.[png|svg]
• max-active.[png|svg]
• max_hover-active.[png|svg]
• max_hover-inactive.[png|svg]
• max-inactive.[png|svg]
• max_toggled-active.[png|svg]
• max_toggled_hover-active.[png|svg]
• max_toggled_hover-inactive.[png|svg]
• max_toggled-inactive.[png|svg]
• menu-active.[png|svg]
• menu_hover-active.[png|svg]
• menu_hover-inactive.[png|svg]
• menu-inactive.[png|svg]
• shade-active.[png|svg]
• shade_hover-active.[png|svg]
• shade_hover-inactive.[png|svg]
• shade-inactive.[png|svg]
• shade_toggled-active.[png|svg]
• shade_toggled-inactive.[png|svg]
• shade_toggled_hover-active.[png|svg]
• shade_toggled_hover-inactive.[png|svg]
• desk-active.[png|svg]
• desk_hover-active.[png|svg]
• desk_hover-inactive.[png|svg]
• desk-inactive.[png|svg]
• desk_toggled-active.[png|svg]
• desk_toggled-inactive.[png|svg]
• desk_toggled_hover-active.[png|svg]
• desk_toggled_hover-inactive.[png|svg]

تعاریف (DEFINITIONS)

دستگیره (handle) تزئین لبه پنجره در پایین پنجره است.

همچنین ببینید (SEE ALSO)

labwc(1), labwc-config(5), labwc-actions(5)