نام (NAME)

urclock - ساعت و یادآور قرار ملاقات برای سامانه پنجره X11

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

urclock [گزینه‌ها]

توضیحات (DESCRIPTION)

urclock -- نسخه 9.31 -- یک ساعت عقربه‌ای (آنالوگ) برای X است که به عنوان جایگزینی کم‌مصرف در حافظه برای xclock(1) طراحی شده و دارای قابلیت‌های بیشتری است: urclock در صورت وجود نامه الکترونیکی منتظر، رنگ‌های تصویر را معکوس می‌کند؛ همچنین دارای یک سیستم یادآور قرار ملاقات درون‌ساخت است.

گزینه‌ها (OPTIONS)

گزینه‌های پشتیبانی‌شده توسط urclock:

-display displayname: تلاش برای باز کردن پنجره روی نمایشگر X مشخص‌شده. در صورت عدم تعیین این گزینه، از نمایشگر تعیین‌شده در متغیر محیطی "DISPLAY" استفاده می‌شود.
-geometry geom: ایجاد پنجره با موقعیت و ابعاد هندسی مشخص‌شده برای پنجره X [پیش‌فرض "80x80"].
-bg color: رنگ پس‌زمینه پنجره [پیش‌فرض "white"].
-fg color: رنگ پیش‌زمینه پنجره [پیش‌فرض "black"].
-fn fontname: انتخاب قلم مورد استفاده برای یادآورها [پیش‌فرض "7x14"].
-nodate: عدم نمایش تاریخ امروز بر روی صفحه ساعت.
-iconic: راه‌اندازی به صورت کوچک‌شده (آیکون)، در صورت پشتیبانی توسط مدیر پنجره.
-adjust ddhhmm: تنظیم ساعت به میزان +/- ddhhmm (dd = روز، hh = ساعت، mm = دقیقه) برای تصحیح زمان نادرست ساعت بدون نیاز به دسترسی کاربر ریشه (root) یا برای کار در یک منطقه زمانی دیگر.
-update n: به‌روزرسانی صفحه ساعت در هر n ثانیه [پیش‌فرض 30]. اگر n=1 باشد، عقربه ثانیه‌شمار نیز نمایش داده می‌شود.
-mail n: بررسی دریافت نامه‌های جدید در هر n ثانیه [پیش‌فرض 60]. فاصله زمانی واقعی مضربی از بازه به‌روزرسانی ساعت است.
-mailfile mailfile: جایگزینی متغیر محیطی "MAIL" با mailfile به عنوان محل ذخیره نامه‌ها.
-mailspawn cmd: اجرای دستور cmd در هنگام کلیک با کلید ماوس روی صفحه ساعت.
#geom: تعیین اندازه ترجیحی برای پنجره آیکون [پیش‌فرض "65x65"].

برخی از این گزینه‌ها ممکن است بسته به نحوه کامپایل urclock در دسترس نباشند. برای آگاهی از قابلیت‌های فعال، دستور urclock -help را اجرا کنید.

منابع سامانه اکس (X RESOURCES)

هیچ منبع X استفاده نمی‌شود -- تنها گزینه‌های خط فرمان کاربرد دارند.

عنوان‌ها و آیکون‌ها (TITLES AND ICONS)

عنوان‌های پنجره و آیکون بر روی روز هفته و تاریخ تنظیم می‌شوند. همچنین تاریخ در نیمه پایینی ساعت نمایش داده می‌شود، مگر اینکه گزینه -nodate مشخص شده باشد. پنجره آیکون «فعال» است و در صورت پشتیبانی توسط مدیر پنجره، زمان را نشان خواهد داد.

یادآورها (REMINDERS)

فایل ~/.rclock (توجه: نه ~/.urclock) فهرست پیام‌هایی که باید نمایش داده شوند و/یا برنامه‌هایی که باید در زمان‌ها و تاریخ‌های مشخص اجرا شوند را مشخص می‌کند. در زمان تعیین‌شده، urclock پنجره‌ای را در مرکز صفحه نمایش باز می‌کند تا پیام را نمایش دهد یا صرفاً برنامه زمان‌بندی‌شده را اجرا خواهد کرد. urclock فایل ~/.rclock را در زمان راه‌اندازی، هر ۱۰ دقیقه یک‌بار (برای بررسی تغییرات) و پس از بسته شدن پنجره یک پیام (برای یافتن قرار ملاقات بعدی) می‌خواند.

یک ورودی در ~/.rclock می‌تواند یکی از دو قالب زیر را داشته باشد (خطوط خالی و خطوط توضیحات نادیده گرفته می‌شوند):

hh:mm [dd] MM/DD/YY message[; program]

یا

[hh:mm [dd] MM/DD/YY [message]]; program

hh - ساعت (0-23؛ * = ساعت جاری)

mm - دقیقه (0-59؛ * = 0)

dd - روزهای هفته (برخی/همه/هیچ‌کدام از umtwrfs؛ * = همه)

MM - ماه (1-12؛ * = ماه جاری)

DD - روز ماه (1-31؛ * = روز جاری)

YY - سال (0-99 یا 1900-????؛ * = سال جاری)

message - پیامی که باید نمایش داده شود

program - برنامه‌ای که باید اجرا شود

روزهای هفته از اختصارات زیر استفاده می‌کنند: u=یکشنبه، m=دوشنبه، t=سه‌شنبه، w=چهارشنبه، r=پنجشنبه، f=جمعه، s=شنبه، *=همه.

اگر message خالی باشد و program مشخص شده باشد، برنامه بدون پنجره پیام اجرا می‌شود. اگر زمان و تاریخ نیز تعیین نشده باشند، program در هنگام راه‌اندازی اجرا خواهد شد. توجه داشته باشید که message می‌تواند حاوی کاراکترهای اسکیپ باشد (\n: خط جدید، \;: نقطه‌ویرگول).

در اینجا یک فایل نمونه آمده است که برخی از ساختارهای مجاز را نشان می‌دهد:

# ~/.rclock - My appointment file
# startup functions
; xsetroot -solid Black &
# cron functions
10:00; xsetroot -solid Grey25 &
14:00; xsetroot -solid Grey75 &
# daily/weekly reminders
08:15 mtwrf *      Good Morning!\\nRead News?; urxvt -e News
12:00 mtwrf *      Lunch Time!
17:00 mtwrf *      Go Home
23:00 mtwrf *      Still Here? Go to bed
08:10 twrf  *      Did you do your time card yesterday?
15:00 f     *      Friday, do your time card early!
16:00 mtwr  *      Do your time card
16:30 mtwrf *      Did you do your time card?
*:00  us    *      It's the weekend, why are you here?
8:15  f     */13/* Friday the 13th! Careful!
8:15  *     4/1/*  fkrkrmfismsmkd...dkdfk
8:16  *     4/1/*  April Fools!
# birthdays/anniversaries
16:00    05/21/*   Pam's Birthday (next week)
16:00    05/24/*   Pam's Birthday (in a few days)
# once-of appointments
08:30    03/15/94    Dentist appointment
08:30    03/15/1999  Dentist appointment
08:30    03/15/2004  Dentist appointment

محیط (ENVIRONMENT)

urclock از متغیر محیطی MAIL برای تعیین محل فایل مخزن نامه کاربر استفاده می‌کند، مگر اینکه گزینه -mailfile مشخص شده باشد.

اشکالات (BUGS)

urclock در برخورد با خطاهای هنگام خواندن فایل ~/.rclock چندان هوشمند نیست. هر یادآور باید یک خط منفرد حداکثر شامل ۲۵۵ نویسه باشد. پنجره‌های یادآور گاهی هنگام بالا آمدن یا آشکار شدن مجدد ترسیم نمی‌شوند (خالی می‌مانند).

تاریخچه (HISTORY)

هنگام تبدیل rxvt به نسخه دارای یونیکد یعنی urxvt-unicode، برنامه‌های جانبی دیگر کنار گذاشته شدند، زیرا عیناً مشابه همتایان خود در rxvt بودند و بنابراین همچنان می‌شد با نصب rxvt آن‌ها را به‌طور مستقل نصب کرد.

از آنجا که توزیع‌ها شروع به حذف rxvt (و به تبع آن rclock) کردند، برنامه rclock با نام urclock به بسته rxvt-unicode اضافه شده است. این برنامه از نظر عملکردی باید با برنامه rclock در rxvt کاملاً یکسان باشد، از جمله استفاده از همان نام فایل پیکربندی.

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

Rob Nation <nation@rocket.sanders.lockheed.com>

اصلاحات توسط mj olesen <olesen@me.QueensU.CA>

اصلاحات توسط Marc A. Lehmann <urclock@schmorp.de>

اصلاحات توسط Emanuele Giaquinta <emanuele.giaquinta@gmail.com>

در حال حاضر به عنوان بخشی از بسته rxvt-unicode نگهداری می‌شود.