'\" t
.\" 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-CONFIG" "1" "Apr 17, 2026" "0.40" "notmuch"
.SH "نام (NAME)"
notmuch-config \- دسترسی به فایل پیکربندی notmuch
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnotmuch\fP \fBconfig\fP \fBget\fP <\fIsection\fP>.<\fIitem\fP>
.sp
\fBnotmuch\fP \fBconfig\fP \fBset\fP [\-\-database] <\fIsection\fP>.<\fIitem\fP> [\fIvalue\fP ...]
.sp
\fBnotmuch\fP \fBconfig\fP \fBlist\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBconfig\fP می‌تواند برای دریافت یا تنظیم مقادیر در فایل پیکربندی notmuch و پایگاه‌داده متناظر با آن استفاده شود.
.INDENT 0.0
.TP
.B get
مقدار مورد پیکربندی مشخص‌شده در خروجی استاندارد (stdout) چاپ می‌شود. اگر آن مورد چند مقداری باشد (یک فهرست باشد)، هر مقدار با یک نویسه خط جدید جدا می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B set
مورد پیکربندی مشخص‌شده روی مقدار داده‌شده تنظیم می‌شود. برای تعیین یک مورد چندمقداری (یک فهرست)، هر مقدار را به عنوان یک آرگومان خط فرمان جداگانه وارد کنید.
.sp
اگر هیچ مقداری ارائه نشود، مورد پیکربندی مشخص‌شده از فایل پیکربندی حذف خواهد شد.
.sp
با گزینه \fI\-\-database\fP، فراداده‌های پیکربندی ذخیره‌شده در پایگاه‌داده، به جای فایل پیکربندی پیش‌فرض (متنی)، به‌روزرسانی می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B list
تمام موارد پیکربندی در خروجی استاندارد چاپ می‌شوند، هر کدام در خطی جداگانه به شکل:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
section.item=value
.EE
.UNINDENT
.UNINDENT
.sp
هیچ فاصله خالی اضافه‌ای در اطراف نویسه‌های نقطه یا علامت مساوی وجود ندارد. در موارد چندمقداری (یک فهرست)، مقادیر با نویسه نقطه\-ویرگول از یکدیگر جدا می‌شوند.
.UNINDENT
.sp
موارد پیکربندی موجود در زیر شرح داده شده‌اند. مسیرهای غیرمطلق برای موارد موجود در بخش \fBdatabase\fP نسبت به \fI$HOME\fP در نظر گرفته می‌شوند.
.INDENT 0.0
.TP
.B built_with.<name>
ویژگی زمان کامپایل <name>. موارد ممکن کنونی شامل \(dqretry_lock\(dq (گزینه پیکربندی، گنجانده‌شده به طور پیش‌فرض) است. (از notmuch 0.30 به بعد، ویژگی‌های \(dqcompact\(dq و \(dqfield_processor\(dq همیشه گنجانده شده‌اند.)
.UNINDENT
.INDENT 0.0
.TP
.B database.autocommit
فواصل زمانی ثبت تراکنش‌ها (commit) روی دیسک. مقدار \fI0\fP به معنای صبر کردن تا زمان پایان اجرای دستور است؛ در غیر این صورت یک عدد صحیح \fIn\fP مشخص می‌کند که پس از هر \fIn\fP تراکنش تکمیل‌شده، تغییرات روی دیسک ثبت شوند.
.sp
تاریخچه: این مقدار پیکربندی در notmuch 0.33 معرفی شد.
.UNINDENT
.INDENT 0.0
.TP
.B database.backup_dir
دایرکتوری برای ذخیره خروجی برچسب‌ها هنگام ارتقای پایگاه‌داده.
.sp
تاریخچه: این مقدار پیکربندی در notmuch 0.32 معرفی شد.
.sp
پیش‌فرض: یک دایرکتوری هم‌سطح پایگاه‌داده Xapian به نام \fIbackups\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B database.hook_dir
دایرکتوری حاوی قلاب‌هایی (hooks) که توسط دستورهای notmuch اجرا می‌شوند. نگاه کنید به notmuch\-hooks \%<#\:notmuch-hooks-5>\&.
.sp
تاریخچه: این مقدار پیکربندی در notmuch 0.32 معرفی شد.
.sp
پیش‌فرض: به HOOKS در ادامه نگاه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B database.mail_root
دایرکتوری سطح بالایی که ایمیل‌های فعلی شما در آن قرار دارند و ایمیل‌های آینده به آن تحویل داده می‌شوند. فایل‌ها باید پیام‌های ایمیل مجزا باشند.
.sp
تاریخچه: این مقدار پیکربندی در notmuch 0.32 معرفی شد.
.sp
پیش‌فرض: برای سازگاری با پیکربندی‌های قدیمی‌تر، در صورت تنظیم نبودن database.mail_root از مقدار database.path استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B database.path
دستور notmuch پایگاه‌داده خود را در اینجا ذخیره خواهد کرد (در صورت تنظیم نبودن database.mail_root، در زیردایرکتوری‌ای به نام \fB\&.notmuch\fP).
.sp
پیش‌فرض: به DATABASE LOCATION نگاه کنید
.UNINDENT
.INDENT 0.0
.TP
.B git.path
مکان پیش‌فرض مخزن git برای notmuch\-git \%<>\&.
.UNINDENT
.INDENT 0.0
.TP
.B git.safe_fraction
برخی از عملیات notmuch\-git \%<> بررسی می‌کنند که نسبت پیام‌های تغییریافته (در پایگاه‌داده یا در git، بسته به مورد) بیش از حد بزرگ نباشد. این مورد کنترل می‌کند چه نسبتی از کل پیام‌ها «نه چندان بزرگ» (\(dqnot too large\(dq) تلقی شود.
.UNINDENT
.INDENT 0.0
.TP
.B git.tag_prefix
پیشوند برچسب (فیلتر) پیش‌فرض برای notmuch\-git \%<>\&.
.UNINDENT
.INDENT 0.0
.TP
.B index.as_text
فهرستی از عبارت‌های باقاعده (بدون جداکننده) برای انواع MIME که قرار است به صورت متن نمایه‌سازی شوند. در حال حاضر این ویژگی تنها روی پیوست‌ها اعمال می‌شود. به طور پیش‌فرض عبارت باقاعده با هر نقطه‌ای از نوع محتوا (content type) تطابق می‌یابد؛ اگر کاربر تطابق مهارشده (anchored) می‌خواهد، باید مهارها (anchors) را در عبارت باقاعده خود بگنجاند.
.sp
تاریخچه: این مقدار پیکربندی در notmuch 0.38 معرفی شد.
.UNINDENT
.INDENT 0.0
.TP
.B index.decrypt
سیاست رمزگشایی پیام‌های رمزگذاری‌شده در هنگام نمایه‌سازی. باید یکی از این مقادیر باشد: \fBfalse\fP، \fBauto\fP، \fBnostash\fP یا \fBtrue\fP\&.
.sp
هنگام نمایه‌سازی یک پیام ایمیل رمزگذاری‌شده، اگر این متغیر روی \fBtrue\fP تنظیم شده باشد، notmuch تلاش می‌کند پیام را رمزگشایی کرده و متن آشکار (cleartext) را نمایه کند، و نسخه‌ای از هر کلید جلسه (session key) کشف‌شده برای آن پیام را ذخیره (stash) نماید. اگر \fBauto\fP باشد، در صورتی که یک کلید جلسه ذخیره‌شده از قبل برای پیام شناخته شده باشد (مثلاً از نسخه‌ای قبلی)، تلاش می‌کند متن آشکار را نمایه کند، اما تلاشی برای دسترسی به کلیدهای مخفی شما نخواهد کرد. از \fBfalse\fP استفاده کنید تا از رمزگشایی اجتناب شود حتی اگر کلید جلسه ذخیره‌شده از قبل موجود باشد.
.sp
مقدار \fBnostash\fP همانند \fBtrue\fP است، به جز اینکه کلیدهای جلسه تازه کشف‌شده را در پایگاه‌داده ذخیره (stash) نمی‌کند.
.sp
از طریق خط فرمان (یعنی در طول اجرای notmuch\-new \%<#\:notmuch-new-1>، notmuch\-insert \%<#\:notmuch-insert-1> یا notmuch\-reindex \%<#\:notmuch-reindex-1>)، کاربر می‌تواند با گزینه \fB\-\-decrypt=\fP، سیاست رمزگشایی ذخیره‌شده در پایگاه‌داده را بازنویسی کند.
.sp
در اینجا جدولی آورده شده که عملکرد هر یک از این سیاست‌ها را خلاصه می‌کند:
.TS
box center;
l|l|l|l|l.
T{
T}	T{
false
T}	T{
auto
T}	T{
nostash
T}	T{
true
T}
_
T{
نمایه‌سازی متن آشکار با
استفاده از کلیدهای جلسه ذخیره‌شده
T}	T{
T}	T{
X
T}	T{
X
T}	T{
X
T}
_
T{
نمایه‌سازی متن آشکار
با استفاده از کلیدهای مخفی
T}	T{
T}	T{
T}	T{
X
T}	T{
X
T}
_
T{
ذخیره کلیدهای جلسه (stash)
T}	T{
T}	T{
T}	T{
T}	T{
X
T}
_
T{
حذف کلیدهای جلسه ذخیره‌شده
هنگام نمایه‌سازی مجدد (reindex)
T}	T{
X
T}	T{
T}	T{
T}	T{
T}
.TE
.sp
کلیدهای جلسه ذخیره‌شده (stashed) به عنوان ویژگی‌های (properties) مرتبط با پیام در پایگاه‌داده نگهداری می‌شوند. برای جزئیات بیشتر درباره سودمندی آن‌ها، \fBsession\-key\fP را در notmuch\-properties \%<#\:notmuch-properties-7> ببینید.
.sp
آگاه باشید که نمایه notmuch احتمالاً کافی است (و یک کلید جلسه ذخیره‌شده قطعاً کافی است) تا بتوان متن آشکار خود پیام را بازسازی کرد؛ بنابراین لطفاً اطمینان حاصل کنید که نمایه پیام‌های notmuch به میزان کافی محافظت می‌شود. از \fBindex.decrypt=true\fP یا \fBindex.decrypt=nostash\fP بدون در نظر گرفتن امنیت نمایه خود استفاده نکنید.
.sp
پیش‌فرض: \fBauto\fP\&.
.UNINDENT
.INDENT 0.0.TP
.B index.header.<prefix>
پیشوند پرس‌وجوی <prefix> را بر پایه یک سرآیند نامه تعریف می‌کند. برای
نمونه \fBindex.header.List=List\-Id\fP یک پیشوند احتمالاتی
\fBList:\fP اضافه می‌کند که در فیلد \fBList\-Id\fP جستجو می‌کند. پیشوندهای
تعریف‌شده توسط کاربر نباید با \(aqa\(aq...\(aqz\(aq آغاز شوند؛ به‌ویژه
افزودن پیشوندی هم‌نام با پیشوندهای از‌پیش‌تعریف‌شده پشتیبانی
نمی‌شود. برای فهرستی از پیشوندهای موجود و توضیحی درباره پیشوندهای احتمالاتی، notmuch\-search\-terms \%<#\:notmuch-search-terms-7> را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B maildir.synchronize_flags
اگر true باشد، پرچم‌های maildir زیر (در نام فایل پیام‌ها)
با برچسب‌های متناظر notmuch همگام‌سازی خواهند شد:
.TS
box center;
l|l.
T{
پرچم
T}	T{
برچسب
T}
_
T{
D
T}	T{
draft
T}
_
T{
F
T}	T{
flagged
T}
_
T{
P
T}	T{
passed
T}
_
T{
R
T}	T{
replied
T}
_
T{
S
T}	T{
unread (هنگامی که پرچم \(aqS\(aq موجود نباشد افزوده می‌شود)
T}
.TE
.sp
دستور notmuch\-new \%<#\:notmuch-new-1> متوجه تغییرات پرچم در نام فایل‌ها شده و برچسب‌ها را به‌روزرسانی می‌کند، در حالی که دستورهای notmuch\-tag \%<#\:notmuch-tag-1> و notmuch\-restore \%<#\:notmuch-restore-1> متوجه تغییرات برچسب‌ها شده و پرچم‌ها را در نام فایل‌ها به‌روزرسانی می‌کنند.
.sp
اگر هرگونه تغییری در maildir رخ داده باشد (افزوده شدن پیام‌های جدید، حذف یا تغییر نام پیام‌های قدیمی، تغییر پرچم‌های maildir و غیره)، توصیه می‌شود پیش از اجرای دستورهای notmuch\-tag \%<#\:notmuch-tag-1> یا notmuch\-restore \%<#\:notmuch-restore-1>، دستور notmuch\-new \%<#\:notmuch-new-1> اجرا شود تا اطمینان حاصل گردد که تغییرات برچسب‌ها به‌درستی با پرچم‌های maildir همگام‌سازی می‌شوند، زیرا این دستورها انتظار دارند پایگاه‌داده و maildir با یکدیگر هماهنگ باشند.
.sp
پیش‌فرض: \fBtrue\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B new.ignore
فهرستی برای مشخص کردن فایل‌ها و دایرکتوری‌هایی که توسط notmuch\-new \%<#\:notmuch-new-1>\& برای یافتن پیام‌ها جستجو نخواهند شد. هر ورودی در این فهرست یکی از موارد زیر است:
.sp
نام یک فایل یا دایرکتوری، بدون مسیر، که صرف‌نظر از مکان آن در سلسله‌مراتب دایرکتوری‌های مخزن نامه‌ها، نادیده گرفته خواهد شد.
.sp
یا:
.sp
یک عبارت باقاعده محصور در // که با مسیر فایل یا دایرکتوری به‌صورت نسبی نسبت به مسیر پایگاه‌داده مطابقت داده می‌شود. فایل‌ها و دایرکتوری‌های منطبق نادیده گرفته خواهند شد. ابتدا و انتهای رشته باید به‌صراحت مهاربندی (anchor) شوند. برای نمونه، /.*/foo$/ با \(dqbar/foo\(dq و \(dqbar/baz/foo\(dq مطابقت دارد، اما با \(dqfoo\(dq یا \(dqbar/foobar\(dq مطابقت نخواهد داشت.
.sp
پیش‌فرض: فهرست خالی.
.UNINDENT
.INDENT 0.0
.TP
.B new.tags
فهرستی از برچسب‌ها که به تمام پیام‌های واردشده توسط \fBnotmuch new\fP\& افزوده خواهند شد.
.sp
پیش‌فرض: \fBunread;inbox\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B query.<name>
بسط برای پرس‌وجوی نام‌گذاری‌شده با نام <name>. برای اطلاعات بیشتر درباره پرس‌وجوهای نام‌گذاری‌شده، notmuch\-search\-terms \%<#\:notmuch-search-terms-7> را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B search.exclude_tags
فهرستی از برچسب‌ها که به‌طور پیش‌فرض از نتایج جستجو مستثنی می‌شوند. استفاده از یک برچسب مستثنی‌شده در پرس‌وجو، این استثنا را نادیده خواهد گرفت.
.sp
پیش‌فرض: فهرست خالی. توجه داشته باشید که notmuch \%<#\:notmuch-setup-1> هنگام ایجاد فایل پیکربندی جدید، \fBdeleted;spam\fP را در اینجا قرار می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B search.authors_separator
رشته‌ای برای جداسازی نویسندگان هنگام نمایش یک رشته‌گفتگو (thread).
.sp
پیش‌فرض: ,
.UNINDENT
.INDENT 0.0
.TP
.B search.authors_matched_separator
رشته‌ای برای جداسازی نویسندگان منطبق از غیرمنطبق هنگام نمایش یک رشته‌گفتگو (thread).
.sp
پیش‌فرض: |
.UNINDENT
.INDENT 0.0
.TP
.B show.extra_headers
به‌طور پیش‌فرض notmuch\-show \%<#\:notmuch-show-1> در صورت وجود سرآیندهای زیر در پیام، آن‌ها را در خروجی ساختاریافته می‌آورد:
\fISubject\fP، \fIFrom\fP، \fITo\fP، \fICc\fP، \fIBcc\fP، \fIReply\-To\fP، \fIDate\fP\&. این
گزینه امکان مشخص کردن فهرستی از سرآیندهای بیشتر را برای نمایش در خروجی فراهم می‌کند.
.sp
تاریخچه: این مقدار پیکربندی در notmuch 0.35 معرفی شد.
.sp
پیش‌فرض: فهرست خالی.
.UNINDENT
.INDENT 0.0
.TP
.B squery.<name>
بسط برای پرس‌وجوی نام‌گذاری‌شده با نام <name>، با استفاده از نحو s\-expression. برای اطلاعات بیشتر درباره پرس‌وجوهای s\-expression، notmuch\-sexp\-queries \%<#\:notmuch-sexp-queries-7> را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B user.name
نام کامل شما.
.sp
پیش‌فرض: در صورت تنظیم بودن، متغیر \fB$NAME\fP، در غیر این صورت از \fB/etc/passwd\fP\& خوانده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B user.other_email
فهرستی از دیگر نشانی‌های رایانامه که در آن‌ها رایانامه دریافت می‌کنید
(همچنین user.primary_email را ببینید).
.sp
پیش‌فرض: تنظیم‌نشده.
.UNINDENT
.INDENT 0.0
.TP
.B user.primary_email
نشانی رایانامه اصلی شما.
.sp
پیش‌فرض: در صورت تنظیم بودن، متغیر \fB$EMAIL\fP، در غیر این صورت از روی نام کاربری و نام میزبان ماشین فعلی ساخته می‌شود.
.UNINDENT.SH "فایل‌ها (FILES)"
.SS "پیکربندی (CONFIGURATION)"
.sp
ترتیب جستجوی فایل پیکربندی Notmuch:
.INDENT 0.0
.IP 1. 3
فایل مشخص‌شده با گزینهٔ سراسری \fBnotmuch \-\-config\fP \%<#\:cmdoption-notmuch-config>؛ به
notmuch \%<#\:notmuch-1>\& مراجعه کنید.
.IP 2. 3
فایل مشخص‌شده توسط متغیر محیطی \fBNOTMUCH_CONFIG\fP \%<#\:envvar-NOTMUCH_CONFIG>.
.IP 3. 3
مسیر \fB$XDG_CONFIG_HOME/notmuch/<profile>/config\fP که در آن چنانچه متغیر محیطی
\fBNOTMUCH_PROFILE\fP \%<#\:envvar-NOTMUCH_PROFILE> تنظیم شده باشد، \fB<profile>\fP
با آن مشخص می‌شود؛ در غیر این صورت \fB$XDG_CONFIG_HOME/notmuch/default/config\fP.
.IP 4. 3
مسیر \fB$HOME/.notmuch\-config.<profile>\fP که در آن چنانچه متغیر محیطی
\fBNOTMUCH_PROFILE\fP \%<#\:envvar-NOTMUCH_PROFILE> تنظیم شده باشد، \fB<profile>\fP
با آن مشخص می‌شود؛ در غیر این صورت \fB$HOME/.notmuch\-config\fP.
.UNINDENT
.SS "مکان پایگاه داده (DATABASE LOCATION)"
.sp
ترتیب جستجوی پایگاه دادهٔ Notmuch:
.INDENT 0.0
.IP 1. 3
دایرکتوری مشخص‌شده توسط متغیر محیطی \fBNOTMUCH_DATABASE\fP \%<#\:envvar-NOTMUCH_DATABASE>.
.IP 2. 3
دایرکتوری مشخص‌شده با کلید پیکربندی \fBdatabase.path\fP\&.
.IP 3. 3
مسیر \fB$XDG_DATA_HOME/notmuch/<profile>\fP که در آن چنانچه متغیر محیطی
\fBNOTMUCH_PROFILE\fP \%<#\:envvar-NOTMUCH_PROFILE> تنظیم شده باشد، \fB<profile>\fP
با آن مشخص می‌شود؛ در غیر این صورت \fB$XDG_DATA_HOME/notmuch/default\fP.
.IP 4. 3
دایرکتوری مشخص‌شده توسط متغیر محیطی \fBMAILDIR\fP.
.IP 5. 3
\fB$HOME/mail\fP
.UNINDENT
.SS "قلاب‌ها (HOOKS)"
.sp
ترتیب جستجوی دایرکتوری قلاب‌های Notmuch:
.INDENT 0.0
.IP 1. 3
دایرکتوری مشخص‌شده با گزینهٔ پیکربندی \fBdatabase.hook_dir\fP.
.IP 2. 3
مسیر \fB$XDG_CONFIG_HOME/notmuch/<profile>/hooks\fP که در آن چنانچه متغیر محیطی
\fBNOTMUCH_PROFILE\fP \%<#\:envvar-NOTMUCH_PROFILE> تنظیم شده باشد، \fB<profile>\fP
با آن مشخص می‌شود؛ در غیر این صورت \fB$XDG_CONFIG_HOME/notmuch/default/hooks\fP.
.IP 3. 3
\fB<database.path>/.notmuch/hooks\fP
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
notmuch \%<#\:notmuch-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\-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>
.SH "نویسندگان (AUTHORS)"
Carl Worth و بسیاری دیگر
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2009-2026, Carl Worth و بسیاری دیگر
.\" End of generated man page.