.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "LEI-MAIL-FORMATS 5" .TH LEI-MAIL-FORMATS 5 1993-10-02 public-inbox.git "public-inbox user manual" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" lei\-mail\-formats \- قالب‌های نامه پشتیبانی‌شده توسط lei .SH "توضیحات (DESCRIPTION)" .IX Header "توضیحات (DESCRIPTION)" دستور \&\fBlei\-q\fR\|(1) از نوشتن در چندین قالب رایج نامه برای هم‌کنش‌پذیری با کارخواه‌های کاربری نامه (MUA) پشتیبانی می‌کند؛ در ادامه برای کمک به کاربران در انتخاب قالب، مروری بر آن‌ها آورده شده است. .SH Maildir .IX Header "Maildir" قالب خروجی پیش‌فرض هنگام ارائه یک مسیر فایل‌سیستم است و از دسترسی خواندن و نوشتن موازی پشتیبانی می‌کند. عملکرد آن برای دایرکتوری‌های کوچک‌تر قابل قبول است، اما با بزرگ‌تر شدن صندوق‌های پستی کاهش می‌یابد. سرعت و مقیاس‌پذیری به دلیل استفاده از فایل‌های کوچک و تعداد زیاد فراخوان‌های سیستمی (syscalls)، توسط عملکرد هسته و فایل‌سیستم محدود می‌شود. .PP همچنین ببینید: و .SH "خانواده Mbox (Mbox family)" .IX Header "Mbox family" خانواده mbox شامل چندین قالب ناسازگار با یکدیگر است. قفل‌گذاری برای دسترسی موازی پشتیبانی می‌شود، اما ممکن است میان ابزارهای گوناگون سازگار نباشد. با فشرده‌سازی (مانند \&\fBgzip\fR\|(1))، این قالب‌ها کمترین میزان فضا را مصرف می‌کنند و در عین حال عملکرد فقط‌خواندنی خوبی ارائه می‌دهند. .PP به‌روزرسانی کلیدواژه‌ها (سرفصل‌های \&\f(CW\*(C`Status:\*(C'\fR و/یا \&\f(CW\*(C`X\-Status:\*(C'\fR) عموماً نیازمند بازنویسی کل فایل mbox است. .PP همچنین ببینید: ، \&\fBmbox\fR\|(5) .SS mboxo .IX Subsection "mboxo" قالب سنتی BSD است. این قالب \&\f(CW\*(C`From \*(C'\fR را به \&\f(CW\*(C`>From \*(C'\fR نقل‌قول (quote) می‌کند، اما خطوطی که پیشاپیش با \&\f(CW\*(C`>From \*(C'\fR آغاز شده‌اند نقل‌قول نمی‌شوند، از این رو بازگشت‌پذیری خودکار تضمین نمی‌گردد. برنامه‌های MUA که از "mboxcl" یا "mboxcl2" پشتیبانی می‌کنند ممکن است این موارد را به‌صورت خودکار به قالب ترجیحی خود تبدیل کنند. .PP کوتاه‌شدگی فایل (Truncation) غیرقابل تشخیص است، مگر اینکه با gzip یا مشابه‌های آن فشرده شده باشد. .SS mboxrd .IX Subsection "mboxrd" تکاملی از "mboxo" است، اما خطوط \&\f(CW\*(C`From \*(C'\fR را که با هر تعداد کاراکتر \&\f(CW\*(C`>\*(C'\fR پیشوند خورده باشند نقل‌قول می‌کند و بنابراین کاملاً بازگشت‌پذیر است. .PP این قالب توسط \&\fBPublicInbox::WWW\fR\|(3pm) همراه با gzip تولید می‌شود. از نسخه 2.10 ابزار git، دستور \&\f(CW\*(C`git am \-\-patch\-format=mboxrd\*(C'\fR این قالب را می‌خواند. دستورات \&\f(CW\*(C`git log\*(C'\fR و \&\f(CW\*(C`git format\-patch \-\-stdout\*(C'\fR نیز می‌توانند با سوییچ \&\f(CW\*(C`\-\-pretty=mboxrd\*(C'\fR این قالب را تولید کنند. .PP همانند "mboxo" فشرده‌نشده، فایل‌های mboxrd فشرده‌نشده نیز در برابر کوتاه‌شدگی غیرقابل تشخیص آسیب‌پذیر هستند. .PP این قالب در برنامه‌های MUA که از آن ناآگاه هستند، بدون مشکل به رفتاری مشابه "mboxo" تنزل می‌یابد، زیرا نقل‌قول‌های اضافی \&\f(CW\*(C`>From \*(C'\fR برای انسان قابل تشخیص است. .SS mboxcl .IX Subsection "mboxcl" همان "mboxo" با سرفصل \&\f(CW\*(C`Content\-Length:\*(C'\fR است؛ خطوط \&\f(CW\*(C`From \*(C'\fR همچنان نقل‌قول باقی می‌مانند تا خوانایی با MUAهای مبتنی بر "mboxo" و "mboxrd" حفظ شود. با این حال، هنگام استفاده از ابزارهایی که از \&\f(CW\*(C`Content\-Length:\*(C'\fR آگاه نیستند و به‌روزرسانی‌ها را با ساختار "mboxo" می‌نویسند، خراب شدن این فایل‌ها بسیار محتمل است. .PP برنامه \&\fBmutt\fR\|(1) هنگام باز کردن فایل، قالب‌های "mboxo" و "mboxrd" را به mboxcl تبدیل می‌کند. .PP همچنین ببینید: .SS mboxcl2 .IX Subsection "mboxcl2" مشابه "mboxcl" است، اما بدون هرگونه نقل‌قول برای \&\f(CW\*(C`From \*(C'\fR. این قالب به‌طور کامل با MUAهایی که فقط از "mboxo" و/یا "mboxrd" پشتیبانی می‌کنند ناسازگار است. این قالب توسط \&\fBmutt\fR\|(1) هنگام نوشتن در یک mbox جدید تولید می‌شود. .SH MH .IX Header "MH" پشتیبانی مقدماتی برای خواندن از نسخه 2.0.0 فراهم شده است. معناشناسی قفل‌گذاری میان نویسنده‌های موجود به شکلی ناسازگار تفاوت دارد: Python و nmh با یکدیگر سازگار به نظر می‌رسند، در حالی که mutt به دلیل احتمال بازنویسی و تخریب فایل \&\f(CW\*(C`.mh_sequences\*(C'\fR توسط \&\fBrename\fR\|(2)، مستعد تداخل و برای دسترسی موازی نامناسب به نظر می‌رسد. اطلاعات بیشتر درباره دیگر کلاینت‌ها بسیار مورد استقبال خواهد بود. .PP شماره‌های توالی ممکن است توسط برخی از ابزارهای نویسنده فشرده (pack) و مجدداً استفاده شوند؛ بنابراین اگر inotify|kevent هنگام خاموش بودن \&\fBlei\-daemon\fR\|(8) این فشرده‌سازی را از دست داده باشد، کاربران lei ممکن است نیاز به اجرای \&\fBlei\-refresh\-mail\-sync\fR\|(1) داشته باشند. .PP برنامه lei برای خواندن آرشیوهای mlmmj به‌عنوان MH ایمن است، زیرا mlmmj نه شماره‌ها را فشرده می‌کند و نه از فایل .mh_sequences برای ذخیره وضعیت استفاده می‌نماید. .SH MMDF .IX Header "MMDF" هنوز پشتیبانی نمی‌شود، و مشخص نیست که آیا میزان استفاده و پشتیبانی فعلی، ارزش افزودن آن را دارد یا خیر. .SH IMAP .IX Header "IMAP" بسته به نرم‌افزار سرور IMAP و پیکربندی آن، سرورهای IMAP ممکن است از هر یک از قالب‌های پیش‌گفته (یا ترکیبی از آن‌ها) یا یک پایگاه داده غیراستاندارد استفاده کنند. در حال حاضر lei از Mail::IMAPClient استفاده می‌کند که روی اتصالات با تاخیر کم (low\-latency) عملکرد قابل قبولی دارد. عملکرد روی اتصالات با تاخیر بالا در حال حاضر ضعیف است. .SH eml .IX Header "eml" یک فایل نامه خام تکی. \&\f(CW\*(C`eml\*(C'\fR یک قالب خروجی برای lei نیست، اما به‌عنوان یک \&\f(CW\*(C`\-\-input\-format\*(C'\fR (\f(CW\*(C`\-F\*(C'\fR) برای دستورات فقط‌خواندنی نظیر \&\fBlei\-tag\fR\|(1) و \&\fBlei\-import\fR\|(1) پذیرفته می‌شود. .PP از آنجا که \&\f(CW\*(C`eml\*(C'\fR پسوند مربوط به نوع MIME \&\f(CW\*(C`message/rfc822\*(C'\fR است (طبق فایل \&\f(CW\*(C`mime.types\*(C'\fR)، اگر \&\f(CW\*(C`\-\-input\-format\*(C'\fR مشخص نشده باشد، lei نوع را بر اساس پسوند \&\f(CW\*(C`.eml\*(C'\fR استنتاج می‌کند. .PP فایل‌های دارای پسوند \&\f(CW\*(C`.patch\*(C'\fR که توسط \&\fBgit\-format\-patch\fR\|(1) (بدون \&\f(CW\*(C`\-\-stdout\*(C'\fR) تولید می‌شوند، فایل‌های \&\f(CW\*(C`eml\*(C'\fR به همراه سرفصل \&\f(CW\*(C`From \*(C'\fR قالب mbox هستند. \&\fBlei\fR\|(1) هنگام خواندن این فایل‌ها جهت سازگاری با \&\f(CW\*(C`git\-am(1)\*(C'\fR و ابزارهای مشابه، خطوط \&\f(CW\*(C`From \*(C'\fR را حذف می‌کند تا با آن‌ها به عنوان \&\f(CW\*(C`eml\*(C'\fR رفتار کند. .SH "حق نشر (COPYRIGHT)" .IX Header "حق نشر (COPYRIGHT)" حق نشر ۲۰۲۱ تمام مشارکت‌کنندگان .PP مجوز: AGPL\-3.0+ .SH "همچنین ببینید (SEE ALSO)" .IX Header "همچنین ببینید (SEE ALSO)" \&\fBlei\fR\|(1)، \&\fBlei\-q\fR\|(1)، \&\fBlei\-convert\fR\|(1)، \&\fBlei\-overview\fR\|(7)