نمونه فایل پیکربندی

show_calendar = 1
show_timezones = 1
mark_today = 1
show_week_numbers = 0
close_on_unfocus = 0
close_on_mouseleave = 0
external_viewer = sunbird -showdate "%Y-%m-%d"
clock_format = %a %d %b %H:%M
force_lang = en_US.utf8
mainwindow_decorated = 0
mainwindow_keep_above = 1
mainwindow_sticky = 0
mainwindow_skip_taskbar = 1
mainwindow_resizable = 0
mainwindow_position = none
mainwindow_xoffset = 0
mainwindow_yoffset = 0
clock_label = UTC
clock_tz = :UTC
clock_label = Local
clock_tz =
clock_label = BST
clock_tz = :Europe/London
clock_label = EDT
clock_tz = :US/Eastern
clock_label = CDT
clock_tz = :US/Central

شرح گزینه‌های پیکربندی

گزینه‌ها تقریباً واضح و بی‌نیاز از توضیح هستند، اما شرح دقیق آن‌ها در ادامه آمده است:

show_calendar: 1 یا 0، پیش‌فرض 1.

تعیین می‌کند که آیا تقویم باید نمایش داده شود یا خیر. اکثر کاربران ترجیح می‌دهند این گزینه 1 باشد.

show_timezones: 1 یا 0، پیش‌فرض 0.

تعیین می‌کند که آیا ساعت‌های مناطق زمانی مختلف باید نمایش داده شوند یا خیر.

mark_today: 1 یا 0، پیش‌فرض 1.

تعیین می‌کند که آیا تاریخ امروز در تقویم علامت‌گذاری شود یا خیر (علاوه بر انتخاب پیش‌فرض؛ بدین معنا که با کلیک روی روزی دیگر، امروز به‌گونه‌ای علامت‌گذاری شده باقی می‌ماند، مثلاً با قلم توپر یا درشت).

show_week_numbers: 1 یا 0، پیش‌فرض 0.

تعیین می‌کند که آیا شماره‌های هفته در تقویم نمایش داده شوند یا خیر.

close_on_unfocus: 1 یا 0، پیش‌فرض 0.

تعیین می‌کند که آیا با از دست رفتن تمرکز (focus) پنجره، تقویم بسته شود یا خیر. توجه داشته باشید که اگر mainwindow_skip_taskbar روی 1 تنظیم شده باشد، ممکن است پنجرهٔ تقویم هنگام ایجاد، تمرکز دریافت نکند.

close_on_mouseleave: 1 یا 0، پیش‌فرض 0.

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

external_viewer: رشته، پیش‌فرض رشتهٔ خالی.

خط فرمانی که هنگام دوبار کلیک روی یک تاریخ اجرا می‌شود. متغیرهای زمانی این رشته توسط strftime جایگزین شده (برای جایگزینی‌های ممکن به man strftime مراجعه کنید) و به پوسته ارسال می‌شود. بنابراین می‌توانید از پایپ‌ها، تغییرمسیرها و هر دستور دیگری استفاده کنید.
با این حال، در حال حاضر پوسته به‌صورت پیش‌فرض روی /bin/sh تنظیم ثابت شده است. امیدواریم این برای همهٔ کاربران مناسب باشد، اما در صورت بروز مشکل لطفاً یک گزارش ثبت کنید (به بخش REPORTING BUGS مراجعه کنید).

clock_format: رشته

قالب ساعت‌ها را تنظیم می‌کند. برای قالب‌های معتبر به man strftime مراجعه کنید.

force_lang: رشته

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

LANG=en_GB.utf8 gsimplecal

باید یکی از مقادیر خروجی دستور locale -a باشد.

mainwindow_decorated: 1 یا 0، پیش‌فرض 0.

به مدیر پنجرهٔ شما می‌گوید که پنجرهٔ اصلی را حاشیه‌دار (تزئین) کند یا خیر.

mainwindow_keep_above: 1 یا 0، پیش‌فرض 1.

تعیین می‌کند که آیا پنجرهٔ اصلی باید توسط مدیر پنجره همواره روی سایر پنجره‌ها قرار گیرد یا خیر.

mainwindow_sticky: 1 یا 0، پیش‌فرض 0.

به مدیر پنجره فرمان می‌دهد که gsimplecal را در تمام میزکارها نمایش دهد.

mainwindow_skip_taskbar: 1 یا 0، پیش‌فرض 1.

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

mainwindow_resizable: 1 یا 0، پیش‌فرض 1.

تعیین می‌کند که آیا مدیر پنجره اجازهٔ تغییر اندازهٔ پنجرهٔ اصلی را بدهد یا خیر. اگر از یک مدیر پنجرهٔ کاشی‌بند (tiling) که از پنجره‌های شناور پشتیبانی می‌کند استفاده می‌کنید، تنظیم این گزینه روی 0 احتمالاً به مدیر پنجره می‌گوید که پنجره را کاشی‌بندی نکند (بر روی XMonad و Awesome آزمایش شده است).

mainwindow_position: mouse|center|none، پیش‌فرض mouse.

به مدیر پنجره اعلام می‌کند که پنجرهٔ gsimplecal را در کجا جای‌گذاری کند:

mouse

نزدیک به موقعیت نشانگر ماوس (این گزینه زمانی سودمند است که اجرای gsimplecal را به یک دستور کلیک ماوس متصل کرده باشید)؛

center

در مرکز صفحهٔ نمایش؛

none

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

mainwindow_xoffset و mainwindow_yoffset: عدد صحیح، پیش‌فرض 0.

امکان تنظیم دقیق موقعیت پنجرهٔ اصلی را فراهم می‌کنند. یک مقدار عددی صحیح به آن‌ها اختصاص دهید تا پنجره به همان تعداد پیکسل جابه‌جا شود.

clock_label و clock_tz: رشته

این دو گزینه باید به‌صورت جفت تعیین شوند و حتماً باید با همان ترتیب ذکرشده قرار گیرند.
هر جفت، یک ساعت جدید ایجاد می‌کند. متغیر clock_label رشته‌ای را تعیین می‌کند که کنار ساعت نمایش داده می‌شود و clock_tz منطقهٔ زمانی را مشخص می‌سازد.
اگر مقدار مربوط به clock_tz را خالی بگذارید، ساعت محلی نشان داده خواهد شد.
برای چگونگی مشخص‌کردن مناطق زمانی مختلف به man timezone مراجعه کنید. معمولاً این مقدار رشته‌ای با قالب ":{Area}/{Location}" است، اما در حقیقت یک دونقطه است که به دنبال آن مسیر نسبی فایل حاوی اطلاعات منطقهٔ زمانی می‌آید. عموماً دایرکتوری حاوی این فایل‌ها /usr/share/zoneinfo است، بنابراین کافی است فهرست آن دایرکتوری را بررسی کرده و فایل‌های مورد نظر خود را انتخاب کنید.