.\" -*- 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 "NOTMUCH-MUTT 1"
.TH NOTMUCH-MUTT 1 2026-04-17 "perl v5.42.2" "User Contributed Perl Documentation"
.\" 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)"
notmuch\-mutt \- ابزار کمکی notmuch برای نرم‌افزار Mutt
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.IP "\fBnotmuch\-mutt\fR [\fIOPTION\fR]... search [\fISEARCH\-TERM\fR]..." 4
.IX Item "notmuch-mutt [OPTION]... search [SEARCH-TERM]..."
.PD 0
.IP "\fBnotmuch\-mutt\fR [\fIOPTION\fR]... thread < \fIMAIL\fR" 4
.IX Item "notmuch-mutt [OPTION]... thread < MAIL"
.IP "\fBnotmuch\-mutt\fR [\fIOPTION\fR]... tag [\fITAGS\fR]... < \fIMAIL\fR" 4
.IX Item "notmuch-mutt [OPTION]... tag [TAGS]... < MAIL"
.PD
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \fBnotmuch\-mutt\fR یک پیشانه (frontend) برای نمایه‌ساز ایمیل notmuch است که می‌تواند یک maildir را با نتایج جستجو پر کند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\-o DIR" 4
.IX Item "-o DIR"
.PD 0
.IP "\-\-output\-dir DIR" 4
.IX Item "--output-dir DIR"
.PD
نتایج جستجو را به عنوان پیام‌ها (پیوندهای نمادین) درون maildir مشخص‌شده در DIR ذخیره می‌کند. توجه: محتوای DIR بازنویسی خواهد شد. (پیش‌فرض: \fI~/.cache/notmuch/mutt/results/\fR)
.IP \-p 4
.IX Item "-p"
.PD 0
.IP \-\-prompt 4
.IX Item "--prompt"
.PD
به جای استفاده از عبارت‌های جستجوی خط فرمان، آن‌ها را از کاربر درخواست می‌کند (تنها برای «search»).
.IP \-r 4
.IX Item "-r"
.PD 0
.IP \-\-remove\-dups 4
.IX Item "--remove-dups"
.PD
ایمیل‌های دارای message\-id تکراری را از نتایج جستجو حذف می‌کند. (گزینهٔ \fB\-\-duplicate=1\fR را به دستور \fBnotmuch search\fR ارسال می‌کند.) توجه داشته باشید در صورتی که ایمیلی به صورت تصادفی یا مخرب از message\-id یکسان با ایمیل دیگری استفاده کند، این گزینه ممکن است نتایج جستجو را پنهان کند.
.IP \-h 4
.IX Item "-h"
.PD 0
.IP \-\-help 4
.IX Item "--help"
.PD
اطلاعات نحوهٔ استفاده را نمایش داده و خارج می‌شود.
.SH "یکپارچه‌سازی با MUTT (INTEGRATION WITH MUTT)"
.IX Header "INTEGRATION WITH MUTT"
دستور \fBnotmuch\-mutt\fR می‌تواند برای یکپارچه‌سازی notmuch با کارگزار کاربر ایمیل Mutt استفاده شود (همان‌طور که از نام آن پیداست). بدین منظور، باید ماکروهایی مانند زیر را در پیکربندی Mutt خود تعریف کنید (معمولاً یکی از مسیرهای: \fI~/.muttrc\fR، \fI/etc/Muttrc\fR، یا قطعه‌کد پیکربندی زیر \fI/etc/Muttrc.d/\fR):
.PP
.Vb 6
\&    macro index <F8> \e
\&    "<enter\-command>set my_old_pipe_decode=\e$pipe_decode my_old_wait_key=\e$wait_key nopipe_decode nowait_key<enter>\e
\&    <shell\-escape>notmuch\-mutt \-r \-\-prompt search<enter>\e
\&    <change\-folder\-readonly>\`echo ${XDG_CACHE_HOME:\-$HOME/.cache}/notmuch/mutt/results\`<enter>\e
\&    <enter\-command>set pipe_decode=\e$my_old_pipe_decode wait_key=\e$my_old_wait_key<enter>" \e
\&          "notmuch: search mail"
\&
\&    macro index <F9> \e
\&    "<enter\-command>set my_old_pipe_decode=\e$pipe_decode my_old_wait_key=\e$wait_key nopipe_decode nowait_key<enter>\e
\&    <pipe\-message>notmuch\-mutt \-r thread<enter>\e
\&    <change\-folder\-readonly>\`echo ${XDG_CACHE_HOME:\-$HOME/.cache}/notmuch/mutt/results\`<enter>\e
\&    <enter\-command>set pipe_decode=\e$my_old_pipe_decode wait_key=\e$my_old_wait_key<enter>" \e
\&          "notmuch: reconstruct thread"
\&
\&    macro index <F6> \e
\&    "<enter\-command>set my_old_pipe_decode=\e$pipe_decode my_old_wait_key=\e$wait_key nopipe_decode nowait_key<enter>\e
\&    <pipe\-message>notmuch\-mutt tag \-\- \-inbox<enter>\e
\&    <enter\-command>set pipe_decode=\e$my_old_pipe_decode wait_key=\e$my_old_wait_key<enter>" \e
\&          "notmuch: remove message from inbox"
.Ve
.PP
ماکروی اول (که با کلید <F8> اجرا می‌شود) عبارت‌های جستجوی notmuch را از کاربر درخواست کرده و سپس به یک maildir موقت که نتایج جستجو را نشان می‌دهد می‌رود. ماکروی دوم (که با کلید <F9> اجرا می‌شود) رشته‌پیام (thread) متناظر با ایمیل فعلی را بازسازی کرده و آن را در قالب نتایج جستجو نمایش می‌دهد. ماکروی سوم (که با کلید <F6> اجرا می‌شود) برچسب \f(CW\*(C`inbox\*(C'\fR را از پیام فعلی حذف می‌کند؛ با تغییر \f(CW\*(C`\-inbox\*(C'\fR می‌توان این ماکرو را جهت افزودن یا حذف برچسب‌های متناسب با گردش‌کار notmuch کاربر سفارشی‌سازی کرد.
.PP
برای به‌روز نگه‌داشتن نمایهٔ notmuch، باید دستور \f(CW\*(C`notmuch new\*(C'\fR را به‌طور دوره‌ای اجرا کنید. بسته به پیکربندی محلی ایمیل شما، ممکن است بخواهید این کار را از طریق cron، یا به صورت یک قلاب (hook) پس از واکشی ایمیل و غیره انجام دهید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBmutt\fR\|(1), \fBnotmuch\fR\|(1)
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
حق نشر: \(C) 2011\-2012 Stefano Zacchiroli <zack@upsilon.cc>
.PP
مجوز: پروانه عمومی همگانی گنو (GPL)، نسخه ۳ یا بالاتر