AERC-SEARCH(1) General Commands Manual AERC-SEARCH(1)

aerc-search - الگوها و سینتکس جستجو در aerc

این سینتکس برای تمامی بک‌اندها مشترک است.

:filter [-rubae] [-x <flag>] [-X <flag>] [-H <header>:[<value>]] [-f <from>] [-t <to>] [-c <cc>] [-d <start[..end]>] [<terms>...]
:search [-rubae] [-x <flag>] [-X <flag>] [-H <header>:[<value>]] [-f <from>] [-t <to>] [-c <cc>] [-d <start[..end]>] [<terms>...]

پوشه جاری را برای پیام‌های منطبق با مجموعه شرایط داده‌شده جستجو می‌کند.

دستور :filter پیام‌های نمایش‌داده‌شده را تنها به نتایج جستجو محدود می‌کند.

هر عبارت جداشده با فاصله در <terms>، در صورت ارائه، بدون حساسیت به حروف بزرگ و کوچک در میان خطوط موضوع جستجو می‌شود مگر اینکه -b یا -a ارائه شده باشند.

-r: جستجو برای پیام‌های خوانده‌شده

-u: جستجو برای پیام‌های خوانده‌نشده

-x <flag>, -X <flag>: محدود کردن جستجو به پیام‌های دارای یا فاقد <flag>

از -x برای جستجوی پیام‌هایی با پرچم تنظیم‌شده استفاده کنید. از -X برای جستجوی پیام‌هایی بدون پرچم تنظیم‌شده استفاده کنید.

مقادیر ممکن عبارتند از:

seen
پیام‌های خوانده‌شده
answered
پیام‌های پاسخ‌داده‌شده
forwarded
پیام‌های هدایت‌شده (فورواردشده)
flagged
پیام‌های پرچم‌دار (نشان‌دار)
draft
پیام‌های پیش‌نویس

-H <header>:[<value>]:

جستجو در سرآیندهای پیام‌ها برای یک <header> مشخص که با <value> تطابق دارد، می‌توان از <value> صرف‌نظر کرد تا تنها برای یک <header> جستجو شود. اگر <header> یا <value> شامل فاصله باشند، کل آرگومان باید با نقل‌قول اسکیپ شود؛ توجه: فاصله‌های اطراف <value> حذف می‌شوند.

-b: جستجو در متن بدنه پیام‌ها

-a: جستجو در کل متن پیام‌ها

-e: دستور به بک‌اند برای استفاده از یک افزونه جستجوی سفارشی

(مانند X-GM-EXT-1 در صورت در دسترس بودن). عبارت‌های جستجو در <terms> انتظار می‌روند؛ سایر فلگ‌ها نادیده گرفته خواهند شد.

-f <from>: جستجو برای پیام‌های ارسال‌شده از <from>

-t <to>: جستجو برای پیام‌های ارسال‌شده به <to>

-c <cc>: جستجو برای پیام‌های رونوشت‌شده (cc) به <cc>

-d <since[..until]>:

جستجو برای پیام‌ها در یک بازه تاریخی مشخص بین since و until، به استثنای مورد دوم (در نمادگذاری ریاضی: جستجو برای پیام‌ها در بازه [since, until)). می‌توان until را حذف کرد تا فقط از <since> تا زمان حال جستجو شود.

استفاده از فاصله‌ها و زیرخط‌ها در تاریخ‌های نسبی برای بهبود خوانایی مجاز است.

YYYY-MM-DD

today, yesterday

(this|last) (year|month|week)

Weekdays, Monthnames

می‌توانند مخفف نیز شوند، بنابراین Monday..Tuesday می‌تواند به صورت Mon..Tue و February..March به صورت Feb..Mar نوشته شود.

<N> (y[ear]|m[onth]|w[eek]|d[ay])

<N> یک عدد صحیح مثبت است که نشان‌دهنده تعداد واحدهای زمانی در گذشته است. چندین عبارت نسبی می‌توانند با یکدیگر ترکیب شوند. واحدها را می‌توان با یک تک‌حرف نیز مخفف کرد، به طوری که yesterday متناظر با 1d (معادل با 1 day یا 1_day) خواهد بود و 8 days ago به صورت 1w1d یا 8d خواهد بود.

افزونه IMAP جیمیل (X-GM-EXT-1) می‌تواند برای جستجو و فیلتر کردن استفاده شود. جهت استفاده از این افزونه سفارشی، اطمینان حاصل کنید که فعال است (به aerc-imap(5) مراجعه کنید) و از فلگ افزونه -e در دستورات :filter یا :search خود استفاده کنید.

مثال:
:filter -e filename:pdf from:bob :filter -e has:attachment newer_than:2d

:search -e is:read is:starred :search -e list:~rjarry/aerc-devel@lists.sr.ht

برای notmuch، امکان اجتناب از استفاده از فلگ‌های فوق و تکیه صرف بر سینتکس جستجوی notmuch وجود دارد.

:filter query...
:search query...

می‌توانید از زبان کامل پرس‌وجوی notmuch همان‌طور که در notmuch-search-terms(7) شرح داده شده است استفاده کنید.

پرس‌وجو تنها بر روی پرس‌وجوی پوشه فعال اعمال خواهد شد.

مثال، پرش به پیام خوانده‌نشده بعدی:

:search tag:unread

aerc(1) aerc-config(5)

در ابتدا توسط Drew DeVault ایجاد شد و توسط Robin Jarry با همراهی سایر مشارکت‌کنندگان متن‌باز نگهداری می‌شود. برای اطلاعات بیشتر درباره توسعه aerc، به https://sr.ht/~rjarry/aerc مراجعه کنید.

2025-08-29