نام (NAME)

notmuch - نمایه‌سازی، جست‌وجو و برچسب‌گذاری ایمیل مبتنی بر رشته‌گفتگو

خلاصه دستور (SYNOPSIS)

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

توضیحات (DESCRIPTION)

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

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

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

نکته (NOTE)

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

گزینه‌ها (OPTIONS)

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

--help [command-name]: خلاصه‌ای از دستورهای در دسترس را چاپ کرده و خارج می‌شود. با تعیین یک نام دستور اختیاری، صفحهٔ راهنمای آن زیردستور نمایش داده می‌شود.

--version: نسخهٔ نصب‌شدهٔ notmuch را چاپ کرده و خارج می‌شود.

--config=FILE: فایل پیکربندی مورد استفاده را مشخص می‌کند. این گزینه بر هر فایل پیکربندی مشخص‌شده توسط NOTMUCH_CONFIG اولویت دارد. رشتهٔ خالی مقداری مجاز و گاه مفید برای FILE است که به notmuch می‌گوید تنها از فراداده‌های پیکربندی پایگاه‌داده استفاده کند.

--uuid=HEX: تطابق UUID پایگاه‌داده (یک شناسهٔ یکتا که مثلاً تا زمان فشرده‌سازی پایگاه‌داده پایدار می‌ماند) با مقدار HEX را اجباری می‌کند؛ در صورت عدم تطابق با یک خطا خارج می‌شود. این برای تشخیص سرریز (rollover) در شمارش تغییرات پیام‌ها مفید است. می‌توانید این UUID را با دستوری مانند notmuch count --lastmod بیابید.

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

دستورها (COMMANDS)

SETUP

دستور 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 را اجرا خواهد کرد.

دستورهای دیگر (OTHER COMMANDS)

چندین دستور 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> می‌توانند برای ایجاد یک رونوشت متنی از برچسب‌های ایمیل برای اهداف پشتیبان‌گیری، و بازگردانی از آن رونوشت استفاده شوند.

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

دستورهای خارجی (EXTERNAL COMMANDS)

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

نحو گزینه‌ها (OPTION SYNTAX)

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

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

فایل‌های پیام تکراری (DUPLICATE MESSAGE FILES)

برنامهٔ 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> به کاربر امکان می‌دهند تعیین کند کدام فایل پیام نمایش داده شود. رابط‌های کاربری باید رابط اختصاصی خود را فراهم کنند، برای نمونه به بخش مواجهه با موارد تکراری در رابط کاربری Emacs <#emacs-show-duplicates> مراجعه کنید.

محیط (ENVIRONMENT)

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

NOTMUCH_CONFIG: مکان فایل پیکربندی notmuch را مشخص می‌کند. برای جزئیات به notmuch-config <#notmuch-config-1> مراجعه کنید.

NOTMUCH_DATABASE: مکان پایگاه‌دادهٔ notmuch را مشخص می‌کند. برای جزئیات به notmuch-config <#notmuch-config-1> مراجعه کنید.

NOTMUCH_PROFILE: پیکربندی مورد نظر را از بین پیکربندی‌های notmuch انتخاب می‌کند. برای جزئیات به notmuch-config <#notmuch-config-1> مراجعه کنید.

NOTMUCH_TALLOC_REPORT: مسیری برای نوشتن گزارش مصرف حافظهٔ talloc. برای اطلاعات بیشتر به talloc_enable_leak_report_full در talloc(3) https://manpages.debian.org/talloc.3.html مراجعه کنید.

NOTMUCH_DEBUG_QUERY: اگر روی مقداری غیرخالی تنظیم شود، کتابخانهٔ notmuch پرس‌وجوهای Xapian ساخته‌شده را (در stderr) چاپ خواهد کرد.

همچنین ببینید (SEE ALSO)

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

تماس (CONTACT)

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

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

نویسندگان (AUTHORS)

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

کپی‌رایت و تکثیر (COPYRIGHT)

2009-2026, Carl Worth and many others