TIMEW-CHART(1) User Manuals TIMEW-CHART(1)

timew-chart - نمایش گزارش نموداری

timew day [<range>] [<tag>...]
timew month [<range>] [<tag>...]
timew week [<range>] [<tag>...]

یک نمودار، زمان‌های ردیابی‌شده و ردیابی‌نشده را با بلوک‌های رنگی رسم‌شده بر روی یک خط زمانی خلاصه می‌کند. این دستور بازه‌های زمانی و برچسب‌ها را برای پالایش می‌پذیرد. سه نوع نمودار وجود دارد: day، week و month همراه با دستورات متناظر خود. تنظیم پیکربندی reports.<type>.range بازهٔ زمانی پیش‌فرض را بازنویسی می‌کند. همچنین می‌توان بازهٔ زمانی پیش‌فرض سراسری را با پیکربندی reports.range بازنویسی کرد. برای جزئیات بیشتر و زمان‌های دقیق‌تر، از گزارش 'summary' استفاده کنید.

month

دستور month نموداری را نمایش می‌دهد که یک ماه منفرد (به‌طور پیش‌فرض ماه جاری) را به تصویر می‌کشد. بازهٔ زمانی پیش‌فرض نمایش‌داده‌شده :month است.

week

دستور week نموداری را نمایش می‌دهد که یک هفتهٔ منفرد (به‌طور پیش‌فرض هفتهٔ جاری) را به تصویر می‌کشد. بازهٔ زمانی پیش‌فرض نمایش‌داده‌شده :week است.

day

دستور day نموداری را نمایش می‌دهد که یک روز منفرد (به‌طور پیش‌فرض امروز) را به تصویر می‌کشد. بازهٔ زمانی پیش‌فرض نمایش‌داده‌شده :day است.

جدای از اشاره‌های بازه (ببینید timew-hints(7))، گزارش‌های نموداری از اشاره‌های زیر پیروی می‌کنند:

:blank

اشارهٔ ':blank' باعث می‌شود تنها زمان‌های مستثنی‌شده نمایش داده شوند و هیچ زمان ردیابی‌شده‌ای نشان داده نشود. از این اشاره می‌توان برای نمایش زمان‌های استثنا استفاده کرد.

:ids

اشارهٔ ':ids' باعث می‌شود بازه‌های زمانی همراه با شناسهٔ (ID) خود نمایش داده شوند.

<type> یکی از مقادیر month، week یا day است.

reports.<type>.cell

مشخص می‌کند که در نمودارها، چند دقیقه توسط یک نویسه (سلول نویسه‌ای) نمایش داده شود. این مقدار باید بزرگ‌تر از '0' باشد. مقدار '15' به این معنی است که یک ساعت با ۶۰/۱۵، یعنی ۴ سلول نویسه‌ای نشان داده می‌شود. مقادیر مناسب مقسوم‌علیه‌های ۶۰ هستند (۳۰، ۲۰، ۱۵، ۱۲، ...). مقدار پیش‌فرض '15' است.

reports.<type>.day

مشخص می‌کند که آیا روز جاریِ ماه در حاشیهٔ سمت چپ نمایش داده شود یا خیر. مقدار پیش‌فرض 'yes' است.

reports.<type>.holidays

مشخص می‌کند که آیا روزهای تعطیل مربوطه در زیر گزارش نمایش داده شوند یا خیر. مقدار پیش‌فرض 'yes' است.

reports.<type>.hours

مشخص می‌کند که گزارش <type> تمام ساعت‌های یک روز را نشان دهد ('all')، یا تنها به ساعت‌هایی که داده‌ای در آن‌ها ردیابی شده محدود شود ('auto'). مقدار پیش‌فرض 'all' است.

reports.<type>.lines

مشخص می‌کند که چند خط برای نمایش هر روز در گزارش <type> استفاده شود. مقدار پیش‌فرض '1' است.

reports.<type>.month

مشخص می‌کند که آیا ماه جاری در حاشیهٔ سمت چپ نمایش داده شود یا خیر. مقدار پیش‌فرض 'yes' است.

reports.<type>.range

برای گزارش‌هایی که بازه‌ای از داده‌ها را نشان می‌دهند، این تنظیم مقدار پیش‌فرض را بازنویسی خواهد کرد. این مقدار باید یک اشارهٔ بازه (بدون دونقطهٔ پیشوند) باشد؛ به timew-hints(7) مراجعه کنید.

reports.<type>.spacing

تعداد فاصله‌هایی را که بین ساعت‌ها در استثناهای گزارش <type> درج می‌شوند، تعیین می‌کند. مقدار '0' گزارش فشرده‌تری ایجاد می‌کند. مقدار پیش‌فرض '1' است.

reports.<type>.axis

مقدار 'internal' نشانگرهای ساعت (خط زمانی در بالا) را درون بلوک‌های استثنا قرار می‌دهد، و 'external' نشانگرهای ساعت را در خطی جداگانه می‌گذارد؛ ممکن است مقادیر دیگری در آینده تعریف شوند. پیش‌فرض برای گزارش day مقدار 'internal' و برای سایر گزارش‌ها 'external' است.

reports.<type>.summary

مشخص می‌کند که آیا خلاصهٔ ساعت‌ها نمایش داده شود یا خیر. مقدار پیش‌فرض 'on' است.

reports.<type>.totals

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

reports.<type>.week

مشخص می‌کند که آیا شمارهٔ هفتهٔ جاری در حاشیهٔ سمت چپ نمایش داده شود یا خیر. مقدار پیش‌فرض 'yes' است.

reports.<type>.weekday

مشخص می‌کند که آیا روز جاری هفته در حاشیهٔ سمت چپ نمایش داده شود یا خیر. مقدار پیش‌فرض 'yes' است.

tags.<tag>.color

به جای پالت رنگی پیش‌فرضی که توسط پوستهٔ جاری شما تعیین شده است، یک رنگ پیش‌زمینه و پس‌زمینهٔ مشخص را به یک برچسب اختصاص می‌دهد. نمونه‌هایی از رنگ‌های معتبر شامل 'white'، 'gray8'، 'black on yellow' و 'rgb345' هستند.

نمودارها بازه‌های زمانی و/یا برچسب‌ها، یا شناسه‌ها را برای پالایش می‌پذیرند:

$ timew month 1st - today
$ timew week FOO BAR
$ timew day @3 @4

برای اطلاع از روش‌های گوناگون مشخص‌کردن بازه‌های زمانی، به timew-ranges(7) و timew-hints(7) مراجعه کنید.

timew-summary(1)

2025-08-16 timew 1.9.1