devtodo - آنلاین در ابر

برنامه:

نام

todo - یک برنامه یادآوری/وظیفه با هدف توسعه دهندگان

خلاصه

TODO []
بدون هیچ گزینه ای، موارد موجود در فهرست فعلی را نمایش می دهد.

tda [-پ ] [-g ] []
یک مورد جدید اضافه کنید، به صورت اختیاری آن را به عنوان فرزند مورد داده شده پیوند بزنید.

tde
مورد داده شده را ویرایش کنید

tdr
موارد داده شده را حذف کنید.

tdd
موارد مشخص شده را به عنوان انجام شده علامت گذاری کنید.

TODO --ارتباط دادن [-g ]
پایگاه داده devtodo مشخص شده را به پایگاه فعلی پیوند دهید و به صورت اختیاری آن را پیوند دهید
فرزند شاخص مشخص شده

شرح

TODO برنامه ای است که به طور خاص برنامه نویسان را هدف قرار می دهد (اما قابل استفاده توسط هر کسی در
ترمینال) برای کمک به توسعه روز به روز.

فهرستی از مواردی را که هنوز تکمیل نشده اند حفظ می کند. این به برنامه نویس اجازه می دهد
اشکالات برجسته یا مواردی را که باید با تلاش بسیار کمی تکمیل شوند، ردیابی کنید.

موارد را می توان اولویت بندی کرد و همچنین می تواند در یک سلسله مراتب نمایش داده شود، به طوری که یک مورد ممکن است
به دیگری بستگی دارد

با استفاده از چند اسکریپت پوسته کوچک (اسکریپت.* در دایرکتوری doc منبع
توزیع)، todo همچنین می تواند آیتم های برجسته را در یک دایرکتوری با تغییر نمایش دهد
به آن بنابراین، برای مثال، اگر شما در فهرست منبع برای خود todo سی دی قرار دهید، باید
لیستی از موارد برجسته را ببینید... مگر اینکه همه اشکالات برطرف شده باشند.

OPTIONS

گزینه ها می توانند هم فرم بلند و هم کوتاه داشته باشند.

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

-v، -- پرحرف
به صورت پرمخاطب نمایش دهید

-آ، --اضافه کردن []
یک یادداشت اضافه کنید (اگر یک یادداشت ارائه نشد، از شما خواسته می شود).

-g، -- پیوند
در رابطه با --اضافه کردن or --ارتباط دادن، مورد جدید را به آیتم مشخص شده پیوند بزنید.

-ل، --ارتباط دادن
فایل todo مشخص شده را به بدنه این یکی پیوند دهید. اگر پایگاه داده پیوند داده شده است
مجموعه عنوان، این به عنوان بدنه آیتم پیوند دهنده استفاده می شود در غیر این صورت
نام دایرکتوری پایگاه داده پیوند داده شده استفاده خواهد شد. برای حذف از --remove (یا tdr) استفاده کنید
پایگاه های داده پیوندی - این کار را انجام می دهد نه خود پایگاه داده را حذف کنید، فقط پیوند را.

-R،--reparent [، ]
والد فهرست مورد اول را به نمایه مورد دوم تغییر دهید. اگر دومی نیست
شاخص داده می شود که آیتم به ریشه درخت بازپرداخت می شود.

-پ، --اولویت
در ارتباط با --add یا --edit، اولویت را تنظیم کنید (پیش فرض | خیلی زیاد | زیاد |
متوسط ​​| کم | خیلی کم)

-ه ، -- ویرایش
یادداشتی که با عدد داده شده نمایه شده است را ویرایش کنید.

--برداشتن
یادداشت نمایه شده با اعداد داده شده، از جمله فرزندان، را بردارید.

-د، --انجام شده
یادداشت های مشخص شده (و فرزندان آنها) را به عنوان انجام شده علامت گذاری کنید.

-دی، --انجام نشده
یادداشت های مشخص شده (و همه کودکان) را به عنوان انجام نشده علامت بزنید.

- پایگاه داده جهانی
دیتابیس مورد استفاده را مشخص کنید اگر یکی از آنها باشد -G or -- جهانی گزینه ها مشخص شده است.

-G، -- جهانی
مجبور به استفاده از پایگاه داده مشخص شده با - پایگاه داده جهانی. اگر این قرار داده شود
در خود ~/.todorc آن را مجبور به استفاده از آن پایگاه داده به استثنای همه خواهد کرد
دیگران.

-- پایگاه داده
پایگاه داده را از هر آنچه پیش فرض است (معمولا '.todo') به فایل تغییر دهید
مشخص شده.

-T، --انجام دادن
یک فایل متنی معمولی خروجی TODO از یک Todo DB ایجاد کنید.

-آ، --همه
میانبر فیلتر «+انجام شد،+فرزندان» برای نمایش همه یادداشت‌ها.

-f، -- فیلتر
فقط یادداشت هایی را نمایش دهید که از فیلتر عبور می کنند. لطفا به بخش مراجعه کنید فیلتر برای
اطلاعات بیشتر.

--رنگ
رنگ‌های پیش‌فرض موارد انجام کار را لغو کنید. لطفا به بخش مراجعه کنید رنگی برای اطلاعات بیشتر
اطلاعات.

- رنگ اجباری
استفاده اجباری از رنگ حتی زمانی که به TTY خروجی نمی دهید. این در هنگام لوله کشی مفید است
به کمتر(1) -R

--مونونوکلئوز تمام دنباله‌های فرار ANSI را از خروجی حذف کنید - برای رنگ‌های آسیب دیده مفید است
پایانه ها

--کمک این راهنما را نمایش دهید.

- نسخه
نمایش نسخه ToDo.

--عنوان []
عنوان یادداشت های todo این فهرست را تنظیم کنید.

--فرمت تاریخ
نمایش مقادیر زمان را فرمت کنید. قالب آن است که توسط زمان صرف وقت(3)
فرمت پیش فرض '%c' است. این گزینه بهتر است در ~/.todorc.

--قالب =
قالب بندی خروجی را مشخص کنید. لطفاً برای اطلاعات بیشتر به بخش FORMATTING مراجعه کنید
اطلاعات.

--use-format =
از رشته فرمت مشخص شده توسط استفاده کنید (تعریف شده با فرمت --) به عنوان
رشته فرمت برای استفاده هنگام قالب بندی با فرمت داخلی .

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

-- پارانوئید
در مورد برخی تنظیمات، از جمله مجوزها، پارانویا باشید.

---پایگاه-بارگذارها <لودر لیست>
فرمت های پایگاه داده را به ترتیب داده شده امتحان کنید. فرمت های معتبر هستند XML و دوتایی. به عنوان مثال.
todo --base-loaders باینری,xml. فرمت پیش فرض XML است.

--پشتیبان گیری []
پشتیبان گیری از پایگاه داده تا بارها، درست قبل از اینکه به آن نوشته شود. اگر نیست
مشخص شده است، یک نسخه پشتیبان تهیه خواهد شد. نام فایل های مورد استفاده برای ذخیره نسخه های پشتیبان عبارتند از
نام پایگاه داده پیش‌فرض به همراه ویرایش آنها به این صورت ضمیمه شده است: .todo.1، .todo.2، و غیره.
برای استفاده از یکی از این پشتیبان‌ها، می‌توانید آن را به .todo ارسال کنید یا از آن استفاده کنید
-- پایگاه داده .todo. استفاده از آن را به صراحت مشخص کنید.

-s ، --خلاصه
حالت "خلاصه" را تغییر دهید، که در آن موارد طولانی به یک خط کوتاه می شوند.

-c، --اظهار نظر
به ترتیب نظرات را ویرایش یا نمایش دهید.

--تایم اوت []
If مشخص شده است، فاصله زمانی بین نمایشگرهای پایگاه داده روی این عدد تنظیم شده است
از ثانیه اگر نه مشخص شده است، رفتار نمایش پایگاه داده است
فقط اگر برای تعداد ثانیه های مشخص شده توسط --timeout نمایش داده نشده باشد
با la داده شده. به عنوان مثال. TODO --تایم اوت 10 --تایم اوت فقط نمایش داده می شود
پایگاه داده حداکثر هر 10 ثانیه یک بار. قرار دادن a فاصله 10 در خود ~/.todorc هست یک
گزینه خوب، سپس --تایم اوت در doc/scripts.* به این معنی است که پایگاه داده
هر بار که در یک فهرست سی دی قرار می گیرید، نمایش داده نمی شود.

-- پاکسازی []
تمام موارد تکمیل شده قدیمی‌تر را پاک کنید . اگر حذف شده است، همه
سوابق تکمیل شده پاک می شوند.

اولویت های

اولویت ها را می توان به صورت نمادین با استفاده از کلمات مشخص کرد به طور پیش فرض, بسیار بالا, بلند, متوسط,
پایین و خیلی کم.

La به طور پیش فرض اولویت معنای خاصی دارد زیرا از اولویت پیش فرض برای هر مورد استفاده می کند
عمل. این بدان معنی است که هنگام ویرایش یک مورد موجود، اولویت آن حفظ می شود. چه زمانی
با ایجاد یک آیتم جدید، اولویت تنظیم خواهد شد متوسط; هنگام پیوند یک مورد جدید، آن است
اولویت با والدین آن خواهد بود. اگر چنین باشد، DevTodo اولویت را درخواست نخواهد کرد
مشخص شده است، و آن را به یک ویژگی مفید برای todorc شما تبدیل می کند. مانند همه گزینه ها، اولویت
را می توان در خط فرمان لغو کرد.

فیلتر

فیلترها شامل لیستی از عبارات مورد استفاده برای تعریف یادداشت هایی هستند که هستند
نمایش داده.

فرمت کلی یک عبارت فیلتر به صورت زیر است:

([-|=|+](همه|کودکان|انجام شد| | )) | (/ بیان>)

به طور کلی، اگر یک عبارت فیلتر با پیشوند «-» باشد، این کار انجام می‌شود نه نمایش مواردی که
عبارت را مطابقت دهید، اگر پیشوند «+» باشد مواردی را نمایش می دهد که با آن مطابقت دارند
عبارت علاوه بر موارد دیگر، یا اگر با یک پیشوند '=' (یا اصلاً بدون پیشوند) باشد،
نمایش فقط مواردی که با عبارت مطابقت دارند. توجه داشته باشید که این فقط موارد را جستجو می کند
توسط فیلترهای دیگر حذف نمی شود، بنابراین برای جستجوی کل پایگاه داده باید این کار را انجام دهید
چیزی مثل: TODO -- فیلتر all,/some-search-string.

شکل دوم بیان فیلتر برای جستجوی متن در پایگاه داده استفاده می شود. <جستجو
بیان> یک عبارت منظم است که با بدنه متن هر مورد مطابقت دارد.

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

عبارات به تفصیل:

تمام همه موارد را مجبور می کند نمایش داده شوند. پیشوندهای مختلف هیچ تاثیری در این مورد ندارند
اصطلاح.

فرزندان
کوچک کردن یا بزرگ کردن موارد کودک. اگر پیشوند '-' موجود باشد، کودکان هستند
سقوط کرد، در غیر این صورت کودکان نمایش داده می شوند.

انجام شده تکمیل یا عدم تکمیل یک مورد را فیلتر کنید.


شاخص های یادداشت به صورت اعداد مشخص می شوند. محدوده‌ها را می‌توان به نام «1.2.10-20» داد.


اولویت ها همانطور که در توضیح داده شده است اولویت های بخش. پیشوند "-"
همه موارد را با اولویت کمتر یا مساوی با اولویت داده شده نمایش می دهد.
با پیشوند «+»، همه موارد با اولویت بیشتر یا مساوی با داده شده
اولویت نشان داده شده است. اگر '=' یا هیچ پیشوندی داده نشده باشد، فقط مواردی با پیشوند مشخص شده است
اولویت نمایش داده می شود.

مثال:

انجام - فیلتر انجام شد، -کودکان، + کم

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

todo /[Tt]he

فقط مواردی را نمایش دهید که کلمه "the" در آنها وجود دارد، جایی که حرف اول می تواند کمتر باشد
یا حروف بزرگ ممکن است لازم باشد عبارت جستجو را نقل قول کنید تا مطمئن شوید که پوسته این کار را می کند
آنها را تفسیر نکنید

قالب بندی

خروجی todo را می توان با تعریف کردن خود تغییر داد تا مطابق میل شما باشد
رشته های قالب بندی این رشته ها مشابه رشته هایی هستند که در آنها استفاده می شود printf(3) و زمان صرف وقت(3).

نمونه های زیر که می توان در آن قرار داد ~/.todorc، پیش فرض را تقلید می کند
رفتار - اخلاق:

# نمایش در قالب پیش فرض
نمایش فرمت=%i%[info]%f%2n.%[اولویت]%T

# نمایش در قالب پیش فرض
قالب تولید شده=%2i-%T%2i (%d اضافه شد، اولویت %p)\n\n

چهار گزینه فرمت جداگانه وجود دارد: نمایش, تولید, پرمخاطب و پرحرف -
تولید. دو مورد آخر برای قالب بندی متن مربوطه خود زمانی که --verbose است استفاده می شود
به عنوان یک استدلال برای انجام مشخص شده است.

علاوه بر این، کاربران می‌توانند رشته‌های قالب خود را به سادگی با ارسال قالب متفاوت ایجاد کنند
شناسه به قالب. سپس با استفاده از آن می توان آن را فعال کرد --use-format. به عنوان مثال.

قالب گزارش کامل=%i%[info]%f%2n.%[اولویت]%+1T%+1i%[info]افزوده شده: %[normal]%c
%[info]تکمیل شد: %[normal]%d\n%+1i%[info]مدت زمان: %[normal]%D %[info]اولویت:
%[normal]%p\n\n
# برای استفاده از "گزارش کامل" قالب نمایش را لغو کنید.
استفاده از فرمت نمایش = گزارش کامل

پرچم های مختلف موجود عبارتند از:

% > La > flag تعداد فاصله ها را تعیین می کند برای استفاده برای تمام تورفتگی های آینده.

%[+|-][ ]من
تورفتگی به عمق مورد فعلی. عمق تورفتگی را مشخص می کند. اگر is
حذف شده، از سطح فعلی استفاده می شود. می توان از مقادیر نسبی استفاده کرد. به عنوان مثال. '%+1T' خواهد بود
تورفتگی به یک سطح بالاتر از سطح تورفتگی فعلی.

%[+|-][ ] تی
متن مورد را که با 80 کاراکتر پیچیده شده و به آن فرورفته است نمایش دهید
سطح مشخص شده معناشناسی از هستند مانند با %i. به متن پیچیده توجه کنید
به طور خودکار یک '0 در انتهای متن اضافه می کند، در حالی که %t نخواهد.

%t متن بسته بندی نشده، بدون قالب مورد.

%s متن خلاصه (یعنی فقط یک خط، معادل --خلاصه).

%p سطح اولویت مورد فعلی.

%c تاریخ ایجاد اقلام فعلی، با فرمت --date قالب بندی شده است.

%d تاریخی که مورد به‌عنوان انجام شده علامت‌گذاری شد، با فرمت --date قالب‌بندی شده است.

%D مدت زمان مورد، با توجه به --date-format قالب بندی شده است.

%[ ]n
شماره شاخص مورد فعلی. مقدار عددی اختیاری را مشخص می کند
تعداد کاراکترهایی که عدد باید اشغال کند. عدد با فاصله پر شده است
تا این تعداد کاراکتر پر شود.

%f پرچم ایالت مورد فعلی. مقادیر نمایش داده شده برای این پرچم '+' هستند
به معنی کودکان، '-' به معنای انجام شده، '*' به معنای انجام شده با کودکان است.

%F پرچم حالت قابل خواندن توسط انسان مورد فعلی. مقادیر نمایش داده شده برای این
پرچم عبارتند از «کودکان»، «انجام شد» به معنای انجام شده، «انجام شد، کودکان» و «باز».

%[ ]
رنگ ها را می توان با این پرچم مشخص کرد. مقادیر معتبر برای هستند:
خیلی کم, پایین, متوسط, بلند, بسیار بالا, عنوان, اطلاعاتو اولویت. اینها منصفانه هستند
خود توضیحی، به جز اولویت به رنگ اولویت اقلام فعلی تغییر می کند. به عنوان مثال.
٪[اولویت]

لطفاً توجه داشته باشید که هنگام تورفتگی، این کار را انجام خواهید داد به طور معمول می خواهید از مقدار پیشوند "+1" استفاده کنید
با %T. یعنی %+1T. این امر متن را مجبور می‌کند تا یک سطح عمیق‌تر از سطح فعلی تورفتگی کند
سطح، باعث می شود آن را از هر قالب دیگری که ممکن است استفاده کرده اید دور نگه دارد.

مرتب سازی

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

todo -- مرتب سازی -انجام شد، متن

این اولاً بر اساس تکمیل شدن یک مورد و ثانیاً بر اساس متن آنها مرتب می شود. این
به طور موثر موارد را به دو بلوک گروه بندی می کند - آنهایی که کامل هستند و آنهایی که نیستند.

کلیدهایی که در دسترس هستند عبارتند از ایجاد شده, تکمیل شده, متن, اولویت, مدت, هیچ و
انجام شده. هر کلید، به جز هیچ می توان با یک پیشوند - برای معکوس کردن ترتیب پیش فرض آن و
چند کلید باید با یک، از هم جدا شوند.

اگر چند پارامتر -- sort مواجه شد، آخرین مورد استفاده می شود. این بدان معناست که الف
ورودی "مرتب سازی". ~/.todorc توسط هر کدام در خط فرمان لغو خواهد شد.

شاخص ها

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

به عنوان مثال با توجه به نکات زیر:

1. صفحات man را انجام دهید
1. آنها را زیباتر کنید.
2. مستندات HTML را نیز بسازید.

دومین مورد به صورت زیر نمایش داده می شود: 1.2

علامت عام '*' می تواند برای نشان دادن همه فرزندان یک گره استفاده شود. به عنوان مثال. 1.*

محدوده یادداشت ها را می توان با استفاده از ' - ' مشخص کرد. به عنوان مثال، برای علامت گذاری یادداشت های 10.1.2،
10.1.3 و 10.3.4 همانطور که انجام شد، می توانید انجام دهید: todo --done 10.1.2-4

رنگی

اقلام مختلف را می توان رنگی کرد. مواردی که می توانند باشند بسیار بالا, بلند, متوسط, پایین, خیلی کم,
عنوان و اطلاعات. اطلاعات برای نمایش شماره اقلام و اطلاعات عمومی استفاده می شود.

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

رنگ ها به این صورت مشخص می شوند:

=[+]

اگر اختیاری است + در این عبارت استفاده می شود که باعث پررنگ شدن آیتم می شود.

به عنوان مثال، یک خط در شما ~/.todorc ممکن است به نظر برسد:

رنگ متوسط=+سفید

که باعث می شود متوسط متن جسور سفید.

TODORC

todo می تواند گزینه ها را از تعدادی فایل منبع بارگیری کند. ترتیبی که اینها تجزیه می شوند
به شرح زیر است:

1. فایلی که در متغیر محیطی مشخص شده است TODORC یا اگر وجود نداشته باشد،
/etc/todorc.
2. ~/.todorc

گزینه‌ها به این صورت تجمعی هستند که آنهایی که از $TODORC بارگیری می‌شوند لغو یا اضافه می‌شوند
کسانی که در ~/.todorc.

این گزینه ها به عنوان جفت کلید/مقدار، یکی در هر خط مشخص می شوند. کلید نام طولانی a است
آرگومان خط فرمان و مقدار در صورت وجود، پارامتر آن آرگومان است. علاوه بر این،
متغیرهای محیطی گسترش یافته است.

به عنوان مثال، آرگومان خط فرمان --filter پارامتری را می پذیرد که فیلتر است
اصطلاح. یک فیلتر پیش فرض می تواند به آن اضافه شود ~/.todorc فایل مانند این:

# موارد کودک به طور پیش فرض نمایش داده نشود
فیلتر -کودکان

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

علاوه بر این، دو دستور در فایل RC موجود است که در فایل موجود نیست
خط فرمان. آن ها هستند:

دستور اول، on، برای اضافه کردن دستورات خاص به صورت مشروط استفاده می شود. قالب این
دستور این است: on [ ]. رویدادهای معتبر هستند اضافه کردن, برداشتن, حبه, ویرایش کنید,
تولید می کنند, انجام شده, انجام نشده, عنوان, والدین, بار, صرفه جویی, پیوند, ایجاد و پالایش. چندگانه
دستورات را می توان به on با محصور کردن آنها در مهاربندها (فاصله فاصله بین آنها لازم است
توکن ها). مثال کامل در زیر

دستور دوم این است exec <پوسته فرمان>. این دستور آرگومان موجود را اجرا می کند
در یک پوسته داده شده است. متغیر محیطی $TODODB شامل نام فایل فعلی است
پایگاه داده به عنوان مثال. exec chmod 600 $TODODB

یک نمونه فایل rc در زیر شاخه doc توزیع منبع وجود دارد.

مثال ها

برای نمایش موارد برجسته در فهرست فعلی، به سادگی تایپ کنید:

TODO

برای حذف یادداشت های 1، 2 و 4:

todo -- حذف 1,2,4،XNUMX،XNUMX

برای نمایش همه موارد:

انجام همه

برای نمایش فقط موارد سطح بالا و نه فرزندان آنها:

todo -کودکان

(بااینکه -فرزندان استدلال معتبری نیست، این کار می کند زیرا todo هر یک را تفسیر می کند
آرگومان های خط فرمان را به عنوان بخشی از یک عبارت فیلتر تشخیص نمی دهد)

یک مثال پیچیده تر این یک آیتم جدید اضافه می کند، با متن مورد مشخص شده در
خط فرمان، با اولویت بلند به عنوان فرزند سومین فرزند مورد دوم (اگر
که منطقی است):

todo -a "Fix the man page" -p high -g 2.3

این مثالی از نحوه استفاده از ویژگی TODO TODO است. باعث می شود todo یک جدید تولید کند
فایل TODO از اطلاعات ذخیره شده در پایگاه داده. این مثال خاص همه را خروجی می دهد
موارد موجود در فایل TODO، حتی مواردی که به عنوان انجام شده علامت گذاری شده اند.

todo -- فیلتر همه --TODO

این مثال استفاده خوب از محرک های رویداد را نشان می دهد. هنگامی که یک پایگاه داده جدید ایجاد می شود
مجوزهای خود را به 0600 مجبور می کند.

در ایجاد {
واژگان
exec chmod 600 .todo
}

از devtodo آنلاین با استفاده از خدمات onworks.net استفاده کنید