'\" t
.\"     Title: localsearch-tag
.\"    Author: The LocalSearch developers
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 09/01/2026
.\"    Manual: LocalSearch manual
.\"    Source: \ \& 3.11.2
.\"  Language: Persian
.\"
.TH "LOCALSEARCH\-TAG" "1" "09/01/2026" "\ \& 3\&.11\&.2" "LocalSearch manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
localsearch-tag \- افزودن، حذف و فهرست کردن برچسب‌ها\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
localsearch tag FILE [\-l <limit>] [\-o <offset>] [\-r]
localsearch tag \-t [\-s] [\-r] FILE
localsearch tag \-a <TAG> [\-e <description>]
localsearch tag \-d <TAG>
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
فهرست کردن برچسب‌ها برای فایل‌های محلی، یا بر اساس خود عنوان‌های برچسب در صورت استفاده از \-t\&.
.sp
همچنین مدیریت برچسب‌ها با استفاده از گزینه‌های \-a و \-d امکان‌پذیر است\&.
.sp
آرگومان \fIFILE\fR می‌تواند یک مسیر محلی یا یک URI باشد\&. همچنین نیازی نیست که حتماً یک مسیر مطلق باشد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-t, \-\-list\fR
.RS 4
فهرست کردن تمام برچسب‌ها\&. نتایج شامل تعداد فایل‌های مرتبط با آن برچسب و شناسهٔ یکتای برچسب خواهد بود\&. با استفاده از \-\-show\-files می‌توانید فایل‌های مرتبط با هر برچسب را نمایش دهید\&.
.RE
.PP
\fB\-s, \-\-show\-files\fR
.RS 4
نمایش فایل‌های مرتبط با هر برچسب\&. این گزینه تنها همراه با گزینهٔ
\fB\-\-list\fR
در دسترس است\&.
.RE
.PP
\fB\-a, \-\-add=TAG\fR
.RS 4
افزودن برچسبی با نام
\fITAG\fR\&. اگر هیچ آرگومان
\fIFILE\fR
مشخص نشده باشد، برچسب صرفاً ایجاد می‌شود (اگر از پیش وجود نداشته باشد) و هیچ فایلی به آن منتسب نخواهد شد\&.
.RE
.PP
\fB\-d, \-\-delete=TAG\fR
.RS 4
حذف برچسبی با نام
\fITAG\fR\&. اگر هیچ آرگومان
\fIFILE\fR
مشخص نشده باشد، برچسب برای همهٔ فایل‌ها حذف می‌شود\&.
.RE
.PP
\fB\-e, \-\-description=STRING\fR
.RS 4
این گزینه تنها هنگام استفاده از
\fB\-\-add\fR
کاربرد دارد و توضیحی مطابق با
\fISTRING\fR
برای عنوان برچسب فراهم می‌کند\&.
.RE
.PP
\fB\-l, \-\-limit=N\fR
.RS 4
محدود کردن جستجو به N نتیجه\&. مقدار پیش‌فرض 512 است\&.
.RE
.PP
\fB\-o, \-\-offset=N\fR
.RS 4
جابه‌جایی (آفست) نتایج جستجو به اندازهٔ N\&. برای نمونه، شروع از مورد شمارهٔ 10 در نتایج\&. مقدار پیش‌فرض 0 است\&.
.RE
.sp
.if n \{\
.RS 4
.\}
.nf
$ localsearch tag \-s \-t banana
.fi
.if n \{\
.RE
.\}
.sp
باید فایل‌هایی از پایگاه‌داده را نمایش دهد که دارای برچسب \fIbanana\fR هستند\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBlocalsearch search\fR(1), \fBlocalsearch info\fR(1)\&.