.\" 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-JMAP" "5" "2025-08-29"
.PP
.SH "نام (NAME)"
.PP
aerc-jmap \- پیکربندی JMAP برای \fBaerc\fR(1)
.PP
.SH "خلاصه (SYNOPSIS)"
.PP
برنامه aerc پروتکل JMAP را مطابق مشخصات RFC 8620 و RFC 8621 پیاده‌سازی می‌کند.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
پیکربندی پایه‌ای JMAP می‌تواند به صورت تعاملی با دستور \fB:new-account\fR
انجام شود.\&
.PP
در فایل \fIaccounts.\&conf\fR (به \fBaerc-accounts\fR(5) مراجعه کنید)، گزینه‌های اختصاصی JMAP زیر
در دسترس هستند:
.PP
\fBsource\fR = \fI<scheme>\fR://[\fI<username>\fR][\fI:<password>@\fR]\fI<hostname>\fR[\fI:<port>\fR]/\fI<path>\fR
.RS 4
به خاطر داشته باشید که تمام فیلدها باید به صورت URL کدگذاری شوند.\& نماد \fI@\fR در صورت کدگذاری
URL، به صورت \fI%40\fR خواهد بود.\&
.PP
عبارت \fI<hostname>\fR[\fI:<port>\fR]/\fI<path>\fR منبع نشست JMAP تحت HTTPS است همان‌طور که
در بخش ۲ از RFC 8620 و بدون طرح پیشوند \fIhttps://\fR مشخص شده است.\&
.PP
مقادیر ممکن برای \fI<scheme>\fR عبارتند از:
.PP
\fIjmap\fR
.RS 4
پروتکل JMAP بر بستر HTTPS با استفاده از احراز هویت Basic.\&
.PP
.RE
\fIjmap+oauthbearer\fR
.RS 4
پروتکل JMAP بر بستر HTTPS با استفاده از احراز هویت OAUTHBEARER
.PP
نام کاربری نادیده گرفته می‌شود و ممکن است خالی رها شود.\& در صورت تعیین گذرواژه، مطمئن شوید که پیشوند
\fI:\fR را قبل از آن قرار می‌دهید تا به صراحت مشخص شود که نام کاربری خالی است.\& یا نام کاربری را بر روی هر مقدار
دلخواهی تنظیم کنید.\& به عنوان مثال:
.PP
.nf
.RS 4
source = jmap+oauthbearer://:s3cr3t@example\&.com/jmap/session
source = jmap+oauthbearer://me:s3cr3t@example\&.com/jmap/session
.fi
.RE
.PP
.RE
اعتبارنامه‌های منبع شما باید دارای قابلیت \fIurn:ietf:params:jmap:mail\fR
باشند.\&
.PP
.RE
\fBsource-cred-cmd\fR = \fI<command>\fR
.RS 4
دستوری را مشخص می‌کند که برای دریافت گذرواژه حساب JMAP اجرا می‌شود.\&
این دستور با استفاده از \fIsh -c command\fR اجرا خواهد شد.\& اگر گذرواژه‌ای
در گزینه \fBsource\fR تعیین شده باشد، آن گذرواژه بر این دستور اولویت
خواهد داشت.\&
.PP
مثال:
.RS 4
source-cred-cmd = pass hostname/username
.PP
.RE
.RE
\fBoutgoing\fR = \fIjmap://\fR
.RS 4
اتصال JMAP همچنین می‌تواند برای ارسال ایمیل‌ها استفاده شود.\& نیازی به تکرار
URL یا هیچ‌گونه اعتبارنامه‌ای نیست.\& تنها طرح URL کافی خواهد بود.\&
.PP
اعتبارنامه‌های منبع شما باید دارای قابلیت \fIurn:ietf:params:jmap:submission\fR
باشند.\&
.PP
.RE
\fBcache-state\fR = \fItrue\fR|\fIfalse\fR
.RS 4
کش کردن تمام وضعیت‌های ایمیل (صندوق‌های پستی، سرآیندهای ایمیل، محتویات صندوق پستی،
پرچم‌های ایمیل و غیره) بر روی دیسک در یک پایگاه‌داده levelDB واقع در پوشه
\fI~/.\&cache/aerc/<account>/state\fR.\&
.PP
داده‌های کش‌شده باید حتی برای مخازن بسیار بزرگ ایمیل نیز کوچک و در حد چند مگابایت
باقی بمانند.\& aerc تمام تلاش خود را برای پاکسازی اطلاعات حذف‌شده/منسوخ انجام خواهد داد.\&
حذف این پوشه در زمانی که aerc در حال اجرا نیست بی‌خطر است و در راه‌اندازی بعدی از ابتدا
بازسازی خواهد شد.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBcache-blobs\fR = \fItrue\fR|\fIfalse\fR
.RS 4
کش کردن تمام بدنه و پیوست‌های دانلودشده ایمیل بر روی دیسک به عنوان فایل‌های جداگانه
در \fI~/.\&cache/aerc/<account>/blobs/<xx>/<blob_id>\fR (که در آن \fI<xx>\fR یک
زیرپوشه است که بر اساس دو نویسه پایانی \fI<blob_id>\fR نام‌گذاری شده است).\&
.PP
برنامه aerc اشیای داده‌ای (blobs) کش‌شده را به‌طور خودکار پاکسازی نخواهد کرد.\&
حتی زمانی که ایمیل‌های مربوط به آن‌ها به‌طور دائمی از سرور حذف شوند.\& در صورت نیاز،
ممکن است بخواهید یک پاکسازی دوره‌ای بر اساس تاریخ ایجاد فایل در crontab اجرا کنید،
به عنوان مثال:
.PP
.RS 4
@daily find ~/.\&cache/aerc/foo/blobs -type f -mtime +30 -delete
.PP
.RE
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBuse-labels\fR = \fItrue\fR|\fIfalse\fR
.RS 4
در صورت تنظیم بر روی \fItrue\fR، صندوق‌های پستی با نقش \fIarchive\fR (معمولاً \fIArchive\fR)
از فهرست دایرکتوری مخفی شده و با یک پوشه مجازی \fBall-mail\fR
جایگزین می‌شوند.\& نام این پوشه را می‌توان از طریق تنظیم
\fBall-mail\fR پیکربندی کرد.\&
.PP
دستور \fB:archive\fR \fIflat\fR همچنان می‌تواند برای "برچسب‌گذاری" موثر پیام‌ها با
صندوق پستی مخفی \fIArchive\fR استفاده شود تا در پوشه مجازی \fBall-mail\fR
نمایش داده شوند.\& هنگامی که پوشه مجازی \fBall-mail\fR انتخاب شده است، \fB:archive\fR \fIflat\fR
نباید استفاده شود و هیچ تاثیری نخواهد داشت.\& پیام‌ها خاکستری خواهند شد
اما تا زمانی که aerc دوباره راه‌اندازی نشود، هرگز بازخوانی نمی‌شوند.\&
.PP
همچنین، این گزینه پشتیبانی از دستور \fB:modify-labels\fR (با نام مستعار \fB:tag\fR)
را فعال می‌کند.\&
.PP
پیش‌فرض: \fIfalse\fR
.PP
.RE
\fBall-mail\fR = \fI<name>\fR
.RS 4
نام پوشه مجازی که در صورت \fBuse-labels\fR = \fItrue\fR جایگزین صندوق پستی با
نقش role=\fIarchive\fR می‌شود.\&
.PP
پیش‌فرض: \fIAll mail\fR
.PP
.RE
\fBserver-ping\fR = \fI<duration>\fR
.RS 4
فاصله زمانی که سرور باید در هنگام نظارت بر تغییرات ایمیل، به کلاینت پینگ ارسال
کند.\& سرور ممکن است این مقدار را نادیده بگیرد.\& به‌طور پیش‌فرض، هیچ پینگی
از سرور درخواست نخواهد شد.\&
.PP
نشانی https://pkg.\&go.\&dev/time#ParseDuration را ببینید.\&
.PP
.RE
.SH "نکات (NOTES)"
.PP
پیام‌های JMAP را می‌توان به عنوان "برچسب‌ها" (labels یا tags) در نظر گرفت.\& هر پیام باید به
یک یا چند صندوق پستی (پوشه‌ها در aerc) تعلق داشته باشد.\& هر صندوق پستی دارای یک "نقش" (role) است همان‌طور
که در نشانی \fIhttps://www.\&iana.\&org/assignments/imap-mailbox-name-attributes\fR شرح داده شده است.\&
.PP
هنگام حذف پیام‌هایی که فقط به صندوق پستی انتخاب‌شده تعلق دارند، aerc تلاش خواهد کرد
تا این پیام‌ها را به صندوق پستی با نقش \fItrash\fR منتقل کند.\& اگر نتواند چنین صندوق پستی را
پیدا کند یا اگر صندوق پستی انتخاب‌شده همان صندوق پستی \fItrash\fR باشد، پیام‌ها به‌طور قطعی
از سرور حذف خواهند شد.\&
.PP
دستور \fB:delete\fR پیام‌ها را از صندوق پستی انتخاب‌شده حذف می‌کند و عملاً همان کار
\fB:tag -<selected_folder>\fR را انجام می‌دهد.\&
.PP
دستور \fB:cp <foo>\fR یک نام مستعار برای \fB:tag <foo>\fR یا \fB:tag +<foo>\fR است.\&
.PP
دستور \fB:mv <foo>\fR ترکیبی از \fB:delete\fR و \fB:mv\fR است و می‌توان آن را به عنوان یک نام مستعار برای
\fB:tag -<selected_folder> +<foo>\fR در نظر گرفت.\&
.PP
دستور \fB:archive\fR \fIflat\fR یک نام مستعار برای \fB:tag -<selected_folder> +<archive>\fR است.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBaerc\fR(1) \fBaerc-accounts\fR(5)
.PP
.SH "نویسندگان (AUTHORS)"
.PP
در ابتدا توسط Drew DeVault ایجاد شد و توسط Robin Jarry با همراهی سایر مشارکت‌کنندگان متن‌باز نگهداری می‌شود.\& برای اطلاعات بیشتر درباره توسعه aerc،
نشانی \fIhttps://sr.\&ht/~rjarry/aerc\fR را ببینید.\&