نام (NAME)

notmuch-tag - افزودن/حذف برچسب‌ها برای تمام پیام‌های منطبق با عبارت‌های جستجو

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

notmuch tag [options ...] +<tag>|-<tag> [--] <search-term> ...

notmuch tag --batch [--input=<filename>]

توضیحات (DESCRIPTION)

افزودن یا حذف برچسب‌ها برای تمامی پیام‌های منطبق با عبارت‌های جستجو.

برای جزئیات نحو پشتیبانی‌شده برای <search-term>، notmuch-search-terms <#notmuch-search-terms-7> را ببینید.

برچسب‌هایی با پیشوند '+' اضافه می‌شوند، در حالی که برچسب‌های دارای پیشوند '-' حذف می‌گردند. برای هر پیام، تغییرات برچسب به همان ترتیبی که در خط فرمان ظاهر شده‌اند اعمال می‌شوند.

شروع عبارت‌های جستجو با نخستین آرگومانی تشخیص داده می‌شود که نه با '+' آغاز شده باشد و نه با '-'. پشتیبانی از عبارت جستجوی اولیه‌ای که با '+' یا '-' شروع شود، با دادن امکان تعیین آرگومان "--" به کاربر جهت تفکیک برچسب‌ها از عبارت‌های جستجو فراهم شده است.

در صورت فعال بودن گزینهٔ پیکربندی maildir.synchronize_flags، دستور notmuch tag پرچم‌های maildir را بر اساس تغییرات برچسب به‌روزرسانی می‌کند. برای جزئیات بیشتر notmuch-config <#notmuch-config-1> را ببینید.

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

--remove-all: حذف تمام برچسب‌ها از هر پیامی که با عبارت‌های جستجو مطابقت دارد، پیش از اعمال تغییرات برچسب مشخص‌شده در خط فرمان. این به معنای تنظیم برچسب‌های هر پیام به برچسب‌هایی است که قرار است اضافه شوند. اگر هیچ برچسبی برای افزودن وجود نداشته باشد، پیام‌ها فاقد برچسب خواهند بود.

--batch: خواندن عملیات برچسب‌گذاری دسته‌ای از یک فایل (به‌طور پیش‌فرض stdin). این روش بسیار کارآمدتر از فراخوانی‌های مکرر دستور notmuch tag است. برای ساختار قالب ورودی، «قالب فایل برچسب» <#tag_file_format> در زیر را ببینید. این گزینه با مشخص کردن برچسب‌گذاری در خط فرمان سازگار نیست.

--input=<filename>: خواندن ورودی از فایل مشخص‌شده به‌جای stdin. مستلزم گزینهٔ --batch است.

قالب فایل برچسب (TAG FILE FORMAT)

ورودی باید شامل خطوطی با این قالب باشد:

+<tag>|-<tag> [...] [--] <query>

هر خط به‌گونه‌ای مشابه با آرگومان‌های خط فرمان notmuch tag تفسیر می‌شود. جداکننده یک یا چند نویسهٔ فاصله ' ' است. هر نویسه‌ای در <tag> می‌تواند به‌صورت %NN به‌شکل شانزده‌شانزدهی (hex) کدگذاری شود که در آن NN مقدار هگزادسیمال نویسه است. برای کدگذاری هگز نویسه‌ای با کدگذاری چندبایتی UTF-8، هر بایت را به‌صورت جداگانه هگز کنید. هرگونه فاصله در <tag> باید به‌صورت %20 کدگذاری هگز شود. هر نویسه‌ای که بخشی از <tag> نیست نباید کدگذاری هگز شود.

در آینده ممکن است نقل‌قول به‌سبک tag:"tag with spaces" برای <tag> نیز پشتیبانی شود؛ به همین دلیل کلیهٔ نویسه‌های نقل‌قول دوگانه (double quote) در <tag> باید به‌صورت هگز کدگذاری شوند.

بخش <query> باید با استفاده از قواعد نقل‌قول عبارت‌های بولی Xapian نقل‌قول شود: اگر یک عبارت شامل نویسهٔ فاصله یا پرانتز بسته باشد یا با یک نقل‌قول دوگانه آغاز شود، باید در نقل‌قول دوگانه محصور گردد (بدون احتساب هیچ پیشوندی) و نقل‌قول‌های دوگانهٔ درون عبارت باید دو برابر شوند (برای مثال‌ها به بخش زیر مراجعه کنید).

فاصله‌های خالی ' ' در ابتدا و انتهای خط نادیده گرفته می‌شوند. خطوط خالی و خطوطی که با '#' آغاز می‌شوند نادیده گرفته خواهند شد.

مثال (EXAMPLE)

نمونهٔ زیر یک ورودی معتبر برای برچسب‌گذاری دسته‌ای را نشان می‌دهد. توجه داشته باشید که تنها نویسهٔ منفرد '*' به‌عنوان نویسه عام (wildcard) عمل می‌کند. همچنین به دو شیوهٔ مختلف نقل‌قول برچسب space in tags دقت فرمایید:

+winner *
+foo::bar%25 -- (One and Two) or (One and tag:winner)
+found::it -- tag:foo::bar%
# ignore this line and the next
+space%20in%20tags -- Two
# add tag '(tags)', among other stunts.
+crazy{ +(tags) +&are +#possible\ -- tag:"space in tags"
+match*crazy -- tag:crazy{
+some_tag -- id:"this is ""nauty)"""

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

notmuch <#notmuch-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-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>,

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

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

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

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