labwc-theme(5) File Formats Manual labwc-theme(5) نام (NAME) labwc-theme - فایل‌های تم در مدیر پنجره labwc تم (THEME) موتور تم با هدف سازگاری با openbox طراحی شده است و تم‌ها به ترتیب زیر جستجو خواهند شد: • ${XDG_DATA_HOME:-$HOME/.local/share}/themes//labwc/ • $HOME/.themes//labwc/ • /usr/share/themes//labwc/ • /usr/local/share/themes//labwc/ • /opt/share/themes//labwc/ • ${XDG_DATA_HOME:-$HOME/.local/share}/themes//openbox-3/ • $HOME/.themes//openbox-3/ • /usr/share/themes//openbox-3/ • /usr/local/share/themes//openbox-3/ • /opt/share/themes//openbox-3/ هنگامی که متغیر $XDG_DATA_HOME تعریف شده باشد، جایگزین مسیر $HOME/.local/share می‌شود (نه اینکه به آن افزوده شود). همین وضعیت برای $XDG_DATA_DIRS و /usr/share/ نیز برقرار است. انتخاب تم با ویرایش کلید در بخش از فایل پیکربندی rc.xml انجام می‌پذیرد (به labwc-config(5) مراجعه کنید). یک تم شامل یک فایل themerc و در صورت تمایل تعدادی آیکون نوار عنوان (تحت عنوان دکمه‌ها یا buttons) است. تنظیمات تم مشخص‌شده در themerc را می‌توان با ایجاد فایلی به نام 'themerc-override' در دایرکتوری پیکربندی بازنویسی کرد؛ این دایرکتوری معمولاً $HOME/.config/labwc/ است اما می‌تواند مطابق با توضیحات labwc-config(5) در مکان‌های دیگری نیز باشد. انواع داده (DATA TYPES) color رنگ‌ها را می‌توان با نام یا با مقادیر هگزادسیمال قرمز-سبز-آبی (RGB) مشخص کرد: عبارت color name به "نام رنگ X11" اشاره دارد، مانند: 'white'، 'grey40'، 'pink' و 'peach puff'. اطلاعات بیشتر را می‌توانید در اینجا بیابید: • • • مقدار RGB (RGB value) • #rrggbb (مقادیر هگزادسیمال RGB) • #rrggbb aaa (مشابه حالت قبل به همراه درصد اعشاری آلفا) • #rrggbbaa (مشابه حالت قبل با مقدار آلفا در کدگذاری هگزادسیمال) • #rgb (مقادیر هگزادسیمال RGB که در آن #fff فرم کوتاه #f0f0f0 است) (از نسخه 0.9.0) نکته: نمادگذاری #rrggbb aaa از نسخه 0.7.2 به بعد منسوخ شده و ممکن است در نسخه‌های بعدی حذف شود. justification تراز افقی متن را تعیین می‌کند. گزینه‌های معتبر عبارتند از Left (چپ)، Center (وسط) و Right (راست). textures بافت‌ها ظاهر بصری یک عنصر را تعیین می‌کنند. آن‌ها از طریق یک رشته متنی با تعدادی فیلد مشخص می‌شوند. حروف کوچک و بزرگ تفاوتی ندارند. ساختار به شرح زیر است: (Solid | Gradient ) که در آن | به معنای "یا" است. • گزینه Solid به این معناست که پس‌زمینه بافت با یک رنگ ثابت پر می‌شود. این بافت باید با یک فیلد رنگی همراه باشد؛ برای نمونه: window.*.title.bg: Solid window.*.title.bg.color: #f8f5f2 • گزینه Gradient به این معناست که پس‌زمینه بافت با یک گرادیان از یک رنگ به رنگ دیگر پر می‌شود. هنگام تعیین Gradient، باید نوع گرادیان بلافاصله پس از آن بیاید. همچنین باید همراه با فیلدهای color و colorTo باشد. انواع معتبر گرادیان عبارتند از: (1) Vertical که در آن گرادیان از لبه بالا به پایین حرکت می‌کند (2) SplitVertical که در آن گرادیان در وسط تقسیم شده و به سمت لبه‌های بالا و پایین حرکت می‌کند. گرادیان‌های SplitVertical دارای دو فیلد رنگی اختیاری اضافی هستند: color.splitTo و colorTo.splitTo. این رنگ‌ها رنگ‌های روشنی هستند که در بالاترین و پایین‌ترین نقاط گرادیان SplitVertical به کار می‌روند. در صورت حذف این موارد، مقادیر پیش‌فرض برای آن‌ها به ترتیب برابر با color x 5/4 و colorTo x 17/16 خواهد بود. نمونه‌ها: # 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 عرض خط (عدد صحیح) حاشیه کشیده‌شده در اطراف کادرهای پنجره. مقدار پیش‌فرض 1 است. window.titlebar.padding.width اندازه فاصله درونی (padding) افقی نوار عنوان به پیکسل، بین حاشیه و اولین دکمه در سمت چپ/راست. پیش‌فرض 0 است. window.titlebar.padding.height اندازه فاصله درونی عمودی نوار عنوان به پیکسل. پیش‌فرض 0 است. window.active.border.color رنگ حاشیه پنجره فعال. پیش‌فرض #aaaaaa است. window.inactive.border.color رنگ حاشیه پنجره غیرفعال. پیش‌فرض #aaaaaa است. window.active.indicator.toggled-keybind.color نشانگر وضعیت برای اقدام ToggleKeybinds. می‌توان آن را روی همان مقداری که برای window.active.border.color تعیین شده قرار داد تا نشانگر غیرفعال شود. پیش‌فرض #ff0000 است. window.active.title.bg بافت نوار عنوان پنجره دارای فوکوس. به بخش بافت‌ها در بالا مراجعه کنید. پیش‌فرض Solid است. window.active.title.bg.color رنگ پس‌زمینه نوار عنوان پنجره دارای فوکوس. پیش‌فرض #e1dedb است. window.inactive.title.bg بافت نوار عنوان پنجره‌های بدون فوکوس. پیش‌فرض Solid است. window.inactive.title.bg.color رنگ پس‌زمینه نوار عنوان پنجره‌های بدون فوکوس. پیش‌فرض #f6f5f4 است. window.active.label.text.color رنگ متن نوار عنوان پنجره دارای فوکوس. پیش‌فرض #000000 است. window.inactive.label.text.color رنگ متن نوار عنوان پنجره‌های بدون فوکوس. پیش‌فرض #000000 است. window.label.text.justify نحوه تراز شدن عنوان پنجره در نوار عنوان را برای هر دو حالت دارای فوکوس و بدون فوکوس تعیین می‌کند. از نوع justification است. پیش‌فرض Center می‌باشد. window.button.width عرض دکمه نوار عنوان به پیکسل. پیش‌فرض 26 است. window.button.height ارتفاع دکمه نوار عنوان به پیکسل. پیش‌فرض 26 است. window.button.spacing فاصله میان دکمه‌های نوار عنوان به پیکسل. پیش‌فرض 0 است. نکته: فضانام window.button.hover (در ادامه) به جلوه‌های هم‌پوشانی هاور (hover) دکمه‌ها مربوط می‌شود که با تمام دکمه‌ها از جمله svg، png و xbm کار می‌کند. جلوه‌های window.button.hover تنها در صورتی نمایش داده می‌شوند که آیکون هاور متناظری مانند close_hover-active.svg وجود نداشته باشد. ابزار Openbox تنها از جلوه‌های هاور که در پشت دکمه‌ها رندر می‌شوند پشتیبانی می‌کند که برای قالب xbm معقول است اما برای سایر قالب‌ها خیر. window.button.hover.bg.color رنگ جلوه هاور دکمه نوار عنوان. پیش‌فرض #80808020 است. window.button.hover.bg.corner-radius شعاع گوشه (radius) جلوه هاور دکمه نوار عنوان به پیکسل. پیش‌فرض 0 است. نکته: برای داشتن جلوه هاور دایره‌ای، مقادیر window.button.width و window.button.height را برابر قرار داده و مقدار window.button.hover.bg.corner-radius را نصف آن‌ها تعیین کنید. window.active.button.unpressed.image.color رنگ تصاویر در دکمه‌های نوار عنوان در وضعیت پیش‌فرض فشرده‌نشده. این عنصر مختص پنجره دارای فوکوس است. پیش‌فرض #000000 می‌باشد. window.inactive.button.unpressed.image.color رنگ تصاویر در دکمه‌های نوار عنوان در وضعیت پیش‌فرض فشرده‌نشده برای پنجره‌های بدون فوکوس. پیش‌فرض #000000 است. نکته: عناصر دکمه‌ها را می‌توان برای هر نوع دکمه ("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 اندازه سایه (drop-shadow) پنجره دارای فوکوس به پیکسل. پیش‌فرض 60 است. window.inactive.shadow.size اندازه سایه پنجره‌های بدون فوکوس به پیکسل. پیش‌فرض 40 است. window.active.shadow.color رنگ سایه پنجره دارای فوکوس، شامل میزان شفافیت (opacity). پیش‌فرض #00000060 (مشکی با ۳۸٪ شفافیت) است. window.inactive.shadow.color رنگ سایه پنجره‌های بدون فوکوس، شامل میزان شفافیت. پیش‌فرض #00000040 (مشکی با ۲۵٪ شفافیت) است. menu.overlap.x هم‌پوشانی افقی به پیکسل میان زیرمنوها و منوهای والد آنها. مقدار مثبت زیرمنوها را روی منوی والد می‌کشد، در حالی که مقدار منفی فاصله‌ای میان زیرمنوها و منوی والد ایجاد می‌کند. پیش‌فرض 0 است. menu.overlap.y آفست عمودی به پیکسل میان زیرمنوها و والدین آنها؛ مقادیر مثبت به سمت پایین و منفی به سمت بالا. پیش‌فرض 0 است. menu.width.min حداقل عرض منوها. پیش‌فرض 20 است. عرض ثابت را می‌توان با تنظیم مقادیر یکسان برای min. و max. به دست آورد. menu.width.max حداکثر عرض منوها. پیش‌فرض 200 است. menu.border.width عرض حاشیه منوها به پیکسل. در صورت عدم تنظیم، از border.width ارث‌بری می‌کند. menu.border.color رنگ حاشیه منوها. در صورت عدم تنظیم، از window.active.border.color ارث‌بری می‌کند. menu.items.padding.x فاصله درونی افقی مدخل‌های متنی منو به پیکسل. پیش‌فرض 7 است. menu.items.padding.y فاصله درونی عمودی مدخل‌های متنی منو به پیکسل. پیش‌فرض 4 است. menu.items.bg.color رنگ پس‌زمینه آیتم‌های غیرفعال منو. پیش‌فرض #fcfbfa است. menu.items.text.color رنگ متن آیتم‌های غیرفعال منو. پیش‌فرض #000000 است. menu.items.active.bg.color رنگ پس‌زمینه آیتم‌های فعال منو. پیش‌فرض #e1dedb است. menu.items.active.text.color رنگ متن آیتم‌های فعال منو. پیش‌فرض #000000 است. menu.separator.width ضخامت خط جداکننده‌های منو. پیش‌فرض 1 است. menu.separator.padding.width فضای سمت چپ و راست هر خط جداکننده. پیش‌فرض 6 است. menu.separator.padding.height فضای بالا و پایین هر خط جداکننده. پیش‌فرض 3 است. menu.separator.color رنگ جداکننده منو. پیش‌فرض #888888 است. menu.title.bg.color رنگ عنوان منو. پیش‌فرض #589bda است. نکته: عنوان منو یک خط جداکننده همراه با برچسب است. menu.title.text.justify نحوه تراز شدن عنوان‌های منو را تعیین می‌کند. نوع justification. پیش‌فرض Center است. menu.title.text.color رنگ متن برچسب جداکننده. پیش‌فرض #ffffff است. osd.bg.color رنگ پس‌زمینه نمایش روی صفحه (OSD). در صورت عدم تنظیم از window.active.title.bg.color ارث‌بری می‌کند. osd.border.color رنگ حاشیه نمایش روی صفحه. در صورت عدم تنظیم از osd.label.text.color ارث‌بری می‌کند. osd.border.width عرض حاشیه نمایش روی صفحه. در صورت عدم تنظیم از border.width ارث‌بری می‌کند. osd.label.text.color رنگ متن نمایش روی صفحه. در صورت عدم تنظیم از window.active.label.text.color ارث‌بری می‌کند. osd.window-switcher.style-classic تم برای تعویض‌کننده پنجره هنگام استفاده از . osd.window-switcher.style-classic.width عرض تعویض‌کننده پنجره به پیکسل. می‌تواند درصدی از عرض نمایشگر با پسوند '%' نیز باشد (مانند 70%). پیش‌فرض 600 است. osd.window-switcher.style-classic.padding فاصله درونی تعویض‌کننده پنجره به پیکسل. پیش‌فرض 4 است. osd.window-switcher.style-classic.item.padding.x فاصله درونی افقی مدخل‌های تعویض‌کننده پنجره به پیکسل. پیش‌فرض 10 است. osd.window-switcher.style-classic.item.padding.y فاصله درونی عمودی مدخل‌های تعویض‌کننده پنجره به پیکسل. پیش‌فرض 1 است. osd.window-switcher.style-classic.item.active.border.width عرض حاشیه کادر انتخاب در تعویض‌کننده پنجره به پیکسل. پیش‌فرض 2 است. osd.window-switcher.style-classic.item.active.border.color رنگ حاشیه اطراف آیتم انتخاب‌شده تعویض‌کننده پنجره. پیش‌فرض osd.label.text.color با ۵۰٪ شفافیت است. osd.window-switcher.style-classic.item.active.bg.color رنگ پس‌زمینه آیتم انتخاب‌شده در تعویض‌کننده پنجره. پیش‌فرض osd.label.text.color با ۱۵٪ شفافیت است. osd.window-switcher.style-classic.item.icon.size اندازه آیکون در تعویض‌کننده پنجره به پیکسل. در صورت عدم تنظیم، از اندازه فونت استخراج‌شده استفاده می‌شود. osd.window-switcher.style-thumbnail تم برای تعویض‌کننده پنجره هنگام استفاده از . osd.window-switcher.style-thumbnail.width.max حداکثر عرض تعویض‌کننده پنجره به پیکسل یا درصد. پیش‌فرض 80% است. osd.window-switcher.style-thumbnail.padding فاصله درونی تعویض‌کننده پنجره به پیکسل. پیش‌فرض 4 است. osd.window-switcher.style-thumbnail.item.width عرض آیتم‌های تعویض‌کننده پنجره به پیکسل. پیش‌فرض 300 است. osd.window-switcher.style-thumbnail.item.height ارتفاع آیتم‌های تعویض‌کننده پنجره به پیکسل. پیش‌فرض 250 است. osd.window-switcher.style-thumbnail.item.padding فاصله درونی آیتم‌های تعویض‌کننده پنجره به پیکسل. پیش‌فرض 2 است. osd.window-switcher.style-thumbnail.item.active.border.width عرض حاشیه آیتم‌های انتخاب‌شده تعویض‌کننده پنجره به پیکسل. پیش‌فرض 2 است. osd.window-switcher.style-thumbnail.item.active.border.color رنگ حاشیه اطراف آیتم‌های انتخاب‌شده تعویض‌کننده پنجره. پیش‌فرض osd.label.text.color با ۵۰٪ شفافیت است. osd.window-switcher.style-thumbnail.item.active.bg.color رنگ آیتم‌های انتخاب‌شده تعویض‌کننده پنجره. پیش‌فرض osd.label.text.color با ۱۵٪ شفافیت است. osd.window-switcher.style-thumbnail.item.icon.size اندازه آیکون‌های پنجره در آیتم‌های تعویض‌کننده پنجره به پیکسل. پیش‌فرض 60 است. osd.window-switcher.preview.border.width عرض حاشیه طرح کلی نشان‌داده‌شده به عنوان پیش‌نمایش پنجره انتخاب‌شده. پیش‌فرض ارث‌بری از osd.border.width است. osd.window-switcher.preview.border.color رنگ(های) طرح کلی نشان‌داده‌شده به عنوان پیش‌نمایش پنجره انتخاب‌شده توسط تعویض‌کننده پنجره. مقدار می‌تواند یک رنگ یا حداکثر ۳ رنگ جداشده با کاما باشد (مانند "#ffffff,#000000,#ffffff"). osd.workspace-switcher.boxes.width عرض جعبه‌ها در تعویض‌کننده فضای کاری به پیکسل. تنظیم روی 0 جعبه‌ها را غیرفعال می‌کند. پیش‌فرض 20 است. osd.workspace-switcher.boxes.height ارتفاع جعبه‌ها در تعویض‌کننده فضای کاری به پیکسل. پیش‌فرض 20 است. osd.workspace-switcher.boxes.border.width عرض حاشیه جعبه‌ها در تعویض‌کننده فضای کاری به پیکسل. پیش‌فرض 2 است. snapping.overlay.region.bg.enabled [yes|no] نمایش یک مستطیل توپر به عنوان هم‌پوشانی هنگام چفت شدن (snap) پنجره به یک ناحیه. پیش‌فرض yes برای رندرهای سخت‌افزاری و no برای رندرهای نرم‌افزاری است. snapping.overlay.edge.bg.enabled [yes|no] نمایش یک مستطیل توپر هنگام چفت شدن پنجره به یک لبه. snapping.overlay.region.border.enabled [yes|no] نمایش یک مستطیل توخالی (دارای خط حاشیه) به عنوان هم‌پوشانی هنگام چفت شدن پنجره به یک ناحیه. پیش‌فرض no برای سخت‌افزاری و yes برای نرم‌افزاری است. snapping.overlay.edge.border.enabled [yes|no] نمایش یک مستطیل توخالی هنگام چفت شدن پنجره به یک لبه. snapping.overlay.region.bg.color رنگ مستطیل توپر هنگام چفت شدن پنجره به یک ناحیه. پیش‌فرض #8080b380 است. snapping.overlay.edge.bg.color رنگ مستطیل توپر هنگام چفت شدن پنجره به یک لبه. پیش‌فرض #8080b380 است. snapping.overlay.region.border.width عرض حاشیه مستطیل توخالی هنگام چفت شدن پنجره به یک ناحیه. در صورت عدم تنظیم از osd.border.width ارث‌بری می‌کند. snapping.overlay.edge.border.width عرض حاشیه مستطیل توخالی هنگام چفت شدن پنجره به یک لبه. snapping.overlay.region.border.color رنگ(های) مستطیل توخالی هنگام چفت شدن پنجره به یک ناحیه. snapping.overlay.edge.border.color رنگ(های) مستطیل توخالی هنگام چفت شدن پنجره به یک لبه. border.color تنظیم همزمان window.active.border.color و window.inactive.border.color. این گزینه منسوخ است اما برای سازگاری با تم‌های قدیمی‌تر پشتیبانی می‌شود. magnifier.border.width عرض حاشیه پنجره ذره‌بین به پیکسل. پیش‌فرض 1 است. magnifier.border.color رنگ حاشیه پنجره ذره‌بین. پیش‌فرض #ff0000 (قرمز) است. دکمه‌ها (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) 2026-08-22 labwc-theme(5)