.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "NOTMUCH" "1" "Apr 17, 2026" "0.40" "notmuch" .SH "نام (NAME)" notmuch \- نمایه‌سازی، جست‌وجو و برچسب‌گذاری ایمیل مبتنی بر رشته‌گفتگو .SH "خلاصه دستور (SYNOPSIS)" .sp \fBnotmuch\fP [option ...] \fBcommand\fP [arg ...] .SH "توضیحات (DESCRIPTION)" .sp برنامهٔ Notmuch ابزاری مبتنی بر خط فرمان برای نمایه‌سازی، جست‌وجو، خواندن و برچسب‌گذاری مجموعه‌های بزرگ پیام‌های ایمیل است. .sp این صفحه نحوهٔ شروع به کار با notmuch از خط فرمان را شرح می‌دهد و مروری کوتاه بر دستورهای موجود ارائه می‌کند. برای اطلاعات بیشتر برای نمونه دربارهٔ \fBnotmuch show\fP به صفحهٔ راهنمای notmuch\-show \%<#\:notmuch-show-1> مراجعه کنید، که از طریق \fBnotmuch help show\fP نیز در دسترس است. .sp سریع‌ترین راه برای شروع به کار با Notmuch، اجرای سادهٔ دستور \fBnotmuch\fP بدون هیچ آرگومانی است که شما را به صورت تعاملی در فرایند نمایه‌سازی ایمیل‌هایتان راهنمایی خواهد کرد. .SH "نکته (NOTE)" .sp اگرچه برنامهٔ خط فرمانی \fBnotmuch\fP قابلیت‌های قدرتمندی فراهم می‌آورد، اما راحت‌ترین رابط کاربری را برای این قابلیت‌ها ارائه نمی‌دهد. انتظار می‌رود رابط‌های کاربری پیشرفته‌تر یا بر فراز رابط خط فرمان و یا به احتمال بیشتر، بر بستر رابط کتابخانهٔ notmuch ساخته شوند. برای اطلاعات بیشتر پیرامون رابط‌های جایگزین notmuch به \% مراجعه کنید. رابط مبتنی بر emacs برای notmuch (موجود در دایرکتوری \fBemacs/\fP در توزیع سورس Notmuch) در حال حاضر احتمالاً پرکاربردترین رابط است. .SH "گزینه‌ها (OPTIONS)" .sp گزینه‌های عمومی پشتیبانی‌شده برای \fBnotmuch\fP عبارتند از: .INDENT 0.0 .TP .B \-\-help [command\-name] خلاصه‌ای از دستورهای در دسترس را چاپ کرده و خارج می‌شود. با تعیین یک نام دستور اختیاری، صفحهٔ راهنمای آن زیردستور نمایش داده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-version نسخهٔ نصب‌شدهٔ notmuch را چاپ کرده و خارج می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-config=FILE فایل پیکربندی مورد استفاده را مشخص می‌کند. این گزینه بر هر فایل پیکربندی مشخص‌شده توسط \fBNOTMUCH_CONFIG\fP اولویت دارد. رشتهٔ خالی مقداری مجاز و گاه مفید برای \fIFILE\fP است که به \fBnotmuch\fP می‌گوید تنها از فراداده‌های پیکربندی پایگاه‌داده استفاده کند. .UNINDENT .INDENT 0.0 .TP .B \-\-uuid=HEX تطابق UUID پایگاه‌داده (یک شناسهٔ یکتا که مثلاً تا زمان فشرده‌سازی پایگاه‌داده پایدار می‌ماند) با مقدار HEX را اجباری می‌کند؛ در صورت عدم تطابق با یک خطا خارج می‌شود. این برای تشخیص سرریز (rollover) در شمارش تغییرات پیام‌ها مفید است. می‌توانید این UUID را با دستوری مانند \fBnotmuch count \-\-lastmod\fP بیابید. .UNINDENT .sp تمام گزینه‌های عمومی به جز \fB\-\-config\fP می‌توانند پس از دستور نیز مشخص شوند. برای نمونه، \fBnotmuch subcommand \-\-uuid=HEX\fP معادل \fBnotmuch \-\-uuid=HEX subcommand\fP است. .SH "دستورها (COMMANDS)" .SS SETUP .sp دستور \fBnotmuch setup\fP برای پیکربندی Notmuch در اولین استفاده (یا پیکربندی مجدد آن در آینده) به کار می‌رود. .sp دستور setup از شما نام کامل، آدرس ایمیل اصلی، سایر آدرس‌های ایمیل فرعی مورد استفاده، و دایرکتوری حاوی آرشیوهای ایمیل شما را درخواست می‌کند. پاسخ‌های شما در یک فایل پیکربندی در \fBNOTMUCH_CONFIG\fP (در صورت تنظیم) یا ${HOME}/.notmuch\-config ذخیره خواهند شد. این فایل پیکربندی همراه با توضیحاتی تشریحی ایجاد می‌شود که ویرایش دستی آن در آینده را آسان می‌کند. همچنین می‌توانید دوباره \fBnotmuch setup\fP را اجرا کنید تا پیکربندی را تغییر دهید. .sp دایرکتوری ایمیلی که مشخص می‌کنید می‌تواند حاوی هر تعداد زیردایرکتوری باشد و در درجهٔ اول باید تنها شامل فایل‌های پیام‌های ایمیل مجزا باشد (مثلاً آرشیوهای maildir یا mh ایدئال هستند). در صورت وجود فایل‌های دیگر و غیرایمیلی (مانند نمایه‌های نگهداری‌شده توسط سایر برنامه‌های ایمیل)، notmuch تمام تلاش خود را برای شناسایی و نادیده گرفتن آن‌ها انجام می‌دهد. .sp فضای ذخیره‌سازی ایمیل که از قالب mbox استفاده می‌کند (که در آن یک فایل mbox شامل پیام‌های بسیاری است)، با notmuch کار نخواهد کرد. اگر ایمیل‌های شما در حال حاضر بدین صورت ذخیره شده‌اند، توصیه می‌شود پیش از اجرای \fBnotmuch setup\fP، ابتدا آن را با ابزاری مانند \fBmb2md(1) \%\fP به قالب maildir تبدیل کنید. .sp فراخوانی \fBnotmuch\fP بدون هیچ آرگومانی، در صورتی که دستور setup پیش از این انجام نشده باشد، \fBsetup\fP را اجرا خواهد کرد. .SS "دستورهای دیگر (OTHER COMMANDS)" .sp چندین دستور notmuch اصطلاحات جست‌وجو را با یک نحو مشترک می‌پذیرند. برای جزئیات بیشتر در مورد نحو پشتیبانی‌شده به notmuch\-search\-terms \%<#\:notmuch-search-terms-7> مراجعه کنید. .sp دستورهای notmuch\-search \%<#\:notmuch-search-1>، notmuch\-show \%<#\:notmuch-show-1>، notmuch\-address \%<#\:notmuch-address-1> و notmuch\-count \%<#\:notmuch-count-1> برای پرس‌وجوی پایگاه‌دادهٔ ایمیل استفاده می‌شوند. .sp دستور notmuch\-reply \%<#\:notmuch-reply-1> برای آماده‌سازی یک الگو جهت پاسخ به ایمیل مفید است. .sp دستور notmuch\-tag \%<#\:notmuch-tag-1> تنها دستور موجود برای دستکاری محتویات پایگاه‌داده است. .sp دستورهای notmuch\-dump \%<#\:notmuch-dump-1> و notmuch\-restore \%<#\:notmuch-restore-1> می‌توانند برای ایجاد یک رونوشت متنی از برچسب‌های ایمیل برای اهداف پشتیبان‌گیری، و بازگردانی از آن رونوشت استفاده شوند. .sp دستور notmuch\-config \%<#\:notmuch-config-1> می‌تواند برای دریافت یا تنظیم مقادیر در فایل پیکربندی notmuch به کار رود. .SS "دستورهای خارجی (EXTERNAL COMMANDS)" .sp اگر دستور داده‌شده برای notmuch ناشناخته باشد، notmuch در عوض تلاش می‌کند دستور خارجی \fBnotmuch\-\fP را در \fBPATH\fP اجرا کند. این به کاربران اجازه می‌دهد ابزارهای مرتبط با notmuch خود را از طریق دستور notmuch اجرا کنند. طبق طراحی، این قابلیت اجازه نمی‌دهد دستورهای خود notmuch با استفاده از دستورهای خارجی بازنویسی شوند. در صورت وجود گزینهٔ \fB\-\-config\fP، متغیر محیطی \fBNOTMUCH_CONFIG\fP بر اساس آن تنظیم خواهد شد. .SS "نحو گزینه‌ها (OPTION SYNTAX)" .sp همهٔ گزینه‌هایی که آرگومان می‌پذیرند می‌توانند با \(aq=\(aq یا \(aq:\(aq به عنوان جداکننده به کار روند. به جز گزینه‌های بولی (که باعث ابهام می‌شوند)، می‌توان از فاصله نیز به عنوان جداکننده استفاده کرد. موارد زیر همگی معادلند: .INDENT 0.0 .INDENT 3.5 .sp .EX notmuch \-\-config=alt\-config config get user.name notmuch \-\-config:alt\-config config get user.name notmuch \-\-config alt\-config config get user.name .EE .UNINDENT .UNINDENT .SH "فایل‌های پیام تکراری (DUPLICATE MESSAGE FILES)" .sp برنامهٔ Notmuch شناسهٔ \fIMessage\-ID\fP را به عنوان شناسهٔ اصلی پیام در نظر می‌گیرد. طبق \fBRFC 5322\fP \% شناسهٔ \fIMessage\-ID\fP باید در سطح جهانی یکتا باشد، اما این امر به دو شکل مجزا نقض می‌شود. هنگامی که رونوشتی از یک پیام را از طریق سازوکاری مانند \fICc\fP یا از طریق یک فهرست پستی دریافت می‌کنید، این رونوشت‌ها معمولاً قابل تعویض با یکدیگرند. در صورت استفاده از برخی نرم‌افزارهای معیوب ارسال ایمیل نیز ممکن است از همان \fIMessage\-ID\fP برای پیام‌های کاملاً نامرتبط استفاده شود. گزینه‌های \fBsearch \-\-duplicate\fP \%<#\:cmdoption-search-duplicate> و \fBshow \-\-duplicate\fP \%<#\:cmdoption-show-duplicate> به کاربر امکان می‌دهند تعیین کند کدام فایل پیام نمایش داده شود. رابط‌های کاربری باید رابط اختصاصی خود را فراهم کنند، برای نمونه به بخش مواجهه با موارد تکراری در رابط کاربری Emacs \%<#\:emacs-show-duplicates>\& مراجعه کنید. .SH "محیط (ENVIRONMENT)" .sp متغیرهای محیطی زیر می‌توانند برای کنترل رفتار notmuch استفاده شوند: .INDENT 0.0 .TP .B NOTMUCH_CONFIG مکان فایل پیکربندی notmuch را مشخص می‌کند. برای جزئیات به notmuch\-config \%<#\:notmuch-config-1> مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B NOTMUCH_DATABASE مکان پایگاه‌دادهٔ notmuch را مشخص می‌کند. برای جزئیات به notmuch\-config \%<#\:notmuch-config-1> مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B NOTMUCH_PROFILE پیکربندی مورد نظر را از بین پیکربندی‌های notmuch انتخاب می‌کند. برای جزئیات به notmuch\-config \%<#\:notmuch-config-1> مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B NOTMUCH_TALLOC_REPORT مسیری برای نوشتن گزارش مصرف حافظهٔ talloc. برای اطلاعات بیشتر به \fBtalloc_enable_leak_report_full\fP در \fBtalloc(3) \%\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B NOTMUCH_DEBUG_QUERY اگر روی مقداری غیرخالی تنظیم شود، کتابخانهٔ notmuch پرس‌وجوهای Xapian ساخته‌شده را (در stderr) چاپ خواهد کرد. .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp notmuch\-address \%<#\:notmuch-address-1>, notmuch\-compact \%<#\:notmuch-compact-1>, notmuch\-config \%<#\:notmuch-config-1>, notmuch\-count \%<#\:notmuch-count-1>, notmuch\-dump \%<#\:notmuch-dump-1>, notmuch\-hooks \%<#\:notmuch-hooks-5>, notmuch\-insert \%<#\:notmuch-insert-1>, notmuch\-new \%<#\:notmuch-new-1>, notmuch\-properties \%<#\:notmuch-properties-7>, notmuch\-reindex \%<#\:notmuch-reindex-1>, notmuch\-reply \%<#\:notmuch-reply-1>, notmuch\-restore \%<#\:notmuch-restore-1>, notmuch\-search \%<#\:notmuch-search-1>, notmuch\-search\-terms \%<#\:notmuch-search-terms-7>, notmuch\-show \%<#\:notmuch-show-1>, notmuch\-tag \%<#\:notmuch-tag-1> .sp وب‌سایت notmuch: \fBhttps://notmuchmail.org\fP .SH "تماس (CONTACT)" .sp می‌توانید پرسش‌ها، نظرات یا تشکرهای خود را به فهرست پستی notmuch به نشانی <\%> بفرستید. عضویت پیش از ارسال پیام الزامی نیست، اما از طریق وب‌سایت notmuchmail.org در دسترس است. .sp تعامل هم‌زمان با جامعهٔ Notmuch از طریق IRC (سرور: irc.libera.chat، کانال: #notmuch) در دسترس است. .SH "نویسندگان (AUTHORS)" Carl Worth و افراد بسیار دیگر .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2009-2026, Carl Worth and many others .\" End of generated man page.