todo - Online sa Cloud

PROGRAMA:

NAME

todo - isang programa ng paalala/gawain na naglalayon sa mga developer

SINOPSIS

todo []
Nang walang mga pagpipilian, ipinapakita ang mga item sa kasalukuyang direktoryo.

tda [-p ] [-g ] []
Magdagdag ng bagong item, opsyonal na i-grafting ito bilang anak ng ibinigay na item.

tde
I-edit ang ibinigay na item.

tdr
Alisin ang mga ibinigay na item.

tdd
Markahan ang mga tinukoy na item bilang tapos na.

todo --link [-g ]
I-link ang tinukoy na database ng devtodo sa kasalukuyang isa, opsyonal na i-grafting ito bilang
isang anak ng tinukoy na index.

DESCRIPTION

todo ay isang programa na partikular na naglalayong sa mga programmer (ngunit magagamit ng sinuman sa
terminal) upang tumulong sa pang-araw-araw na pag-unlad.

Ito ay nagpapanatili ng isang listahan ng mga bagay na hindi pa nakumpleto. Ito ay nagpapahintulot sa programmer na
subaybayan ang mga natitirang bug o mga item na kailangang kumpletuhin sa napakakaunting pagsisikap.

Maaaring unahin ang mga item at maaari ding ipakita sa isang hierarchy, upang ang isang item ay maaaring
depende sa iba.

Gamit ang ilang maliliit na shell script (mga script.* sa doc directory ng source
distribution), maaari ding ipakita ng todo ang mga natitirang item sa isang direktoryo habang nagbabago ka
sa loob nito. Kaya, halimbawa, kung nag-cd ka sa source na direktoryo para sa todo mismo dapat mo
tingnan ang isang listahan ng mga natitirang item...maliban kung naayos na ang lahat ng mga bug ;).

Opsyon

Maaaring magkaroon ng parehong mahaba at maikling anyo ang mga opsyon.

Ang mga maiikling opsyon ay maaaring pagsamahin sa isang argumento sa pamamagitan ng paggamit ng gitling na sinusundan ng isang string ng
maikling mga pagpipilian. Ang mga parameter ng maikling opsyon ay maaari ding idugtong sa string na ito.

-sa, --verbose
Ipakita nang pasalita

-a, --idagdag []
Magdagdag ng tala (mag-prompt para sa isang tala kung ang isa ay hindi ibinigay).

-g, --graft
Kasabay ng --idagdag or --link, i-graft ang bagong item sa tinukoy na item.

-l, --link
I-link ang tinukoy na todo file sa katawan ng isang ito. Kung ang naka-link na database ay may
isang set ng pamagat, gagamitin ito bilang katawan ng nagli-link na item kung hindi man ay ang
pangalan ng direktoryo ng naka-link na database ang gagamitin. Gamitin ang --remove (o tdr) para alisin
mga naka-link na database - ginagawa nito hindi tanggalin ang database mismo, tanging ang link.

-R,--magulang [, ]
Baguhin ang parent ng unang item index sa pangalawang item index. Kung walang pangalawa
index ay ibinigay ang item ay reparented sa ugat ng puno.

-p, --priyoridad
Kasabay ng --add o --edit, itakda ang priyoridad (default | napakataas | mataas |
daluyan | mababa | Napakababa)

-e, --edit
I-edit ang tala na na-index ng ibinigay na numero.

--alisin
Alisin ang tala na na-index ng mga ibinigay na numero, kabilang ang sinumang mga bata.

-d, --tapos na
Markahan ang tinukoy na mga tala (at ang kanilang mga anak) bilang tapos na.

-D, --hindi tapos
Markahan ang tinukoy na mga tala (at lahat ng mga bata) bilang hindi tapos na.

--global-database
Tukuyin ang database na gagamitin kung alinman ang -G or --pandaigdigan ang mga pagpipilian ay tinukoy.

-G, --pandaigdigan
Pilitin ang todo na gamitin ang database na tinukoy sa --global-database. Kung ito ay nakalagay
sa iyong ~/.todorc pipilitin nitong gamitin ang database na iyon sa pagbubukod ng lahat
iba pa.

--database
Baguhin ang database mula sa kung ano man ang default (karaniwang '.todo') sa file
tinukoy.

-T, --GAGAWIN
Bumuo ng tipikal na TODO output text file mula sa isang Todo DB.

-A, --lahat
Shortcut para sa filter na '+tapos na,+mga bata' upang ipakita ang lahat ng mga tala.

-f, --filter
Ipakita lamang ang mga tala na pumasa sa filter. Mangyaring sumangguni sa seksyon Mga filter para
karagdagang informasiyon.

--kulay
I-override ang mga default na kulay ng mga todo item. Mangyaring sumangguni sa seksyon KULAY para sa karagdagang
impormasyon.

--force-color
Pilitin ang paggamit ng kulay kahit na hindi nag-output sa isang TTY. Ito ay kapaki-pakinabang kapag piping
sa kulang(1) -R.

--mono Alisin ang lahat ng ANSI escape sequence mula sa output - kapaki-pakinabang para sa may kapansanan sa kulay
mga terminal.

- Tumulong Ipakita ang tulong na ito.

--bersyon
Ipakita ang bersyon ng ToDo.

--pamagat []
Itakda ang pamagat ng todo notes ng direktoryo na ito.

--format-date
I-format ang pagpapakita ng mga halaga ng oras. Ang format ay ang ginamit ng strftime(3). Ang
ang default na format ay '%c'. Ang pagpipiliang ito ay pinakamahusay na tinukoy sa ~/.todorc.

--format =
Tukuyin ang pag-format ng output. Mangyaring sumangguni sa seksyong FORMATTING para sa higit pa
impormasyon.

--use-format =
Gamitin ang format na string na kinilala ni (tinukoy sa --format) bilang ang
format string na gagamitin kapag nagfo-format gamit ang builtin na format .

--uri-uriin
Pagbukud-bukurin ang database gamit ang tinukoy na expression. Sumangguni sa seksyon PAG-UURI para
mas detalyadong impormasyon.

--paranoid
Maging paranoid tungkol sa ilang setting, kabilang ang mga pahintulot.

--mga database-loader <loader listahan>
Subukan ang mga format ng database sa ibinigay na pagkakasunud-sunod. Ang mga wastong format ay xml at doble. hal.
todo --database-loaders binary,xml. Ang default na format ay XML.

--backup []
I-backup ang database hanggang sa beses, bago ito isulat sa. Kung Hindi
tinukoy, isang backup ang gagawin. Ang mga filename na ginamit upang mag-imbak ng mga backup ay ang
default na pangalan ng database kasama ang kanilang rebisyon na nakadugtong tulad nito: .todo.1, .todo.2, atbp.
Upang aktwal na gamitin ang isa sa mga backup na ito, maaari mo itong i-mv sa .todo o gamitin
--database .todo. upang tahasang tukuyin ang paggamit nito.

-oo, --buod
I-toggle ang "summary" mode, kung saan pinuputol ang mahahabang item sa isang linya.

-c, --komento
I-edit o ipakita ang mga komento ayon sa pagkakabanggit.

--timeout []
If ay tinukoy, ang timeout sa pagitan ng mga pagpapakita ng database ay nakatakda sa numerong ito
ng mga segundo. Kung hindi ay tinukoy, ang pag-uugali ay upang ipakita ang database
lamang kung hindi ito naipakita para sa bilang ng mga segundo na tinukoy ng --timeout
sa ang binigay. hal. todo --timeout 10 --timeout ipapakita lamang ang
database nang hindi hihigit sa isang beses bawat 10 segundo. Paglalagay ng a oras 10 sa iyong ~/.todorc ay isang
magandang opsyon, pagkatapos ay ang --timeout sa doc/scripts.* ay nangangahulugan na ang database
ay hindi ipapakita sa tuwing mag-cd ka sa isang direktoryo.

--purga []
I-purge ang lahat ng nakumpletong item na mas luma sa . Kung ay tinanggal, lahat
ang mga nakumpletong rekord ay nalilinis.

MGA PRAYORIDAD

Ang mga priyoridad ay maaaring tukuyin sa simbolikong paraan gamit ang mga salita default, napakataas, mataas, medium,
mababa at Napakababa.

Ang default Ang priyoridad ay may espesyal na kahulugan dahil gagamitin nito ang default na priyoridad para sa anuman
aksyon. Nangangahulugan ito na kapag nag-e-edit ng isang umiiral na item, ang priyoridad nito ay pinapanatili; kailan
paglikha ng bagong item, ang priyoridad ay itatakda sa medium; kapag nag-grafting ng bagong item, nito
magiging priyoridad ang magulang nito. Hindi magpo-prompt ang DevTodo para sa priyoridad kung ito ay
tinukoy, ginagawa itong isang madaling gamiting tampok para sa iyong todorc. Tulad ng lahat ng mga pagpipilian, ang priority
maaaring ma-override sa command line.

Mga filter

Ang mga filter ay binubuo ng isang listahan ng mga expression na ginagamit upang tukuyin ang mga tala na
ipinakita

Ang pangkalahatang format ng isang filter na expression ay:

([-|=|+](lahat|mga bata|tapos na| | )) | (/ expression>)

Sa pangkalahatan, kung ang isang filter na expression ay may prefix na '-' gagawin ito hindi ipakita ang mga item na
tumugma sa expression, kung may prefix na '+' ipapakita nito ang mga item na tumutugma dito
expression bilang karagdagan sa iba, o kung may prefix na '=' (o walang prefix sa lahat) ito ay
magpakita lamang mga item na tumutugma sa expression. Tandaan na maghahanap lang ito ng mga item
hindi ibinukod ng iba pang mga filter, kaya upang maghanap sa buong database ay kailangan mong gawin
isang bagay tulad ng: todo --filter lahat,/some-search-string.

Ang pangalawang anyo ng filter na expression ay ginagamit para sa paghahanap ng teksto sa isang database. <hanapin
expression> ay isang regular na expression na itinutugma laban sa katawan ng teksto ng bawat item.

Ang mga filter na atom ay sinasala sa pagkakasunud-sunod ayon sa tapos na estado, priyoridad, pagkatapos ay maghanap. Kaya unang mga item
na hindi tumutugma sa "tapos na" na filter ay hindi isasama, pagkatapos ay ang mga hindi tumutugma sa
priority filter, at iba pa.

Detalyadong mga expression:

lahat Pinipilit na ipakita ang lahat ng item. Ang iba't ibang prefix ay walang epekto dito
pagpapahayag.

mga bata
I-collapse o palawakin ang mga child item. Kung ang '-' prefix ay naroroon ang mga bata ay
gumuho, kung hindi ay ipapakita ang mga bata.

tapos I-filter kung nakumpleto o hindi ang isang item.


Ang mga indeks ng tala ay tinukoy bilang mga numero. Maaaring ibigay ang mga hanay ng ala '1.2.10-20'.


Ang mga priyoridad ay tinukoy tulad ng inilarawan sa MGA PRAYORIDAD seksyon. Isang prefix ng '-'
ay ipapakita ang lahat ng mga item na may mga priyoridad na mas mababa sa o katumbas ng ibinigay na priyoridad.
Gamit ang prefix na '+', lahat ng item na may mga priyoridad na mas malaki kaysa o katumbas ng ibinigay
ipinakita ang priyoridad. Kung '=' o walang prefix na ibinigay, mga item lamang na may tinukoy
priyoridad ay ipinapakita.

Halimbawa:

todo --filter tapos na,-bata,+mababa

Ipapakita lamang nito ang mga item na tapos na at may priyoridad na mababa o mas mataas. Sa
karagdagan, ang mga bata ay babagsak.

todo /[Tt]siya

Ipakita lamang ang mga item na iyon na may salitang 'ang', kung saan maaaring mas mababa ang unang titik
o upper case. Maaaring kailanganin na banggitin ang expression ng paghahanap upang matiyak na ginagawa ng shell
huwag bigyang kahulugan ang mga ito.

PAG-FORMAT

Ang output ng todo ay maaaring baguhin upang maging higit pa sa iyong gusto sa pamamagitan ng pagtukoy sa iyong sarili
pag-format ng mga string. Ang mga string na ito ay katulad ng mga ginamit sa printf(3) at strftimeNa (3).

Ang mga sumusunod na halimbawa, na maaaring ilagay sa ~/.todorc, ay gagayahin ang default
pag-uugali:

# Display sa default na format
pagpapakita ng format=%i%[info]%f%2n.%[priority]%T

# Display sa default na format
nabuong format=%2i-%T%2i (idinagdag %d, priyoridad %p)\n\n

Mayroong apat na magkahiwalay na opsyon sa format: magpakita, nabuo, verbose-display at verbose-
nabuo. Ang huling dalawa ay ginagamit upang i-format ang kani-kanilang teksto kapag ang --verbose ay
tinukoy bilang argumentong todo.

Bilang karagdagan, ang mga gumagamit ay maaaring lumikha ng kanilang sariling mga string ng format sa pamamagitan lamang ng pagpasa ng iba
identifier sa format. Maaari itong paganahin sa pamamagitan ng paggamit --use-format. hal.

format full-report=%i%[info]%f%2n.%[priority]%+1T%+1i%[info]Idinagdag: %[normal]%c
%[info]Nakumpleto: %[normal]%d\n%+1i%[info]Tagal: %[normal]%D %[info]Priyoridad:
%[normal]%p\n\n
# I-override ang display format para magamit ang "full-report".
use-format display=full-report

Ang iba't ibang mga flag na magagamit ay:

% > Ang > itinatakda ng bandila ang bilang ng mga puwang gamitin para sa lahat ng indent sa hinaharap.

%[+|-][ ]i
Indent sa lalim ng kasalukuyang item. tumutukoy sa lalim na i-indent. Kung is
tinanggal, ginagamit ang kasalukuyang antas. Maaaring gamitin ang mga kamag-anak na halaga. hal. Gusto ng '%+1T'
indent sa isang antas na mas mataas kaysa sa kasalukuyang antas ng indentation.

%[+|-][ ]T
Ipakita ang text ng item, na nakabalot sa 80 character at naka-indent sa
tinukoy na antas. Semantika ng ay tulad ng kasama %i. Tandaan ang nakabalot na text
awtomatikong nagdaragdag ng '0 sa dulo ng teksto, samantalang %t ay hindi.

%t Hindi nakabalot, hindi na-format na text ng item.

%s Buod ng teksto (ibig sabihin, isang linya lamang, katumbas ng --buod).

%p Ang antas ng priyoridad ng kasalukuyang item.

%c Ang kasalukuyang petsa ng paglikha ng mga item, na na-format ayon sa --date-format.

%d Ang petsa kung kailan minarkahan ang item bilang tapos na, na-format ayon sa --date-format.

%D Ang tagal ng item, na na-format ayon sa --date-format.

%[ ]n
Ang index number ng kasalukuyang item. Ang opsyonal na halaga ng numero tinutukoy ang
bilang ng mga character na dapat sakupin ng numero. Ang numero ay may palaman na may mga puwang
upang mapunan ang bilang ng mga character na ito.

%f Ang flag ng estado ng kasalukuyang item. Ang mga ipinapakitang halaga para sa flag na ito ay '+'
ibig sabihin ay mga bata, '-' ibig sabihin tapos na', '*' ibig sabihin tapos na kasama ang mga bata.

%F Ang nababasa ng tao na flag ng estado ng kasalukuyang item. Ang mga ipinakitang halaga para dito
Ang bandila ay 'mga bata', 'tapos na' ay nangangahulugang tapos na', 'tapos na, mga bata' at 'bukas'.

%[ ]
Maaaring tukuyin ang mga kulay gamit ang watawat na ito. Ang mga wastong halaga para sa ay:
Napakababa, mababa, medium, mataas, napakataas, pamagat, info, at karapatang mauna. Ang mga ito ay patas
nagpapaliwanag sa sarili, maliban karapatang mauna mga pagbabago sa kasalukuyang kulay ng priority ng mga item. hal.
%[priyoridad]

Pakitandaan na kapag nag-indent, gagawin mo Karaniwan gustong gumamit ng prefix na halaga ng '+1'
may %T. ibig sabihin. %+1T. Pinipilit nito ang teksto na mag-indent sa isang antas na mas malalim kaysa sa kasalukuyang
antas, na ginagawa itong malayo sa anumang iba pang pag-format na maaaring nagamit mo na.

PAG-UURI

Ang pagpapakita ng mga item sa database ay maaaring ayusin sa iba't ibang mga key. Nabigyan ng serye ng
keys todo sorts sa bawat sunud-sunod na key, magpapatuloy sa susunod na lamang kung ang nakaraang key
pantay ang paghahambing. Halimbawa:

todo --sort -done,text

Una itong mag-uuri sa pamamagitan ng kung ang isang item ay nakumpleto at pangalawa sa pamamagitan ng kanilang teksto. Ito
epektibong pinagsasama-sama ang mga item sa dalawang bloke - ang mga kumpleto at ang mga hindi.

Ang mga susi na magagamit ay nilikha, natapos, teksto, karapatang mauna, tagal, wala at
tapos. Ang bawat susi, maliban wala maaaring lagyan ng prefix ng a - upang baligtarin ang default na pagkakasunud-sunod nito at
maramihang mga susi ang dapat paghiwalayin ng isang ,.

Kung maramihang --sort na mga parameter ay nakatagpo ang huling isa ay ginagamit. Nangangahulugan ito na a
'sort' entry in ~/.todorc ay ma-override ng sinuman sa command line.

INDICES

Ginagamit ang mga indicies bilang mga opsyon sa iba't ibang argumento ng command line. Maramihang mga index ng tala
ay pinaghihiwalay ng mga kuwit (ang mga puwang ay hindi pinapayagan). Ang mga bata ay sinasaklaw gamit ang isang '.'.

Halimbawa, ibinigay ang mga sumusunod na tala:

1. Gawin ang mga pahina ng tao
1. Gawing mas maganda sila.
2. Gumawa rin ng dokumentasyong HTML.

Ang pangalawang sub-item ay kinakatawan ng ganito: 1.2

Ang wildcard na '*' ay maaaring gamitin upang kumatawan sa lahat ng mga bata ng isang node. hal. 1.*

Maaaring tukuyin ang mga hanay ng mga tala sa pamamagitan ng paggamit ng ' - '. Halimbawa, upang markahan ang mga tala 10.1.2,
10.1.3 at 10.3.4 bilang tapos na, magagawa mo: todo --done 10.1.2-4

KULAY

Maaaring kulayan ang iba't ibang mga item. Ang mga bagay na maaari ay napakataas, mataas, medium, mababa, Napakababa,
pamagat at info. info ay ginagamit para sa pagpapakita ng mga numero ng item at pangkalahatang impormasyon.

Ang mga item na ito ay maaaring itakda sa isa sa walong kulay. Yung mga kulay itim, pula, berde,
dilaw, asul, kulay-pula, cyan, puti at default. Ang kulay default ay ginagamit upang tukuyin ang
default na kulay ng terminal sa harapan.

Ang mga kulay ay tinukoy tulad nito:

=[+]

Kung ang opsyonal + sa expression na ito ay ginagamit ito ay magiging sanhi ng item na maging bold.

Halimbawa, isang linya sa iyong ~/.todorc maaaring magmukhang:

kulay daluyan=+puti

Na gagawin medium teksto matapang puti.

TODORC

Ang todo ay maaaring mag-load ng mga opsyon mula sa isang bilang ng mga resource file. Ang pagkakasunud-sunod kung saan ang mga ito ay na-parse
ay ang mga sumusunod:

1. Ang file na tinukoy sa variable ng kapaligiran TODORC o, kung wala iyon,
/etc/todorc.
2. ~/.todorc

Ang mga opsyon ay pinagsama-sama na ang mga na-load mula sa $TODORC ay ma-o-override o idaragdag sa ni
ang mga nasa ~/.todorc.

Ang mga opsyon na ito ay tinukoy bilang key/value pairs, isa sa bawat linya Ang key ay ang mahabang pangalan ng a
command line argument at ang value ay ang parameter sa argument na iyon, kung mayroon man. At saka,
pinalawak ang mga variable ng kapaligiran.

Halimbawa, ang --filter command line argument ay tumatanggap ng isang parameter na isang filter
pagpapahayag. Maaaring magdagdag ng default na filter sa ~/.todorc file tulad nito:

# Huwag magpakita ng mga child item bilang default
salain -mga bata

Ang tanging pagkakaiba sa pagitan ng mga opsyon na tinukoy sa rc file at sa mga nasa command line
ay ang mga opsyon sa rc file ay hindi prefix ng --.

Bilang karagdagan, mayroong dalawang command na available sa RC file na hindi available sa
command line. Sila ay:

Ang unang utos, on, ay ginagamit upang may kondisyong magdagdag ng mga partikular na command. Ang porma nito
ang utos ay: on [ ]. Ang mga wastong kaganapan ay idagdag, alisin, tingnan, i-edit,
lumikha, tapos, hindi tapos, pamagat, reparent, magkarga, i-save ang, link, lumikha at pampadumi. Maramihang
maaaring ipasa ang mga utos sa on sa pamamagitan ng paglalagay sa kanila ng mga braces (kinakailangan ang whitespace sa pagitan
mga token). Buong halimbawa sa ibaba.

Ang pangalawang utos ay exec <shell utos>. Ipapatupad ng utos na ito ang argumento nito
ibinigay sa isang shell. Ang variable ng kapaligiran $TODODB naglalaman ng filename ng kasalukuyang
database. hal. exec chmod 600 $TODODB

Mayroong isang halimbawang rc file sa doc subdirectory ng source distribution.

HALIMBAWA

Upang ipakita ang anumang natitirang mga item sa kasalukuyang direktoryo, i-type lang ang:

todo

Upang alisin ang mga tala 1, 2 at 4:

todo --alisin ang 1,2,4

Upang ipakita ang LAHAT ng mga item:

todo lahat

Upang ipakita lamang ang mga item sa pinakamataas na antas at hindi ang kanilang mga anak:

todo -mga bata

(kahit na -mga bata ay hindi isang wastong argumento, ito ay gumagana dahil ang todo ay nagbibigay kahulugan sa anuman
mga argumento ng command line na hindi nito kinikilala bilang bahagi ng isang filter na expression)

Isang mas kumplikadong halimbawa. Nagdaragdag ito ng bagong item, na may teksto ng item na tinukoy sa
command line, na may priyoridad ng mataas bilang anak ng ikatlong anak ng pangalawang aytem (kung
na may katuturan):

todo -a "Ayusin ang man page" -p mataas -g 2.3

Ito ay isang halimbawa kung paano gamitin ang TODO feature ng todo. Ginagawa nitong gumawa ng bago ang todo
TODO file mula sa impormasyong nakaimbak sa database. Ang partikular na halimbawang ito ay naglalabas ng lahat
mga item sa TODO file, kahit na ang mga minarkahan bilang tapos na.

todo --filter lahat --TODO

Ang halimbawang ito ay nagpapakita ng magandang paggamit ng mga trigger ng kaganapan. Kapag ang isang bagong database ay nilikha ito
pipilitin ang mga pahintulot nito sa 0600.

sa paglikha {
pandiwang
exec chmod 600 .todo
}

Gumamit ng todo online gamit ang mga serbisyo ng onworks.net