نام (NAME)

waybar-clock - ماژول ساعت در waybar

توضیحات (DESCRIPTION)

ماژول clock تاریخ و زمان کنونی را نمایش می‌دهد.

فایل‌ها (FILES)

$XDG_CONFIG_HOME/waybar/config
فایل پیکربندی اختصاصی هر کاربر

پیکربندی (CONFIGURATION)

1. آدرس‌دهی شده با clock

گزینه (Option)	نوع (Typeof)	پیش‌فرض (Default)	توضیحات (Description)
interval	integer	60	بازهٔ زمانی (بر حسب ثانیه) برای دریافت و به‌روزرسانی اطلاعات.
format	string	{:%H:%M}	قالب نحوهٔ نمایش تاریخ و زمان. گزینه‌های قالب‌بندی را در زیر مشاهده کنید.
timezone	string		منطقهٔ زمانی برای نمایش زمان؛ برای نمونه America/New_York. مقدار "" بیانگر منطقهٔ زمانی محلی سامانه است. فهرست غیررسمی مناطق زمانی در ویکی‌پدیا را ببینید: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
timezones	list of strings		فهرستی از مناطق زمانی (مشابه timezone) برای استفاده در نمایش زمان، که با چرخ اسکرول ماوس جابه‌جا می‌شوند. هنگام تعیین گزینهٔ timezones، گزینهٔ timezone را مشخص نکنید. مقدار "" بیانگر منطقهٔ زمانی محلی سامانه است.
timezone-tooltip-format	string		قالب مورد استفاده برای نمایش مناطق زمانی در راهنمای شناور (tooltip). در صورت تنظیم، امکان نمایش اطلاعات منطقهٔ زمانی (مانند اختصارات منطقهٔ زمانی) را در راهنمای شناور فراهم می‌کند در حالی که نمایشگر اصلی خلوت می‌ماند. از همان گزینه‌های قالب‌بندی format استفاده می‌کند.
locale	string		مکان‌تنظیم (locale) برای نمایش زمان. برای رندر زمان در مناطق زمانی سفارشی با زبان و قالب مناسب به کار می‌رود.
max-length	integer		بیشینهٔ طول (بر حسب نویسه) که پودمان باید نمایش دهد.
rotate	integer		مقدار مثبت برای چرخاندن برچسب متنی (با گام‌های ۹۰ درجه).
on-click	string		دستوری که هنگام کلیک بر روی پودمان اجرا می‌شود.
on-click-middle	string		دستوری که هنگام کلیک وسط (با چرخ ماوس) بر روی پودمان اجرا می‌شود.
on-click-right	string		دستوری که هنگام کلیک راست بر روی پودمان اجرا می‌شود.
on-scroll-up	string		دستوری که هنگام اسکرول به بالا بر روی پودمان اجرا می‌شود.
on-scroll-down	string		دستوری که هنگام اسکرول به پایین بر روی پودمان اجرا می‌شود.
smooth-scrolling-threshold	double		آستانهٔ مورد استفاده هنگام اسکرول روان.
tooltip	bool	true	گزینه‌ای برای فعال‌سازی راهنمای شناور (tooltip) هنگام نگه داشتن نشانگر ماوس.
tooltip-format	string	مشابه format	راهنمای شناور هنگام نگه داشتن نشانگر ماوس.
menu	string		اقدامی که منو را باز می‌کند.
menu-file	string		مسیر فایل توصیف‌گر منو. باید عنصری از نوع GtkMenu با شناسهٔ menu وجود داشته باشد.
menu-actions	array		اقدامات متناظر با دکمه‌های منو.
expand:	bool	false	به این پودمان امکان می‌دهد تمام فضای باقی‌مانده را به‌صورت پویا مصرف کند.

تمامی گزینه‌های معتبر قالب‌بندی را در strftime(3) مشاهده کنید یا به نشانی https://en.cppreference.com/w/cpp/chrono/duration/formatter مراجعه فرمایید.

2. آدرس‌دهی شده با clock: calendar

گزینه (Option)	نوع (Typeof)	پیش‌فرض (Default)	توضیحات (Description)
mode	string	month	حالت نمایش تقویم. مقادیر ممکن: year\|month
mode-mon-col	integer	3	مرتبط با mode=year. تعداد ماه‌ها در هر سطر.
weeks-pos	string		موقعیتی که شماره‌های هفته باید نمایش داده شوند. هنگام خالی بودن غیرفعال است. مقادیر ممکن: left\|right
on-scroll	integer	1	مقدار اسکرول ماه‌ها/سال‌ها به جلو/عقب. می‌تواند منفی باشد. تحت گزینهٔ on-scroll پیکربندی می‌شود.
iso8601	bool	false	هنگام فعال بودن، تقویم از استاندارد ISO 8601 پیروی می‌کند: هفته‌ها از دوشنبه آغاز می‌شوند و نخستین هفتهٔ سال با شمارهٔ ۱ شماره‌گذاری می‌شود. قالب پیش‌فرض هفته '{:%V}' است.

3. آدرس‌دهی شده با clock: calendar: format

گزینه (Option)	نوع (Typeof)	پیش‌فرض (Default)	توضیحات (Description)
months	string		قالب اعمال‌شده بر سرآیند ماه‌ها (January، February و غیره).
days	string		قالب اعمال‌شده بر روزها.
weeks	string	{:%U}	قالب اعمال‌شده بر شماره‌های هفته. هنگامی که قالب روزهای هفته ارائه نشده باشد، از قالب پیش‌فرض استفاده می‌شود: در صورتی که هفته با دوشنبه آغاز شود '{:%W}' و در غیر این صورت '{:%U}'.
weekdays	string		قالب اعمال‌شده بر سرآیند روزهای هفته (Su، Mo و غیره).
today	string	<b><u>{}</u></b>	قالب اعمال‌شده بر روز جاری (امروز).

اقدامات (ACTIONS)

رشته (String)	اقدام (Action)
mode	تغییر حالت تقویم بین سال/ماه (year/month)
tz_up	تغییر به منطقهٔ زمانی مشخص‌شدهٔ بعدی
tz_down	تغییر به منطقهٔ زمانی مشخص‌شدهٔ قبلی
shift_up	انتقال به ماه/سال تقویمی بعدی
shift_down	انتقال به ماه/سال تقویمی قبلی

جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)

{calendar}: تقویم ماه کنونی
{tz_list}: فهرست زمان در سایر مناطق زمانی، در صورتی که بیش از یک منطقهٔ زمانی در پیکربندی تنظیم شده باشد
{ordinal_date}: روز جاری در شکل ترتیبی (انگلیسی)، مانند 21st

مثال‌ها (EXAMPLES)

1. عمومی (General)

"clock": {
	"interval": 60,
	"format": "{:%H:%M}",
	"max-length": 25
}

2. تقویم (Calendar)

"clock": {
	"format": "{:%H:%M}  ",
	"format-alt": "{:%A, %B %d, %Y (%R)}  ",
	"tooltip-format": "<tt><small>{calendar}</small></tt>",
	"calendar": {
		"mode"          : "year",
		"mode-mon-col"  : 3,
		"weeks-pos"     : "right",
		"on-scroll"     : 1,
		"on-click-right": "mode",
		"format": {
			"months":     "<span color='#ffead3'><b>{}</b></span>",
			"days":       "<span color='#ecc6d9'><b>{}</b></span>",
			"weeks":      "<span color='#99ffdd'><b>W{}</b></span>",
			"weekdays":   "<span color='#ffcc66'><b>{}</b></span>",
			"today":      "<span color='#ff6699'><b><u>{}</u></b></span>"
		}
	},
	"actions": {
		"on-click-right": "mode",
		"on-click-forward": "tz_up",
		"on-click-backward": "tz_down",
		"on-scroll-up": "shift_up",
		"on-scroll-down": "shift_down"
	}
},

3. نمایش تاریخ کامل هنگام نگه داشتن نشانگر ماوس (Full date on hover)

"clock": {
	"interval": 60,
	"tooltip": true,
	"format": "{:%H.%M}",
	"tooltip-format": "{:%Y-%m-%d}",
}

4. نمایش منطقهٔ زمانی فقط در راهنمای شناور (Show timezone in tooltip only)

"clock": {
	"interval": 60,
	"format": "{:%H:%M}",
	"timezone-tooltip-format": "{:%H:%M %Z}",
	"timezones": [
		"",
		"America/Chicago",
		"America/Los_Angeles",
		"Europe/Paris",
		"UTC"
	],
	"tooltip": true,
	"tooltip-format": "{tz_list}"
}

استایل (STYLE)

•: #clock

عیب‌یابی (TROUBLESHOOTING)

اگر پودمان clock در زمان راه‌اندازی با پیام خطای locale::facet::_S_create_c_locale
name not valid غیرفعال شد، یکی از موارد زیر را امتحان کنید:

بررسی کنید که متغیر LC_TIME به‌درستی تنظیم شده باشد (glibc)
تنظیم locale به C در فایل پیکربندی (musl)

گزینهٔ locale باید تنظیم شود تا {calendar} بدون توجه به مکان‌تنظیم سامانه، از شروع هفتهٔ صحیح استفاده کند.

تقویم به زبان چینی. تراز (Calendar in Chinese. Alignment)

به منظور داشتن یک تقویم چینی تراز شده، توصیه‌های مفیدی وجود دارد:

1.: از قلم "WenQuanYi Zen Hei Mono" استفاده کنید که در اکثر توزیع‌های لینوکس ارائه شده است.
2.: اندازه‌های مختلف قلم را آزمایش کنید و بهترین را برای خود بیابید؛ اندازهٔ size = 9pt مناسب خواهد بود.
3.: در صورتی که از قلم "WenQuanYi Zen Hei Mono" استفاده می‌شود، تگ pango مربوط به قلم مونو‌اسپیس (monospace) را غیرفعال کنید.

نمونه‌ای از پیکربندی کارآمد

"clock": {
	"format": "{:%H:%M}  ",
	"format-alt": "{:%A, %B %d, %Y (%R)}  ",
	"tooltip-format": "n<span size='9pt' font='WenQuanYi Zen Hei Mono'>{calendar}</span>",
	"calendar": {
		"mode"          : "year",
		"mode-mon-col"  : 3,
		"weeks-pos"     : "right",
		"on-scroll"     : 1,
		"on-click-right": "mode",
		"format": {
			"months":     "<span color='#ffead3'><b>{}</b></span>",
			"days":       "<span color='#ecc6d9'><b>{}</b></span>",
			"weeks":      "<span color='#99ffdd'><b>W{}</b></span>",
			"weekdays":   "<span color='#ffcc66'><b>{}</b></span>",
			"today":      "<span color='#ff6699'><b><u>{}</u></b></span>"
		}
	},
	"actions": {
		"on-click-right": "mode",
		"on-click-forward": "tz_up",
		"on-click-backward": "tz_down",
		"on-scroll-up": "shift_up",
		"on-scroll-down": "shift_down"
	}
},

نویسنده (AUTHOR)

Alexis Rouillard <contact@arouillard.fr>