'\" t
.\"     Title: timew-tag
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2025-08-22
.\"    Manual: User Manuals
.\"    Source: timew 1.9.1
.\"  Language: English
.\"
.TH "TIMEW\-TAG" "1" "2025-08-22" "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-tag \- افزودن برچسب به بازه‌های زمانی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBtimew tag\fP [\fI<id>\fP\fB...\fP] \fI<tag>\fP\fB...\fP
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \*(Aqtag\*(Aq برای افزودن یک برچسب به یک بازه زمانی به کار می‌رود.
استفاده از دستور \*(Aqsummary\*(Aq همراه با مشخص کردن شناسه راهنمای \*(Aq:ids\*(Aq، شناسه‌های بازه‌ها را نمایش می‌دهد.
با استفاده از شناسه درست، می‌توانید بازه مورد نظر را برای برچسب‌گذاری مشخص کنید.
.SH "مثال‌ها (EXAMPLES)"
.sp
به‌عنوان مثال، نمایش شناسه‌ها:
.sp
.if n .RS 4
.nf
.fam C
$ timew summary :week :ids
.fam
.fi
.if n .RE
.sp
سپس با انتخاب \*(Aq@2\*(Aq به‌عنوان بازه‌ای که قصد برچسب‌گذاری آن را دارید:
.sp
.if n .RS 4
.nf
.fam C
$ timew tag @2 \*(AqNew Tag\*(Aq
.fam
.fi
.if n .RE
.sp
توجه داشته باشید که می‌توانید چندین بازه را با چندین برچسب، برچسب‌گذاری کنید:
.sp
.if n .RS 4
.nf
.fam C
$ timew tag @2 @10 @23 \*(AqTag One\*(Aq tag2 tag3
.fam
.fi
.if n .RE
.sp
اگر رهگیری زمانِ فعال وجود داشته باشد، هنگامی که می‌خواهید برچسب‌ها را به بازه بازِ جاری اضافه کنید، می‌توانید شناسه را نادیده بگیرید:
.sp
.if n .RS 4
.nf
.fam C
$ timew start foo
$ timew tag bar
.fam
.fi
.if n .RE
.sp
این کار منجر به این می‌شود که بازه جاری دارای برچسب‌های \*(Aqfoo\*(Aq و \*(Aqbar\*(Aq باشد.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBtimew\-lengthen\fP(1),
\fBtimew\-retag\fP(1),
\fBtimew\-shorten\fP(1),
\fBtimew\-summary\fP(1),
\fBtimew\-untag\fP(1)