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)
مراجعه
کنید.