نام (NAME)

fluxbox-apps - پیکربندی مشخصه‌های هر پنجره برای fluxbox(1)

خلاصه دستور (SYNOPSIS)

~/.fluxbox/apps

نحو (SYNTAX)

پارامترهای متغیر به صورت تأکیدی نشان داده شده‌اند: argument

تمام نویسه‌های دیگر نشان‌داده‌شده باید عیناً درج شوند. فضای خالی تنها برای جداسازی کلمات لازم است، اما افزودن فاصله‌های بیشتر بلامانع است.

توضیحات (DESCRIPTION)

می‌توان یک برنامه را مجبور کرد که هنگام اجرای اولیه همیشه ابعاد، موقعیت و سایر تنظیمات یکسانی داشته باشد. این تنظیمات در فایل ‘apps’ ذخیره می‌شوند.

بیشتر تنظیمات ساده را می‌توان با استفاده از زیرمنوی “Remember...” در منوی پنجره (که معمولاً با راست‌کلیک روی نوار عنوان باز می‌شود) ذخیره کرد. قابلیت‌های پیشرفته‌تر نیازمند ویرایش دستی فایل ‘apps’ هستند. این موارد می‌تواند شامل استفاده از بخش‌های گروه (GROUP SECTIONS) برای راه‌اندازی گروه‌های زبانه‌ای خودکار پنجره‌ها باشد.

پس از ویرایش فایل apps نیازی به بارگذاری مجدد (“reload”) در fluxbox ندارید؛ تغییرات هنگام باز شدن پنجرهٔ بعدی مجدداً بررسی خواهند شد.

این فایل از دو نوع بخش اصلی تشکیل شده است: برنامه‌ها (apps) و گروه‌ها (groups)، که جزئیات آن‌ها در ادامه آمده است.

بخش‌های برنامه (APP SECTIONS)

بخش‌های [app] تنظیماتی را برای پنجره‌های مجزای برنامه‌ها فراهم می‌کنند.

این بخش‌ها با خطی در قالب زیر آغاز می‌شوند:

[app](pattern){count}

مؤلفهٔ pattern می‌تواند یک یا چند الگو باشد که با پنجره‌ها مطابقت داده می‌شوند. برای جزئیات بیشتر، الگوهای کلاینت (CLIENT PATTERNS) را ببینید. اگر بیش از یک pattern تعیین کنید، برای اعمال تنظیمات باید همگی مطابقت داشته باشند.

مقدار {count} اختیاری است. اگر تعیین شود، این مدخل در هر لحظه حداکثر با همان تعداد پنجره مطابقت داده می‌شود. در صورت حذف، پیش‌فرض اعمال تنظیمات روی همهٔ پنجره‌های منطبق است.

پس از این خطِ آغازینِ [apps]، می‌توان هر تعداد تنظیمی را برای برنامه مشخص کرد. برای جزئیات بیشتر تنظیمات (SETTINGS) را ببینید.

هر یک از این بخش‌ها با تک‌خط زیر به پایان می‌رسد:

[end]

بخش‌های گذرا (TRANSIENT SECTIONS)

بخش‌های [transient] تنظیماتی را برای «کادرهای محاوره» (dialogs) فراهم می‌کنند.

این بخش مشابه بخش [app] است، اما برای پنجره‌های گذرا (transient) اعمال می‌شود. پنجره‌های گذرا دارای مشخصهٔ WM_TRANSIENT_FOR هستند. این مورد برای همهٔ پنجره‌های مودال و چندین محاورهٔ دیگر که دارای یک پنجرهٔ والد هستند و در بالای آن می‌مانند اعمال می‌شود. به ویژه، کادرهای محاوره‌ای باز کردن/ذخیره کردن (open/save) در این دسته قرار می‌گیرند.

بخش‌های گروه (GROUP SECTIONS)

هدف اصلی بخش‌های [group] گروه‌بندی پنجره‌ها با یکدیگر است. تمام پنجره‌های موجود در یک گروه به طور خودکار به صورت زبانه (تب) در کنار هم قرار می‌گیرند.

این بخش‌ها با خطی در قالب زیر آغاز می‌شوند:

[group](pattern)

که در آن مؤلفهٔ pattern اختیاری است. در صورت تعیین، این الگو باید مطابقت داشته باشد تا گروه اعمال شود. معمولاً در اینجا از الگوهای غیرمختص پنجره مانند (workspace) استفاده می‌شود. برای جزئیات بیشتر الگوهای کلاینت (CLIENT PATTERNS) را ببینید.

در ادامه هر تعداد خطِ [app] قرار می‌گیرد. این خطوط قالبی مشابه بخش [app] دارند که در بالا در بخش‌های برنامه (APP SECTIONS) توضیح داده شد، اما حاوی هیچ تنظیمی نیستند و خط [end] مربوطه را نیز ندارند.

مانند این:

[app](pattern)

این بخش همچنین می‌تواند شامل تنظیماتی باشد که روی تک‌تک پنجره‌های گروه اعمال می‌شوند. برای جزئیات، بخش تنظیمات (SETTINGS) را ببینید.

مانند بخش‌های [app]، هر یک از این بخش‌ها با تک‌خط زیر به پایان می‌رسد:

[end]

تنظیمات (SETTINGS)

این تنظیمات ممکن است در فایل ‘apps’ ذخیره شوند. خط تنظیمات باید درون یک بخش [app] یا [group] قرار گیرد.

قالب کلی به این صورت است:

[setting]{value}

تمامی مقادیر مجاز در زیر شرح داده شده‌اند، به جز bool که می‌تواند مقادیر yes یا no را داشته باشد که به ترتیب تنظیم مربوطه را فعال یا غیرفعال می‌کند.

[Workspace] {number}

برنامه را مجبور می‌کند روی فضای کاری شمارهٔ number مشخص‌شده باز شود. فضاهای کاری بر اساس شماره و با شروع از 0 تنظیم می‌شوند.

[Jump] {bool}

هنگام باز شدن برنامه، فضای کاری فعال را به فضای کاری به‌خاطرسپرده‌شده تغییر می‌دهد. این گزینه تنها زمانی کاربرد دارد که به همراه [Workspace] استفاده شود. مثال‌ها (EXAMPLES) را ببینید.

[Head] {number}

برنامه را مجبور می‌کند روی نمایشگر (head) شمارهٔ number مشخص‌شده باز شود (فقط در Xinerama).

[Layer] {number}

لایه‌ای را که پنجره باید در آن باز شود (با شماره) مشخص می‌کند. هر لایه یک شماره دارد. لایه‌های نام‌گذاری‌شده عبارتند از: 2-AboveDock، 4-Dock، 6-Top، 8-Normal، 10-Bottom، 12-Desktop.

[Dimensions] {width[%] height[%]}

برنامه را با width (عرض) و height (ارتفاع) مشخص‌شده بر حسب پیکسل باز می‌کند. اگر مقدار به صورت درصد داده شود، اندازهٔ پنجره بر اساس اندازهٔ صفحهٔ نمایش فعلی محاسبه خواهد شد.

[IgnoreSizeHints] {bool}

برخی از برنامه‌ها نسبت تصویر، یا حداقل و حداکثر اندازهٔ پنجره‌ها را محدود می‌کنند. تنظیم این کلید روی "yes" باعث می‌شود fluxbox از این محدودیت‌ها صرف‌نظر کند. توجه داشته باشید که پیاده‌سازی‌های نادرست کلاینت ممکن است وابستگی شدیدی به این محدودیت‌ها داشته باشند (مثلاً با استفادهٔ کورکورانه از هندسهٔ خود در محاسبات ناامن، باعث خطاهای تقسیم بر صفر، segfault و غیره شوند).

[Position] (anchor) {X[%] Y[%]}

پنجرهٔ برنامه را در یک نقطهٔ خاص قرار می‌دهد. به طور پیش‌فرض، گوشهٔ بالا-چپ در مختصات صفحه (X,Y) قرار می‌گیرد. اگر یک anchor تعیین کنید، مثلاً BottomRight، گوشهٔ پایین-راست پنجره در فاصلهٔ (X,Y) پیکسلی از گوشهٔ پایین-راست صفحه قرار می‌گیرد. اگر مقدار به صورت درصد داده شود، مختصات بر اساس اندازهٔ صفحهٔ فعلی محاسبه خواهد شد.

مقدار anchor می‌تواند یکی از موارد زیر باشد:

TopLeft Left BottomLeft Top Center Bottom TopRight Right BottomRight

[Deco] {value}

وضعیت تزیینات (decorations) را مشخص می‌کند. چندین مجموعه value از پیش تعریف‌شده وجود دارد:

NORMAL

تزیینات استاندارد

NONE

بدون تزیینات

BORDER

مانند NONE به جز اینکه حاشیه پنجرهٔ X حفظ می‌شود

TAB

مانند BORDER به جز اینکه زبانه‌های خارجی حفظ می‌شوند (در صورت فعال بودن)

TINY

نوار عنوان تنها با یک دکمهٔ کمینه‌سازی

TOOL

فقط نوار عنوان

مقدار value همچنین می‌تواند یک ماسک بیتی (bitmask) برای کنترل دقیق‌تر باشد. بیت‌ها از (1<<0) تا (1<<10) عبارتند از: Titlebar، Handle/Grips، Border، Iconify Button، Maximize Button، Close Button، Menu Button، Sticky Button، Shade Button، External Tabs، Focus Enabled.

[Shaded] {bool}

آیا پنجره به صورت کرکره‌ای جمع شده (رول‌شده) باشد یا خیر.

[Tab] {bool}

آیا پنجره زبانه‌ها (tabs) را فعال داشته باشد یا خیر.

[FocusNewWindow] {bool}

منسوخ شده! لطفاً به جای آن از FocusProtection با مقادیر "Gain" یا "Refuse" استفاده کنید.

در صورت فعال بودن، پنجرهٔ جدید به محض باز شدن فوکوس X را می‌گیرد. در صورت غیرفعال بودن، پنجرهٔ جدید به محض باز شدن فوکوس X را نخواهد گرفت.

[FocusProtection] {value [,value [, ...]] }

فهرستی از پرچم‌های کنترل فوکوس که با کاما از هم جدا شده‌اند. value می‌تواند موارد زیر باشد:

None

رفتار عادی

Gain

پنجرهٔ جدید به محض باز شدن فوکوس X را می‌گیرد.

Refuse

پنجرهٔ جدید به محض باز شدن فوکوس X را نمی‌گیرد.

Deny

پنجره مجاز نیست در زمانی که باز است فوکوس را تصاحب کند.

Lock

هیچ پنجره‌ای مجاز نیست فوکوس را در حالی که این پنجره آن را در اختیار دارد بگیرد.

لطفاً توجه داشته باشید که از نظر فنی، پنجره‌ها ممکن است همچنان فوکوس را به دست آورند که البته بعداً توسط مدیر پنجره (WM) لغو می‌شود. در صورتی که خیلی بدشانس باشید، یک رویداد کلید ممکن است به پنجرهٔ اشتباه ارسال شود.

[FocusHidden] {bool}

در صورت فعال بودن، پنجره در فهرست‌های NextWindow/PrevWindow ظاهر نخواهد شد.

[IconHidden] {bool}

در صورت فعال بودن، پنجره در ناحیهٔ آیکون نوار ابزار ظاهر نخواهد شد.

[Hidden] {bool}

یک میانبر برای تنظیم همزمان هر دو مورد FocusHidden و IconHidden.

[Sticky] {bool}

مشخص می‌کند که آیا برنامه باید چسبان باشد (در تمام فضاهای کاری نمایش داده شود) یا خیر.

[Minimized] {bool}

برنامه باید به صورت کمینه‌شده (minimized) شروع به کار کند.

[Maximized] {value}

برنامه باید به صورت بیشینه‌شده (maximized) شروع به کار کند. مقدار value می‌تواند یکی از موارد زیر باشد:

yes

کاملاً بیشینه‌شده

horz

بیشینه‌شده به صورت افقی

vert

بیشینه‌شده به صورت عمودی

no

بیشینه‌نشده

[Fullscreen] {bool}

برنامه باید در حالت تمام‌صفحه (کاملاً بیشینه‌شده بدون هیچ تزییناتی) شروع به کار کند.

[Close] {bool}

ذخیرهٔ تنظیمات هنگام بستن. به طور پیش‌فرض، تنظیمات برنامه هنگام بسته شدن پنجره به‌روزرسانی نمی‌شوند.

[Alpha] {value [value]}

تنظیم مقدار آلفا (شفافیت) برای این پنجره. اگر دو مقدار داده شود، به ترتیب نشان‌دهندهٔ شفافیت در حالت فوکوس و بدون فوکوس هستند. اگر تنها یک عدد مشخص شود، برای هر دو حالت استفاده خواهد شد. value یک عدد صحیح بین 0 تا 255 است.

الگوهای کلاینت (CLIENT PATTERNS)

یک pattern به این شکل است:

([propertyname[!]=]regexp) ...

تعاریف تطابق در پرانتزهای (...) قرار می‌گیرند، و اگر هیچ propertyname داده نشود، مقدار پیش‌فرض Name فرض می‌شود. مؤلفهٔ regexp می‌تواند شامل هر عبارت باقاعده‌ای باشد، یا مقدار ویژهٔ [current] که با مقدار متناظر پنجره‌ای که در حال حاضر دارای فوکوس است مطابقت دارد. برای اطلاعات بیشتر در مورد عبارات باقاعدهٔ قابل قبول، regex(7) را ببینید.

مؤلفهٔ propertyname به حروف بزرگ و کوچک حساس نیست، در حالی که regexp حساس است.

اگر چندین آرگومان (pattern) تعیین کنید، این به معنای شرط AND (و) است؛ یعنی تمام الگوهای مشخص‌شده باید مطابقت داشته باشند.

می‌توانید از = برای بررسی برابری یا از != برای بررسی نابرابری استفاده کنید.

مقادیر زیر برای propertyname پذیرفته می‌شوند:

Name

یک رشته، متناظر با مشخصهٔ CLASSNAME (فیلد اول WM_CLASS در خروجی ابزار xprop(1)).

Class

یک رشته، متناظر با مشخصهٔ CLASSCLASS (فیلد دوم WM_CLASS در خروجی ابزار xprop(1)).

Title

یک رشته، متناظر با عنوان پنجره (WM_NAME از xprop(1)).

Role

یک رشته، متناظر با مشخصهٔ ROLE (مقدار WM_WINDOW_ROLE از xprop(1)).

Transient

مقدار yes یا no، بسته به اینکه پنجره گذرا است (معمولاً یک کادر محاوره‌ای پاپ‌آپ) یا خیر.

Maximized

مقدار yes یا no، بسته به اینکه پنجره بیشینه‌شده است یا خیر.

MaximizedHorizontal

مقدار yes یا no، بسته به اینکه پنجره به صورت افقی بیشینه‌شده است یا خیر.

MaximizedVertical

مقدار yes یا no، بسته به اینکه پنجره به صورت عمودی بیشینه‌شده است یا خیر.

Minimized

مقدار yes یا no، بسته به اینکه پنجره کمینه (آیکون) شده است یا خیر.

Fullscreen

مقدار yes یا no، بسته به اینکه پنجره تمام‌صفحه است یا خیر.

Shaded

مقدار yes یا no، بسته به اینکه پنجره کرکره‌ای (جمع‌شده) است یا خیر.

Stuck

مقدار yes یا no، بسته به اینکه پنجره چسبان (در تمام فضاهای کاری) است یا خیر.

FocusHidden

مقدار yes یا no، بسته به اینکه آیا پنجره درخواست کرده است که از فهرست فوکوس (یا فهرست alt-tab) حذف شود یا خیر.

IconHidden

مقدار yes یا no، بسته به اینکه آیا پنجره درخواست کرده است که از فهرست آیکون‌ها (یا نوار وظیفه) حذف شود یا خیر.

Urgent

مقدار yes یا no، بسته به اینکه آیا پرچم فوریت (urgent hint) پنجره تنظیم شده است یا خیر.

Workspace

شماره‌ای متناظر با شمارهٔ فضای کاری که پنجره به آن متصل است. اولین فضای کاری در اینجا 0 است. همچنین می‌توانید از [current] برای تطابق با فضای کاری فعلیِ قابل مشاهده استفاده کنید.

WorkspaceName

رشته‌ای متناظر با نام فضای کاری که پنجره به آن متصل است.

Head

شمارهٔ نمایشگری (head) که پنجره به آن متصل است. می‌توانید این مورد را با مقدار ویژهٔ [mouse] مطابقت دهید که به نمایشگری که اشاره‌گر ماوس در حال حاضر در آن قرار دارد اشاره می‌کند.

Layer

نام رشته‌ای لایهٔ پنجره که یکی از موارد زیر است: AboveDock، Dock، Top، Normal، Bottom، Desktop

Screen

شمارهٔ صفحهٔ نمایش ( screen ) فعلی مورد استفاده. اگر راه‌اندازی سرور x در حال اجرا شامل صفحه‌های مستقل باشد (not Xinerama)، متغیر محیطی $DISPLAY شامل مقادیری مانند :0.1 یا :1.0 خواهد بود. بخش بعد از نقطه (.) شمارهٔ صفحهٔ نمایش است.

@XPROP

یک رشته، متناظر با هر مشخصهٔ x (برای تنظیم یک مشخصهٔ x روی یک پنجره، از ابزار xprop(1) یا دستور SetXProp استفاده کنید)

تطابق با هر پنجره‌ای که دارای CLASSNAME برابر با "xterm" است.

(xterm)

تطابق با هر پنجره‌ای که دارای CLASSNAME یکسان با پنجرهٔ دارای فوکوس فعلی باشد.

(Name=[current])

تطابق با هر پنجره‌ای که روی همان نمایشگر ماوس قرار دارد اما در لایه‌ای متفاوت از پنجرهٔ دارای فوکوس فعلی است.

(Head=[mouse]) (Layer!=[current])

تطابق با هر پنجره‌ای که دارای یک مشخصهٔ x به نام FOO باشد که شامل "bar" است.

(@FOO=.*bar.*)

فایل‌ها (FILES)

~/.fluxbox/apps

این مکان پیش‌فرض برای ذخیرهٔ تنظیمات برنامه است.

منابع (RESOURCES)

session.appsFile: location

این مورد می‌تواند برای لغو مکان پیش‌فرض فایل تنظیمات برنامه تنظیم شود.

مثال‌ها (EXAMPLES)

در اینجا چند مثال جالب و/یا کاربردی آورده شده است که می‌توانید با فایل apps خود انجام دهید.

# قرار دادن دو پنجره اولی که نام آن‌ها با 'term' پایان می‌یابد در فضای کاری 1
[app] (name=.*[tT]erm) {2}
  [Workspace]   {1}
[end]
# در مرکز قرار دادن kate با اندازه‌ای مشخص، و به‌روزرسانی این مقادیر هنگام بسته شدن پنجره.
[app] (name=kate)
  [Dimensions]  {1022 747}
  [Position]    (CENTER) {0 0}
  [Close]       {yes}
[end]
# هنگام اجرای konqueror، ابتدا به فضای کاری 1 برود و آن را در آنجا باز کند.
[app] (name=konqueror)
  [Workspace]   {1}
  [Jump]        {yes}
[end]
# اجرای تمام پنجره‌های aterm بدون تزیینات
[app] (name=aterm)
  [Deco]        {NONE}
[end]
# یک گروه شامل dock و toolbox مربوط به gimp
# در لایه 4 (پایین) نمایش داده می‌شود
[group]
  [app] (name=gimp) (role=gimp-dock)
  [app] (name=gimp) (role=gimp-toolbox)
  [Layer]       {4}
[end]

نویسندگان (AUTHORS)

•Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0)

•Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11)

•Tobias Klausmann <klausman at users sourceforge net> (⟨fluxbox-0.9.11)

•Grubert <grubert at users sourceforge net> (fluxbox)

•Matthew Hawkins <matt at mh dropbear id au> (blackbox)

•Wilbert Berendsen <wbsoft at xs4all nl> (blackbox)

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

fluxbox(1) xprop(1) regex(7)

نویسنده (AUTHOR)

Jim Ramsay <i.am@jimramsay.com>

نویسنده.