فایل‌ها (FILES)

data.location=$HOME/.task

مسیر دایرکتوری حاوی تمام داده‌های Taskwarrior است. به طور پیش‌فرض روی ~/.task تنظیم شده است، به عنوان مثال: /home/paul/.task

توجه داشته باشید که می‌توانید از متای کاراکتر پوسته ~ استفاده کنید که به درستی گسترش می‌یابد.

توجه داشته باشید که متغیر محیطی TASKDATA این تنظیم را بازنویسی می‌کند.

hooks.location=$HOME/.task/hooks

مسیر دایرکتوری اسکریپت‌های قلاب (hook) است. به طور پیش‌فرض ~/.task/hooks است.

gc=1

می‌تواند برای تعلیق موقت بازسازی پایگاه‌داده استفاده شود تا شناسه‌های وظایف (IDs) تغییر نکنند. بازسازی نیازمند دسترسی خواندن/نوشتن به پایگاه‌داده است، بنابراین غیرفعال کردن `gc` ممکن است عملکرد بهتری به همراه داشته باشد.

توجه داشته باشید که این گزینه باید به شکل یک بازنویسی خط فرمان (task rc.gc=0 ...) استفاده شود و نباید به طور دائم در فایل .taskrc قرار گیرد، زیرا در بلندمدت تأثیر منفی چشمگیری بر عملکرد می‌گذارد.

purge.on-sync=0

در صورت تنظیم، وظایف قدیمی پس از هر همگام‌سازی به صورت خودکار پاکسازی می‌شوند. وظایف زمانی به عنوان «قدیمی» شناخته می‌شوند که وضعیت "Deleted" داشته و به مدت ۱۸۰ روز تغییر نیافته باشند.

hooks=1

این سوییچ کنترل اصلی، پردازش اسکریپت‌های قلاب را فعال می‌کند. مقدار پیش‌فرض '1' است، اما برخی افزونه‌ها و محیط‌ها ممکن است به غیرفعال کردن قلاب‌ها نیاز داشته باشند.

exit.on.missing.db=0

هنگامی که روی '1' تنظیم شود، در صورت مفقود بودن پایگاه‌داده (~/.task یا rc.data.location یا بازنویسی TASKDATA)، برنامه خارج می‌شود. مقدار پیش‌فرض '0' است.

ترمینال (TERMINAL)

detection=1

تعیین می‌کند که آیا از ioctl برای تشخیص اندازه پنجره جهت شکستن خودکار متن (text wrapping) استفاده شود یا خیر.

limit:25

در صورت ارائه یک عدد صحیح مثبت، تعداد مطلوب وظایفی را که یک گزارش باید نشان دهد مشخص می‌کند. مقدار 'page' نیز می‌تواند استفاده شود و خروجی گزارش را به تعداد خطوطی که در صفحه جا می‌شوند محدود می‌کند. مقدار پیش‌فرض '25' است.

defaultwidth=80

عرض خروجی در زمانی که پشتیبانی از تشخیص خودکار در دسترس نباشد. پیش‌فرض ۸۰ است. اگر روی ۰ تنظیم شود، به عنوان عرض نامحدود و بدون شکستن خطوط تفسیر می‌شود؛ این ویژگی هنگام تغییر مسیر خروجی گزارش به یک فایل برای پردازش‌های بعدی مفید است.

defaultheight=24

ارتفاع خروجی در زمانی که پشتیبانی از تشخیص خودکار در دسترس نباشد. پیش‌فرض ۲۴ است. اگر روی ۰ تنظیم شود، به عنوان ارتفاع نامحدود تفسیر می‌شود. این ویژگی هنگام هدایت نمودارها به یک فایل برای پردازش‌های بعدی مفید است.

avoidlastcolumn=0

باعث می‌شود عرض ترمینال منهای یک به عنوان عرض کامل استفاده شود. این کار از قرار گرفتن کدهای رنگی در آخرین ستون جلوگیری می‌کند که می‌تواند برای کاربران Cygwin مشکل ایجاد کند. مقدار پیش‌فرض '0' است.

hyphenate=1

هنگامی که شکستن خطوط در وسط کلمه رخ می‌دهد، کلمات را با خط تیره جدا می‌کند. مقدار پیش‌فرض '1' است.

editor=vi

ویرایشگر متنی را که می‌خواهید هنگام استفاده از دستور task edit <ID> استفاده شود مشخص می‌کند. Taskwarrior ابتدا به دنبال این متغیر پیکربندی می‌گردد. اگر پیدا شود، از آن استفاده می‌کند. در غیر این صورت، قبل از اینکه به طور پیش‌فرض از "vi" استفاده کند، متغیرهای محیطی $VISUAL یا $EDITOR را بررسی خواهد کرد.

reserved.lines=1

تعداد خطوط رزروشده در پایین صفحه برای اعلان خط فرمان (shell prompt) است. این گزینه فقط زمانی مورد استفاده قرار می‌گیرد که از 'limit:page' استفاده شود.

متفرقه (MISCELLANEOUS)

verbose=1|0|nothing|list...

هنگامی که روی "1" (پیش‌فرض) تنظیم شود، توضیحات و راهنمایی‌های مفید به تمام خروجی‌های Taskwarrior اضافه می‌شود. تنظیم آن روی "0" به این معنی است که خروجی معمولی را مشاهده خواهید کرد.

مقدار ویژه "nothing" می‌تواند برای حذف تمام خروجی‌های اختیاری استفاده شود، که باعث می‌شود فقط داده‌های قالب‌بندی‌شده بدون هیچ چیز دیگری نمایش داده شوند. این خروجی برای تجزیه و استفاده توسط اسکریپت‌های پوسته بسیار مناسب است.

روش دیگر این است که فهرستی از نشانه‌های پرگویی جداشده با کاما را مشخص کنید که موقعیت‌های خاص تولید خروجی را کنترل می‌کنند. این فهرست می‌تواند شامل موارد زیر باشد:

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 برای انجام یک اقدام پیش‌فرض

نشانه‌های "affected"، "new-id"، "new-uuid"، "project"، "override" و "recur" متضمن "footnote" هستند.

نشانه "default" متضمن "header" است.

توجه داشته باشید که تنظیم "1" معادل مشخص کردن تمام نشانه‌ها است، و تنظیم "nothing" معادل مشخص نکردن هیچ‌یک از نشانه‌ها است.

در اینجا معادل‌های میان‌بر آورده شده است:

verbose=on
verbose=blank,header,footnote,label,new-id,news,affected,edit,special,project,sync,filter,override,recur

verbose=0
verbose=blank,label,new-id,edit

verbose=nothing
verbose=

این توضیحات اضافی برای header، footnote و project به خروجی خطای استاندارد (stderr) ارسال می‌شوند. سایر موارد به خروجی استاندارد (stdout) فرستاده می‌شوند.

confirmation=1

می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا Taskwarrior قبل از حذف یک وظیفه یا اجرای دستور undo درخواست تأیید کند یا خیر. مقدار پیش‌فرض "1" است. برای ایمنی بیشتر، توصیه می‌شود این گزینه را فعال نگه دارید.

allow.empty.filter=1

یک فیلتر خالی در ترکیب با یک دستور نوشتن، به طور بالقوه راهی برای تغییر اشتباهی تمام وظایف است و هنگامی که چنین موردی شناسایی شود، تأییدیه الزامی خواهد بود. تنظیم این گزینه روی '0' به این معنی است که استفاده از دستور نوشتن بدون فیلتر یک خطا محسوب می‌شود.

annotation.info=1

تعیین می‌کند که آیا یادداشت‌ها توسط دستور 'info' در زیر فیلد توضیحات نمایش داده شوند یا خیر. مقدار پیش‌فرض "1" است.

indent.annotation=2

تعداد فاصله‌ها را برای تورفتگی یادداشت‌ها هنگامی که در زیر فیلد توضیحات نشان داده می‌شوند کنترل می‌کند. مقدار پیش‌فرض "2" است.

indent.report=0

تورفتگی کل خروجی گزارش را کنترل می‌کند. پیش‌فرض "0" است.

row.padding=0

فاصله‌گذاری (padding) چپ و راست را در اطراف هر سطر از خروجی گزارش کنترل می‌کند. پیش‌فرض "0" است.

column.padding=0

فاصله‌گذاری بین ستون‌های خروجی گزارش را کنترل می‌کند. پیش‌فرض "1" است.

bulk=3

یک عدد با مقدار پیش‌فرض ۳ است. هنگامی که این تعداد یا بیشتر از وظایف در یک دستور واحد تغییر داده شوند، بدون در نظر گرفتن مقدار متغیر confirmation تأییدیه لازم خواهد بود. مقدار ویژه bulk=0 به عنوان بی‌نهایت در نظر گرفته می‌شود.

این گزینه برای جلوگیری از تغییرات ناخواسته در مقیاس بزرگ مفید است.

nag=You have more urgent tasks.

می‌تواند یک رشته متنی یا خالی باشد. به عنوان یک پیام یادآوری در هنگام شروع یا تکمیل یک وظیفه استفاده می‌شود، زمانی که وظایف دیگری با فوریت بالاتر وجود دارند. مقدار پیش‌فرض این است: 'You have more urgent tasks'. این یک یادآوری ملایم است که شما در حال نقض تنظیمات فوریت خود هستید.

list.all.projects=0

می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا دستور 'projects' تمام نام‌های پروژه‌هایی را که تاکنون استفاده کرده‌اید فهرست کند یا فقط پروژه‌هایی را که در وظایف فعال استفاده شده‌اند. مقدار پیش‌فرض "0" است.

summary.all.projects=0

اگر روی "1" تنظیم شود، تمام پروژه‌ها را در گزارش خلاصه نشان می‌دهد، حتی اگر هیچ وظیفه معلقی نداشته باشند. مقدار پیش‌فرض "0" است.

complete.all.tags=1

می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا اسکریپت‌های تکمیل خودکار کلید Tab تمام برچسب‌هایی را که استفاده کرده‌اید در نظر بگیرند یا فقط برچسب‌های استفاده‌شده در وظایف فعال را. مقدار پیش‌فرض "0" است.

list.all.tags=1

می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا دستور 'tags' تمام نام‌های برچسب‌هایی را که تاکنون استفاده کرده‌اید فهرست کند یا فقط موارد استفاده‌شده در وظایف فعال را. مقدار پیش‌فرض "0" است.

print.empty.columns=1

می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا ستون‌های فاقد داده برای هر وظیفه‌ای چاپ شوند یا خیر. پیش‌فرض "0" است.

search.case.sensitive=1

می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا جستجوی کلمات کلیدی و جایگزینی‌ها در توضیحات و یادداشت‌ها به صورت حساس به حروف کوچک و بزرگ انجام شود یا خیر. در بیشتر پلتفرم‌ها پیش‌فرض "1" است. در Cygwin به دلیل مشکلات کتابخانه‌های قدیمی regex با حساسیت به حروف، پیش‌فرض "0" است.

regex=1

کنترل می‌کند که آیا پشتیبانی از عبارات باقاعده (regular expressions) فعال باشد یا خیر. مقدار پیش‌فرض "1" است.

xterm.title=1

عنوان پنجره xterm را هنگام اجرای گزارش‌ها تنظیم می‌کند. پیش‌فرض "0" است.

expressions=infix|postfix

اولویت را برای عبارات میانوندی (infix مانند 1 + 2) یا پسوندی (postfix مانند 1 2 +) تعیین می‌کند. پیش‌فرض infix است.

json.array=1

تعیین می‌کند که آیا دستور export خروجی JSON را در '[...]' قرار دهد و پس از هر شیء وظیفه صادرشده یک ',' اضافه کند تا یک آرایه JSON با ساختار صحیح ایجاد شود یا خیر. با json.array=0، دستور export اشیاء خام JSON را به خروجی استاندارد (STDOUT)، هر شیء در یک خط، می‌نویسد. پیش‌فرض "1" است.

_forcecolor=1

هنگامی که خروجی مستقیماً به یک TTY ارسال نمی‌شود، Taskwarrior به طور خودکار رنگ را خاموش می‌کند. به عنوان مثال، این دستور:

پیش‌فرض "0" است.

active.indicator=*

کاراکتر یا رشته‌ای که باید در ستون start.active نمایش داده شود. پیش‌فرض * است.

tag.indicator=+

کاراکتر یا رشته‌ای که باید در ستون tag.indicator نمایش داده شود. پیش‌فرض + است.

dependency.indicator=D

کاراکتر یا رشته‌ای که باید در ستون depends.indicator نمایش داده شود. پیش‌فرض D است.

uda.<name>.indicator=U

کاراکتر یا رشته‌ای که باید در ستون <uda>.indicator نمایش داده شود. پیش‌فرض U است.

recurrence=1

کنترل می‌کند که آیا تکرار فعال باشد و آیا وظایف تکرارشونده به ایجاد نمونه‌های جدید وظیفه ادامه دهند یا خیر. پیش‌فرض "1" است.

اگر چندین کلاینت را همگام‌سازی می‌کنید، توصیه می‌شود که 'recurrence=1' را روی کلاینت اصلی خود و 'recurrence=0' را روی تمام کلاینت‌های دیگر تنظیم کنید. این یک راهکار موقت برای رفع باگ تکثیر وظایف است.

recurrence.confirmation=prompt

کنترل می‌کند که آیا تغییرات در وظایف تکرارشونده با یا بدون تأیید به سایر وظایف فرزند منتقل شود یا خیر. مقدار 'yes' به معنای انتشار تغییرات بدون درخواست تأیید است. مقدار 'no' به معنای عدم انتشار تغییرات و عدم درخواست تأیید است. مقدار 'prompt' هر بار از شما سؤال می‌کند. پیش‌فرض 'prompt' است.

recurrence.indicator=R

کاراکتر یا رشته‌ای که باید در ستون recurrence_indicator نمایش داده شود. پیش‌فرض R است.

recurrence.limit=1

تعداد وظایف تکرارشونده آینده برای نمایش را مشخص می‌کند. پیش‌فرض ۱ است. به عنوان مثال، اگر یک وظیفه با تکرار هفتگی با موعد سررسید فردا اضافه شود و recurrence.limit روی ۲ تنظیم شده باشد، گزارش دو وظیفه معلق تکرارشونده را فهرست می‌کند: یکی برای فردا و دیگری برای یک هفته بعد از فردا.

abbreviation.minimum=2

حداقل طول هر دستور/مقدار مخفف‌شده است. این بدان معناست که "ve"، "ver"، "vers"، "versi" و "versio" همگی معادل "version" خواهند بود، اما "v" چنین نخواهد بود. پیش‌فرض ۲ است.

debug=0

نرم‌افزار Taskwarrior دارای یک حالت اشکال‌زدایی (debug) است که باعث نمایش خروجی‌های تشخیصی می‌شود. معمولاً این چیزی نیست که کسی بخواهد، اما هنگام گزارش باگ، خروجی دیباگ می‌تواند مفید باشد. همچنین می‌تواند به درک نحوه تجزیه خط فرمان کمک کند، اما این اطلاعات به شیوه‌ای مناسب توسعه‌دهندگان نمایش داده می‌شود، نه کاربران عادی.

روشن کردن دیباگ به طور خودکار گزینه‌های debug.hooks=1 و debug.parser=1 را در صورتی که مقداری به آن‌ها تخصیص نیافته باشد فعال می‌کند. پیش‌فرض "0" است.

debug.hooks=0

سطح تشخیصی سیستم قلاب‌ها را کنترل می‌کند. سطح ۰ به معنای عدم نمایش خروجی تشخیصی است. سطح ۱ فراخوانی‌های قلاب را نشان می‌دهد. سطح ۲ همچنین وضعیت خروج و ورودی/خروجی (I/O) را نشان می‌دهد.

debug.parser=0

سطح تشخیصی تجزیه‌کننده (parser) را کنترل می‌کند. سطح ۰ هیچ خروجی تشخیصی نشان نمی‌دهد. سطح ۱ درخت تجزیه نهایی را نشان می‌دهد. سطح ۲ درخت تجزیه را در تمام مراحل تجزیه نشان می‌دهد. سطح ۳ جزئیات ارزیابی عبارت را نشان می‌دهد.

obfuscate=0

هنگامی که روی '1' تنظیم شود، تمام متن گزارش را با 'xxx' جایگزین می‌کند. این قابلیت برای به اشتراک‌گذاری خروجی گزارش‌ها در گزارش باگ‌ها بدون افشای اطلاعات حساس مفید است. مقدار پیش‌فرض '0' است.

alias.rm=delete

ابزار Taskwarrior از نام‌های مستعار دستورات (aliases) پشتیبانی می‌کند. این نام مستعار یک نام جایگزین (rm) برای دستور delete فراهم می‌کند. می‌توانید از نام‌های مستعار برای تعریف نام‌های جایگزین برای هر یک از دستورات استفاده کنید. چندین دستوری که ممکن است استفاده کنید در واقع نام مستعار هستند؛ به عنوان مثال گزارش 'history' یا دستور 'export'.

burndown.cumulative=1

می‌تواند "1" یا "0" باشد و رفتار دستور burndown را کنترل می‌کند. هنگامی که روی ۱ تنظیم شود، تمام وظایف تکمیل‌شده را جمع می‌زند، در غیر این صورت فقط در بازه‌ای که وظیفه تکمیل شده است رسم می‌شوند. پیش‌فرض ۱ است.

تاریخ‌ها (DATES)

dateformat=Y-M-D

dateformat.report=

dateformat.holiday=YMD

dateformat.edit=Y-M-D H:N:S

dateformat.info=Y-M-D H:N:S

dateformat.annotation=

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. این رشته می‌تواند شامل کاراکترهای زیر باشد:

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 برای جمعه

d/m/Y  برای ورودی و خروجی از 24/7/2009 استفاده می‌کند
yMD    برای ورودی و خروجی از 090724 استفاده می‌کند
M-D-Y  برای ورودی و خروجی از 07-24-2009 استفاده می‌کند

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" را تولید می‌کند

8/1/2013  همراه با m/d/Y   به معنی 1 اوت 2013 در نیمه‌شب است (استنباط‌شده)
8/1 20:40 همراه با m/d H:N به معنی 1 اوت 2013 (استنباط‌شده) در ساعت 20:40 است

date.iso=1

پشتیبانی از تاریخ‌های ISO-8601 را فعال می‌کند. مقدار پیش‌فرض "1" است.

تقویم (CALENDAR)

weekstart=Sunday

روز آغاز هفته را تعیین می‌کند. مقادیر معتبر فقط Sunday یا Monday هستند. مقدار پیش‌فرض "Sunday" است.

displayweeknumber=1

تعیین می‌کند که آیا شماره‌های هفته هنگام استفاده از دستور "task calendar" نمایش داده شوند یا خیر. شماره هفته به روز شروع هفته وابسته است. مقدار پیش‌فرض "1" است.

due=7

تعداد روزهای آینده است که مشخص می‌کند چه زمانی یک وظیفه سررسیدشده تلقی می‌شود و بر همین اساس رنگ‌آمیزی می‌گردد. مقدار پیش‌فرض ۷ است.

calendar.details=sparse

اگر روی "full" تنظیم شود، اجرای "task calendar" جزئیات وظایفی را که موعد سررسید آن‌ها در دوره تقویم قرار دارد نمایش می‌دهد. روزهای متناظر در تقویم با کد رنگی مشخص می‌شوند. اگر روی "sparse" تنظیم شود، فقط روزهای متناظر کد رنگی دریافت می‌کنند و هیچ جزئیاتی نمایش داده نمی‌شود. نمایش تاریخ‌های سررسید همراه با جزئیات را می‌توان با تنظیم این متغیر روی "none" خاموش کرد. مقدار پیش‌فرض "sparse" است.

calendar.details.report=list

گزارشی است که هنگام نمایش جزئیات وظایف دارای تاریخ سررسید در زمان اجرای دستور "task calendar" اجرا می‌شود. مقدار پیش‌فرض "list" است.

calendar.offset=0

اگر "1" باشد، اولین ماه در گزارش تقویم به میزان مقدار افست مشخص‌شده در calendar.offset.value تغییر می‌کند. پیش‌فرض "0" است.

calendar.offset.value=-1

مقدار افست برای اعمال روی اولین ماه در گزارش تقویم است. مقدار پیش‌فرض "-1" است.

calendar.holidays=none

اگر روی full تنظیم شود، اجرای "task calendar" تعطیلات را با کدگذاری رنگی روزهای متناظر در تقویم نمایش می‌دهد. همچنین یک فهرست دقیق با تاریخ‌ها و نام‌های تعطیلات نشان داده می‌شود. اگر روی sparse تنظیم شود، فقط روزها کد رنگی دریافت می‌کنند و هیچ جزئیاتی از تعطیلات نمایش داده نمی‌شود. نمایش تعطیلات با تنظیم این متغیر روی none خاموش می‌شود. مقدار پیش‌فرض "none" است.

calendar.legend=1

تعیین می‌کند که آیا راهنمای علائم تقویم (legend) نمایش داده شود یا خیر. مقدار پیش‌فرض "1" است.

calendar.monthsperline=N

تعیین می‌کند دستور "task calendar" چند ماه را در عرض صفحه رندر کند. به طور پیش‌فرض به تعداد ماه‌هایی است که در صفحه جا می‌شوند. اگر تعداد ماه‌های بیشتری نسبت به گنجایش صفحه مشخص شود، Taskwarrior فقط به میزانی که جا می‌شود نمایش خواهد داد.

مدخل‌های وقایع روزانه (JOURNAL ENTRIES)

journal.time=0

می‌تواند "1" یا "0" باشد و تعیین می‌کند که آیا دستورات 'start' و 'stop' در هنگام اجرا باید یک یادداشت ثبت کنند یا خیر. مقدار پیش‌فرض "0" است. متن یادداشت‌های متناظر توسط متغیرهای زیر کنترل می‌شود:

journal.time.start.annotation=Started task

متن یادداشتی است که هنگام اجرای دستور start و با فعال بودن journal.time ثبت می‌شود.

journal.time.stop.annotation=Stopped task

متن یادداشتی است که هنگام اجرای دستور stop و با فعال بودن journal.time ثبت می‌شود.

journal.info=1

هنگامی که فعال باشد، این تنظیم باعث می‌شود گزارش تغییرات (change log) هر وظیفه توسط دستور 'info' نمایش داده شود. مقدار پیش‌فرض "1" است.

تعطیلات (HOLIDAYS)

تعطیلات یا مستقیماً در فایل .taskrc وارد می‌شوند یا از طریق یک فایل include که در .taskrc مشخص شده است فراخوانی می‌گردند. برای تعطیلات یک‌روزه، ذکر نام و تاریخ الزامی است:

holiday.towel.name=Day of the towel
holiday.towel.date=20100525

برای تعطیلاتی که شامل یک بازه چندروزه هستند (مانند تعطیلات مرخصی)، می‌توانید از یک تاریخ شروع و یک تاریخ پایان استفاده کنید:

holiday.sysadmin.name=System Administrator Appreciation Week
holiday.sysadmin.start=20100730
holiday.sysadmin.end=20100805

holiday.eastersunday.name=Easter
holiday.eastersunday.date=easter

توجه داشته باشید که توزیع Taskwarrior شامل فایل‌های نمونه تعطیلات است که می‌توانند مانند نمونه زیر گنجانده شوند:

include holidays.en-US.rc

وابستگی‌ها (DEPENDENCIES)

dependency.reminder=1

تعیین می‌کند که آیا نقض زنجیره وابستگی باعث ایجاد پیام‌های یادآوری شود یا خیر.

dependency.confirmation=1

تعیین می‌کند که آیا ترمیم زنجیره وابستگی نیازمند تأیید کاربر باشد یا خیر.

کنترل‌های رنگ (COLOR CONTROLS)

color=1

می‌تواند "1" یا "0" باشد. تعیین می‌کند که آیا Taskwarrior از رنگ استفاده کند یا خیر. هنگامی که روی "0" باشد، از خط تیره (-----) برای خط کشیدن زیر عناوین ستون‌ها استفاده می‌کند.

fontunderline=1

تعیین می‌کند که آیا حتی با وجود فعال بودن رنگ، باید از زیرخط فونت یا خط تیره‌های اسکی برای زیر عناوین استفاده شود یا خیر.

ابزار Taskwarrior دارای تعدادی قوانین رنگ‌آمیزی است. این قوانین با یک ویژگی خاص از وظیفه، مانند زمان سررسید یا فعال بودن آن مطابقت دارند و رنگ‌آمیزی خودکار آن وظیفه را مشخص می‌کنند. فهرستی از رنگ‌های معتبر (بسته به نوع ترمینال شما) را می‌توان با اجرای دستور زیر به دست آورد:

color.tagged=

برخی ویژگی‌ها مانند برچسب‌ها، پروژه‌ها و کلمات کلیدی می‌توانند قوانین رنگ‌آمیزی مخصوص به خود را داشته باشند.

color.tag.X=yellow

هر وظیفه‌ای را که دارای برچسب X باشد رنگ‌آمیزی می‌کند.

color.project.X=on green

هر وظیفه‌ای را که به پروژه X اختصاص داده شده باشد رنگ‌آمیزی می‌کند.

color.keyword.X=on blue

هر وظیفه‌ای را که توضیحات یا هر یک از یادداشت‌های آن حاوی X باشد رنگ‌آمیزی می‌کند.

color.uda.X=on green

هر وظیفه‌ای را که دارای ویژگی تعریف‌شده توسط کاربر X باشد رنگ‌آمیزی می‌کند.

color.uda.X.VALUE=on green

هر وظیفه‌ای را که ویژگی تعریف‌شده توسط کاربر X آن برابر با VALUE باشد رنگ‌آمیزی می‌کند.

color.uda.X.none=on green

هر وظیفه‌ای را که فاقد ویژگی تعریف‌شده توسط کاربر X باشد رنگ‌آمیزی می‌کند.

color.error=white on red

تمام پیام‌های خطا را رنگ‌آمیزی می‌کند.

color.warning=bold red

تمام پیام‌های هشدار را رنگ‌آمیزی می‌کند.

color.header=green

پیام‌هایی را که قبل از خروجی گزارش چاپ می‌شوند رنگ‌آمیزی می‌کند.

color.footnote=green

پیام‌هایی را که در انتهای خروجی گزارش چاپ می‌شوند رنگ‌آمیزی می‌کند.

color.summary.bar=on green

نوار پیشرفت گزارش خلاصه را رنگ‌آمیزی می‌کند. باید شامل یک رنگ پس‌زمینه باشد.

color.summary.background=on black

نوار پیشرفت گزارش خلاصه را رنگ‌آمیزی می‌کند. باید شامل یک رنگ پس‌زمینه باشد.

color.calendar.today=black on cyan

رنگ امروز در تقویم است.

color.calendar.due=black on green

رنگ روزهای دارای وظایف موعد سررسید در تقویم است.

color.calendar.due.today=black on magenta

رنگ امروز همراه با وظایف موعد سررسید در تقویم است.

color.calendar.overdue=black on red

رنگ روزهای دارای وظایف معوق در تقویم است.

color.calendar.scheduled=black on orange

رنگ روزهای دارای وظایف زمان‌بندی‌شده در تقویم است.

color.calendar.weekend=bright white on black

رنگ روزهای آخر هفته در تقویم است.

color.calendar.holiday=black on bright yellow

رنگ روزهای تعطیل در تقویم است.

color.calendar.weeknumber=black on white

رنگ شماره‌های هفته در تقویم است.

color.label=

برچسب‌های گزارش را رنگ‌آمیزی می‌کند. پیش‌فرض عدم استفاده از رنگ است.

color.label.sort=

برچسب‌های گزارش را برای ستون‌های مرتب‌سازی رنگ‌آمیزی می‌کند. پیش‌فرض color.label است.

color.alternate=on rgb253

رنگ وظایف متناوب (یک‌درمیان) است. این گزینه برای اعمال یک رنگ خاص به وظایف یک‌درمیان در یک گزارش استفاده می‌شود که تفکیک بصری وظایف را آسان‌تر می‌کند. این ویژگی به ویژه زمانی مفید است که وظایف به دلیل توضیحات یا یادداشت‌های طولانی در چندین خط نمایش داده می‌شوند.

color.history.add=on red

color.burndown.pending=on red

color.undo.before=red

color.sync.added=green

rule.precedence.color=due.today,active,blocking,blocked,overdue,due,

scheduled,keyword.,project.,tag.,uda.,recurring, tagged,completed,deleted

color.debug=green

فوریت (URGENCY)

محاسبه فوریت از یک چندجمله‌ای با چندین جمله استفاده می‌کند که هر کدام دارای یک ضریب قابل‌پیکربندی هستند. این ضریب‌ها عبارتند از:

urgency.blocking.coefficient=8.0

این ضرایب اهمیت نسبی جملات مختلف را در محاسبه فوریت منعکس می‌کنند. این مقادیر پیش‌فرض هستند و می‌توان آن‌ها را متناسب با ترجیحات خود تغییر داد، اما مهم است که هرگونه تغییر را با دقت بررسی کنید.

urgency.inherit=0

پیش‌فرض‌ها (DEFAULTS)

default.project=foo

در صورتی که پروژه‌ای را مشخص نکنید، یک نام پروژه پیش‌فرض برای دستور task add ارائه می‌دهد. پیش‌فرض خالی است.

default.due=...

در صورتی که تاریخی را مشخص نکنید، یک تاریخ سررسید پیش‌فرض برای دستور task add ارائه می‌دهد. می‌توانید از یک تاریخ یا مقدار مدت زمان (که نسبت به زمان حال یا 'now' فرض می‌شود) استفاده کنید. پیش‌فرض خالی است.

default.scheduled=...

در صورتی که تاریخی را مشخص نکنید، یک تاریخ زمان‌بندی پیش‌فرض برای دستور task add ارائه می‌دهد. می‌توانید از یک تاریخ یا مقدار مدت زمان (که نسبت به زمان حال یا 'now' فرض می‌شود) استفاده کنید. پیش‌فرض خالی است.

uda.<name>.default=...

در صورت مشخص نکردن مقادیر، مقادیر پیش‌فرضی را برای فیلدهای UDA در هنگام استفاده از دستور task add ارائه می‌دهد. پیش‌فرض خالی است.

default.command=next

دستور پیش‌فرضی را تعیین می‌کند که هر بار Taskwarrior بدون هیچ آرگومانی فراخوانی شود اجرا می‌گردد. به عنوان مثال، اگر به صورت زیر تنظیم شود:

default.command=project:foo list

$ task
[task project:foo list]
ID Project Pri Description
 1 foo     H   Design foo
 2 foo         Build foo

گزارش‌ها (REPORTS)

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

task overdue

report.X.description

توضیحات مربوط به گزارش X هنگام اجرای دستور "task help".

report.X.columns

فهرستی از ستون‌ها و مشخص‌کننده‌های قالب‌بندی است که با کاما از هم جدا شده‌اند. برای مشاهده فهرست کامل گزینه‌ها و مثال‌ها به دستور 'task columns' مراجعه کنید.

report.X.context

یک مقدار بولی که مشخص می‌کند آیا گزارش داده‌شده باید زمینه (context) فعال فعلی را رعایت (اعمال) کند یا خیر. برای جزئیات درباره زمینه به بخش CONTEXT مراجعه کنید. پیش‌فرض 1 است.

report.X.labels

برچسب‌های هر ستون که هنگام تولید گزارش X استفاده می‌شوند. برچسب‌ها فهرستی جداشده با کاما هستند.

report.X.sort

ترتیب مرتب‌سازی وظایف در گزارش تولیدشده X است. ترتیب مرتب‌سازی با استفاده از شناسه‌های ستون مشخص می‌شود که با یک "+" برای ترتیب صعودی یا یک "-" برای ترتیب نزولی پسوندگذاری می‌شوند. شناسه‌های مرتب‌سازی با کاما از هم جدا می‌شوند. به عنوان مثال:

report.list.sort=due+,priority-,start.active-,project+

علاوه بر این، پس از "+" یا "-"، می‌تواند یک خط مایل "/" وجود داشته باشد که نشان‌دهنده شکست خط (فاصله) پس از تغییر مقادیر ستون است. به عنوان مثال:

report.minimal.sort=project+/,description+

این ترتیب مرتب‌سازی مشخص می‌کند که بین هر پروژه یک شکست در فهرست وجود دارد. شکست در فهرست صرفاً یک خط خالی است که یک گروه‌بندی بصری ایجاد می‌کند.

مقدار ویژه مرتب‌سازی "none" نشان می‌دهد که هیچ مرتب‌سازی لازم نیست و وظایف به همان ترتیبی (در صورت وجود) که انتخاب شده‌اند ارائه می‌شوند.

مقدار ویژه مرتب‌سازی "random" نشان می‌دهد که وظایف به صورت تصادفی مرتب خواهند شد. هر بار که گزارشی با 'sort:random' اجرا شود، یک ترتیب تصادفی جدید تولید خواهد شد.

report.X.filter

یک فیلتر به گزارش X اضافه می‌کند تا فقط وظایف مطابق با معیارهای فیلتر در گزارش تولیدشده نمایش داده شوند.

یک مورد خاص برای 'report.timesheet.filter' وجود دارد که می‌تواند مشخص شود حتی اگر گزارش 'timesheet' چندان قابل سفارشی‌سازی نباشد.

report.X.dateformat

یک قالب تاریخ به گزارش X اضافه می‌کند که توسط ستون "تاریخ سررسید" (due date) استفاده خواهد شد. اگر تنظیم نشده باشد، dateformat.report و dateformat به همین ترتیب استفاده خواهند شد. برای جزئیات در مورد نگه‌دارنده‌های مکان به بخش تاریخ‌ها (DATES) مراجعه کنید.

report.X.annotations

امکان کنترل خروجی یادداشت‌ها را برای یک وظیفه در یک گزارش فراهم می‌کند. منسوخ شده است. به جای آن از ستون description با یک قالب مشخص (به عنوان مثال description.count) استفاده کنید.

ابزار Taskwarrior با تعدادی گزارش ازپیش‌تعریف‌شده ارائه می‌شود که عبارتند از:

next

مهم‌ترین وظایف را فهرست می‌کند.

long

تمام وظایف معلق و تمام داده‌های مطابق با معیارهای مشخص‌شده را فهرست می‌کند.

list

تمام وظایف مطابق با معیارهای مشخص‌شده را فهرست می‌کند.

ls

فهرست کوتاهی از تمام وظایف مطابق با معیارهای مشخص‌شده.

minimal

حداقل فهرست از تمام وظایف مطابق با معیارهای مشخص‌شده.

newest

جدیدترین وظایف را نشان می‌دهد.

oldest

قدیمی‌ترین وظایف را نشان می‌دهد.

overdue

وظایف معوق مطابق با معیارهای مشخص‌شده را فهرست می‌کند.

active

وظایف فعال مطابق با معیارهای مشخص‌شده را فهرست می‌کند.

completed

وظایف تکمیل‌شده مطابق با معیارهای مشخص‌شده را فهرست می‌کند.

recurring

وظایف تکرارشونده مطابق با معیارهای مشخص‌شده را فهرست می‌کند.

waiting

تمام وظایف در حال انتظار مطابق با معیارهای مشخص‌شده را فهرست می‌کند.

all

تمام وظایف مطابق با معیارهای مشخص‌شده را فهرست می‌کند.

blocked

تمام وظایفی را که دارای وابستگی هستند فهرست می‌کند.

ویژگی‌های تعریف‌شده توسط کاربر (USER DEFINED ATTRIBUTES)

ویژگی‌های تعریف‌شده توسط کاربر (UDAs) یک مکانیزم افزونه هستند که به شما امکان می‌دهند ویژگی‌های جدیدی را برای ذخیره و نمایش در Taskwarrior تعریف کنید. یک نمونه از این موارد، ویژگی 'estimate' است که می‌تواند برای ذخیره تخمین‌های زمانی مرتبط با یک وظیفه استفاده شود. این ویژگی 'estimate' به طور پیش‌فرض در Taskwarrior تعبیه نشده است، اما با چند تنظیم ساده در پیکربندی می‌توانید به Taskwarrior دستور دهید که این مورد را ذخیره کرده و امکان دسترسی به آن را برای گزارش‌ها و فیلترهای سفارشی فراهم کند.

این ویژگی به شما امکان می‌دهد تا Taskwarrior را متناسب با گردش کار خود گسترش دهید، یا قواعد را تغییر داده و از Taskwarrior برای ذخیره و همگام‌سازی داده‌هایی که لزوماً مرتبط با وظایف نیستند استفاده کنید.

یک محدودیت مهم این است که از آنجا که این یک سیستم باز است که امکان تعریف هر ویژگی جدیدی را می‌دهد، Taskwarrior نمی‌تواند معنای آن ویژگی را درک کند. بنابراین در حالی که Taskwarrior داده‌های UDA شما را به دقت ذخیره، ویرایش، گزارش‌گیری، مرتب‌سازی و فیلتر می‌کند، هیچ برداشتی از مفهوم آن ندارد. به عنوان مثال، اگر یک UDA به نام 'estimate' تعریف کنید، Taskwarrior متوجه نخواهد شد که این مقدار نشان‌دهنده هفته‌ها، ساعت‌ها، دقیقه‌ها، پول یا شمارش منابع دیگر است.

uda.<name>.type=string|numeric|uuid|date|duration

uda.<name>.label=<column heading>

uda.<name>.values=A,B,C

uda.<name>.default=...

مثال ویژگی UDA با نام 'estimate'

این مثال یک UDA به نام 'estimate' را نشان می‌دهد که مقادیر خاصی را برای اندازه یک وظیفه ذخیره می‌کند. به مقدار خالی پس از 'trivial' توجه کنید.

زمینه (CONTEXT)

تنظیم زمینه (Context) مکانیزمی است که به کاربر اجازه می‌دهد یک فیلتر دائمی تنظیم کند و در نتیجه از نیاز به تعیین مکرر یک فیلتر جلوگیری نماید. جزئیات بیشتر در مورد استفاده از این قابلیت را می‌توانید در صفحه راهنمای task(1) بیابید.

زمینه جاری در فایل .taskrc همراه با تعاریف تمام زمینه‌های ارائه‌شده توسط کاربر ذخیره می‌شود.

context=<name>

context.<name>.read=<filter>

context.<name>.rc.<key>=<value>

همگام‌سازی (SYNC)

این تنظیمات پیکربندی برای اتصال و همگام‌سازی وظایف با سرور task استفاده می‌شوند.