.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "AERC-SEARCH" "1" "2025-08-29"
.PP
.SH "نام (NAME)"
.PP
aerc-search \- الگوها و سینتکس جستجو در aerc
.PP
.SH "سینتکس (SYNTAX)"
.PP
این سینتکس برای تمامی بک‌اندها مشترک است.\&
.PP
\fB:filter\fR [\fB-rubae\fR] [\fB-x\fR \fI<flag>\fR] [\fB-X\fR \fI<flag>\fR] [\fB-H\fR \fI<header>:[<value>]\fR] [\fB-f\fR \fI<from>\fR] [\fB-t\fR \fI<to>\fR] [\fB-c\fR \fI<cc>\fR] [\fB-d\fR \fI<start[.\&.\&end]>\fR] [\fI<terms>\fR.\&.\&.\&]
.br
\fB:search\fR [\fB-rubae\fR] [\fB-x\fR \fI<flag>\fR] [\fB-X\fR \fI<flag>\fR] [\fB-H\fR \fI<header>:[<value>]\fR] [\fB-f\fR \fI<from>\fR] [\fB-t\fR \fI<to>\fR] [\fB-c\fR \fI<cc>\fR] [\fB-d\fR \fI<start[.\&.\&end]>\fR] [\fI<terms>\fR.\&.\&.\&]
.RS 4
پوشه جاری را برای پیام‌های منطبق با مجموعه شرایط داده‌شده جستجو می‌کند.\&
.PP
دستور \fB:filter\fR پیام‌های نمایش‌داده‌شده را تنها به نتایج جستجو محدود می‌کند.\&
.PP
هر عبارت جداشده با فاصله در \fI<terms>\fR، در صورت ارائه، بدون حساسیت به حروف بزرگ و کوچک در میان خطوط موضوع جستجو می‌شود مگر اینکه \fB-b\fR یا \fB-a\fR ارائه شده باشند.\&
.PP
\fB-r\fR: جستجو برای پیام‌های خوانده‌شده
.PP
\fB-u\fR: جستجو برای پیام‌های خوانده‌نشده
.PP
\fB-x\fR \fI<flag>\fR, \fB-X\fR \fI<flag>\fR: محدود کردن جستجو به پیام‌های دارای یا فاقد \fI<flag>\fR
.RS 4
از \fB-x\fR برای جستجوی پیام‌هایی با پرچم تنظیم‌شده استفاده کنید.\&
از \fB-X\fR برای جستجوی پیام‌هایی بدون پرچم تنظیم‌شده استفاده کنید.\&
.PP
مقادیر ممکن عبارتند از:
.RS 4
\fIseen\fR
.RS 4
پیام‌های خوانده‌شده
.RE
\fIanswered\fR
.RS 4
پیام‌های پاسخ‌داده‌شده
.RE
\fIforwarded\fR
.RS 4
پیام‌های هدایت‌شده (فورواردشده)
.RE
\fIflagged\fR
.RS 4
پیام‌های پرچم‌دار (نشان‌دار)
.RE
\fIdraft\fR
.RS 4
پیام‌های پیش‌نویس
.PP
.RE
.RE
.RE
\fB-H\fR \fI<header>:[<value>]\fR:
.RS 4
جستجو در سرآیندهای پیام‌ها برای یک \fI<header>\fR مشخص که با \fI<value>\fR تطابق دارد،
می‌توان از \fI<value>\fR صرف‌نظر کرد تا تنها برای یک \fI<header>\fR جستجو شود.\&
اگر \fI<header>\fR یا \fI<value>\fR شامل فاصله باشند، کل آرگومان باید با نقل‌قول اسکیپ شود؛ توجه: فاصله‌های اطراف \fI<value>\fR حذف می‌شوند.\&
.PP
.RE
\fB-b\fR: جستجو در متن بدنه پیام‌ها
.PP
\fB-a\fR: جستجو در کل متن پیام‌ها
.PP
\fB-e\fR: دستور به بک‌اند برای استفاده از یک افزونه جستجوی سفارشی
.RS 4
(مانند X-GM-EXT-1 در صورت در دسترس بودن).\& عبارت‌های جستجو در \fI<terms>\fR انتظار می‌روند؛ سایر فلگ‌ها نادیده گرفته خواهند شد.\&
.PP
.RE
\fB-f\fR \fI<from>\fR: جستجو برای پیام‌های ارسال‌شده از \fI<from>\fR
.PP
\fB-t\fR \fI<to>\fR: جستجو برای پیام‌های ارسال‌شده به \fI<to>\fR
.PP
\fB-c\fR \fI<cc>\fR: جستجو برای پیام‌های رونوشت‌شده (cc) به \fI<cc>\fR
.PP
\fB-d\fR \fI<since[.\&.\&until]>\fR:
.RS 4
جستجو برای پیام‌ها در یک بازه تاریخی مشخص بین \fIsince\fR و \fIuntil\fR، به استثنای مورد دوم (در نمادگذاری ریاضی: جستجو برای پیام‌ها در بازه [\fIsince\fR, \fIuntil\fR)).\& می‌توان \fIuntil\fR را حذف کرد تا فقط از \fI<since>\fR تا زمان حال جستجو شود.\&
.PP
استفاده از فاصله‌ها و زیرخط‌ها در تاریخ‌های نسبی برای بهبود خوانایی مجاز است.\&
.PP
\fIYYYY-MM-DD\fR
.PP
\fBtoday\fR, \fByesterday\fR
.PP
\fB(this|last) (year|month|week)\fR
.PP
\fBWeekdays\fR, \fBMonthnames\fR
.RS 4
می‌توانند مخفف نیز شوند، بنابراین Monday.\&.\&Tuesday می‌تواند به صورت Mon.\&.\&Tue و February.\&.\&March به صورت Feb.\&.\&Mar نوشته شود.\&
.PP
.RE
\fI<N>\fR \fB(y[ear]|m[onth]|w[eek]|d[ay])\fR
.RS 4
\fI<N>\fR یک عدد صحیح مثبت است که نشان‌دهنده تعداد واحدهای زمانی در گذشته است.\& چندین عبارت نسبی می‌توانند با یکدیگر ترکیب شوند.\& واحدها را می‌توان با یک تک‌حرف نیز مخفف کرد، به طوری که yesterday متناظر با \fI1d\fR (معادل با \fI1 day\fR یا \fI1_day\fR) خواهد بود و \fI8 days ago\fR به صورت \fI1w1d\fR یا \fI8d\fR خواهد بود.\&
.PP
.RE
.RE
.RE
.SH "افزونه‌های سفارشی IMAP (CUSTOM IMAP EXTENSIONS)"
.PP
افزونه IMAP جیمیل (X-GM-EXT-1) می‌تواند برای جستجو و فیلتر کردن استفاده شود.\& جهت استفاده از این افزونه سفارشی، اطمینان حاصل کنید که فعال است (به \fBaerc-imap\fR(5) مراجعه کنید) و از فلگ افزونه \fB-e\fR در دستورات \fB:filter\fR یا \fB:search\fR خود استفاده کنید.\&
.PP
.RS 4
مثال:
.PP
.RS 4
:filter -e filename:pdf from:bob
:filter -e has:attachment newer_than:2d
.PP
:search -e is:read is:starred
:search -e list:~rjarry/aerc-devel@lists.\&sr.\&ht
.PP
.PP
.RE
.RE
.SH "نات‌ماچ (NOTMUCH)"
.PP
برای notmuch، امکان اجتناب از استفاده از فلگ‌های فوق و تکیه صرف بر سینتکس جستجوی notmuch وجود دارد.\&
.PP
\fB:filter\fR \fIquery\fR.\&.\&.\&
.br
\fB:search\fR \fIquery\fR.\&.\&.\&
.RS 4
می‌توانید از زبان کامل پرس‌وجوی notmuch همان‌طور که در \fBnotmuch-search-terms\fR(7) شرح داده شده است استفاده کنید.\&
.PP
پرس‌وجو تنها بر روی پرس‌وجوی پوشه فعال اعمال خواهد شد.\&
.PP
مثال، پرش به پیام خوانده‌نشده بعدی:
.PP
.RS 4
:search tag:unread
.PP
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBaerc\fR(1) \fBaerc-config\fR(5)
.PP
.SH "نویسندگان (AUTHORS)"
.PP
در ابتدا توسط Drew DeVault ایجاد شد و توسط Robin Jarry با همراهی سایر مشارکت‌کنندگان متن‌باز نگهداری می‌شود.\& برای اطلاعات بیشتر درباره توسعه aerc، به \fIhttps://sr.\&ht/~rjarry/aerc\fR مراجعه کنید.\&