'\" t
.\"     Title: timew-chart
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2025-08-16
.\"    Manual: User Manuals
.\"    Source: timew 1.9.1
.\"  Language: English
.\"
.TH "TIMEW\-CHART" "1" "2025-08-16" "timew 1.9.1" "User Manuals"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
timew-chart \- نمایش گزارش نموداری
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBtimew day\fP [\fI<range>\fP] [\fI<tag>\fP\fB...\fP]
\fBtimew month\fP [\fI<range>\fP] [\fI<tag>\fP\fB...\fP]
\fBtimew week\fP [\fI<range>\fP] [\fI<tag>\fP\fB...\fP]
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
یک نمودار، زمان‌های ردیابی‌شده و ردیابی‌نشده را با بلوک‌های رنگی رسم‌شده بر روی یک خط زمانی خلاصه می‌کند.
این دستور بازه‌های زمانی و برچسب‌ها را برای پالایش می‌پذیرد.
سه نوع نمودار وجود دارد: \fBday\fP، \fBweek\fP و \fBmonth\fP همراه با دستورات متناظر خود.
تنظیم پیکربندی \fBreports.\fP\fI<type>\fP\fB.range\fP بازهٔ زمانی پیش‌فرض را بازنویسی می‌کند.
همچنین می‌توان بازهٔ زمانی پیش‌فرض سراسری را با پیکربندی \fBreports.range\fP بازنویسی کرد.
برای جزئیات بیشتر و زمان‌های دقیق‌تر، از گزارش \*(Aqsummary\*(Aq استفاده کنید.
.sp
\fBmonth\fP
.RS 4
دستور month نموداری را نمایش می‌دهد که یک ماه منفرد (به‌طور پیش‌فرض ماه جاری) را به تصویر می‌کشد.
بازهٔ زمانی پیش‌فرض نمایش‌داده‌شده \fB:month\fP است.
.RE
.sp
\fBweek\fP
.RS 4
دستور week نموداری را نمایش می‌دهد که یک هفتهٔ منفرد (به‌طور پیش‌فرض هفتهٔ جاری) را به تصویر می‌کشد.
بازهٔ زمانی پیش‌فرض نمایش‌داده‌شده \fB:week\fP است.
.RE
.sp
\fBday\fP
.RS 4
دستور day نموداری را نمایش می‌دهد که یک روز منفرد (به‌طور پیش‌فرض امروز) را به تصویر می‌کشد.
بازهٔ زمانی پیش‌فرض نمایش‌داده‌شده \fB:day\fP است.
.RE
.SH "اشاره‌ها (HINTS)"
.sp
جدای از اشاره‌های بازه (ببینید \fBtimew\-hints\fP(7))، گزارش‌های نموداری از اشاره‌های زیر پیروی می‌کنند:
.sp
\fB:blank\fP
.RS 4
اشارهٔ \*(Aq:blank\*(Aq باعث می‌شود تنها زمان‌های مستثنی‌شده نمایش داده شوند و هیچ زمان ردیابی‌شده‌ای نشان داده نشود.
از این اشاره می‌توان برای نمایش زمان‌های استثنا استفاده کرد.
.RE
.sp
\fB:ids\fP
.RS 4
اشارهٔ \*(Aq:ids\*(Aq باعث می‌شود بازه‌های زمانی همراه با شناسهٔ (ID) خود نمایش داده شوند.
.RE
.SH "پیکربندی (CONFIGURATION)"
.sp
\fI<type>\fP یکی از مقادیر \fBmonth\fP، \fBweek\fP یا \fBday\fP است.
.sp
\fBreports.\fP\fI<type>\fP\fB.cell\fP
.RS 4
مشخص می‌کند که در نمودارها، چند دقیقه توسط یک نویسه (سلول نویسه‌ای) نمایش داده شود.
این مقدار باید بزرگ‌تر از \*(Aq0\*(Aq باشد.
مقدار \*(Aq15\*(Aq به این معنی است که یک ساعت با ۶۰/۱۵، یعنی ۴ سلول نویسه‌ای نشان داده می‌شود.
مقادیر مناسب مقسوم‌علیه‌های ۶۰ هستند (۳۰، ۲۰، ۱۵، ۱۲، ...).
مقدار پیش‌فرض \*(Aq15\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.day\fP
.RS 4
مشخص می‌کند که آیا روز جاریِ ماه در حاشیهٔ سمت چپ نمایش داده شود یا خیر.
مقدار پیش‌فرض \*(Aqyes\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.holidays\fP
.RS 4
مشخص می‌کند که آیا روزهای تعطیل مربوطه در زیر گزارش نمایش داده شوند یا خیر.
مقدار پیش‌فرض \*(Aqyes\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.hours\fP
.RS 4
مشخص می‌کند که گزارش <type> تمام ساعت‌های یک روز را نشان دهد (\*(Aqall\*(Aq)، یا تنها به ساعت‌هایی که داده‌ای در آن‌ها ردیابی شده محدود شود (\*(Aqauto\*(Aq).
مقدار پیش‌فرض \*(Aqall\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.lines\fP
.RS 4
مشخص می‌کند که چند خط برای نمایش هر روز در گزارش <type> استفاده شود.
مقدار پیش‌فرض \*(Aq1\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.month\fP
.RS 4
مشخص می‌کند که آیا ماه جاری در حاشیهٔ سمت چپ نمایش داده شود یا خیر.
مقدار پیش‌فرض \*(Aqyes\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.range\fP
.RS 4
برای گزارش‌هایی که بازه‌ای از داده‌ها را نشان می‌دهند، این تنظیم مقدار پیش‌فرض را بازنویسی خواهد کرد.
این مقدار باید یک اشارهٔ بازه (بدون دونقطهٔ پیشوند) باشد؛ به \fBtimew\-hints\fP(7) مراجعه کنید.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.spacing\fP
.RS 4
تعداد فاصله‌هایی را که بین ساعت‌ها در استثناهای گزارش <type> درج می‌شوند، تعیین می‌کند.
مقدار \*(Aq0\*(Aq گزارش فشرده‌تری ایجاد می‌کند.
مقدار پیش‌فرض \*(Aq1\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.axis\fP
.RS 4
مقدار \*(Aqinternal\*(Aq نشانگرهای ساعت (خط زمانی در بالا) را درون بلوک‌های استثنا قرار می‌دهد، و \*(Aqexternal\*(Aq نشانگرهای ساعت را در خطی جداگانه می‌گذارد؛ ممکن است مقادیر دیگری در آینده تعریف شوند.
پیش‌فرض برای گزارش day مقدار \*(Aqinternal\*(Aq و برای سایر گزارش‌ها \*(Aqexternal\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.summary\fP
.RS 4
مشخص می‌کند که آیا خلاصهٔ ساعت‌ها نمایش داده شود یا خیر.
مقدار پیش‌فرض \*(Aqon\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.totals\fP
.RS 4
مشخص می‌کند که آیا مجموع زمان‌ها برای هر روز در گزارش نمایش داده شود یا خیر.
مقدار پیش‌فرض \*(Aqon\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.week\fP
.RS 4
مشخص می‌کند که آیا شمارهٔ هفتهٔ جاری در حاشیهٔ سمت چپ نمایش داده شود یا خیر.
مقدار پیش‌فرض \*(Aqyes\*(Aq است.
.RE
.sp
\fBreports.\fP\fI<type>\fP\fB.weekday\fP
.RS 4
مشخص می‌کند که آیا روز جاری هفته در حاشیهٔ سمت چپ نمایش داده شود یا خیر.
مقدار پیش‌فرض \*(Aqyes\*(Aq است.
.RE
.sp
\fBtags.\fP\fI<tag>\fP\fB.color\fP
.RS 4
به جای پالت رنگی پیش‌فرضی که توسط پوستهٔ جاری شما تعیین شده است، یک رنگ پیش‌زمینه و پس‌زمینهٔ مشخص را به یک برچسب اختصاص می‌دهد.
نمونه‌هایی از رنگ‌های معتبر شامل \*(Aqwhite\*(Aq، \*(Aqgray8\*(Aq، \*(Aqblack on yellow\*(Aq و \*(Aqrgb345\*(Aq هستند.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
نمودارها بازه‌های زمانی و/یا برچسب‌ها، یا شناسه‌ها را برای پالایش می‌پذیرند:
.sp
.if n .RS 4
.nf
.fam C
$ timew month 1st \- today
$ timew week FOO BAR
$ timew day @3 @4
.fam
.fi
.if n .RE
.sp
برای اطلاع از روش‌های گوناگون مشخص‌کردن بازه‌های زمانی، به \fBtimew\-ranges\fP(7) و \fBtimew\-hints\fP(7) مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBtimew\-summary\fP(1)