.\" 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 "TODO" "1" "Apr 22, 2026" "4.7.0" "Todoman" .SH "نام (NAME)" todo \- یک مدیر وظایف خط فرمانی، ساده و مبتنی بر استانداردها .SH TODO .sp کاربرد .INDENT 0.0 .INDENT 3.5 .sp .EX todo [OPTIONS] COMMAND [ARGS]... .EE .UNINDENT .UNINDENT .sp گزینه‌ها .INDENT 0.0 .TP .B \-v, \-\-verbosity یکی از مقادیر CRITICAL، ERROR، WARNING، INFO یا DEBUG .UNINDENT .INDENT 0.0 .TP .B \-\-colour, \-\-color به‌طور پیش‌فرض، اگر stdout یک TTY نباشد، todoman خروجی رنگی را غیرفعال می‌کند (مقدار \fIauto\fP). برای غیرفعال کردن کامل خروجی رنگی آن را روی \fInever\fP تنظیم کنید، یا برای فعال‌سازی آن در هر شرایطی روی \fIalways\fP قرار دهید. .INDENT 7.0 .TP .B گزینه‌ها always | auto | never .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-porcelain استفاده از یک ساختار JSON که صرف‌نظر از پیکربندی یا نسخه، پایدار باقی می‌ماند. .UNINDENT .INDENT 0.0 .TP .B \-h, \-\-humanize قالب‌بندی تمام تاریخ‌ها و زمان‌ها به شیوه‌ای خوانا برای انسان .UNINDENT .INDENT 0.0 .TP .B \-c, \-\-config فایل پیکربندی مورد استفاده. .UNINDENT .INDENT 0.0 .TP .B \-\-version نمایش نسخه و خروج. .UNINDENT .sp متغیرهای محیطی .INDENT 0.0 .TP .B TODOMAN_CONFIG .INDENT 7.0 .INDENT 3.5 تعیین مقدار پیش‌فرض برای \fB\-\-config\fP .UNINDENT .UNINDENT .UNINDENT .sp دستورها .INDENT 0.0 .TP .B cancel لغو یک یا چند وظیفه. .UNINDENT .INDENT 0.0 .TP .B copy رونوشت وظایف به فهرستی دیگر. .UNINDENT .INDENT 0.0 .TP .B delete حذف وظایف. .UNINDENT .INDENT 0.0 .TP .B done علامت‌گذاری یک یا چند وظیفه به عنوان انجام‌شده. .UNINDENT .INDENT 0.0 .TP .B edit ویرایش وظیفه با شناسه ID. .UNINDENT .INDENT 0.0 .TP .B flush حذف وظایف انجام‌شده. .UNINDENT .INDENT 0.0 .TP .B list فهرست کردن وظایف (پیش‌فرض). .UNINDENT .INDENT 0.0 .TP .B lists بازگرداندن تمام فهرست‌ها .UNINDENT .INDENT 0.0 .TP .B move انتقال وظایف به فهرستی دیگر. .UNINDENT .INDENT 0.0 .TP .B new ایجاد یک وظیفه جدید با SUMMARY. .UNINDENT .INDENT 0.0 .TP .B path چاپ مسیر فایل مربوط به یک وظیفه. .UNINDENT .INDENT 0.0 .TP .B repl راه‌اندازی یک پوسته تعاملی. .UNINDENT .INDENT 0.0 .TP .B show نمایش جزئیات درباره یک وظیفه. .UNINDENT.SH "توضیحات (DESCRIPTION)" .sp برنامه Todoman یک ابزار مدیریت کارهای انجام‌دادنی (یا به بیانی دیگر: وظایف) ساده، مبتنی بر استانداردها و خط فرمانی (cli) است. کارهای انجام‌دادنی در فایل‌های \fIicalendar\fP ذخیره می‌شوند، به این معنی که می‌توانید آن‌ها را از طریق \fICalDAV\fP با استفاده از ابزارهایی مانند \fIvdirsyncer\fP همگام‌سازی کنید\&. .SH "نحوه استفاده (USAGE)" .sp استفاده از Todoman مبتنی بر خط فرمان (CLI) \% است (هرچند بخش‌هایی بر پایه TUI دارد و هدف این است که یک رابط کاربری کاملاً مبتنی بر TUI \% نیز ارائه شود). .sp عمل پیش‌فرض \fBlist\fP است که تمام وظایف را برای همه تقویم‌ها نمایش می‌دهد، هر کدام همراه با یک شناسه (id) یکتای نیمه‌پایدار: .INDENT 0.0 .INDENT 3.5 .sp .EX 1 [ ] !!! 2015\-04\-30 Close bank account @work (0%) 2 [ ] ! Send minipimer back for warranty replacement @home (0%) 3 [X] 2015\-03\-29 Buy soy milk @home (100%) 4 [ ] !! Fix the iPad\(aqs screen @home (0%) 5 [ ] !! Fix the Touchpad battery @work (0%) .EE .UNINDENT .UNINDENT .sp ستون‌ها به ترتیب عبارتند از: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP \(bu 2 یک شناسه (id). .IP \(bu 2 اینکه آیا وظیفه تکمیل شده است یا خیر. .IP \(bu 2 علامت \fB!!!\fP نشان‌دهنده اولویت بالا، \fB!!\fP اولویت متوسط، و \fB!\fP نشان‌دهنده وظایف با اولویت پایین. .IP \(bu 2 تاریخ سررسید (due date). .IP \(bu 2 خلاصه وظیفه. .IP \(bu 2 فهرستی که وظیفه به آن تعلق دارد؛ هنگام فیلتر کردن بر اساس یک فهرست یا زمانی که پایگاه‌داده تنها شامل یک فهرست باشد، پنهان خواهد شد. .IP \(bu 2 درصد تکمیل‌شده. .UNINDENT .UNINDENT .UNINDENT .sp شناسه تا اجرای بعدی دستور \fBflush\fP توسط \fBtodoman\fP نگه‌داری می‌شود. .sp برای انجام عملیات روی یک مورد todo، از شناسه برای ارجاع به آن استفاده می‌شود. برای نمونه، جهت ویرایش وظیفه \fIBuy soy milk\fP از مثال بالا، دستور مناسب \fBtodo edit 3\fP است، یا \fBtodo undo 3\fP برای لغو علامت‌گذاری وظیفه به عنوان انجام‌شده. .sp ویرایش وظایف در حال حاضر تنها از طریق رابط کاربری TUI امکان‌پذیر است و هنوز نمی‌توان آن را از طریق خط فرمان انجام داد. .SH "همگام‌سازی (SYNCHRONIZATION)" .sp اگر می‌خواهید وظایف خود را همگام‌سازی کنید، به ابزاری نیاز خواهید داشت که از طریق CalDAV همگام‌سازی کند. ابزار vdirsyncer \% برای این منظور پیشنهاد می‌شود. .SH "پوسته تعاملی (INTERACTIVE SHELL)" .sp اگر click\-repl \% نصب باشد، todoman از دستور \fBrepl\fP پشتیبانی می‌کند که یک پوسته تعاملی با قابلیت تکمیل خودکار کلید Tab را اجرا می‌نماید. .SH "یکپارچه‌سازی‌ها (INTEGRATIONS)" .sp هنگام تلاش برای ادغام \fBtodoman\fP در سامانه‌های دیگر یا تجزیه خروجی آن، توصیه می‌شود از پرچم \fB\-\-porcelain\fP استفاده کنید که تمام خروجی را در قالبی از پیش تعریف‌شده چاپ می‌کند که فارغ از پیکربندی کاربر یا نسخه برنامه ثابت و پایدار خواهد ماند. .sp قالب داده JSON است، شامل یک آرایه واحد که هر todo را به عنوان یک ورودی (شیء) مجزا در بر دارد. فیلدها همیشه وجود خواهند داشت؛ اگر یک todo مقداری برای یک فیلد مشخص نداشته باشد، به صورت \fBnull\fP چاپ خواهد شد\&. .sp ممکن است در آینده فیلدهایی اضافه شوند، اما هرگز هیچ فیلدی حذف نخواهد شد. .SS Conky .sp برنامه Todoman را می‌توان با استفاده از یکی از متغیرهای اجرای پوسته \% همراه با Conky \% استفاده کرد\&. با توجه به ماهیت ابزارهای pimutils، نیازی نیست در هر بار به‌روزرسانی conky اطلاعات جدید استعلام شود، بنابراین در بیشتر مواقع \fBexeci\fP بهترین گزینه خواهد بود. .sp افزودن \fB${execi 30 todo}\fP در بخش متن (text)، خروجی دستور را نمایش داده و آن را هر ۳۰ ثانیه یک‌بار به‌روزرسانی می‌کند. .sp یک پیکربندی کاربردی را می‌توانید در اینجا بیابید: \%\&..SH "مرتب‌سازی (SORTING)" .sp مأموریت‌ها را می‌توان با آرگومان \fB\-\-sort\fP مرتب‌سازی کرد. مرتب‌سازی ممکن است بر اساس فیلدهای زیر انجام گیرد: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP \(bu 2 \fBdescription\fP .IP \(bu 2 \fBlocation\fP .IP \(bu 2 \fBstatus\fP .IP \(bu 2 \fBsummary\fP .IP \(bu 2 \fBuid\fP .IP \(bu 2 \fBrrule\fP .IP \(bu 2 \fBpercent_complete\fP .IP \(bu 2 \fBpriority\fP .IP \(bu 2 \fBsequence\fP .IP \(bu 2 \fBcategories\fP .IP \(bu 2 \fBcompleted_at\fP .IP \(bu 2 \fBcreated_at\fP .IP \(bu 2 \fBdtstamp\fP .IP \(bu 2 \fBstart\fP .IP \(bu 2 \fBdue\fP .IP \(bu 2 \fBlast_modified\fP .UNINDENT .UNINDENT .UNINDENT .sp می‌توان یک علامت \fB\-\fP را پیش از نام فیلد اضافه کرد تا مرتب‌سازی بر اساس آن فیلد به صورت صعودی انجام شود (به‌صورت پیش‌فرض مرتب‌سازی به صورت نزولی است). .sp مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX todo list \-\-sort due,\-priority .EE .UNINDENT .UNINDENT .SH "پیکربندی (CONFIGURING)" .sp پیش از نخستین استفاده، لازم است Todoman را با استفاده از فایل پیکربندی سادهٔ شبیه به ini آن پیکربندی کنید. .SH "فایل پیکربندی (CONFIGURATION FILE)" .sp فایل پیکربندی باید در مسیر \fB$XDG_CONFIG_HOME/todoman/config.py\fP\& قرار گیرد. \fB$XDG_CONFIG_HOME\fP در اکثر شرایط به‌طور پیش‌فرض برابر با \fB~/.config\fP است، بنابراین این مسیر عموماً \fB~/.config/todoman/config.py\fP\& خواهد بود. .INDENT 0.0 .TP .B cache_path محل قرارگیری فایل کَش (یک پایگاه دادهٔ sqlite). از این فایل برای ذخیرهٔ داده‌های todo و افزایش سرعت اجرا/راه‌اندازی استفاده می‌شود و همچنین شامل شناسه‌های (ID) todoها است. اگر این مقدار مشخص نشود، مسیری نسبی نسبت به \fB$XDG_CACHE_HOME\fP استفاده خواهد شد. \fB$XDG_CACHE_HOME\fP عموماً به \fB~/.cache/\fP\& اشاره دارد. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع str .TP .B پیش‌فرض \fB\(dq$XDG_CACHE_HOME/todoman/cache.sqlite3\(dq\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B color به‌طور پیش‌فرض، اگر خروجی استاندارد (stdout) یک TTY نباشد، todoman خروجی رنگی را غیرفعال می‌کند (مقدار \fBauto\fP). مقدار را روی \fBnever\fP تنظیم کنید تا خروجی رنگی به‌طور کامل غیرفعال شود، یا روی \fBalways\fP قرار دهید تا در هر حالتی فعال باشد. این مقدار را می‌توان با گزینهٔ \fB\-\-color\fP بازنویسی کرد. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع str .TP .B پیش‌فرض \fB\(dqauto\(dq\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B date_format قالب تاریخ که هم برای نمایش تاریخ‌ها و هم برای تجزیهٔ تاریخ‌های ورودی به کار می‌رود. اگر این گزینه مشخص نشود، از قالب لوکال (locale) سیستم استفاده خواهد شد. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع str .TP .B پیش‌فرض \fB\(dq%x\(dq\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B default_command دستوری که هنگام اجرای \fBtodo\fP بدون هیچ زیردستوری اجرا می‌شود. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع str .TP .B پیش‌فرض \fB\(dqlist\(dq\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B default_due اختلاف زمانی پیش‌فرض (به ساعت) میان تاریخ سررسید todo جدید و تاریخ ایجاد آن. اگر مشخص نشود، مقدار آن 24 است. اگر روی 0 تنظیم شود، تاریخ سررسید برای todoهای جدید تعیین نخواهد شد. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع int .TP .B پیش‌فرض \fB24\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B default_list لیست پیش‌فرض برای افزودن todo. اگر این گزینه را مشخص نکنید، باید هربار که یک todo اضافه می‌کنید از گزینهٔ \fB\-\-list\fP / \fB\-l\fP استفاده نمایید. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع str .TP .B پیش‌فرض \fBNone\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B default_priority اولویت پیش‌فرض مأموریت هنگام ایجاد. بالاترین اولویت 1، پایین‌ترین اولویت 10 است، و 0 به معنای نداشتن هیچ‌گونه اولویتی است. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0.TP .B نوع int .TP .B پیش‌فرض \fBNone\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B dt_separator رشته‌ای که برای جداسازی تاریخ و زمان هنگام نمایش و تجزیه استفاده می‌شود. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع str .TP .B پیش‌فرض \fB\(dq \(dq\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B humanize اگر روی true تنظیم شود، تاریخ و زمان‌ها در قالب‌های انسان‌فهم مانند \(dqtomorrow\(dq، \(dqin one hour\(dq، \(dq3 weeks ago\(dq و غیره چاپ خواهند شد. .sp اگر false باشد، تاریخ و زمان‌ها با استفاده از \fBdate_format\fP و \fBtime_format\fP قالب‌بندی خواهند شد. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع bool .TP .B پیش‌فرض \fBFalse\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B path یک الگوی glob که با دایرکتوری‌های محل قرارگیری وظایف (todos) شما تطبیق می‌یابد. این الگو بسط داده خواهد شد و با هر دایرکتوری منطبق (شامل هرگونه فایل icalendar) به‌عنوان یک فهرست رفتار می‌شود. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع str .TP .B پیش‌فرض \fB\(dq~/calendars/\(dq\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B startable اگر روی true تنظیم شود، فقط وظایفی نمایش داده می‌شوند که در حال حاضر قابل شروع باشند؛ این‌ها وظایفی هستند که تاریخ شروع آن‌ها امروز یا روزی در گذشته است. وظایف بدون تاریخ شروع همیشه جاری در نظر گرفته می‌شوند. وظایف ناتمام (برای مثال: partially\-complete) نیز لحاظ می‌شوند. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع bool .TP .B پیش‌فرض \fBFalse\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B time_format قالب تاریخی که هم برای نمایش زمان‌ها و هم برای تجزیه زمان‌های ورودی استفاده می‌شود. .INDENT 7.0 .INDENT 3.5 .INDENT 0.0 .TP .B نوع str .TP .B پیش‌فرض \fB\(dq%X\(dq\fP .UNINDENT .UNINDENT .UNINDENT .UNINDENT.SH "نمونه پیکربندی (SAMPLE CONFIGURATION)" .sp مثال زیر می‌تواند به عنوان مرجع استفاده شود. این نمونه فایل‌های ics را از هر دایرکتوری درون \fB~/.local/share/calendars/\fP می‌خواند، از قالب تاریخ ISO\-8601 استفاده می‌کند، و موعد سررسید کارهای جدید را روی ۴۸ ساعت بعد تنظیم می‌نماید. .INDENT 0.0 .INDENT 3.5 .sp .EX # A glob expression which matches all directories relevant. path = \(dq~/my_calendars/*\(dq date_format = \(dq%Y\-%m\-%d\(dq time_format = \(dq%H:%M\(dq default_list = \(dqPersonal\(dq default_due = 48 .EE .UNINDENT .UNINDENT .SH "رنگ و نام نمایشی (COLOR AND DISPLAYNAME)" .INDENT 0.0 .IP \(bu 2 می‌توانید با ایجاد یک فایل \fBcolor\fP حاوی کد رنگ در قالب هگزادسیمال (\fB#RRGGBB\fP)، برای هر فهرست کارها یک رنگ تنظیم کنید\&. .IP \(bu 2 فایلی با نام \fBdisplayname\fP مشخص می‌کند که فهرست کارها چگونه باید نام‌گذاری شود و زمانی که چندین دایرکتوری با نام مشترک وجود دارند (به عنوان مثال هنگام استفاده از چندین $CloudInstances)، لازم است. پیش‌فرض، نام دایرکتوری است. .UNINDENT .sp همچنین مستندات مرتبط با قالب vdir را ببینید: \%\&. .SH "منطقه زمانی (TIMEZONE)" .sp برنامه Todoman از منطقه زمانی پیکربندی‌شده در سطح سیستم استفاده خواهد کرد. اگر این تنظیم برای شما مناسب نیست، _می‌توانید_ با تعیین متغیر محیطی \fBTZ\fP، منطقه زمانی را بازنویسی کنید. .sp برای دریافت دستورالعمل‌های تغییر منطقه زمانی سیستم خود، به مستندات توزیع‌تان مراجعه کنید. .SH "هشدارها (CAVEATS)" .sp پشتیبانی از مشخصه \fBpercent\-completed\fP ناقص است. برنامه Todoman فقط می‌تواند کارها را به عنوان انجام‌شده (۱۰۰٪) علامت‌گذاری کند، و مقادیر مربوط به \fBpercent > 0 ^ percent < 100\fP را نه منعکس می‌کند و نه اجازه ویرایش آن‌ها را می‌دهد\&. .SH "مشارکت (CONTRIBUTING)" .sp برای اطلاعات در مورد نحوه مشارکت، ببینید: \% .SH "مجوز (LICENCE)" .sp برنامه Todoman تحت پروانه ISC منتشر شده است. برای جزئیات، LICENCE را ببینید. .SH "نویسندگان (AUTHORS)" Hugo Osvaldo Barrera ، و دیگران .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2015-2023, Hugo Osvaldo Barrera .\" End of generated man page.