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

aerc-accounts - قالب فایل پیکربندی حساب‌ها برای aerc(1)

فایل accounts.conf برای پیکربندی هر یک از حساب‌های ایمیل مورد استفاده در aerc به کار می‌رود. انتظار می‌رود این فایل در مسیر پیکربندی XDG شما به همراه aerc قرار داشته باشد که مقدار پیش‌فرض آن ~/.config/aerc/accounts.conf است. این فایل باید محرمانه نگه داشته شود، زیرا ممکن است حاوی اطلاعات احراز هویت حساب شما باشد. می‌توان با استفاده از آرگومان خط فرمان --accounts-conf یک فایل جایگزین را مشخص کرد؛ aerc(1) را ببینید.

اگر accounts.conf وجود نداشته باشد، در اولین راه‌اندازی برنامه، راهنمای گام‌به‌گام پیکربندی :new-account به‌طور خودکار اجرا خواهد شد.

این فایل در قالب ini نوشته می‌شود که در آن هر [بخش] ([section]) نام حسابی است که می‌خواهید پیکربندی کنید، و کلیدها و مقادیر موجود در آن بخش، جزئیات پیکربندی آن حساب را مشخص می‌کنند. گزینه‌های سراسری را می‌توان با قرار دادن آن‌ها در بالای فایل، پیش از بخش‌های اختصاصی هر حساب پیکربندی کرد. این گزینه‌ها را می‌توان برای یک حساب مشخص با بازتعریف آن‌ها در بخش همان حساب رونویسی کرد. علاوه بر گزینه‌های مستندشده در این صفحه، شیوه‌های انتقال (ترنسپورت‌های) خاص برای ایمیل‌های ورودی و خروجی ممکن است پارامترهای پیکربندی بیشتری داشته باشند که در صفحات راهنمای مربوط به خود مستند شده‌اند.

توجه داشته باشید که بسیاری از این گزینه‌های پیکربندی، مانند source و outgoing، هنگام اجرای راهنمای گام‌به‌گام پیکربندی حساب (:new-account) به‌طور خودکار برای شما نوشته می‌شوند.

archive = <folder>

پوشه‌ای را مشخص می‌کند که به عنوان مقصد دستور :archive استفاده می‌شود.

پیش‌فرض: Archive

check-mail = <duration>

بازه زمانی بررسی ایمیل‌های جدید را مشخص می‌کند. ایمیل‌ها هنگام راه‌اندازی برنامه و سپس در هر بازه زمانی بررسی خواهند شد. حساب‌های IMAP ایمیل‌ها را در تمام پوشه‌های انتخاب‌نشده بررسی می‌کنند و پوشه انتخاب‌شده نیز به دریافت اعلان‌های ایمیل PUSH ادامه خواهد داد. پوشه‌های Maildir/Notmuch باید از check-mail-cmd همراه با این گزینه استفاده کنند. برای اطلاعات بیشتر صفحات aerc-maildir(5) و aerc-notmuch(5) را ببینید.

تنظیم این گزینه روی 0 ویژگی check-mail را غیرفعال می‌کند.

مثال:

check-mail = 5m

پیش‌فرض: 0

copy-to = <folder1,folder2,folder3...>

فهرستی جداشده با کاما از پوشه‌هایی را مشخص می‌کند که ایمیل‌های ارسال‌شده در آن‌ها کپی می‌شوند، که معمولاً Sent است.

به‌طور پیش‌فرض، ایمیل در هیچ پوشه‌ای کپی نمی‌شود.

copy-to-replied = true|false

علاوه بر copy-to، پاسخ‌ها را در همان پوشه‌ای که پیام پاسخ‌داده‌شده در آن قرار دارد نیز کپی می‌کند.

پیش‌فرض: false

strip-bcc = true|false

سرفصل‌های Bcc را پیش از ارسال ایمیل‌ها حذف می‌کند. این مورد بر نسخه‌های محلی پیام‌های ارسال‌شده (copy-to و copy-to-replied) نیز اثر می‌گذارد.

برخی از ارائه‌دهندگان/بک‌اندهای ایمیل پیش از ارسال پیام‌ها به گیرندگان، سرفصل‌های Bcc را به‌طور خودکار حذف می‌کنند. پیش از تنظیم این گزینه روی false، برای جلوگیری از نشت هرگونه اطلاعات خصوصی، این موضوع را به‌دقت بررسی کنید.

پیش‌فرض: true

default = <folder>

پوشه پیش‌فرضی را مشخص می‌کند که هنگام راه‌اندازی این حساب توسط aerc، در فهرست پیام‌ها باز می‌شود.

پیش‌فرض: INBOX

folders = <folder1,folder2,folder3...>

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

به‌طور پیش‌فرض، تمام پوشه‌ها نمایش داده می‌شوند.

folders-exclude = <folder1,folder2,folder3...>

فهرستی جداشده با کاما از پوشه‌هایی را مشخص می‌کند که از نوار کناری مستثنی می‌شوند. نام‌هایی که پیشوند ~ دارند، به عنوان عبارات باقاعده تفسیر می‌شوند. توجه داشته باشید که این گزینه بر هر تنظیمی در folders اولویت دارد.

به‌طور پیش‌فرض، هیچ پوشه‌ای مستثنی نمی‌شود.

enable-folders-sort = true|false

اگر مقدار آن true باشد، پوشه‌ها مرتب‌سازی می‌شوند؛ ابتدا بر اساس پوشه‌های مشخص‌شده (folders-sort را ببینید) و سپس به ترتیب الفبایی.

پیش‌فرض: true

folders-sort = <folder1,folder2,folder3...>

فهرستی جداشده با کاما از پوشه‌هایی را مشخص می‌کند که در بالای فهرست و به همان ترتیب ارائه‌شده نمایش داده می‌شوند. پوشه‌های باقی‌مانده به ترتیب الفبایی مرتب خواهند شد.

folder-map = <file>

نگاشت پوشه شامل یک نگاشت یک‌به‌یک از پوشه‌های سرور به نام‌های نمایشی پوشه‌ها است. فایل folder-map در هر خط یک نگاشت به صورت <display-folder-name>=<server-folder-name>[*] را انتظار دارد (ساختار کلید=مقدار مشابه query-map در notmuch). این نگاشت‌ها به همان ترتیبی که در folder-map آمده‌اند اعمال می‌شوند. بک‌اندهای پشتیبانی‌شده: imap، maildir.

توجه داشته باشید که اگر پوشه‌ای تحت تأثیر نگاشت پوشه قرار گیرد، گزینه‌های دیگر حساب مانند archive، default، copy-to، postpone، folders، folders-exclude و folders-sort باید بر این اساس تنظیم شوند.

برای اعمال نگاشت روی زیرپوشه‌ها یا پوشه‌هایی با پیشوند مشابه، علامت '*' را به انتهای نام پوشه سرور اضافه کنید.

مثال‌ها:

نگاشت مجدد یک پوشه تکی:

Spam = [Gmail]/Spam

نگاشت مجدد پوشه و تمام زیرپوشه‌های آن:

G = [Gmail]*

حذف پیشوند برای تمام زیرپوشه‌ها:

* = [Gmail]/*

نگاشت مجدد تمام زیرپوشه‌ها و جلوگیری از تداخل پوشه‌ها:

Archive/existing = Archive*
Archive = OldArchive*

from = <address>

مقدار پیش‌فرضی که برای سرفصل From در ایمیل‌های جدید استفاده می‌شود. این مقدار باید یک رشته سازگار با RFC 5322 باشد، مانند Your Name <you@example.org>.

aliases = <address1,address2,address3...>

تمام نام‌های مستعار حساب جاری. از این مقادیر برای پر کردن فیلد :From استفاده خواهد شد. اطمینان حاصل کنید که سرور ایمیل شما این مقدار را می‌پذیرد، یا برای نمونه از aerc-sendmail(5) در ترکیب با msmtp(1) و گزینه --read-envelope-from استفاده کنید.

یک نام مستعار می‌تواند در بخش آدرس از نویسه‌های عام به سبک fnmatch نیز استفاده کند. این نویسه‌های عام برای آدرس‌های همه‌گیر (catch-all) مفید هستند. برای مثال، نام مستعار "Your Name" <*@you.com> تضمین می‌کند که هنگام پاسخ دادن به ایمیل‌های ارسال‌شده به hi@you.com و contact@you.com، فیلد :From به‌ترتیب روی hi@you.com و contact@you.com تنظیم شود. نام موجود در نام مستعار استفاده می‌شود، نه نام برگرفته از آدرس منطبق.

use-envelope-from = true|false

هنگام ارسال پیام‌ها، به جای گزینه پیکربندی from، از آدرس سرفصل From پاکت ایمیل استفاده می‌کند.

پیش‌فرض: false

original-to-header = <header>

هنگام پاسخ دادن، از نام مستعار آدرس ایمیل مشخص‌شده در این سرفصل استفاده می‌کند.

headers = <header1,header2,header3...>

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

به‌طور پیش‌فرض، تمام سرفصل‌ها واکشی می‌شوند. اگر هر سرفصلی در این فهرست مشخص شود، aerc آن را به فهرست سرفصل‌های الزامی زیر اضافه خواهد کرد:

  • date
  • subject
  • from
  • sender
  • reply-to
  • to
  • cc
  • bcc
  • in-reply-to
  • message-id
  • references

headers-exclude = <header1,header2,header3...>

فهرستی جداشده با کاما از سرفصل‌هایی را مشخص می‌کند که از واکشی مستثنی می‌شوند. توجه داشته باشید که این گزینه بر هر مقداری در headers اولویت دارد.

به‌طور پیش‌فرض، هیچ سرفصلی مستثنی نمی‌شود.

outgoing = <uri>

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

outgoing-cred-cmd = <command>

دستوری اختیاری را مشخص می‌کند که برای دریافت گذرواژه حساب خروجی اجرا می‌شود. برای جزئیات بیشتر صفحه راهنمای هر پروتکل را ببینید.

outgoing-cred-cmd-cache = true|false

به‌طور پیش‌فرض، اطلاعات هویتی برگشت‌داده‌شده توسط دستور تا زمان بسته شدن aerc ذخیره موقت می‌شوند. در صورت تنظیم روی false، هر بار که قرار است ایمیلی ارسال شود، outgoing-cred-cmd اجرا خواهد شد.

پیش‌فرض: true

pama-auto-switch = true|false

اگر مقدار آن true باشد، در صورتی که موضوع پیام حاوی بخش '[PATCH <project>]' باشد، مدیر وصله برای دستور :patch به‌طور خودکار به پروژه موجود تغییر وضعیت می‌دهد.

پیش‌فرض: false

pgp-auto-sign = true|false

اگر مقدار آن true باشد، تمام ایمیل‌های خروجی از این حساب امضا خواهند شد (در صورتی که کلید امضا در دسترس باشد).

پیش‌فرض: false

pgp-attach-key = true|false

اگر مقدار آن true باشد، کلید عمومی امضا به ایمیل‌های خروجی امضاشده پیوست می‌شود.

پیش‌فرض: false

pgp-self-encrypt = true|false

اگر مقدار آن true باشد، هر ایمیل رمزگذاری‌شده خروجی، برای فرستنده یا کلید مشخص‌شده در pgp-key-id نیز رمزگذاری خواهد شد.

پیش‌فرض: false

pgp-error-level = none|warn|error

سطح خطایی که هنگام عدم امکان انجام رمزگذاری خودکار و مقتضی نمایش داده می‌شود. pgp-opportunistic-encryption را ببینید.

پیش‌فرض: warn

pgp-key-id = <key-id>

شناسه کلید مورد استفاده هنگام امضای پیام را مشخص می‌کند. می‌تواند شناسه کلید کوتاه یا بلند باشد. در صورت عدم تنظیم، aerc کلید را بر اساس ایمیل جستجو خواهد کرد.

pgp-opportunistic-encrypt = true|false

اگر مقدار آن true باشد، هر ایمیل خروجی از این حساب در صورتی که تمام گیرندگان (شامل فیلدهای Cc و Bcc) کلید عمومی در دسترسی در دسته‌کلید داشته باشند، رمزگذاری خواهد شد. سطح خطایی که در هنگام عدم امکان رمزگذاری پیام نمایش داده می‌شود، با pgp-error-level قابل پیکربندی است.

پیش‌فرض: false

postpone = <folder>

پوشه‌ای را برای ذخیره پیام‌های به تعویق افتاده مشخص می‌کند.

پیش‌فرض: Drafts

send-as-utc = true|false

برچسب زمانی سرفصل Date را به UTC تبدیل می‌کند.

پیش‌فرض: false

send-with-hostname = true|false

در سرفصل‌های Message-Id خروجی، به جای نام دامنه آدرس ایمیل شما، از نام میزبان محلی استفاده می‌کند.

پیش‌فرض: false

source = <uri>

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

source-cred-cmd = <command>

دستوری اختیاری را مشخص می‌کند که برای دریافت گذرواژه حساب مبدأ اجرا می‌شود. برای جزئیات بیشتر صفحه راهنمای هر پروتکل را ببینید.

signature-file = <path>

فایلی را مشخص می‌کند که برای دریافت امضای افزوده‌شده به ایمیل‌های ارسالی از این حساب، باید خوانده شود.

لطفاً توجه داشته باشید که طبق قرارداد سبک امضای یوزنت (Usenet)، دو خط تیره که به دنبال آن یک فاصله قرار دارد ("-- ") باید در بالای امضا قرار گیرد تا محتوا و امضا از یکدیگر جدا شوند. اگر این جداکننده از قبل وجود نداشته باشد، aerc آن را اضافه خواهد کرد.

signature-cmd = <command>

دستوری را برای اجرا با sh -c مشخص می‌کند تا امضای افزوده‌شده به ایمیل‌های ارسالی از این حساب به دست آید. در صورت ناموفق بودن دستور، به جای آن از signature-file استفاده می‌شود.

trusted-authres = <host1,host2,host3...>

فهرستی جداشده با کاما از نام‌های میزبان قابل اعتماد که سرفصل نتایج احراز هویت (Authentication Results) برگرفته از آن‌ها نمایش داده می‌شود. ورودی‌ها می‌توانند عبارات باقاعده باشند. اگر می‌خواهید به هر میزبانی اعتماد کنید (مثلاً برای اشکال‌زدایی)، از نویسه عام * استفاده کنید.

subject-re-pattern = <regexp>

هنگام پاسخ دادن به یک پیام، این همان عبارت باقاعده‌ای است که برای تطبیق پیشوند موضوع پیام اصلی که باید برای ایجاد عنوان موضوع پیام جدید حذف شود، به کار می‌رود. معمولاً از این گزینه برای جلوگیری از تکرار پیشوند :Re در سرفصل موضوع استفاده می‌شود. مقدار پیش‌فرض با ترجمه‌های شناخته‌شده برای :Re متداول مطابقت دارد.

پیش‌فرض: (?i)^((AW|RE|SV|VS|ODP|R): ?)+

restrict-delete = true|false

مشخص می‌کند که آیا حذف فوری ایمیل‌ها (در مقایسه با انتقال به سطل زباله) از هر پوشه‌ای مجاز است یا خیر. هنگامی که مقدار آن true باشد، حذف تنها از پوشه‌های Trash یا Junk مجاز خواهد بود.

پیش‌فرض: false

aerc(1) aerc-config(5) aerc-imap(5) aerc-jmap(5) aerc-maildir(5) aerc-notmuch(5) aerc-sendmail(5) aerc-smtp(5)

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

2025-08-29