NOTMUCH-SETUP(1) notmuch NOTMUCH-SETUP(1)

notmuch-setup - شروع کار با notmuch

notmuch [option ...] command [arg ...]

برنامه Notmuch یک ابزار مبتنی بر خط فرمان برای نمایه‌سازی، جستجو، خواندن، و برچسب‌گذاری مجموعه‌های بزرگ پیام‌های ایمیل است.

این صفحه نحوه شروع به کار با notmuch از طریق خط فرمان را شرح داده و مروری اجمالی بر دستورهای موجود ارائه می‌دهد. برای اطلاعات بیشتر برای مثال در مورد notmuch show به صفحه راهنمای notmuch-show <#notmuch-show-1> مراجعه کنید، که از طریق notmuch help show نیز قابل دسترسی است.

سریع‌ترین راه برای شروع کار با Notmuch اجرای ساده دستور notmuch بدون هیچ آرگومانی است که شما را به صورت تعاملی در طول فرایند نمایه‌سازی ایمیل‌هایتان راهنمایی خواهد کرد.

اگرچه برنامه خط فرمانی notmuch قابلیت‌های قدرتمندی ارائه می‌دهد، اما راحت‌ترین رابط کاربری را برای این قابلیت‌ها فراهم نمی‌کند. انتظار می‌رود رابط‌های پیشرفته‌تری بر روی رابط خط فرمان، یا به احتمال قوی‌تر، بر بستر رابط کتابخانه notmuch ساخته شوند. برای اطلاعات بیشتر درباره رابط‌های جایگزین notmuch به https://notmuchmail.org مراجعه کنید. رابط مبتنی بر emacs برای notmuch (که تحت پوشه emacs/ در توزیع سورس Notmuch موجود است) احتمالاً در حال حاضر بیشترین استفاده را دارد.

گزینه‌های سراسری پشتیبانی‌شده برای notmuch عبارتند از:

چاپ خلاصه‌ای از دستورهای موجود و خروج. با تعیین نام اختیاری یک دستور، صفحه راهنما (man page) را برای آن زیردستور نمایش می‌دهد.
چاپ نسخه نصب‌شده notmuch و خروج.
مشخص کردن فایل پیکربندی مورد استفاده. این گزینه بر هر فایل پیکربندی مشخص‌شده توسط NOTMUCH_CONFIG اولویت دارد. رشته خالی یک مقدار مجاز و گاهی مفید برای FILE است، که به notmuch می‌گوید فقط از متاداده‌های پیکربندیِ درون پایگاه‌داده استفاده کند.
الزام می‌کند که UUID پایگاه‌داده (شناسه یکتایی که برای مثال تا زمان فشرده‌سازی (compact) پایگاه‌داده باقی می‌ماند) برابر با HEX باشد؛ اگر این‌طور نباشد با یک خطا خارج می‌شود. این ویژگی برای تشخیص بازنشانی (rollover) در شمارش تغییرات پیام‌ها مفید است. می‌توانید این UUID را با استفاده از مثلاً notmuch count --lastmod پیدا کنید.

تمامی گزینه‌های سراسری به جز --config را می‌توان پس از دستور نیز مشخص کرد. برای مثال، notmuch subcommand --uuid=HEX معادل است با notmuch --uuid=HEX subcommand.

دستور notmuch setup برای پیکربندی Notmuch در اولین استفاده (یا پیکربندی مجدد آن در آینده) به کار می‌رود.

دستور setup نام کامل شما، آدرس ایمیل اصلی شما، هر آدرس ایمیل جایگزینی که استفاده می‌کنید، و دایرکتوری حاوی بایگانی‌های ایمیل شما را می‌پرسد. پاسخ‌های شما در یک فایل پیکربندی در NOTMUCH_CONFIG (در صورت تنظیم) یا ${HOME}/.notmuch-config نوشته خواهد شد. این فایل پیکربندی همراه با کامنت‌های توصیفی ایجاد می‌شود که ویرایش دستی آن را برای تغییر پیکربندی در آینده آسان می‌کند. یا می‌توانید برای تغییر پیکربندی، دوباره notmuch setup را اجرا کنید.

دایرکتوری ایمیلی که مشخص می‌کنید می‌تواند شامل هر تعداد زیردایرکتوری باشد و اصولاً باید فقط شامل فایل‌هایی با پیام‌های تکی ایمیل باشد (برای مثال، بایگانی‌های maildir یا mh ایده‌آل هستند). اگر فایل‌های دیگری غیر از ایمیل (مانند نمایه‌های نگه‌داری‌شده توسط سایر برنامه‌های ایمیل) وجود داشته باشند، notmuch نهایت تلاش خود را برای شناسایی و نادیده گرفتن آن‌ها انجام خواهد داد.

فضای ذخیره‌سازی ایمیل که از قالب mbox استفاده می‌کند (که در آن یک فایل mbox حاوی چندین پیام است)، با notmuch کار نخواهد کرد. اگر ایمیل‌های شما در حال حاضر به این شکل ذخیره شده‌اند، توصیه می‌شود پیش از اجرای notmuch setup، ابتدا آن را با ابزاری مانند mb2md(1) https://manpages.debian.org/mb2md.1.html به قالب maildir تبدیل کنید.

فراخوانی notmuch بدون هیچ آرگومان دستوری، چنانچه دستور setup پیش‌تر تکمیل نشده باشد، setup را اجرا خواهد کرد.

چندین دستور notmuch عبارت‌های جستجو را با نحوی مشترک می‌پذیرند. برای جزئیات بیشتر درباره نحو پشتیبانی‌شده، notmuch-search-terms <#notmuch-search-terms-7> را ببینید.

دستورهای notmuch-search <#notmuch-search-1>، notmuch-show <#notmuch-show-1>، notmuch-address <#notmuch-address-1> و notmuch-count <#notmuch-count-1> برای پرس‌وجو از پایگاه‌داده ایمیل استفاده می‌شوند.

دستور notmuch-reply <#notmuch-reply-1> برای آماده‌سازی یک قالب جهت پاسخ به ایمیل مفید است.

دستور notmuch-tag <#notmuch-tag-1> تنها دستور موجود برای دست‌کاری محتویات پایگاه‌داده است.

دستورهای notmuch-dump <#notmuch-dump-1> و notmuch-restore <#notmuch-restore-1> می‌توانند برای ایجاد یک خروجی متنی (dump) از برچسب‌های ایمیل برای اهداف پشتیبان‌گیری، و بازیابی از آن خروجی استفاده شوند.

دستور notmuch-config <#notmuch-config-1> می‌تواند برای مشاهده یا اعمال تنظیمات در فایل پیکربندی notmuch به کار رود.

اگر دستور داده‌شده برای notmuch ناشناخته باشد، notmuch تلاش می‌کند به جای آن دستور خارجی notmuch-<subcommand> را در PATH اجرا کند. این قابلیت به کاربران امکان می‌دهد ابزارهای مرتبط با notmuch اختصاصی خود را داشته باشند تا از طریق دستور notmuch اجرا شوند. بر اساس طراحی، این ویژگی اجازه نمی‌دهد دستورهای خودِ notmuch با استفاده از دستورهای خارجی بازنویسی (override) شوند. متغیر محیطی NOTMUCH_CONFIG بر اساس --config تنظیم خواهد شد، اگر دومی موجود باشد.

تمامی گزینه‌هایی که یک آرگومان می‌پذیرند می‌توانند با '=' یا ':' به عنوان جداساز استفاده شوند. به جز گزینه‌های بولی (که مبهم خواهند بود)، فاصله نیز می‌تواند به عنوان جداساز استفاده شود. موارد زیر همگی معادل هستند:

notmuch --config=alt-config config get user.name
notmuch --config:alt-config config get user.name
notmuch --config alt-config config get user.name

ابزار Notmuch شناسه Message-ID را به عنوان شناسه اصلی پیام در نظر می‌گیرد. طبق RFC 5322 https://datatracker.ietf.org/doc/html/rfc5322.html شناسه Message-ID باید در سراسر جهان یکتا باشد، اما این موضوع به دو روش مختلف نقض می‌شود. هنگامی که رونوشتی از یک پیام را از طریق سازوکاری مانند Cc یا از طریق یک فهرست پستی دریافت می‌کنید، این رونوشت‌ها معمولاً قابل تعویض با یکدیگر هستند. در مورد برخی نرم‌افزارهای معیوب ارسال ایمیل، یک Message-ID یکسان برای پیام‌های کاملاً نامرتبط استفاده می‌شود. گزینه‌های search --duplicate <#cmdoption-search-duplicate> و show --duplicate <#cmdoption-show-duplicate> به کاربر این امکان را می‌دهند که تعیین کند کدام فایل پیام نمایش داده شود. رابط‌های کاربری (front-end) باید واسط مخصوص خود را فراهم کنند، برای مثال بخش Dealing with duplicates <#emacs-show-duplicates> در رابط کاربری Emacs را ببینید.

متغیرهای محیطی زیر می‌توانند برای کنترل رفتار notmuch استفاده شوند.

مکان فایل پیکربندی notmuch را مشخص می‌کند. برای جزئیات به notmuch-config <#notmuch-config-1> مراجعه کنید.
مکان پایگاه‌داده notmuch را مشخص می‌کند. برای جزئیات به notmuch-config <#notmuch-config-1> مراجعه کنید.
پیکربندی مورد نظر را از بین پیکربندی‌های notmuch انتخاب می‌کند. برای جزئیات به notmuch-config <#notmuch-config-1> مراجعه کنید.
مکانی برای نوشتن گزارش مصرف حافظه talloc. برای اطلاعات بیشتر به talloc_enable_leak_report_full در talloc(3) https://manpages.debian.org/talloc.3.html مراجعه کنید.
اگر روی یک مقدار غیرخالی تنظیم شود، کتابخانه notmuch پرس‌وجوهای Xapian ساخته‌شده را چاپ می‌کند (در stderr).

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>

وب‌سایت notmuch: https://notmuchmail.org

می‌توانید پرسش‌ها، نظرات، یا تشکرات خود را به فهرست پستی notmuch به نشانی <<notmuch@notmuchmail.org>> ارسال کنید. عضویت پیش از ارسال پیام الزامی نیست، اما از طریق وب‌سایت notmuchmail.org امکان‌پذیر است.

تعامل آنی و برخط با جامعه Notmuch از طریق IRC فراهم است (سرور: irc.libera.chat، کانال: #notmuch).

Carl Worth و افراد بسیار دیگر

2009-2026, Carl Worth و افراد بسیار دیگر

April 17, 2026 0.40