.TH taskrc 5 2016-02-24 "task 3.5.0" "User Manuals" .SH "نام (NAME)" taskrc \- جزئیات پیکربندی برای دستور task(1) .SH "خلاصه دستور (SYNOPSIS)" .B $HOME/.taskrc .br .B task rc:/.taskrc ... .br .B TASKRC=/.taskrc task ... .br .B XDG_CONFIG_HOME=/task/taskrc task ... .SH "توضیحات (DESCRIPTION)" .B Taskwarrior داده‌های پیکربندی خود را از فایلی به نام .I .taskrc به دست می‌آورد. این فایل معمولاً در دایرکتوری خانگی کاربر قرار دارد: .nf $HOME/.taskrc .fi مکان پیش‌فرض را می‌توان با استفاده از ویژگی .I rc: هنگام اجرای task بازنویسی (override) کرد: .nf $ task rc:/.taskrc ... .fi یا با استفاده از متغیر محیطی TASKRC: .nf $ TASKRC=/tmp/.taskrc task ... .fi علاوه بر این، اگر ~/.taskrc وجود نداشته باشد، taskwarrior بررسی می‌کند که آیا متغیر محیطی XDG_CONFIG_HOME تعریف شده است یا خیر: .nf $ XDG_CONFIG_HOME=~/.config task ... .fi گزینه‌های منفرد را می‌توان با استفاده از ویژگی .I rc.: هنگام اجرای task بازنویسی کرد: .nf $ task rc.: ... .fi یا .nf $ task rc.= ... .fi اگر .B Taskwarrior بدون فایل پیکربندی موجود اجرا شود، خواهد پرسید که آیا باید یک فایل نمونه و پیش‌فرض .I .taskrc در دایرکتوری خانگی کاربر ایجاد کند یا خیر. فایل .taskrc از یک نحو بسیار ساده برای تعریف جفت‌های نام/مقدار پیروی می‌کند: .nf = .fi ممکن است در اطراف ، '=' و فاصله‌های خالی وجود داشته باشد که نادیده گرفته می‌شوند. فاصله خالی درون دست‌نخورده باقی می‌ماند. فاصله خالی در فهرست‌های جداشده با کاما مجاز نیست. هر مدخل باید در یک خط واحد باشد و شکست خط مجاز نیست. مقادیر هم از کدگذاری UTF8 و هم از JSON (مانند \\uNNNN) پشتیبانی می‌کنند. توجه داشته باشید که Taskwarrior در مورد مقادیر مورداستفاده برای نمایش موارد بولی انعطاف‌پذیر است. می‌توانید از "1" برای فعال‌سازی استفاده کنید؛ هر مقدار دیگری به عنوان غیرفعال تفسیر می‌شود. مقادیر "on"، "yes"، "y" و "true" نیز پشتیبانی می‌شوند. .nf include .fi ممکن است در اطراف 'include' و فاصله خالی وجود داشته باشد. فایل می‌تواند یک مسیر مطلق یا نسبی باشد، و کاراکتر ویژه '~' به $HOME گسترش می‌یابد. اگر مسیر نسبی مشخص شود، نسبت به دایرکتوری‌های زیر (به ترتیب اولویت) ارزیابی خواهد شد: 1. دایرکتوری کاری جاری 2. دایرکتوری حاوی فایل taskrc 3. دایرکتوری‌های تنظیم‌شده توسط مدیر بسته (که معمولاً حاوی پوسته‌های ازپیش‌تعریف‌شده هستند) توجه داشته باشید که متغیرهای محیطی نیز در مسیرها (و هر متغیر taskrc دیگری) گسترش می‌یابند. .nf # .fi یک کامنت شامل کاراکتر '#' است و از '#' تا انتهای خط ادامه می‌یابد. هیچ راهی برای کامنت‌گذاری یک بلوک چندخطی وجود ندارد. خطوط خالی مجاز هستند. تقریباً هر مقداری دارای یک تنظیم پیش‌فرض است، و یک فایل .taskrc خالی فایلی است که از تمام مقادیر پیش‌فرض استفاده می‌کند. بنابراین محتویات فایل .taskrc نشان‌دهنده بازنویسی مقادیر پیش‌فرض است. برای حذف کامل یک مقدار پیش‌فرض باید مدخلی مانند این وجود داشته باشد: .nf = .fi این مدخل مقدار پیش‌فرض را با یک مقدار خالی جایگزین می‌کند. .SH "ویرایش (EDITING)" در صورت تمایل می‌توانید فایل .taskrc خود را به صورت دستی ویرایش کنید، یا می‌توانید از دستور 'config' استفاده نمایید. برای تنظیم دائمی یک مقدار در فایل .taskrc خود، از این دستور استفاده کنید: .nf $ task config nag "You have more urgent tasks." .fi برای حذف یک مدخل، از این دستور استفاده کنید: .nf $ task config nag .fi سپس Taskwarrior از مقدار پیش‌فرض استفاده خواهد کرد. برای تنظیم صریح یک مقدار به صورت خالی، و در نتیجه اجتناب از استفاده از مقدار پیش‌فرض، از این دستور استفاده کنید: .nf $ task config nag "" .fi Taskwarrior همچنین تمام تنظیمات شما را با این دستور نمایش می‌دهد: .nf $ task show .fi و علاوه بر این، بررسی تمام مقادیر موجود در فایل را نیز انجام خواهد داد و هرگونه مورد نادرستی را به شما هشدار می‌دهد. .SH "تودرتوسازی فایل‌های پیکربندی (NESTING CONFIGURATION FILES)" فایل .taskrc می‌تواند با استفاده از عبارت .B include شامل فایل‌های دیگری حاوی تنظیمات پیکربندی باشد: .nf include .fi با استفاده از فایل‌های include می‌توانید فایل پیکربندی اصلی خود را به چندین فایل حاوی داده‌های پیکربندی مرتبط مانند رنگ‌ها و غیره تقسیم کنید. سه کاربرد عالی از دستور include در .taskrc شما وجود دارد که در اینجا نشان داده شده است: .nf include default.theme include holidays.en-US.rc include dark-16.theme .fi این دستورها دو فایل استاندارد را که به همراه Taskwarrior توزیع می‌شوند شامل می‌کنند؛ این فایل‌ها مجموعه‌ای از تعطیلات ایالات متحده را تعریف کرده و یک پوسته ۱۶ رنگی را برای رنگ‌آمیزی گزارش‌ها و تقویم تنظیم می‌کنند. .SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)" این متغیرهای محیطی مقادیر پیش‌فرض را بازنویسی می‌کنند، اما آرگومان‌های خط فرمان را خیر. .TP .B TASKDATA=~/.task این متغیر مسیر پیش‌فرض داده‌های Taskwarrior را بازنویسی می‌کند. .TP .B TASKRC=~/.taskrc این متغیر فایل RC پیش‌فرض را بازنویسی می‌کند. .RE این متغیر محیطی در صورت عدم وجود .I ~/.taskrc بررسی خواهد شد: .TP .B XDG_CONFIG_HOME=~/.config در صورت تنظیم، taskwarrior به دنبال فایل .I $XDG_CONFIG_HOME/task/taskrc خواهد گشت. .SH "متغیرهای پیکربندی (CONFIGURATION VARIABLES)" نام‌های معتبر متغیرها و مقادیر پیش‌فرض آن‌ها عبارتند از: .SS "فایل‌ها (FILES)" .TP .B data.location=$HOME/.task مسیر دایرکتوری حاوی تمام داده‌های Taskwarrior است. به طور پیش‌فرض روی ~/.task تنظیم شده است، به عنوان مثال: /home/paul/.task توجه داشته باشید که می‌توانید از متای کاراکتر پوسته .B ~ استفاده کنید که به درستی گسترش می‌یابد. توجه داشته باشید که متغیر محیطی TASKDATA این تنظیم را بازنویسی می‌کند. .TP .B hooks.location=$HOME/.task/hooks مسیر دایرکتوری اسکریپت‌های قلاب (hook) است. به طور پیش‌فرض ~/.task/hooks است. .TP .B gc=1 می‌تواند برای تعلیق موقت بازسازی پایگاه‌داده استفاده شود تا شناسه‌های وظایف (IDs) تغییر نکنند. بازسازی نیازمند دسترسی خواندن/نوشتن به پایگاه‌داده است، بنابراین غیرفعال کردن `gc` ممکن است عملکرد بهتری به همراه داشته باشد. توجه داشته باشید که این گزینه باید به شکل یک بازنویسی خط فرمان (task rc.gc=0 ...) استفاده شود و نباید به طور دائم در فایل .taskrc قرار گیرد، زیرا در بلندمدت تأثیر منفی چشمگیری بر عملکرد می‌گذارد. .TP .B purge.on-sync=0 در صورت تنظیم، وظایف قدیمی پس از هر همگام‌سازی به صورت خودکار پاکسازی می‌شوند. وظایف زمانی به عنوان «قدیمی» شناخته می‌شوند که وضعیت "Deleted" داشته و به مدت ۱۸۰ روز تغییر نیافته باشند. .TP .B hooks=1 این سوییچ کنترل اصلی، پردازش اسکریپت‌های قلاب را فعال می‌کند. مقدار پیش‌فرض '1' است، اما برخی افزونه‌ها و محیط‌ها ممکن است به غیرفعال کردن قلاب‌ها نیاز داشته باشند. .TP .B exit.on.missing.db=0 هنگامی که روی '1' تنظیم شود، در صورت مفقود بودن پایگاه‌داده (~/.task یا rc.data.location یا بازنویسی TASKDATA)، برنامه خارج می‌شود. مقدار پیش‌فرض '0' است. .SS "ترمینال (TERMINAL)" .TP .B detection=1 تعیین می‌کند که آیا از ioctl برای تشخیص اندازه پنجره جهت شکستن خودکار متن (text wrapping) استفاده شود یا خیر. .TP .B limit:25 در صورت ارائه یک عدد صحیح مثبت، تعداد مطلوب وظایفی را که یک گزارش باید نشان دهد مشخص می‌کند. مقدار 'page' نیز می‌تواند استفاده شود و خروجی گزارش را به تعداد خطوطی که در صفحه جا می‌شوند محدود می‌کند. مقدار پیش‌فرض '25' است. .TP .B defaultwidth=80 عرض خروجی در زمانی که پشتیبانی از تشخیص خودکار در دسترس نباشد. پیش‌فرض ۸۰ است. اگر روی ۰ تنظیم شود، به عنوان عرض نامحدود و بدون شکستن خطوط تفسیر می‌شود؛ این ویژگی هنگام تغییر مسیر خروجی گزارش به یک فایل برای پردازش‌های بعدی مفید است. .TP .B defaultheight=24 ارتفاع خروجی در زمانی که پشتیبانی از تشخیص خودکار در دسترس نباشد. پیش‌فرض ۲۴ است. اگر روی ۰ تنظیم شود، به عنوان ارتفاع نامحدود تفسیر می‌شود. این ویژگی هنگام هدایت نمودارها به یک فایل برای پردازش‌های بعدی مفید است. .TP .B avoidlastcolumn=0 باعث می‌شود عرض ترمینال منهای یک به عنوان عرض کامل استفاده شود. این کار از قرار گرفتن کدهای رنگی در آخرین ستون جلوگیری می‌کند که می‌تواند برای کاربران Cygwin مشکل ایجاد کند. مقدار پیش‌فرض '0' است. .TP .B hyphenate=1 هنگامی که شکستن خطوط در وسط کلمه رخ می‌دهد، کلمات را با خط تیره جدا می‌کند. مقدار پیش‌فرض '1' است. .TP .B editor=vi ویرایشگر متنی را که می‌خواهید هنگام استفاده از دستور .B task edit استفاده شود مشخص می‌کند. Taskwarrior ابتدا به دنبال این متغیر پیکربندی می‌گردد. اگر پیدا شود، از آن استفاده می‌کند. در غیر این صورت، قبل از اینکه به طور پیش‌فرض از "vi" استفاده کند، متغیرهای محیطی $VISUAL یا $EDITOR را بررسی خواهد کرد. .TP .B reserved.lines=1 تعداد خطوط رزروشده در پایین صفحه برای اعلان خط فرمان (shell prompt) است. این گزینه فقط زمانی مورد استفاده قرار می‌گیرد که از 'limit:page' استفاده شود. .SS "متفرقه (MISCELLANEOUS)" .TP .B verbose=1|0|nothing|list... هنگامی که روی "1" (پیش‌فرض) تنظیم شود، توضیحات و راهنمایی‌های مفید به تمام خروجی‌های Taskwarrior اضافه می‌شود. تنظیم آن روی "0" به این معنی است که خروجی معمولی را مشاهده خواهید کرد. مقدار ویژه "nothing" می‌تواند برای حذف تمام خروجی‌های اختیاری استفاده شود، که باعث می‌شود فقط داده‌های قالب‌بندی‌شده بدون هیچ چیز دیگری نمایش داده شوند. این خروجی برای تجزیه و استفاده توسط اسکریپت‌های پوسته بسیار مناسب است. روش دیگر این است که فهرستی از نشانه‌های پرگویی جداشده با کاما را مشخص کنید که موقعیت‌های خاص تولید خروجی را کنترل می‌کنند. این فهرست می‌تواند شامل موارد زیر باشد: .nf blank درج خطوط خالی اضافی در خروجی جهت خوانایی بهتر header پیام‌هایی که قبل از خروجی گزارش ظاهر می‌شوند (شامل بازنویسی‌های .taskrc/.task و پیام "[task next]") footnote پیام‌هایی که بعد از خروجی گزارش ظاهر می‌شوند (بیشتر پیام‌های وضعیت و شرح تغییرات) label برچسب ستون‌ها در گزارش‌های جدول‌بندی‌شده new-id ارائه بازخورد درباره هر وظیفه جدید با شناسه‌ها (و UUIDها برای وظایف جدید با شناسه ۰، مانند وظایف تکمیل‌شده جدید) new-uuid ارائه بازخورد درباره هر وظیفه جدید با UUIDها؛ این گزینه new-id را بازنویسی می‌کند و برای خودکارسازی مفید است news یادآوری مطالعه نکات برجسته نسخه جدید تا زمانی که کاربر دستور "task news" را اجرا کند affected گزارش 'تعداد N وظیفه تحت تأثیر قرار گرفت' و موارد مشابه edit استفاده از الگوی پرگویی برای دستور 'edit' special بازخورد هنگام اعمال برچسب‌های ویژه project بازخورد درباره تغییرات وضعیت پروژه sync بازخورد درباره همگام‌سازی filter نمایش فیلتر استفاده‌شده در دستور context نمایش زمینه جاری در پاورقی (footnote) override اعلان هنگام بازنویسی گزینه‌های پیکربندی recur اعلان هنگام ایجاد یک نمونه جدید از وظیفه تکرارشونده default اعلان‌ها درباره تصمیم taskwarrior برای انجام یک اقدام پیش‌فرض .fi نشانه‌های "affected"، "new-id"، "new-uuid"، "project"، "override" و "recur" متضمن "footnote" هستند. نشانه "default" متضمن "header" است. توجه داشته باشید که تنظیم "1" معادل مشخص کردن تمام نشانه‌ها است، و تنظیم "nothing" معادل مشخص نکردن هیچ‌یک از نشانه‌ها است. در اینجا معادل‌های میان‌بر آورده شده است: .nf verbose=on verbose=blank,header,footnote,label,new-id,news,affected,edit,special,project,sync,filter,override,recur .fi .nf verbose=0 verbose=blank,label,new-id,edit .fi .nf verbose=nothing verbose= .fi این توضیحات اضافی برای header، footnote و project به خروجی خطای استاندارد (stderr) ارسال می‌شوند. سایر موارد به خروجی استاندارد (stdout) فرستاده می‌شوند. .TP .B confirmation=1 می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا Taskwarrior قبل از حذف یک وظیفه یا اجرای دستور undo درخواست تأیید کند یا خیر. مقدار پیش‌فرض "1" است. برای ایمنی بیشتر، توصیه می‌شود این گزینه را فعال نگه دارید. .TP .B allow.empty.filter=1 یک فیلتر خالی در ترکیب با یک دستور نوشتن، به طور بالقوه راهی برای تغییر اشتباهی تمام وظایف است و هنگامی که چنین موردی شناسایی شود، تأییدیه الزامی خواهد بود. تنظیم این گزینه روی '0' به این معنی است که استفاده از دستور نوشتن بدون فیلتر یک خطا محسوب می‌شود. .TP .B annotation.info=1 تعیین می‌کند که آیا یادداشت‌ها توسط دستور 'info' در زیر فیلد توضیحات نمایش داده شوند یا خیر. مقدار پیش‌فرض "1" است. .TP .B indent.annotation=2 تعداد فاصله‌ها را برای تورفتگی یادداشت‌ها هنگامی که در زیر فیلد توضیحات نشان داده می‌شوند کنترل می‌کند. مقدار پیش‌فرض "2" است. .TP .B indent.report=0 تورفتگی کل خروجی گزارش را کنترل می‌کند. پیش‌فرض "0" است. .TP .B row.padding=0 فاصله‌گذاری (padding) چپ و راست را در اطراف هر سطر از خروجی گزارش کنترل می‌کند. پیش‌فرض "0" است. .TP .B column.padding=0 فاصله‌گذاری بین ستون‌های خروجی گزارش را کنترل می‌کند. پیش‌فرض "1" است. .TP .B bulk=3 یک عدد با مقدار پیش‌فرض ۳ است. هنگامی که این تعداد یا بیشتر از وظایف در یک دستور واحد تغییر داده شوند، بدون در نظر گرفتن مقدار متغیر .B confirmation تأییدیه لازم خواهد بود. مقدار ویژه bulk=0 به عنوان بی‌نهایت در نظر گرفته می‌شود. این گزینه برای جلوگیری از تغییرات ناخواسته در مقیاس بزرگ مفید است. .TP .B nag=You have more urgent tasks. می‌تواند یک رشته متنی یا خالی باشد. به عنوان یک پیام یادآوری در هنگام شروع یا تکمیل یک وظیفه استفاده می‌شود، زمانی که وظایف دیگری با فوریت بالاتر وجود دارند. مقدار پیش‌فرض این است: 'You have more urgent tasks'. این یک یادآوری ملایم است که شما در حال نقض تنظیمات فوریت خود هستید. .TP .B list.all.projects=0 می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا دستور 'projects' تمام نام‌های پروژه‌هایی را که تاکنون استفاده کرده‌اید فهرست کند یا فقط پروژه‌هایی را که در وظایف فعال استفاده شده‌اند. مقدار پیش‌فرض "0" است. .TP .B summary.all.projects=0 اگر روی "1" تنظیم شود، تمام پروژه‌ها را در گزارش خلاصه نشان می‌دهد، حتی اگر هیچ وظیفه معلقی نداشته باشند. مقدار پیش‌فرض "0" است. .TP .B complete.all.tags=1 می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا اسکریپت‌های تکمیل خودکار کلید Tab تمام برچسب‌هایی را که استفاده کرده‌اید در نظر بگیرند یا فقط برچسب‌های استفاده‌شده در وظایف فعال را. مقدار پیش‌فرض "0" است. .TP .B list.all.tags=1 می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا دستور 'tags' تمام نام‌های برچسب‌هایی را که تاکنون استفاده کرده‌اید فهرست کند یا فقط موارد استفاده‌شده در وظایف فعال را. مقدار پیش‌فرض "0" است. .TP .B print.empty.columns=1 می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا ستون‌های فاقد داده برای هر وظیفه‌ای چاپ شوند یا خیر. پیش‌فرض "0" است. .TP .B search.case.sensitive=1 می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا جستجوی کلمات کلیدی و جایگزینی‌ها در توضیحات و یادداشت‌ها به صورت حساس به حروف کوچک و بزرگ انجام شود یا خیر. در بیشتر پلتفرم‌ها پیش‌فرض "1" است. در Cygwin به دلیل مشکلات کتابخانه‌های قدیمی regex با حساسیت به حروف، پیش‌فرض "0" است. .TP .B regex=1 کنترل می‌کند که آیا پشتیبانی از عبارات باقاعده (regular expressions) فعال باشد یا خیر. مقدار پیش‌فرض "1" است. .TP .B xterm.title=1 عنوان پنجره xterm را هنگام اجرای گزارش‌ها تنظیم می‌کند. پیش‌فرض "0" است. .TP .B expressions=infix|postfix اولویت را برای عبارات میانوندی (infix مانند 1 + 2) یا پسوندی (postfix مانند 1 2 +) تعیین می‌کند. پیش‌فرض infix است. .TP .B json.array=1 تعیین می‌کند که آیا دستور export خروجی JSON را در '[...]' قرار دهد و پس از هر شیء وظیفه صادرشده یک ',' اضافه کند تا یک آرایه JSON با ساختار صحیح ایجاد شود یا خیر. با json.array=0، دستور export اشیاء خام JSON را به خروجی استاندارد (STDOUT)، هر شیء در یک خط، می‌نویسد. پیش‌فرض "1" است. .TP .B _forcecolor=1 هنگامی که خروجی مستقیماً به یک TTY ارسال نمی‌شود، Taskwarrior به طور خودکار رنگ را خاموش می‌کند. به عنوان مثال، این دستور: .RS .RS $ task list > file .RE از هیچ رنگی استفاده نخواهد کرد. برای نادیده گرفتن این رفتار، از دستور زیر استفاده کنید: .RS $ task rc._forcecolor=yes list > file .RE .RE پیش‌فرض "0" است. .TP .B active.indicator=* کاراکتر یا رشته‌ای که باید در ستون start.active نمایش داده شود. پیش‌فرض * است. .TP .B tag.indicator=+ کاراکتر یا رشته‌ای که باید در ستون tag.indicator نمایش داده شود. پیش‌فرض + است. .TP .B dependency.indicator=D کاراکتر یا رشته‌ای که باید در ستون depends.indicator نمایش داده شود. پیش‌فرض D است. .TP .B uda..indicator=U کاراکتر یا رشته‌ای که باید در ستون .indicator نمایش داده شود. پیش‌فرض U است. .TP .B recurrence=1 کنترل می‌کند که آیا تکرار فعال باشد و آیا وظایف تکرارشونده به ایجاد نمونه‌های جدید وظیفه ادامه دهند یا خیر. پیش‌فرض "1" است. اگر چندین کلاینت را همگام‌سازی می‌کنید، توصیه می‌شود که 'recurrence=1' را روی کلاینت اصلی خود و 'recurrence=0' را روی تمام کلاینت‌های دیگر تنظیم کنید. این یک راهکار موقت برای رفع باگ تکثیر وظایف است. .TP .B recurrence.confirmation=prompt کنترل می‌کند که آیا تغییرات در وظایف تکرارشونده با یا بدون تأیید به سایر وظایف فرزند منتقل شود یا خیر. مقدار 'yes' به معنای انتشار تغییرات بدون درخواست تأیید است. مقدار 'no' به معنای عدم انتشار تغییرات و عدم درخواست تأیید است. مقدار 'prompt' هر بار از شما سؤال می‌کند. پیش‌فرض 'prompt' است. .TP .B recurrence.indicator=R کاراکتر یا رشته‌ای که باید در ستون recurrence_indicator نمایش داده شود. پیش‌فرض R است. .TP .B recurrence.limit=1 تعداد وظایف تکرارشونده آینده برای نمایش را مشخص می‌کند. پیش‌فرض ۱ است. به عنوان مثال، اگر یک وظیفه با تکرار هفتگی با موعد سررسید فردا اضافه شود و recurrence.limit روی ۲ تنظیم شده باشد، گزارش دو وظیفه معلق تکرارشونده را فهرست می‌کند: یکی برای فردا و دیگری برای یک هفته بعد از فردا. .TP .B abbreviation.minimum=2 حداقل طول هر دستور/مقدار مخفف‌شده است. این بدان معناست که "ve"، "ver"، "vers"، "versi" و "versio" همگی معادل "version" خواهند بود، اما "v" چنین نخواهد بود. پیش‌فرض ۲ است. .TP .B debug=0 نرم‌افزار Taskwarrior دارای یک حالت اشکال‌زدایی (debug) است که باعث نمایش خروجی‌های تشخیصی می‌شود. معمولاً این چیزی نیست که کسی بخواهد، اما هنگام گزارش باگ، خروجی دیباگ می‌تواند مفید باشد. همچنین می‌تواند به درک نحوه تجزیه خط فرمان کمک کند، اما این اطلاعات به شیوه‌ای مناسب توسعه‌دهندگان نمایش داده می‌شود، نه کاربران عادی. روشن کردن دیباگ به طور خودکار گزینه‌های debug.hooks=1 و debug.parser=1 را در صورتی که مقداری به آن‌ها تخصیص نیافته باشد فعال می‌کند. پیش‌فرض "0" است. .TP .B debug.hooks=0 سطح تشخیصی سیستم قلاب‌ها را کنترل می‌کند. سطح ۰ به معنای عدم نمایش خروجی تشخیصی است. سطح ۱ فراخوانی‌های قلاب را نشان می‌دهد. سطح ۲ همچنین وضعیت خروج و ورودی/خروجی (I/O) را نشان می‌دهد. .TP .B debug.parser=0 سطح تشخیصی تجزیه‌کننده (parser) را کنترل می‌کند. سطح ۰ هیچ خروجی تشخیصی نشان نمی‌دهد. سطح ۱ درخت تجزیه نهایی را نشان می‌دهد. سطح ۲ درخت تجزیه را در تمام مراحل تجزیه نشان می‌دهد. سطح ۳ جزئیات ارزیابی عبارت را نشان می‌دهد. .TP .B obfuscate=0 هنگامی که روی '1' تنظیم شود، تمام متن گزارش را با 'xxx' جایگزین می‌کند. این قابلیت برای به اشتراک‌گذاری خروجی گزارش‌ها در گزارش باگ‌ها بدون افشای اطلاعات حساس مفید است. مقدار پیش‌فرض '0' است. .TP .B alias.rm=delete ابزار Taskwarrior از نام‌های مستعار دستورات (aliases) پشتیبانی می‌کند. این نام مستعار یک نام جایگزین (rm) برای دستور delete فراهم می‌کند. می‌توانید از نام‌های مستعار برای تعریف نام‌های جایگزین برای هر یک از دستورات استفاده کنید. چندین دستوری که ممکن است استفاده کنید در واقع نام مستعار هستند؛ به عنوان مثال گزارش 'history' یا دستور 'export'. .TP .B burndown.cumulative=1 می‌تواند "1" یا "0" باشد و رفتار دستور burndown را کنترل می‌کند. هنگامی که روی ۱ تنظیم شود، تمام وظایف تکمیل‌شده را جمع می‌زند، در غیر این صورت فقط در بازه‌ای که وظیفه تکمیل شده است رسم می‌شوند. پیش‌فرض ۱ است. .SS "تاریخ‌ها (DATES)" .TP .B dateformat=Y-M-D .TP .B dateformat.report= .TP .B dateformat.holiday=YMD .TP .B dateformat.edit=Y-M-D H:N:S .TP .B dateformat.info=Y-M-D H:N:S .TP .B dateformat.annotation= .TP .B report.X.dateformat=Y-M-D این یک رشته از کاراکترها است که نحوه قالب‌بندی مقادیر تاریخ را توسط Taskwarrior مشخص می‌کند. ترتیب اولویت برای متغیرهای پیکربندی جهت قالب‌بندی تاریخ‌های سررسید در گزارش‌ها به این صورت است: ابتدا report.X.dateformat، سپس dateformat.report و سپس dateformat. اگر هر دو متغیر report.X.dateformat و dateformat.report تنظیم نشده باشند، dateformat روی تاریخ اعمال خواهد شد. تاریخ‌های واردشده و همچنین تمام تاریخ‌های نمایش‌داده‌شده در گزارش‌ها طبق dateformat قالب‌بندی می‌شوند. مقدار پیش‌فرض، استاندارد ISO-8601 است: Y-M-D. این رشته می‌تواند شامل کاراکترهای زیر باشد: .nf m ماه با حداقل رقم، مانند 1 یا 12 d روز با حداقل رقم، مانند 1 یا 30 y سال دورقمی، مانند 09 یا 12 D روز دورقمی، مانند 01 یا 30 M ماه دورقمی، مانند 01 یا 12 Y سال چهاررقمی، مانند 2009 یا 2015 a نام کوتاه روز هفته، مانند Mon یا Wed A نام کامل روز هفته، مانند Monday یا Wednesday b نام کوتاه ماه، مانند Jan یا Aug B نام کامل ماه، مانند January یا August v هفته با حداقل رقم، مانند 3 یا 37 V هفته دورقمی، مانند 03 یا 37 h ساعت با حداقل رقم، مانند 3 یا 21 n دقیقه با حداقل رقم، مانند 5 یا 42 s ثانیه با حداقل رقم، مانند 7 یا 47 H ساعت دورقمی، مانند 03 یا 21 N دقیقه دورقمی، مانند 05 یا 42 S ثانیه دورقمی، مانند 07 یا 47 J روز ژولینی سه‌رقمی، مانند 023 یا 365 j روز ژولینی، مانند 23 یا 365 w روز هفته، به عنوان مثال 0 برای دوشنبه، 5 برای جمعه .fi .RS کاراکترهای 'v'، 'V'، 'a' و 'A' فقط برای قالب‌بندی تاریخ‌های چاپ‌شده قابل استفاده هستند (نه برای تجزیه ورودی‌ها). .RE .RS این رشته همچنین می‌تواند شامل کاراکترهای دیگری به عنوان جداکننده یا قالب‌بندی باشد. نمونه‌هایی از سایر مقادیر dateformat: .RE .nf d/m/Y برای ورودی و خروجی از 24/7/2009 استفاده می‌کند yMD برای ورودی و خروجی از 090724 استفاده می‌کند M-D-Y برای ورودی و خروجی از 07-24-2009 استفاده می‌کند .fi .RS نمونه‌هایی از سایر مقادیر dateformat.report: .RE .nf a D b Y (V) خروجی "Fri 24 Jul 2009 (30)" را تولید می‌کند A, B D, Y خروجی "Friday, July 24, 2009" را تولید می‌کند wV a Y-M-D خروجی "w30 Fri 2009-07-24" را تولید می‌کند yMD.HN خروجی "110124.2342" را تولید می‌کند m/d/Y H:N خروجی "1/24/2011 10:42" را تولید می‌کند a D b Y H:N:S خروجی "Mon 24 Jan 2011 11:19:42" را تولید می‌کند .fi .RS فیلدهای تعریف‌نشده در صورتی که حداقل یک فیلد عمومی دیگر تاریخ تنظیم شده باشد، روی حداقل مقادیر معتبر خود (۱ برای ماه و روز، و ۰ برای ساعت، دقیقه و ثانیه) تنظیم می‌شوند. در غیر این صورت، روی مقادیر متناظر زمان فعلی ("now") تنظیم می‌گردند. به عنوان مثال: .RE .nf 8/1/2013 همراه با m/d/Y به معنی 1 اوت 2013 در نیمه‌شب است (استنباط‌شده) 8/1 20:40 همراه با m/d H:N به معنی 1 اوت 2013 (استنباط‌شده) در ساعت 20:40 است .fi .TP .B date.iso=1 پشتیبانی از تاریخ‌های ISO-8601 را فعال می‌کند. مقدار پیش‌فرض "1" است. .SS "تقویم (CALENDAR)" .TP .B weekstart=Sunday روز آغاز هفته را تعیین می‌کند. مقادیر معتبر فقط Sunday یا Monday هستند. مقدار پیش‌فرض "Sunday" است. .TP .B displayweeknumber=1 تعیین می‌کند که آیا شماره‌های هفته هنگام استفاده از دستور "task calendar" نمایش داده شوند یا خیر. شماره هفته به روز شروع هفته وابسته است. مقدار پیش‌فرض "1" است. .TP .B due=7 تعداد روزهای آینده است که مشخص می‌کند چه زمانی یک وظیفه سررسیدشده تلقی می‌شود و بر همین اساس رنگ‌آمیزی می‌گردد. مقدار پیش‌فرض ۷ است. .TP .B calendar.details=sparse اگر روی "full" تنظیم شود، اجرای "task calendar" جزئیات وظایفی را که موعد سررسید آن‌ها در دوره تقویم قرار دارد نمایش می‌دهد. روزهای متناظر در تقویم با کد رنگی مشخص می‌شوند. اگر روی "sparse" تنظیم شود، فقط روزهای متناظر کد رنگی دریافت می‌کنند و هیچ جزئیاتی نمایش داده نمی‌شود. نمایش تاریخ‌های سررسید همراه با جزئیات را می‌توان با تنظیم این متغیر روی "none" خاموش کرد. مقدار پیش‌فرض "sparse" است. .TP .B calendar.details.report=list گزارشی است که هنگام نمایش جزئیات وظایف دارای تاریخ سررسید در زمان اجرای دستور "task calendar" اجرا می‌شود. مقدار پیش‌فرض "list" است. .TP .B calendar.offset=0 اگر "1" باشد، اولین ماه در گزارش تقویم به میزان مقدار افست مشخص‌شده در calendar.offset.value تغییر می‌کند. پیش‌فرض "0" است. .TP .B calendar.offset.value=-1 مقدار افست برای اعمال روی اولین ماه در گزارش تقویم است. مقدار پیش‌فرض "-1" است. .TP .B calendar.holidays=none اگر روی full تنظیم شود، اجرای "task calendar" تعطیلات را با کدگذاری رنگی روزهای متناظر در تقویم نمایش می‌دهد. همچنین یک فهرست دقیق با تاریخ‌ها و نام‌های تعطیلات نشان داده می‌شود. اگر روی sparse تنظیم شود، فقط روزها کد رنگی دریافت می‌کنند و هیچ جزئیاتی از تعطیلات نمایش داده نمی‌شود. نمایش تعطیلات با تنظیم این متغیر روی none خاموش می‌شود. مقدار پیش‌فرض "none" است. .TP .B calendar.legend=1 تعیین می‌کند که آیا راهنمای علائم تقویم (legend) نمایش داده شود یا خیر. مقدار پیش‌فرض "1" است. .TP .B calendar.monthsperline=N تعیین می‌کند دستور "task calendar" چند ماه را در عرض صفحه رندر کند. به طور پیش‌فرض به تعداد ماه‌هایی است که در صفحه جا می‌شوند. اگر تعداد ماه‌های بیشتری نسبت به گنجایش صفحه مشخص شود، Taskwarrior فقط به میزانی که جا می‌شود نمایش خواهد داد. .SS "مدخل‌های وقایع روزانه (JOURNAL ENTRIES)" .TP .B journal.time=0 می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا دستورات 'start' و 'stop' در هنگام اجرا باید یک یادداشت ثبت کنند یا خیر. مقدار پیش‌فرض "0" است. متن یادداشت‌های متناظر توسط متغیرهای زیر کنترل می‌شود: .TP .B journal.time.start.annotation=Started task متن یادداشتی است که هنگام اجرای دستور start و با فعال بودن journal.time ثبت می‌شود. .TP .B journal.time.stop.annotation=Stopped task متن یادداشتی است که هنگام اجرای دستور stop و با فعال بودن journal.time ثبت می‌شود. .TP .B journal.info=1 هنگامی که فعال باشد، این تنظیم باعث می‌شود گزارش تغییرات (change log) هر وظیفه توسط دستور 'info' نمایش داده شود. مقدار پیش‌فرض "1" است. .SS "تعطیلات (HOLIDAYS)" تعطیلات یا مستقیماً در فایل .taskrc وارد می‌شوند یا از طریق یک فایل include که در .taskrc مشخص شده است فراخوانی می‌گردند. برای تعطیلات یک‌روزه، ذکر نام و تاریخ الزامی است: .nf holiday.towel.name=Day of the towel holiday.towel.date=20100525 .fi برای تعطیلاتی که شامل یک بازه چندروزه هستند (مانند تعطیلات مرخصی)، می‌توانید از یک تاریخ شروع و یک تاریخ پایان استفاده کنید: .nf holiday.sysadmin.name=System Administrator Appreciation Week holiday.sysadmin.start=20100730 holiday.sysadmin.end=20100805 .fi .RS تاریخ‌ها باید مطابق با تنظیمات موجود در متغیر dateformat.holiday وارد شوند. .RE .RS تعطیلات زیر به صورت خودکار محاسبه می‌شوند: جمعه نیک (goodfriday)، عید پاک (easter)، دوشنبه عید پاک (eastermonday)، معراج مسیح (ascension)، و عید پنجاهه (pentecost). تاریخ این تعطیلات کلمه کلیدی داده‌شده است: .RE .nf holiday.eastersunday.name=Easter holiday.eastersunday.date=easter .fi توجه داشته باشید که توزیع Taskwarrior شامل فایل‌های نمونه تعطیلات است که می‌توانند مانند نمونه زیر گنجانده شوند: .nf include holidays.en-US.rc .fi .SS "وابستگی‌ها (DEPENDENCIES)" .TP .B dependency.reminder=1 تعیین می‌کند که آیا نقض زنجیره وابستگی باعث ایجاد پیام‌های یادآوری شود یا خیر. .TP .B dependency.confirmation=1 تعیین می‌کند که آیا ترمیم زنجیره وابستگی نیازمند تأیید کاربر باشد یا خیر. .SS "کنترل‌های رنگ (COLOR CONTROLS)" .TP .B color=1 می‌تواند "1" یا "0" باشد. تعیین می‌کند که آیا Taskwarrior از رنگ استفاده کند یا خیر. هنگامی که روی "0" باشد، از خط تیره (-----) برای خط کشیدن زیر عناوین ستون‌ها استفاده می‌کند. .TP .B fontunderline=1 تعیین می‌کند که آیا حتی با وجود فعال بودن رنگ، باید از زیرخط فونت یا خط تیره‌های اسکی برای زیر عناوین استفاده شود یا خیر. .RE ابزار Taskwarrior دارای تعدادی قوانین رنگ‌آمیزی است. این قوانین با یک ویژگی خاص از وظیفه، مانند زمان سررسید یا فعال بودن آن مطابقت دارند و رنگ‌آمیزی خودکار آن وظیفه را مشخص می‌کنند. فهرستی از رنگ‌های معتبر (بسته به نوع ترمینال شما) را می‌توان با اجرای دستور زیر به دست آورد: .RS .B task colors .RE .RS تنظیمات پیش‌فرض اکنون با تنظیمات تعریف‌شده در default.theme مطابقت دارند. قوانین اساسی رنگ‌آمیزی که از طریق این ساختار ماژولار تجزیه می‌شوند به شرح زیر است: .RE .RS .B color.due.today وظیفه امروز سررسید می‌شود. .br .B color.active وظیفه شروع شده، بنابراین فعال است. .br .B color.scheduled وظیفه زمان‌بندی شده، بنابراین آماده کار است. .br .B color.until وظیفه دارای تاریخ انقضا است. .br .B color.blocking وظیفه مانع انجام وظیفه دیگری در یک وابستگی است. .br .B color.blocked وظیفه توسط یک وابستگی مسدود شده است. .br .B color.overdue وظیفه معوق است (موعد سررسید آن قبل از زمان فعلی بوده است). .br .B color.due موعد وظیفه نزدیک است. .br .B color.project.none وظیفه به هیچ پروژه‌ای تخصیص نیافته است. .br .B color.tag.none وظیفه هیچ برچسبی ندارد. .br .B color.tagged وظیفه حداقل دارای یک برچسب است. .br .B color.recurring وظیفه تکرارشونده است. .br .B color.completed وظیفه تکمیل شده است. .br .B color.deleted وظیفه حذف شده است. .RE .RE .RS برای غیرفعال کردن یک قانون رنگ‌آمیزی که دارای مقدار پیش‌فرض است، مقدار آن را خالی بگذارید؛ به عنوان مثال: .nf color.tagged= .fi .RS به طور پیش‌فرض، رنگ‌های تولیدشده توسط قوانین با هم ترکیب می‌شوند (blend). این ویژگی این مزیت را دارد که با تولید ترکیب‌هایی که مستقیماً توسط هیچ قانون خاصی استفاده نمی‌شوند، اطلاعات بیشتری را منتقل می‌کند. با این حال، ترکیب رنگ‌ها ممکن است باعث ایجاد ترکیب‌های برجسته‌سازی شود که مطلوب نیستند. در چنین مواردی، از گزینه زیر برای غیرفعال کردن این رفتار استفاده کنید: .RE .TP .B rule.color.merge=1 می‌تواند "1" یا "0" باشد. هنگامی که روی "0" تنظیم شود، ادغام رنگ‌های تولیدشده توسط قوانین مختلف رنگ را غیرفعال می‌کند. اگر طرح رنگی شما ترکیب‌های نامطلوبی از پیش‌زمینه و پس‌زمینه ایجاد می‌کند، از این گزینه استفاده کنید. برای جزئیات رنگ‌ها به صفحات راهنمای task-color(5) مراجعه کنید. .RE برخی ویژگی‌ها مانند برچسب‌ها، پروژه‌ها و کلمات کلیدی می‌توانند قوانین رنگ‌آمیزی مخصوص به خود را داشته باشند. .RE .TP .B color.tag.X=yellow هر وظیفه‌ای را که دارای برچسب X باشد رنگ‌آمیزی می‌کند. .RE .TP .B color.project.X=on green هر وظیفه‌ای را که به پروژه X اختصاص داده شده باشد رنگ‌آمیزی می‌کند. .RE .TP .B color.keyword.X=on blue هر وظیفه‌ای را که توضیحات یا هر یک از یادداشت‌های آن حاوی X باشد رنگ‌آمیزی می‌کند. .RE .TP .B color.uda.X=on green هر وظیفه‌ای را که دارای ویژگی تعریف‌شده توسط کاربر X باشد رنگ‌آمیزی می‌کند. .RE .TP .B color.uda.X.VALUE=on green هر وظیفه‌ای را که ویژگی تعریف‌شده توسط کاربر X آن برابر با VALUE باشد رنگ‌آمیزی می‌کند. .RE .TP .B color.uda.X.none=on green هر وظیفه‌ای را که فاقد ویژگی تعریف‌شده توسط کاربر X باشد رنگ‌آمیزی می‌کند. .RE .TP .B color.error=white on red تمام پیام‌های خطا را رنگ‌آمیزی می‌کند. .RE .TP .B color.warning=bold red تمام پیام‌های هشدار را رنگ‌آمیزی می‌کند. .RE .TP .B color.header=green پیام‌هایی را که قبل از خروجی گزارش چاپ می‌شوند رنگ‌آمیزی می‌کند. .RE .TP .B color.footnote=green پیام‌هایی را که در انتهای خروجی گزارش چاپ می‌شوند رنگ‌آمیزی می‌کند. .RE .TP .B color.summary.bar=on green نوار پیشرفت گزارش خلاصه را رنگ‌آمیزی می‌کند. باید شامل یک رنگ پس‌زمینه باشد. .RE .TP .B color.summary.background=on black نوار پیشرفت گزارش خلاصه را رنگ‌آمیزی می‌کند. باید شامل یک رنگ پس‌زمینه باشد. .RE .TP .B color.calendar.today=black on cyan رنگ امروز در تقویم است. .RE .TP .B color.calendar.due=black on green رنگ روزهای دارای وظایف موعد سررسید در تقویم است. .RE .TP .B color.calendar.due.today=black on magenta رنگ امروز همراه با وظایف موعد سررسید در تقویم است. .RE .TP .B color.calendar.overdue=black on red رنگ روزهای دارای وظایف معوق در تقویم است. .RE .TP .B color.calendar.scheduled=black on orange رنگ روزهای دارای وظایف زمان‌بندی‌شده در تقویم است. .RE .TP .B color.calendar.weekend=bright white on black رنگ روزهای آخر هفته در تقویم است. .RE .TP .B color.calendar.holiday=black on bright yellow رنگ روزهای تعطیل در تقویم است. .RE .TP .B color.calendar.weeknumber=black on white رنگ شماره‌های هفته در تقویم است. .RE .TP .B color.label= برچسب‌های گزارش را رنگ‌آمیزی می‌کند. پیش‌فرض عدم استفاده از رنگ است. .RE .TP .B color.label.sort= برچسب‌های گزارش را برای ستون‌های مرتب‌سازی رنگ‌آمیزی می‌کند. پیش‌فرض color.label است. .RE .TP .B color.alternate=on rgb253 رنگ وظایف متناوب (یک‌درمیان) است. این گزینه برای اعمال یک رنگ خاص به وظایف یک‌درمیان در یک گزارش استفاده می‌شود که تفکیک بصری وظایف را آسان‌تر می‌کند. این ویژگی به ویژه زمانی مفید است که وظایف به دلیل توضیحات یا یادداشت‌های طولانی در چندین خط نمایش داده می‌شوند. .RE .TP .B color.history.add=on red .RE .br .B color.history.done=on green .RE .br .B color.history.delete=on yellow .RS میله‌ها را در نمودارهای گزارش ghistory رنگ‌آمیزی می‌کند. پیش‌فرض میله‌های قرمز، سبز و زرد است. .RE .TP .B color.burndown.pending=on red .RE .br .B color.burndown.started=on yellow .RE .br .B color.burndown.done=on green .RS میله‌ها را در نمودارهای گزارش‌های burndown رنگ‌آمیزی می‌کند. پیش‌فرض میله‌های قرمز، سبز و زرد است. .RE .TP .B color.undo.before=red .RE .br .B color.undo.after=green .RS رنگ‌های مورداستفاده توسط دستور undo، برای نشان دادن مقادیر قبل و بعد از تغییری که قرار است واگردانی شود. در حال حاضر پشتیبانی نمی‌شود. .RE .TP .B color.sync.added=green .RE .br .B color.sync.changed=yellow .RE .br .B color.sync.rejected=red .RS خروجی دستور sync را رنگ‌آمیزی می‌کند. .RE .TP .B rule.precedence.color=due.today,active,blocking,blocked,overdue,due, .B scheduled,keyword.,project.,tag.,uda.,recurring, .B tagged,completed,deleted .RS این تنظیم اولویت قوانین رنگ را از بالاترین به پایین‌ترین مشخص می‌کند. توجه داشته باشید که پیشوند 'color.' (برای اختصار) حذف شده است، و هر مقدار عام (مانند color.tag.XXX) به 'tag.' کوتاه شده است که تمام قوانین خاص برچسب‌ها را در یک اولویت یکسان قرار می‌دهد. .RE .TP .B color.debug=green .RS در صورت فعال بودن، تمام خروجی‌های دیباگ را رنگ‌آمیزی می‌کند. .RE .SS "فوریت (URGENCY)" محاسبه فوریت از یک چندجمله‌ای با چندین جمله استفاده می‌کند که هر کدام دارای یک ضریب قابل‌پیکربندی هستند. این ضریب‌ها عبارتند از: .TP .B urgency.blocking.coefficient=8.0 .RS ضریب فوریت برای وظایف مسدودکننده .RE .B urgency.blocked.coefficient=-5.0 .RS ضریب فوریت برای وظایف مسدودشده .RE .B urgency.due.coefficient=12.0 .RS ضریب فوریت برای تاریخ‌های سررسید .RE .B urgency.waiting.coefficient=-3.0 .RS ضریب فوریت برای وضعیت در حال انتظار .RE .B urgency.active.coefficient=4.0 .RS ضریب فوریت برای وظایف فعال .RE .B urgency.scheduled.coefficient=5.0 .RS ضریب فوریت برای وظایف زمان‌بندی‌شده .RE .B urgency.project.coefficient=1.0 .RS ضریب فوریت برای پروژه‌ها .RE .B urgency.tags.coefficient=1.0 .RS ضریب فوریت برای برچسب‌ها .RE .B urgency.annotations.coefficient=1.0 .RS ضریب فوریت برای یادداشت‌ها .RE .B urgency.age.coefficient=2.0 .RS ضریب فوریت برای سن وظایف .RE .B urgency.age.max=365 .RS حداکثر سن بر حسب روز. پس از سپری شدن این تعداد روز، فوریت وظیفه دیگر به دلیل گذر زمان افزایش نمی‌یابد. .RE .B urgency.user.tag..coefficient=... .RS ضریب برچسب خاص. .RE .B urgency.user.tag.next.coefficient=15.0 .RS ضریب فوریت برای برچسب 'next'. .RE .B urgency.user.project..coefficient=... .RS ضریب پروژه خاص. .RE .B urgency.user.keyword..coefficient=... .RS ضریب کلمه کلیدی خاص در توضیحات. .RE .B urgency.uda..coefficient=... .RS حضور یا عدم حضور داده‌های UDA. .RE .B urgency.uda...coefficient=... .RS مقدار خاص داده‌های UDA. .RE این ضرایب اهمیت نسبی جملات مختلف را در محاسبه فوریت منعکس می‌کنند. این مقادیر پیش‌فرض هستند و می‌توان آن‌ها را متناسب با ترجیحات خود تغییر داد، اما مهم است که هرگونه تغییر را با دقت بررسی کنید. .B urgency.inherit=0 .RS در واقع یک ضریب نیست. در صورت فعال بودن، وظایف مسدودکننده بالاترین مقدار فوریت موجود در وظایفی را که مسدود کرده‌اند به ارث می‌برند. این کار به صورت بازگشتی انجام می‌شود. توصیه می‌شود برای اینکه این تنظیم بیشترین کارایی را داشته باشد، urgency.blocking.coefficient و urgency.blocked.coefficient را روی 0.0 تنظیم کنید. .RE .SS "پیش‌فرض‌ها (DEFAULTS)" .TP .B default.project=foo در صورتی که پروژه‌ای را مشخص نکنید، یک نام پروژه پیش‌فرض برای دستور .I task add ارائه می‌دهد. پیش‌فرض خالی است. .TP .B default.due=... در صورتی که تاریخی را مشخص نکنید، یک تاریخ سررسید پیش‌فرض برای دستور .I task add ارائه می‌دهد. می‌توانید از یک تاریخ یا مقدار مدت زمان (که نسبت به زمان حال یا 'now' فرض می‌شود) استفاده کنید. پیش‌فرض خالی است. .TP .B default.scheduled=... در صورتی که تاریخی را مشخص نکنید، یک تاریخ زمان‌بندی پیش‌فرض برای دستور .I task add ارائه می‌دهد. می‌توانید از یک تاریخ یا مقدار مدت زمان (که نسبت به زمان حال یا 'now' فرض می‌شود) استفاده کنید. پیش‌فرض خالی است. .TP .B uda..default=... در صورت مشخص نکردن مقادیر، مقادیر پیش‌فرضی را برای فیلدهای UDA در هنگام استفاده از دستور .I task add ارائه می‌دهد. پیش‌فرض خالی است. .TP .B default.command=next دستور پیش‌فرضی را تعیین می‌کند که هر بار Taskwarrior بدون هیچ آرگومانی فراخوانی شود اجرا می‌گردد. به عنوان مثال، اگر به صورت زیر تنظیم شود: .nf default.command=project:foo list .fi .RS در این صورت اگر دستوری مشخص نشود، Taskwarrior دستور "project:foo list" را اجرا خواهد کرد. این بدان معناست که صرفاً با تایپ کردن .RE .nf $ task [task project:foo list] ID Project Pri Description 1 foo H Design foo 2 foo Build foo .fi .SS "گزارش‌ها (REPORTS)" گزارش‌ها را می‌توان با استفاده از متغیرهای پیکربندی زیر سفارشی‌سازی کرد. ستون‌های خروجی، برچسب‌های آن‌ها و ترتیب مرتب‌سازی را می‌توان با استفاده از متغیرهای متناظر برای هر گزارش تنظیم کرد. هر نام گزارش به عنوان یک نام "دستور" استفاده می‌شود. به عنوان مثال: .TP .B task overdue .TP .B report.X.description توضیحات مربوط به گزارش X هنگام اجرای دستور "task help". .TP .B report.X.columns فهرستی از ستون‌ها و مشخص‌کننده‌های قالب‌بندی است که با کاما از هم جدا شده‌اند. برای مشاهده فهرست کامل گزینه‌ها و مثال‌ها به دستور 'task columns' مراجعه کنید. .TP .B report.X.context یک مقدار بولی که مشخص می‌کند آیا گزارش داده‌شده باید زمینه (context) فعال فعلی را رعایت (اعمال) کند یا خیر. برای جزئیات درباره زمینه به بخش CONTEXT مراجعه کنید. پیش‌فرض 1 است. .TP .B report.X.labels برچسب‌های هر ستون که هنگام تولید گزارش X استفاده می‌شوند. برچسب‌ها فهرستی جداشده با کاما هستند. .TP .B report.X.sort ترتیب مرتب‌سازی وظایف در گزارش تولیدشده X است. ترتیب مرتب‌سازی با استفاده از شناسه‌های ستون مشخص می‌شود که با یک "+" برای ترتیب صعودی یا یک "\-" برای ترتیب نزولی پسوندگذاری می‌شوند. شناسه‌های مرتب‌سازی با کاما از هم جدا می‌شوند. به عنوان مثال: .nf report.list.sort=due+,priority-,start.active-,project+ .fi علاوه بر این، پس از "+" یا "\-"، می‌تواند یک خط مایل "/" وجود داشته باشد که نشان‌دهنده شکست خط (فاصله) پس از تغییر مقادیر ستون است. به عنوان مثال: .nf report.minimal.sort=project+/,description+ .fi این ترتیب مرتب‌سازی مشخص می‌کند که بین هر پروژه یک شکست در فهرست وجود دارد. شکست در فهرست صرفاً یک خط خالی است که یک گروه‌بندی بصری ایجاد می‌کند. مقدار ویژه مرتب‌سازی "none" نشان می‌دهد که هیچ مرتب‌سازی لازم نیست و وظایف به همان ترتیبی (در صورت وجود) که انتخاب شده‌اند ارائه می‌شوند. مقدار ویژه مرتب‌سازی "random" نشان می‌دهد که وظایف به صورت تصادفی مرتب خواهند شد. هر بار که گزارشی با 'sort:random' اجرا شود، یک ترتیب تصادفی جدید تولید خواهد شد. .TP .B report.X.filter یک فیلتر به گزارش X اضافه می‌کند تا فقط وظایف مطابق با معیارهای فیلتر در گزارش تولیدشده نمایش داده شوند. یک مورد خاص برای 'report.timesheet.filter' وجود دارد که می‌تواند مشخص شود حتی اگر گزارش 'timesheet' چندان قابل سفارشی‌سازی نباشد. .TP .B report.X.dateformat یک قالب تاریخ به گزارش X اضافه می‌کند که توسط ستون "تاریخ سررسید" (due date) استفاده خواهد شد. اگر تنظیم نشده باشد، dateformat.report و dateformat به همین ترتیب استفاده خواهند شد. برای جزئیات در مورد نگه‌دارنده‌های مکان به بخش .B "تاریخ‌ها (DATES)" مراجعه کنید. .TP .B report.X.annotations امکان کنترل خروجی یادداشت‌ها را برای یک وظیفه در یک گزارش فراهم می‌کند. منسوخ شده است. به جای آن از ستون .B description با یک قالب مشخص (به عنوان مثال \fBdescription.count\fP) استفاده کنید. .TP ابزار Taskwarrior با تعدادی گزارش ازپیش‌تعریف‌شده ارائه می‌شود که عبارتند از: .TP .B next مهم‌ترین وظایف را فهرست می‌کند. .TP .B long تمام وظایف معلق و تمام داده‌های مطابق با معیارهای مشخص‌شده را فهرست می‌کند. .TP .B list تمام وظایف مطابق با معیارهای مشخص‌شده را فهرست می‌کند. .TP .B ls فهرست کوتاهی از تمام وظایف مطابق با معیارهای مشخص‌شده. .TP .B minimal حداقل فهرست از تمام وظایف مطابق با معیارهای مشخص‌شده. .TP .B newest جدیدترین وظایف را نشان می‌دهد. .TP .B oldest قدیمی‌ترین وظایف را نشان می‌دهد. .TP .B overdue وظایف معوق مطابق با معیارهای مشخص‌شده را فهرست می‌کند. .TP .B active وظایف فعال مطابق با معیارهای مشخص‌شده را فهرست می‌کند. .TP .B completed وظایف تکمیل‌شده مطابق با معیارهای مشخص‌شده را فهرست می‌کند. .TP .B recurring وظایف تکرارشونده مطابق با معیارهای مشخص‌شده را فهرست می‌کند. .TP .B waiting تمام وظایف در حال انتظار مطابق با معیارهای مشخص‌شده را فهرست می‌کند. .TP .B all تمام وظایف مطابق با معیارهای مشخص‌شده را فهرست می‌کند. .TP .B blocked تمام وظایفی را که دارای وابستگی هستند فهرست می‌کند. .SS "ویژگی‌های تعریف‌شده توسط کاربر (USER DEFINED ATTRIBUTES)" ویژگی‌های تعریف‌شده توسط کاربر (UDAs) یک مکانیزم افزونه هستند که به شما امکان می‌دهند ویژگی‌های جدیدی را برای ذخیره و نمایش در Taskwarrior تعریف کنید. یک نمونه از این موارد، ویژگی 'estimate' است که می‌تواند برای ذخیره تخمین‌های زمانی مرتبط با یک وظیفه استفاده شود. این ویژگی 'estimate' به طور پیش‌فرض در Taskwarrior تعبیه نشده است، اما با چند تنظیم ساده در پیکربندی می‌توانید به Taskwarrior دستور دهید که این مورد را ذخیره کرده و امکان دسترسی به آن را برای گزارش‌ها و فیلترهای سفارشی فراهم کند. این ویژگی به شما امکان می‌دهد تا Taskwarrior را متناسب با گردش کار خود گسترش دهید، یا قواعد را تغییر داده و از Taskwarrior برای ذخیره و همگام‌سازی داده‌هایی که لزوماً مرتبط با وظایف نیستند استفاده کنید. یک محدودیت مهم این است که از آنجا که این یک سیستم باز است که امکان تعریف هر ویژگی جدیدی را می‌دهد، Taskwarrior نمی‌تواند معنای آن ویژگی را درک کند. بنابراین در حالی که Taskwarrior داده‌های UDA شما را به دقت ذخیره، ویرایش، گزارش‌گیری، مرتب‌سازی و فیلتر می‌کند، هیچ برداشتی از مفهوم آن ندارد. به عنوان مثال، اگر یک UDA به نام 'estimate' تعریف کنید، Taskwarrior متوجه نخواهد شد که این مقدار نشان‌دهنده هفته‌ها، ساعت‌ها، دقیقه‌ها، پول یا شمارش منابع دیگر است. .TP .B uda..type=string|numeric|uuid|date|duration .RS یک UDA به نام '' از نوع مشخص‌شده تعریف می‌کند. .RE .TP .B uda..label= .RS یک برچسب گزارش پیش‌فرض برای UDA به نام '' فراهم می‌کند. .RE .TP .B uda..values=A,B,C .RS فقط برای UDAهای از نوع 'string'، فهرستی از مقادیر قابل‌قبول را که با کاما از هم جدا شده‌اند ارائه می‌دهد. در این مثال، UDA با نام '' فقط می‌تواند مقادیر 'A'، 'B' یا 'C' را داشته باشد، اما همچنین می‌تواند بدون مقدار نیز باشد. توجه داشته باشید که ترتیب مقادیر مهم است و نشان‌دهنده ترتیب مرتب‌سازی از بالاترین ('A') به پایین‌ترین ('C') است. توجه داشته باشید که مقدار خالی مجاز است. .RE .TP .B uda..default=... .RS یک مقدار پیش‌فرض برای UDA به نام '' تعیین می‌کند. .RE .TP .B مثال ویژگی UDA با نام 'estimate' این مثال یک UDA به نام 'estimate' را نشان می‌دهد که مقادیر خاصی را برای اندازه یک وظیفه ذخیره می‌کند. به مقدار خالی پس از 'trivial' توجه کنید. .RS .B uda.estimate.type=string .br .B uda.estimate.label=Size Estimate .br .B uda.estimate.values=huge,large,medium,small,trivial, .RE .RS توجه داشته باشید که مقادیر به این صورت مرتب می‌شوند: huge > large > medium > small > trivial > '' .RE .SS "زمینه (CONTEXT)" تنظیم زمینه (Context) مکانیزمی است که به کاربر اجازه می‌دهد یک فیلتر دائمی تنظیم کند و در نتیجه از نیاز به تعیین مکرر یک فیلتر جلوگیری نماید. جزئیات بیشتر در مورد استفاده از این قابلیت را می‌توانید در صفحه راهنمای task(1) بیابید. زمینه جاری در فایل .taskrc همراه با تعاریف تمام زمینه‌های ارائه‌شده توسط کاربر ذخیره می‌شود. .TP .B context= .RS مقدار زمینه فعال جاری را ذخیره می‌کند. .RE .TP .B context..read= .RE .br .B context..write= .RS تعریف زمینه خواندن یا نوشتن با نام را ذخیره می‌کند. زمینه خواندن فیلتر پیش‌فرضی است که در زمان فعال بودن زمینه اعمال می‌شود. زمینه نوشتن تغییرات پیش‌فرضی است که در زمان فعال بودن زمینه بر روی وظایف جدید اضافه شده اعمال می‌شود. .RE .TP .B context..rc.= .RS نوع rc امکان بازنویسی هر پارامتر پیکربندی را برای زمینه جاری فراهم می‌کند؛ به عنوان مثال اگر دستور پیش‌فرض برای زمینه home باید به home_report تغییر یابد، عبارت زیر می‌تواند اضافه شود: context.home.rc.default.command=home_report .RE .SS "همگام‌سازی (SYNC)" این تنظیمات پیکربندی برای اتصال و همگام‌سازی وظایف با سرور task استفاده می‌شوند. .SH "اعتبارات و حق نشر (CREDITS & COPYRIGHTS)" حق نشر (C) 2006 \- 2021 متعلق است به T. Babej, P. Beckingham, F. Hernandez. این صفحه راهنما در ابتدا توسط Federico Hernandez نوشته شده است. نرم‌افزار Taskwarrior تحت مجوز MIT توزیع می‌شود. برای اطلاعات بیشتر پیوند https://www.opensource.org/licenses/mit-license.php را ببینید. .SH "همچنین ببینید (SEE ALSO)" .BR task(1), .BR task-color(5), .BR task-sync(5) برای اطلاعات بیشتر درباره Taskwarrior، موارد زیر را ببینید: .TP وب‌سایت رسمی در .TP مخزن رسمی کد در .TP می‌توانید با ارسال ایمیل با پروژه ارتباط برقرار کنید: .SH "گزارش باگ‌ها (REPORTING BUGS)" .TP باگ‌های Taskwarrior را می‌توان در سامانه ردیابی مشکلات گزارش کرد: