AERC-NOTMUCH(5) File Formats Manual AERC-NOTMUCH(5)

aerc-notmuch - پیکربندی notmuch برای کلاینت ایمیل aerc

برنامه aerc از سیستم ایمیل notmuch به عنوان بک‌اند جهت نمایه‌سازی سریع و جستجو پشتیبانی می‌کند.

برای فعال‌سازی این قابلیت، aerc باید همراه با پشتیبانی از notmuch کامپایل و ساخته شده باشد. برای اطلاعات بیشتر به دستورالعمل‌های نصب مراجعه فرمایید.

پیکربندی پایه‌ای Notmuch می‌تواند به صورت تعاملی با دستور :new-account انجام شود.

در فایل accounts.conf (به aerc-accounts(5) مراجعه فرمایید)، گزینه‌های اختصاصی notmuch زیر در دسترس هستند:

check-mail-cmd = <command>

دستوری که در ارتباط با گزینه check-mail اجرا می‌شود.

مثال:

check-mail-cmd = mbsync -a

check-mail-timeout = <duration>

مدت زمان انقضا (مهلت زمانی) برای check-mail-cmd. اگر دستور در این بازه زمانی به پایان نرسد، متوقف شده و خطایی نمایش داده می‌شود. در صورت بروز خطاهای مکرر، این مقدار را از مقدار پیش‌فرض افزایش دهید.

پیش‌فرض: 10s

source = notmuch://<path>

گزینه source مسیر پوشه‌ای را مشخص می‌کند که شامل پایگاه‌داده notmuch شما است (معمولاً یک پوشه .notmuch/).

بخش مسیر در نشانی اینترنتی (URL) پس از notmuch:// باید یک مسیر مطلق باشد که با / شروع می‌شود یا یک مسیر نسبی نسبت به پوشه خانگی (home) شما باشد که با ~ آغاز می‌شود. برای مثال:

source = notmuch:///home/me/mail

source = notmuch://~/mail

query-map = <file>

مسیر فایلی شامل نگاشت از نام نمایشی به پرسمان notmuch به صورت <NAME>=<QUERY>.

می‌توان چندین مدخل را مشخص کرد که در هر سطر یکی قرار می‌گیرد. خطوطی که با # شروع می‌شوند نادیده گرفته شده و به عنوان یادداشت (کامنت) در نظر گرفته می‌شوند.

به عنوان مثال: inbox=tag:inbox and not tag:archived

exclude-tags = <tag1,tag2,tag3...>

فهرستی از برچسب‌ها که با کاما از هم جدا شده‌اند و از نتایج جستجو مستثنی می‌شوند، مگر آنکه صراحتاً در پرسمان ذکر شده باشند.

این گزینه برای مثال زمانی کاربرد دارد که از برچسب archive یا spam استفاده می‌کنید.

maildir-store = <path>

مسیر ذخیره‌ساز maildir که شامل فایل‌های پیام پشتیبان پایگاه‌داده notmuch است. این مسیر اغلب همان مسیر پایگاه‌داده notmuch است. در صورت مشخص شدن، این گزینه توسط aerc برای فهرست کردن پوشه‌های موجود و فعال‌سازی دستوراتی مانند :delete و :archive استفاده می‌شود.

نکته مهم: aerc همچنان همیشه پیام‌ها را نمایش می‌دهد و نه فایل‌ها را (در notmuch، یک پیام منفرد می‌تواند توسط چندین فایل نشان داده شود)، که این امر مفهوم برخی دستورات نظیر move را مبهم می‌سازد. از گزینه multi-file-strategy استفاده کنید تا به aerc بگویید چگونه این ابهامات را برطرف کند.

maildir-account-path = <path>

مسیر حساب maildir به صورت نسبی نسبت به maildir-store.

این گزینه می‌تواند برای دستیابی به رفتار سنتی maildir مبنی بر یک برگه برای هر حساب کاربری به کار رود. نکته ذکرشده در مورد maildir-store برای این گزینه نیز صدق می‌کند.

multi-file-strategy = <strategy>

راهبرد عملیات فایل (مانند انتقال، رونوشت، حذف) روی پیام‌هایی که توسط چندین فایل پشتیبانی می‌شوند. مقادیر ممکن عبارتند از:
  • refuse (پیش‌فرض): از انجام عملیات خودداری می‌کند.
  • act-all: روی تمامی فایل‌ها عمل می‌کند.
  • act-one: روی یکی از فایل‌ها که به صورت اختیاری انتخاب شده عمل کرده و از بقیه چشم‌پوشی می‌کند.
  • act-one-delete-rest: مانند act-one، اما فایل‌های باقی‌مانده را حذف می‌کند.
  • act-dir: روی تمامی فایل‌های موجود در پوشه فعلی عمل کرده و از بقیه چشم‌پوشی می‌کند. توجه داشته باشید که این راهبرد فقط در داخل پوشه‌های maildir کار می‌کند؛ در سایر پوشه‌ها مانند refuse رفتار می‌کند.
  • act-dir-delete-rest: مانند act-dir، اما فایل‌های باقی‌مانده را حذف می‌کند.

توجه داشته باشید که این راهبرد تاثیری بر عملیات میان حساب‌های کاربری ندارد. رونوشت کردن یک پیام میان حساب‌ها همیشه یک فایل منفرد را که به صورت اختیاری انتخاب شده رونوشت می‌کند. انتقال دادن یک پیام میان حساب‌ها همیشه یک فایل منفرد را که به صورت اختیاری انتخاب شده منتقل می‌کند و از حذف چند فایل از حساب مبدا خودداری می‌کند.

عملکرد Notmuch تفاوت‌های اندکی با مواردی همچون IMAP دارد. برخی دستورات از نظر معنایی کمی متفاوت هستند که در زیر ذکر شده‌اند:

cf <notmuch query>

دستور تغییر پوشه امکان اجرای هرگونه پرسمان دلخواه notmuch را فراهم می‌سازد. اجرای دستور :cf یک پرسمان جدید در سطح بالا (top-level) در notmuch اجرا می‌کند.

filter <notmuch query>

دستور فیلتر برای بک‌اندهای notmuch پرسمان‌های دلخواه notmuch را دریافت می‌کند. این دستور پرسمان را روی مجموعه پیام‌های نمایش داده‌شده در فهرست پیام‌ها اعمال می‌نماید. این کار می‌تواند برای اعمال فیلترها یا پرسمان‌های پی‌درپی استفاده شود و معادل اجرای مجموعه‌ای از پرسمان‌ها است که با «and» به یکدیگر متصل شده‌اند.

aerc(1), aerc-accounts(5), aerc-smtp(5), aerc-maildir(5)

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

https://sr.ht/~rjarry/aerc

2025-08-29