نام (NAME)

devilspie - اجرای عملیات روی پنجره‌ها به هنگام ایجاد شدن آن‌ها

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

devilspie [گزینه‌ها]... [فایل‌های-پیکربندی...]

توضیحات (DESCRIPTION)

devilspie برنامه‌ای است که می‌تواند پنجره‌ها را هنگام ایجاد شدن شناسایی کرده و در صورت مطابقت با مجموعه‌ای از معیارها، عملیاتی را روی آن‌ها انجام دهد.

فایل‌های پیکربندی مجموعه‌ای از عبارت‌های نمادین (s-expressions) هستند. برای مستندات و مثال‌ها، به مسیر /usr/share/doc/devilspie مراجعه کنید.

گزینه‌های خط فرمان:

-a --apply-to-existing: اعمال روی تمام پنجره‌های موجود به جای اعمال فقط روی پنجره‌های جدید.
-d --debug: نمایش خروجی اطلاعات اشکال‌زدایی.
-l --list-symbols: فهرست کردن نمادهای موجود و پشتیبانی‌شده در فایل‌های ورودی.
-s symname --symbol-doc=symname: دریافت راهنمای دقیق درباره نماد symname (مقدار 'all' برای تمام نمادها).

نمادهای مجاز (ALLOWED SYMBOLS)

در فایل‌های ورودی، نمادهای زیر توسط devilspie شناخته می‌شوند:

is: برابری رشته‌ها؛ دستور (is a b) به این معناست که a با b یکسان است.
contains: زیررشته؛ دستور (contains haystack needle) به این معناست که haystack شامل needle است.
matches: تطابق با عبارت منظم (Regexp)؛ دستور (matches str pattern) یعنی الگوی عبارت منظم با str مطابقت دارد.
window_name: عنوان پنجره جاری را برمی‌گرداند (رشته).
window_role: نقش پنجره جاری (تعیین‌شده با راهنمای WM_WINDOW_ROLE) را برمی‌گرداند (رشته).
window_class: کلاس پنجره جاری را برمی‌گرداند (رشته).
window_xid: شناسه پنجره X11 پنجره جاری را برمی‌گرداند (عدد صحیح).
application_name: نام برنامه پنجره جاری (تعیین‌شده توسط libwnck) را برمی‌گرداند (رشته).
window_property: ویژگی داده‌شده از پنجره را برمی‌گرداند؛ برای مثال ارسال "_NET_WM_STATE" (رشته).
window_workspace: فضای کاری که پنجره در آن قرار دارد را برمی‌گرداند (عدد صحیح).
debug: تابع اشکال‌زدایی؛ عنوان، نام، نقش و ابعاد و موقعیت (geometry) پنجره جاری را در خروجی چاپ می‌کند (مقدار TRUE را برمی‌گرداند).
print: چاپ آرگومان‌ها (بدون کاراکتر خط جدید \n پایانی، مقدار بولی برمی‌گرداند).
println: چاپ آرگومان‌ها (همراه با کاراکتر خط جدید \n پایانی، مقدار بولی برمی‌گرداند).
str: تبدیل پارامترها به رشته و الحاق آن‌ها به یکدیگر.
hex: تبدیل پارامتر عدد صحیح به یک رشته هگزادسیمال بدون علامت (با پیشوند 0x).
geometry: تنظیم موقعیت و اندازه پنجره جاری (به صورت رشته) (مقدار بولی برمی‌گرداند).
fullscreen: تمام‌صفحه کردن پنجره جاری (مقدار TRUE را برمی‌گرداند).
focus: فوکوس کردن روی پنجره جاری (مقدار TRUE را برمی‌گرداند).
center: قرار دادن پنجره جاری در مرکز صفحه (مقدار بولی برمی‌گرداند).
maximize: بزرگ‌نمایی کامل (بیشینه‌سازی) پنجره جاری (مقدار TRUE را برمی‌گرداند).
maximize_vertically: بزرگ‌نمایی عمودی پنجره جاری (مقدار TRUE را برمی‌گرداند).
maximize_horizontally: بزرگ‌نمایی افقی پنجره جاری (مقدار TRUE را برمی‌گرداند).
unmaximize: خروج پنجره جاری از حالت بیشینه (مقدار TRUE را برمی‌گرداند).
minimize: کمینه‌سازی پنجره جاری (مقدار TRUE را برمی‌گرداند).
unminimize: خروج پنجره جاری از حالت کمینه (مقدار TRUE را برمی‌گرداند).
shade: جمع کردن پنجره جاری به سمت بالا («roll up») (مقدار TRUE را برمی‌گرداند).
unshade: باز کردن پنجره جاری به سمت پایین («roll down») (مقدار TRUE را برمی‌گرداند).
close: بستن پنجره جاری (مقدار TRUE را برمی‌گرداند).
pin: سنجاق کردن پنجره جاری به تمام فضاهای کاری (مقدار TRUE را برمی‌گرداند).
unpin: برداشتن سنجاق پنجره جاری از تمام فضاهای کاری (مقدار TRUE را برمی‌گرداند).
stick: چسباندن پنجره جاری به تمام درگاه‌های دید (viewports) (مقدار TRUE را برمی‌گرداند).
unstick: جدا کردن پنجره از درگاه‌های دید (مقدار TRUE را برمی‌گرداند).
set_workspace: انتقال پنجره به شماره فضای کاری مشخص، با شمارش از ۱ (مقدار بولی برمی‌گرداند).
set_viewport: انتقال پنجره به شماره درگاه دید (viewport) مشخص، با شمارش از ۱ (مقدار بولی برمی‌گرداند).
skip_pager: حذف پنجره جاری از فهرست پنجره‌ها (مقدار TRUE را برمی‌گرداند).
skip_tasklist: حذف پنجره جاری از پیجر (نمایش‌دهنده فضای کاری) (مقدار TRUE را برمی‌گرداند).
above: قرار دادن پنجره جاری بالاتر از همه پنجره‌های عادی (مقدار TRUE را برمی‌گرداند).
below: قرار دادن پنجره جاری پایین‌تر از همه پنجره‌های عادی (مقدار TRUE را برمی‌گرداند).
decorate: افزودن تزیینات و حاشیه‌های مدیر پنجره به پنجره جاری (مقدار بولی برمی‌گرداند).
undecorate: حذف تزیینات و حاشیه‌های مدیر پنجره از پنجره جاری (مقدار بولی برمی‌گرداند).
wintype: تنظیم نوع پنجره برای پنجره جاری (مقدار بولی برمی‌گرداند). مقادیر پذیرفته‌شده عبارتند از: normal، dialog، menu، toolbar، splashscreen، utility، dock، desktop.
opacity: تغییر میزان کدر بودن و شفافیت (به صورت عدد صحیح بین ۰ تا ۱۰۰) پنجره جاری (مقدار بولی برمی‌گرداند).
spawn_async: اجرای یک دستور در پس‌زمینه (مقدار بولی برمی‌گرداند). دستور به صورت یک رشته منفرد یا مجموعه‌ای از رشته‌ها (مشابه با execl) داده می‌شود.
spawn_sync: اجرای یک دستور در پیش‌زمینه (خروجی دستور را به صورت رشته برمی‌گرداند، یا در صورت بروز خطا مقدار FALSE). دستور به صورت یک رشته منفرد یا مجموعه‌ای از رشته‌ها (مشابه با execl) داده می‌شود.

اشکالات (BUGS)

این صفحه راهنما تقریباً بی‌استفاده است، زیرا با عجله درون یک قطار سرهم‌بندی شده است.

نویسنده (AUTHOR)

این صفحه راهنما توسط Ross Burton <ross@burtonini.com> نوشته شده است.