.\" 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-SETUP" "1" "Apr 17, 2026" "0.40" "notmuch" .SH "نام (NAME)" notmuch-setup \- شروع کار با 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] چاپ خلاصه‌ای از دستورهای موجود و خروج. با تعیین نام اختیاری یک دستور، صفحه راهنما (man page) را برای آن زیردستور نمایش می‌دهد. .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 پایگاه‌داده (شناسه یکتایی که برای مثال تا زمان فشرده‌سازی (compact) پایگاه‌داده باقی می‌ماند) برابر با 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> می‌توانند برای ایجاد یک خروجی متنی (dump) از برچسب‌های ایمیل برای اهداف پشتیبان‌گیری، و بازیابی از آن خروجی استفاده شوند. .sp دستور notmuch\-config \%<#\:notmuch-config-1> می‌تواند برای مشاهده یا اعمال تنظیمات در فایل پیکربندی notmuch به کار رود. .SS "دستورهای خارجی (EXTERNAL COMMANDS)" .sp اگر دستور داده‌شده برای notmuch ناشناخته باشد، notmuch تلاش می‌کند به جای آن دستور خارجی \fBnotmuch\-\fP را در \fBPATH\fP اجرا کند. این قابلیت به کاربران امکان می‌دهد ابزارهای مرتبط با notmuch اختصاصی خود را داشته باشند تا از طریق دستور notmuch اجرا شوند. بر اساس طراحی، این ویژگی اجازه نمی‌دهد دستورهای خودِ notmuch با استفاده از دستورهای خارجی بازنویسی (override) شوند. متغیر محیطی \fBNOTMUCH_CONFIG\fP بر اساس \fB\-\-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> به کاربر این امکان را می‌دهند که تعیین کند کدام فایل پیام نمایش داده شود. رابط‌های کاربری (front-end) باید واسط مخصوص خود را فراهم کنند، برای مثال بخش Dealing with duplicates \%<#\:emacs-show-duplicates> در رابط کاربری Emacs را ببینید. .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 و افراد بسیار دیگر .\" End of generated man page.