Enhavolisto

Antaŭa temo

Esperanto en LaTeX UTF-8 dosieroj

Sekva temo

Dosieradministrilo vifm

Komputila agendo etm

etm estas mallongigo de Event and Task Manager, kio tradukeblas kiel Mastrumilo de okazaĵoj kaj taskoj.

Ĝi estas Pitona programo por mastrumi taskojn, agojn kaj aliajn okazaĵojn, kaj por fari notojn.

La ĉi-suba teksto estas traduko de helpa dosiero de la unua generacio de etm. Aktuale estas programata la dua, nomata etmqt (ĉar ĝi utiligas la grafikan programaron Qt) - vidu pli ĉe http://people.duke.edu/~dgraham/etmqt (anglalingve).

GTD with etm

Celo de etm estas plifaciligi plenumi postulojn de Getting Things Done (Esperantlingve: Igi Aferojn Finitajn). Ĝi estas maniero de taskomastrumado kaj la titolo de tre populara libro de David Allen. GTD baziĝas je ĝenerala sento ke kun kompleta kaj ĝisdatigata aro de ĉiuj farendaĵoj, organizitaj kaj trarigardataj sisteme, la menso estas liberigita de laboro memori ĉion farendan, kaj tiel povas fokusiĝi je plenumo de la taskoj.

Tri observoj estas bazaj:

  1. Projektoj engaĝigas serion de paŝoj, parto de kiuj devas esti faritaj sinsekve, ekzemple oni devas unue kolekti partojn antaŭ muntado povas komenciĝi.
  2. La paŝoj de projekto estas plenumataj en kuntekstoj variantaj de paŝo al paŝo, ekzemple partojn oni akiras en kunteksto ‘vendejo’ kaj muntado en kunteksto ‘metiejo’.
  3. Dum fokusiĝo je projektoj estas bonega por planado, por plenumi taskojn, estus pli konvene fokusiĝi je kunteksto tiel, ke oni vidu agojn de ĉiuj projektoj kun kunteksto ‘vendejo’ antaŭ forveturi aŭtomobile. Por fokusiĝi je taskoj farendaj, estus utile kaŝi agojn kiuj ne estas ankoraŭ disponeblaj, ekzemple ‘munti partojn’ ne vidiĝas ĝis ‘aĉeti partojn’ estas efektivigita.

Tiel GTD postulas konvenajn manierojn por:

planado:
kolekti kaj organizi ĉiujn eroj,
agado:
vidigi ĝuste informojn kiujn oni bezonas, kiam oni ilin bezonas,
trarigardado:
kontroli statojn de ĉiuj elementoj de la projektoj.

etm ebligas kolekti kaj organizi viajn farendaĵojn uzante simplan, intuician formon utiligante simplajn tekstodosierojn. Taskoj povas esti enigataj en ‘skiza formo’ en kiu parencaj taskoj estas konsiderataj kiel plenumeblaj antaŭ iliaj subnivelaj idaj taskoj.

La farendaĵoj povas esti vidigataj kaj ordigataj laŭ dato, kunteksto, ŝlosilvorto, loko, prioritato aŭ projekto. Uzante la skizan grupigan opcion ‘-g F’ oni povas kontroli staton de ĉiuj elementoj en la projektoj, sendistinge de iliaj limdatoj. Oni povas kaŝi finitajn taskojn aŭ atendantajn taskojn aŭ eventojn. Oni povas vidigi nur elementojn kies kunteksto aŭ ŝlosilvortoj kongruas liveritan regulan esprimon. Oni povas vidigi okupitan/liberan tempon por ajna periodo. Oni povas prepari grafikan aspekton de la tempo, grupigita laŭ ajna kombino de dato, ŝlosilvorto, kaj/aŭ kunteksto. Oni povas eksporti kongruajn elementojn en vCal/ICal formato.

Koncize, etm faciligas konservi kaj organizi ĉiujn erojn kaj vidigi nur informojn bezonatajn kiam ili estas bezonataj.

Trarigardo

etm disponigas formaton utiligantan simplajn tekstajn dosierojn po konservi informojn pri okazaĵojn, taskojn kaj agojn, komandlinian reĝimon por vidigi taskojn kaj okazaĵojn en diversaj oportunaj manieroj kaj bazitan je wx(python) grafikan interfacon.

Grafika fasado

Datobreto
 
Monata
kalendaro
 
 
 
Panelo
de okupita tempo
 
 
 
 
 
Skizpanelo
 
 
 
 
Detalpanelo
 
Statuslinio

Datobreto

La aktuala dato kaj tempo videblas maldekstre. Ĝin sekvas aktuale vidigata datoperiodo kaj enigareo kiu ebligas usklecoblindan serĉon de ĉiuj elementoj kongruaj kun regula esprimo Kongruaj elementoj estas listigitaj en la skizpanelo sube.

Monata kalendaro

La koloro de ĉiu tago dependas de nombro da minutoj da planitaj eventoj por tiu tago. La tagoj de aktuale elektita semajno (la elektita tago kaj la ses sekvaj tagoj) estas emfazitaj.

En kalendaro, dekstren kaj maldekstren sagoklavoj ŝanĝas la elekton al sekva kaj antaŭa tago respektive. Supren kaj malsupren sagoklavoj ŝanĝas elekton al antaŭa kaj sekva semajno kaj PĝSup kaj PĝSub ŝanĝas elekton po unu monato.

Panelo de okupita tempo

La periodoj de planitaj okazaĵoj por la elektitaj tagoj en kalendaro estas emfazitaj. Alklakante la emfazitan areon elektas la ĝustan okazaĵon en skizpanelo kaj la duobla alklako malfermos la okazaĵon por redakto en la detalpanelo.

Skizpanelo

Tiu ĉi panelo montras datenojn laŭ la aktualaj opcioj de skizformo.

Kiam la elemento estas elektita, ĝiaj detaloj aperas sube en la detalpanelo.

Detalpanelo

Kiam oni elektas elementon en la skizpanelo, ĝiaj detaloj estas vidigataj tie ĉi.

Aldone, tiu ĉi areo estas uzata por redakti ekzistantajn elementojn, por krei novajn elementojn kaj por etatoj de okupita tempo. Vidu opcioj por agoj, okazaĵoj, notoj kaj taskoj kaj opcioj por Skizpanelo kaj Panelo de okupita tempo por detaloj.

Premu Supren-EnenStir-S por aprobi enhavon aŭ Eskapo por nuligi.

Statuslinio

Maldekstre, la statuslinio montras konstantan memorigilon ke premante F1 oni funkciigos la programan helpon. Se pli ol unu alarmo atendas en la vico por aktuala dato, tiam videblas la tempo de sekva planita alarmo.

Ĝin sekvas la listo de vidigoopcioj. La postrestanta spaco estas uzata por vidigi diversajn informojn. Se tempumilo funkcias por akcio, ekzemple, tiam la nomo de akcio kaj la jam pasinta tempo kaj ĝia stato (daŭranta aŭ paŭzita) estas vidigataj.

Tuja starto

En etm oni distingas kvar specoj de elementoj:

Agoj

Registrado de tempodaŭra ago, postulata por plenumigi taskon aŭ partopreni en okazaĵo. Agoj ne estas memorigiloj, ili estas anstataŭ registroj kiom da tempo aktuale daŭris. Agolinioj komenciĝas per ‘~’ (tildao) signo.

Okazaĵoj

Io kio okazos en difinita tago (aŭ tagoj) kaj, eble, en difinita tempo. Alarmoj estas fakultativaj por okazaĵoj kun komencotempoj.

Okazaĵolinioj komenciĝas per ‘*’ (steleto) signo.

Notoj

Konserviĝo de utila informo. Notolinioj komenciĝas per ‘!’ (krisigno).

Taskoj

Io farigenda. Ĝi povas havi limdaton. Taskolinioj komenciĝas per unu aŭ pli da ‘-‘ (minusosigno) aŭ ‘+’ (plusosigno)

Datendosieroj de etm komenciĝas per ‘projektolinio’ kiu provizas titolon de projekto kaj, eble, ankaŭ opciojn. Elementoj sekvas unu la alian okupante unu aŭ pli da linioj. Ĉiu elemento komenciĝas per ‘~’, ‘*’, ‘!’, ‘-‘’ aŭ ‘+’ kiel la unua signo de la linio, sekvata per titolo de la elemento kaj poste per kampoŝlosiloj kaj valoroj. La elemento daŭras aŭ ĝis la dosierofino aŭ ĝis estas trovita la linio komenciĝanta per ‘~’, ‘*’, ‘!’, ‘-‘’ aŭ ‘+’, ekz.:

----------komeco de la dosiero-------------------------------------
la titolo de projektodosiero
...
* mia okazaĵotitolo @d 8/23 @s 9a @n noto por mu okazaĵo kiu
daŭras en la sekva linio.
...
----------fino de la dosiero--------------------------------------

Vidu opcioj por agoj, okazaĵoj, notoj kaj taskoj por detaloj.

Notu, ke elementoopcioj aldonitaj al la projektolinio fariĝas aprioraj por ĉiu elemento de la sama dosiero. Supozu, ke la projektodosiero koncernas ‘Projekto A’ por kliento ‘John Smith’. Aldonante @k Smith, John:Projekto A al la projektolinio, agordus la klienton kaj ŝlosilvorton de la projekto por ĉiu elemento en la dosiero.

Por krei novan okazaĵon, premu e (aŭ *) kaj la detalobreto fokusiĝos preta por via enigo. Por provi kiel ĝi funkcias, kreu novan testan elementon kiel

* testa okazaĵo @s 3p @e 4p

kaj premu Supren kaj Enen samtempe por registri vian okazaĵoj. La programo demandos tiam pri la dosiero en kiun konservi la elementon. Antaŭ vi elektos la dosieron, tiru la dialogujon flanken kaj rimarku ke la enigo ŝanĝiĝis en ion similan al

* testa okazajo @d 2011-06-25 @s (3:00p) @e +1:00 @z Europe/Paris

kun komenca tempo kompletigita, la fina horo anstataŭigita per daŭro de la okazaĵo kaj ladonitaj aktuala dato kaj tempozono.

Kreado de okazaĵo (premu a~), noto (premu n:kbd:!`) aŭ tasko (premu t, -+) estas simila.

Okazaĵo aŭ sen komenca tempo aŭ sen plivastiĝo estas konsiderata tuttaga okazaĵo. Ĉiuj tuttagaj okazaĵoj estas vidigataj ĉe la supro de la taga plano.

Okazaĵo kun unu aŭ pli da komencaj tempoj sed sen plivastiĝo, estas konsiderata memorigilo, ekz.:

* testa memorigilo @d 6/25 @s (10a, 2p, 4p) @a (15, 0)

kreus memorigilon por 10:00, 14:00 kaj 16:00 horoj 25-an de junio, kun alarmoj funkciiĝantaj 15 minutojn antaŭ kaj precize en la difintaj tempoj. Memorigiloj, eĉ kun pluraj komencaj tempoj, estas vidigataj nur unufoje en la taga plano.

Okazaĵo kun unu aŭ pli da komencaj tempoj kaj kun plivastiĝo, estas kosiderata planata okazaĵo. Ĉiu komenca tempo estas vidigata en taga plano kaj la taŭgaj periodoj estas vidigataj en la panelo de okupita tempo.

Ago povas esti konsiderata okazaĵo kun plivastiĝo sed sen komenca tempo ĉe agoj gravas por uzo en temporegistrado kaj estas konsiderataj aparta speco. Kiam oni kreas agon premante a~, oni povas liveri nur la priskribon kaj premi Supren-Enen. Tiumomente ekfunkcias tempumilo, kiu povas esti paŭzita aŭ refunkciigita premante a. Memorigilo sonos periode por memorigi pri funkciado de la tempumilo. Oni povas premi A por halti la tempumilon kaj fari finajn ŝanĝojn al la agoregistro. La suma pasinta tempo estos aŭtomate aldonita.

Noto estas kreata premante aŭ n!. Oni povas uzi notojn ekz. por registri tagan protokolon aŭ taglibron. Kiel ĉe aliaj elementoj, novlinioj kaj aliaj blankaj spacoj estas konservitaj kaj povas esti uzataj por deviga formatado.

Tasko estas kreata premante aŭ t, -+. Tasko sen @d enigo estas konsiderata nefiksita tasko kaj ĉiam aperas kiel farenda je aktuala dato. Tasko kun @d estas kosiderata farenda je la difinita dato. Se nefinita, ĝi aperas en la taga plano por limdato. Se ĝi estas post la limdato, ĝi ankaŭ aperas en la taga plano por la aktuala tago, sed kun indiko de nombro da tagoj post la limdato. Etm ne nur povas admoni pri la posttempaj taskoj, sed ankaŭ atentigi pri la baldaŭaj limdatoj, ekz.:

- disponigi rubujon @d 6/1 @r w @w FR @b 1 @o s

atentigus pri bezono disponigi rubujon ĉiun vendredon kaj, pro @b 1 parto, ĝi atentigus pri tio unu tagon antaŭ la limdato (do, ĵaŭde). La @o s parto, parenteze, signifas, ke kiam la tasko fariĝas posttempa, etm ne plu admonu kaj simple informu pri la sekva limdato.

Kiam la tasko estas finita, ĝi aperos en la taga plano por la limdato kun indiko ke ĝi estas plenumita.

Taskoj en etm povas havi precedencojn, ekz.:

- kontroli grandecon de ekzistantaj aerofiltriloj
-- aĉeti anstataŭigaj aerofiltriloj
--- munti novajn aerofiltrilojn

La skiza strukturo difinas precedencojn.

Taskoj kun nefinitaj precedencoj estas konsiderataj atendataj en etm.

Eblas ankaŭ ke tasko havu plurajn, sendependajn precedencojn. Ekz.

- pruntepreni borilon de Ed
+ venigi la ilon
-- ripari pordon

Tie ĉi la + aldonas ‘pruntepreni’ kaj ‘venigi’ al precedencoj por ‘ripari’.

Danke al uzo de dateutil en etm, okazaĵoj kaj taskoj povas esti ripetataj en diversaj manieroj, ekz.:

* pagotago @d 6/1 @r m @w (MO,TU,WE,TH,FR) @m (-3,-2,-1) @S -1

ripetiĝus la lastan semajnon de ĉiu monato.

Vidu opcioj por agoj, okazaĵoj, notoj kaj taskoj por detaloj.

Klasifikiloj de elementoj

Por klasifiki elementojn, etm disponeblas aron da opciojn:

@c KUNTEKSTO
Por uzo laŭ GTD (Igi Aferojn Finitaj). Kutime la kunteksto inkluzivas ‘hejmo’, ‘laboro’, ‘telefono’, ‘komputilo’ kaj ‘aliaj’. Se vi intencas utiligi kuntekston, vi povas uzi opcion de skizpanelo -c aliaj por vidigi nur elementojn kun kunteksto ‘aliaj’.
@k ŜLOSILVORTO
Por temporegistrado. Unu el uzmanieroj estus uzi ŝlosilvortojn en formo ‘kliento:projekto’. Tiam, uzo de opcio de skizpanelo -g (k1, (y,m), k2) grupiĝus suman tempon unue laŭ k1 (kliento), kaj due laŭ jaro kaj monato kaj fine laŭ k2 (projekto).
@l LOKO
Tiu ĉi parto estas uzata eksportante al vCal formato.
@p PRIORITATO

Tiu ĉi parto estas uzata eksportante al vCal formato Notu ke entjeraj prioritatoj de etm, povas esti konvertitaj per iuj programoj. iCal, ekzeple, faras la jenajn konvertojn:

etm iCal
1-4 Grava
5 Meze grava
6-9 Negrava
@t ETIKEDOJ
Tiu ĉi parto estas uzata eksportante al vCal formato Pluraj etikedoj povas esti uzitaj, disigante ilin per komoj kaj ĉirkaŭante per parentezoj.
@U UZANTO
Por pluruzanta apliko. Tiu ĉi kampo povas esti uzata por distingi respondecon ĉe temporegistrado kaj taskokompletigo. Elementoj povas esti grupigataj kaj/aŭ laŭ iu kombino de la supraj klasifikiloj kaj krome laŭ titolo de la dosiero kaj titolo de la projekto (de la unua linio de la dosiero). Por detaloj pri tiuj ĉiu kaj aliaj opcioj vidu opcioj por skizpanelo kaj panelo de okupita tempo.

Datoj, tempoj kaj alarmoj

Svaga analizo de datoj

Supozu, ke hodiaŭ estas Mardo, 17-an de februaro 2009. Tiam en kampo postulanta daton:

enigita post svaga analizo
tue 2009-02-17
thu 2009-02-19
mon 2009-02-23
23 2009-02-23
mar 2 2009-03-02
3/2 2009-03-02
+0 2009-02-17 (hodiaŭ)
+1 2009-02-18 (morgaŭ)
+45 2009-04-03 (45 tagoj de nun)
-1 2009-02-16 (hieraŭ)
-90 2008-11-19 (antaŭ 90 tagoj)

Svaga analizo de tempo

Simile en kampoj postulantaj tempon, enigo de ‘6p’ rezultas post analizo, per ‘06:00PM’ aŭ ‘18:00’.

Pliaj eblecoj eblas kreante plivastiĝon @e ĉe okazaĵo. La plivastiĝo povas esti priskribita kiel daŭro aŭ plivastiĝo de la okazaĵo antaŭante ĝin per plusosigno aŭ, por okazaĵoj kun unu komencotempo, per la fina tempo de la okazaĵo. Ekzemple, la ĉi subaj estas samsignifaj:

@s 9a @e 10:30a

@s 9a @e +90m

@s 9a @e +90

@s 9a @e +1:30

@s 9a @e +1h 30m

Iel ajn enigita, etm registriĝos la plivastiĝon kiel @e +1:30.

Alarmoj

Alarmoj por okazaĵoj kaj memorigiloj estas aldonataj aldonante kampon @a al la okazaĵo, ekz.:

* telefona konferenco kun CR @d tue @s 2p @a (15, 5)

difinus alarmon por 15 minutoj antaŭ la okazaĵo kaj 5 minutoj antaŭ la okazaĵo. Kio okazas kiam alarmo ekfunkcias kaj en ‘~/.etm/rc’ estas difinita ‘alertcmd’. Kun normale difinita

alertcmd = ''

aperos dialogujo kun aktuala tempo kaj teksto de la informo.

Anstataŭe, ĉe Makintoŝo (OS X leopard), oni povas uzi

alertcmd = '''say -v "Alex" "%(t)s. %(m)s."'''

por voĉlegi la informon uzante voĉon de ‘Alex’ aŭ

alertcmd = '''say -v "Alex" "%(t)s. %(m)s.";
        growlnotify -t %(T)s -m "%(m)s"'''

(ĉio en unu linio) por ambaŭ voĉlegi kaj montri la informon uzante growl. Ĉe linuksaj sistemoj per ‘notify-send’ (provizita per libnotify-bin), oni povas aŭdigi avertosonon sekvatan per kvinsekunda ŝprucfenestro de alarma informo uzante

alertcmd = '''aplay /usr/share/sounds/purple/receive.wav 2>
        /dev/null; notify-send "%(T)s" "%(m)s" -t 5000'''

Kun -t 0 la ŝprucfenestro restos ĝis oni ĝin konfirmos.

Alterne, oni povas ricevi ret-mesaĝan memorigon per

alertcmd = '''echo "%(m)s" | mail -s "|etm|_ alatrmo je %(T)s"
        via@ret-poŝta.adreso"'''

se aŭ sendmail aŭ postfix funkcias en la sistemo.

Pli ĝenerale, oni povas uzi ĉiun komandon akceptantan tekstan ĉenon kiel argumento.

Jardatrevenaj anstataŭigoj

Kiam elemento estas analizata, ĉiuj titoloj enhavantaj ĉenon en formo !YYYY!, la ĉeno estas astataŭigata per N##, kie N estas la nombro de jaroj de YYYY ĝis la aktuala jaro, kaj ## estas ‘st’, ‘nd’, ‘rd’ aŭ ‘th’. Ekzemple, la 23-an de aŭgusto 2010, la okazaĵo

* !1985! datreveno  de Will @d 2010-01-01 @r y @M 8 @m 23

aperos kiel

25th datreveno de Will

Limigoj

En paneloj grupigantaj laŭ dato, etm vidigos nur elementon aŭ ekfunkciigos alarmon je la tago de ĝia komenco. Tio signifas, ke ekzemple, la okazaĵo

* okazaĵo @d 2010-12-01 @s 23:00 @e +2h

videbolos nur 1-an de decembro eĉ se ĝi daŭras ĝis 1:00 je 2-a de decembro. Simile

* okazaĵo @d 2010-12-01 @s 1:00 @a (90, 30)

ekfunkciigos alarmon je 0:30 la 1-an de decembro kaj ne ekfunkciigos alarmon je 23:30 30-an de novembro.

Tempozonoj

Datoj kaj tempoj en etm aŭ havas tempozonon kunigitan kun ili aŭ estas konsiderataj ‘krudaj’ tempoj. La traktado de tempo varias depende ĉu la elemento enhavas @z ZONO enigo kaj, se jes, de la valoro de ZONO. Ekzistas du eblecoj por linioj en la etm datendosieroj:

  1. La elemento

    1. ne enhavas @z ZONO enigon aŭ
    2. la elemento havas @z ZONO enigon sed la valoro de ZONE estas ‘none’.

    Tempoj de la elemento estas konsiderataj krudaj kaj vidigataj senŝanĝe.

    Ekzemple la okazaĵoj:

    * okazaĵo @d 2010-11-28 @s 17:00
    
    * okazaĵo @d 2010-11-28 @s 17:00 @z none

    estus ambaŭ konsideritaj komencantaj je 17:00 la 28-an de novembro, ne gravas kiu estas la tempozono de la sistemo de la uzanto. Kelkaj kalendaraj programoj konsiderus ilin kiel nefiksitaj okazaĵoj.

  2. La elemento havas @ ZONO enigon kaj valoro de ZONO ne estas ‘none’.

    Dato de elemento estas konsiderata apartenanta al la ZONO tempo kaj estas

    vidigata kiel loka tempo laŭ la tempozono de la uzanto. Ekzemple la okazaĵo:

    * okazaĵo @d 2010-12-01 @s 12:00 @z Pacific/Auckland

    estus konsiderita kiel komencanta je la 12:00 la 1-an de decembro laŭ la Pacific/Auckland tempozono kaj, se la tempozono de la uzanto estus US/Eastern, ĝi estus vidigata kiel komencanta je la 18:00 30-an de novembro.

Se oni kreas novan elementon en etm, provizita tempozono, se valida, restas neŝanĝita. Tio validas ankaŭ por @z none. Kio okazas kiam oni kreas elementon sen @z enigo dependas de valoro de la ‘auto_set_timezone’ variablo en la rc dosiero. Se True (la apriora), tiam @z ZONO estos aŭtomate aldonata al ĉiu nova elemento kun ZONO priskribanta vian lokan tempozonon. Se False, tiam la enigo estos konservita tia, kia ĝi estas kaj ĝiaj datoj kaj tempoj estos konsiderataj krudaj.

Dum enigo de informo pri la tempozono en etm, funkcias aŭtomata kompletigo. Supozu, ke oni enigis

* okazajo @d 12/1 @s 12 @z US

kaj premis Stir-Spaco kiam kursoro troviĝas post ‘US’. Tiam etm ŝprucus liston de eblaj kompletigoj laŭ ‘timezones’ variablo en la rc dosiero. Laŭ la ‘timezones’ provizita kun etm, la listo enhavus ‘US/Alaska’, ‘US/Central’, ‘US/Eastern’ kaj la aliajn komenciĝantajn per ‘US’.

Tempozono informo, alia ol ‘none’, aŭtomate akordiĝas al vintra/somera tempo. Konsideru, ekzemple, la du sekvaj du okazaĵoj:

* okazaĵo @d 2010-08-01 @s 17:00 @z US/Eastern

* okazaĵo @d 2010-12-01 @s 17:00 @z US/Eastern

Kvankam ambaŭ komenciĝas je la 17:00, sed la unua estas laŭ somera tempo kaj la dua - laŭ la vintra. Tio signifas ke kiam oni ŝanĝas daton de tasko kun tempozono, oni ne devas zorgi pri korektado koncerne la vintra/somera tempoŝanĝo.

La variabloj due_hour (0-23) kaj due_minute (0-59) en la rc dosiero, pravalorizas la implictiajn valorojn por taskoj kaj aliaj elementoj sen komencaj tempoj. Tiuj ĉi valoroj ne efikas krom se @z ZONO estas uzita kaj ZONO ne egalas al ‘none’. La provizitaj due_hour = 12 kaj due_minute = 0 sufiĉas por la plej multo da bezonoj. Ekzemple, tasko kun limdato je tagmezo 30-an de novembro en Novjorko (12:00 11/30 EST), havus ankaŭ la limdaton 30-an de novembro en Londono (17:00 11/30 GMT) kaj Honolulu (7:00 11/30 HST), sed havus la limdaton 1-an de decembro trans la internacia linio de datoŝanĝo en Tokjo (2;)0 12/1 JST) kaj Singaporo (1:00 12/1/ SGT).

Grupigado kaj ordigado

Grupigado kaj ordigado estas kontrolata per -g opcio de skizpanelo. La apriora

-g ((y,m,d),)

grupigas kaj ordigas elementojn laŭ jaro (y), monato (m) kaj tago (d) june rezultante per io simila al

ven 3 jun2011 (17) 3.5h
   3:00p Konferenco
   ...   16 aliaj elementoj por 3-a de junio
sab 4 jun 2011 (3) 1.0h
   ...   3 elementoj por 4-a de junio

Por sekva ekzemplo, oni supozu ke estas uzataj ŝlosilvortoj en formo nomo de kliento:nomo de projekto Tiam

-g (k1, (y,q,m), k2)

grupiĝus kaj ordigus laŭ k1 (nomo de kliento), tiam laŭ jaro (y), jarkvarono (q) kaj monato (m) kune, kaj fine laŭ k2 (nomo de projekto) kio rezultas simile al:

kliento 1 (3) 1,5h
   2a jarkvarono 2011 jun (3) 1,5h
      projekto E (3) 1,5h
         ...  3 elementoj por 'kliento 1:projekto E'
...

-g (k1, (y,m,d), T) -d 0 -T 1

grupigus laŭ k1 (nomo de kliento), tiam laŭ jaro (y), monato (m) kaj tago (d) kune, kaj fine laŭ T (titolo de elemento). Kiam oni forigas detalojn -d 0 kaj unue sumas -T 1, la rezulto similas al:

3.6h) kliento 1 (4)
   2.0h) ven aŭg 5 2011 (2)
      1.0h) prepari mendon (1)
      0.5h) kontroli fakturon (1) ...
...

Notu, ke en grafika aspekto de la superaj ekzemploj, informo ‘(nombro da elementoj) suma tempo’ estas aŭtomate aldonata al ĉiu nodo.

Disponeblaj por grupigado/ordigado kampoŝlosiloj estas: y (jaro), m (monato), d (tago), e (plivastiĝo), w (numero de semajno en jaro), q (numero de jarkvarono), c (kunteksto), l (loko), u (uzanto), s (tipo de elemeneto) kaj k1, k2, k3 (unua, dua kaj ĉiuj sekvaj ŝlosilvortoj). Ekzemple kun @k A:B:C:D:E, k1 estus ‘A’, k2 estus ‘B’ kaj k3 estus ‘C:D:E’.

Fina grupiga opcio uzas -g F por grupigi kaj ordigi laŭ projektodosiero. Kiam tiu ĉi opcio estas uzita, aliaj grupigoj kaj komenca kaj fina datoopcioj estas malatentataj por vidigi ĉiujn elementojn skizitaj laŭ projektodosiero.

Ekzemploj:

  • montri ĉiujn notojn skiztiaj laŭ projektodosiero:

    -g F -o !n
  • montri ĉiujn nefinitajn taskojn aranĝitajn laŭ projektodosieroj:

    -g F -o !ut

Regulesprimaj filtriloj

Etm subtenas uzon de usklecoblinda regulesprima kongruo serĉante kaj filtrante laŭ kunteksto, ŝlosilvorto, loko, prioritato, etikedo, uzanto, dosiero kaj/aŭ projekto. Ekz. vidiga opcio kiu enhavus -c aliaj limigus vidigatajn elementoj al tiuj, kiuj enhavas kuntekstokampon ‘aliaj’.

Kontraste, -c !aliaj limigus vidigatajn elementojn al tiu, kiuj ne havas aliaj en la kuntekstokampo. Notu, ke uzante komandlinian interfacon la lasta esprimo devas esti inter apostrofoj, ekz.:

e.py o -c '!aliaj'

Bonega enkonduko al uzo de regulaj esprimoj troveblas (anglalingve) ĉe

www.duke.edu/~dgraham/ETM/LearningtoUseRegularExpressions.html

Okulumu la ‘Kongruaj serĉpetoj en teksto: bazo’ kaj notu ke la ĉirkaŭantaj ‘/’ limigiloj ne estas devigaj en etm.

Serĉo

Enigante regulan esprimon en serĉobreto de grafika fasado aŭ liverante la esprimon kiel opcio de skizpanelo uzante -s funkcias alie ol la filtriloj priskribitaj supre:

  1. Serĉo efikas al ĉiuj elementoj pritraktataj per etm. Tio signifas ke ĉiuj nefiksitaj elementoj kaj almenaŭ unu apero de ĉiuj fikstiaj elementoj estas traserĉataj. Filtriloj, kontraste, efikas nur por nefiksitaj elementoj kaj tiuj inter -b KOMENCO (apriore hodiaŭ) kaj -e FINO (apriore 6 tagoj post KOMENCO).
  2. Serĉo efikas por ĉiu kampo kongrua al la esprimo. Tiel -s smith kongruas kun elementoj kiuj havas ‘smith’ (usklecoblinde) en la titolo, kunteksto, ŝlosilvorto, loko, noto aŭ ĉio alia. Kontraste, filtrilo kiel -k smith kongruas kun elementoj kun ‘smith’ nur en kampo de ŝlosilvorto.

Ekzempla projekto

Supozu, ke estas departamenta kunveno tagmeze, 13-an de marto 2009, pri kiu oni volus memori. Kun etm, la jena teksta dosiero tion efektivigus:

---- komenco de la dosiero -----------------
etato
* departamenta renkonto @c laboro @d
2009-03-13 @s 12:00p
---- fino de la dosiero -------------------

La steleto antaŭ departamenta renkonto signifas ka tiu ĉi lini priskribas okazaĵoj. La departamenta renkonto aperus en la tagplano 13-an de marto kunigita kun projekto ‘etato’ kaj kunteksto ‘laboro’. Se oni volus esti avertataj 15 kaj 10 minutoj antaŭ la renkonto kaj rememorigataj kunporti etaton al la renkonto, tiam oni ŝanĝu la linion al:

* departamenta renkonto @c laboro @d 2009-03-13 @s 12:00p @a 15, 10 @n kunporti etaton

Por igi aferojn pli interesaj, supozu ke oni estas respondecaj por preparo de la etato kaj ĝia prezentado dum la renkonto. La jena:

---- komenco de la dosiero -----------------
etato @c laboro @d 2009-03-13
* departamenta renkonto @s 12:00p @a 15, 10 @n kunporti etaton
- prepari etaton @b 1
---- fino de la dosiero -------------------

rememorigus pri tiu ci tasko unu tagon antaŭ la renkonto.

Eĉ pli interese, supozu ke oni bezonas datenojn de Joe kaj inventaron de Mary por prepari la etaton. Simple aldonu du pliajn taskojn:

---- komenco de la dosiero -----------------
etato @c laboro @d 2009-03-13
* departamenta renkonto @s 12:00p @a 15, 10 @n kunporti etaton
- preni vendojn de Joe @b 2
- preni inventaron de Mary @b 2
- prepari etaton @b 1
---- fino de la dosiero -------------------

Taskoj povas komenciĝi per unu aŭ pli ‘-‘ ‘+’ signoj. La taskoj povas esti priskribitaj en skiza formo per nombro de ‘-‘ aŭ ‘+’ signoj priskribantaj la nivelon kaj tiel difini parencajn taskojn. La taskoj de la sama nivelo de la skizo povas esti plenumigitaj en iu laŭvola sinsekvo sed neniu povas komenci antaŭ ĉiuj de la pli alta nivelo de la sama branĉo estos finitaj. La sola minusosigno antaŭ Joe, Mary kaj etato signifas ke tiuj taskoj estas je la sama (unua) nivelo kaj tiel povas esti plenumigitaj en laŭvola sinsekvo.

Se oni volas plenumigi Mary antaŭ komenci etaton, tiam oni devas skribi jene:

---- komenco de la dosiero -----------------
etato @c laboro @d 2009-03-13
* departamenta renkonto @s 12:00p @a 15, 10 @n kunporti etaton
- preni vendojn de Joe @b 2
- preni inventaron de Mary @b 2
-- prepari etaton @b 1
---- fino de la dosiero -------------------

La du minusosignoj antaŭ etato signifas ke ĝi estas subnivelo de Mary kaj tiel Mary devas esti finita antaŭ la etato povas komenci.

Se oni volas fakte kompletigi ambaŭ Joe kaj Mary antaŭ komeci etaton tiam oni devas uzi plusosignon antaŭ Mary por aldoni la antaŭan taskon, Joe, al la parencoj por ĉiuj taskoj, kiel etato, kiu dependas de Mary:

---- komenco de la dosiero -----------------
etato @c laboro @d 2009-03-13
* departamenta renkonto @s 12:00p @a 15, 10 @n kunporti etaton
- preni vendojn de Joe @b 2
+ preni inventaron de Mary @b 2
-- prepari etaton @b 1
---- fino de la dosiero -------------------

Finfine eta ŝanĝo kiu konvenus por tiaj renkontoj se tiuj ripetas ĉiun duan vendredon de ĉiu monato:

---- komenco de la dosiero -----------------
etato @c laboro @d 2009-03-13 @r m @w FR(2)
* departamenta renkonto @s 12:00p @a 15, 10 @n kunporti etaton
- preni vendojn de Joe @b 2
+ preni inventaron de Mary @b 2
-- prepari etaton @b 1
---- fino de la dosiero -------------------

Kio povus esti pli facila?

Opcioj por agoj, okazaĵoj, notoj kaj taskoj

Uzante grafikan fasadon, premu aŭ a~ por krei agon, e* por krei okazaĵon, n! por krei noton kaj t, -+ por krei taskon. Nedevigaj (N) kaj devigaj (D) kampoj estas listitaj ĉi sube.

Kampoŝlosilo Valoro Ago Okazaĵo Noto Tasko Priskribo
@d DATO D D N N dato (svage analizata).
@b KOMENCO       N entjera nombro da tagoj antaŭ tasko kun limdato de kiu komenci montri atentoj de venonta limdato.
@f FINO       N dato aŭ, por ripetaj taskoj, listo de datoj en parentezoj, kiam la tasko estis plenumita (svage analizataj).
@s KOMENCOTEMPO   N     tempo aŭ listo de aŭ listo tempoj en parentezoj (svage analizataj). Nkazaĵo sen komenca tempo estas konsiderata tuttaga okazaĵo.
@a ALARMOJ   N     entjera nombro aŭ listo de entjeraj minutoj en parentezoj. Alarmoj estos funkciigataj je tempoj rilatantaj al tiuj nombroj da minutoj antaŭ KNMENCNTEMPN.
@A ANSTKMD   N     anstataŭa komando funkciigata por alarmo. Akceptas la samajn anstataŭaj ĉenoj de alertcmd uzita en la etmrc dosiero.
@e PLIVAST D N   N entjera nombro da minutoj of antaŭitaj per + (plusosigno). Eventuale, oni povas provizi finan tempon (svage analizatan) por okazaĵo kun unuopa komenca tempo. Nkazaĵo kun unu aŭ pli da komencaj tempoj sed sen plivastiĝo, estas konsiderata memorigilo.
@n NOTO N N N N teksto. Novlinioj kaj komencaj blankaj spacoj estas konservataj ene de korpo de la noto.
@g IRIAL N N N N dosierpado aŭ URL, aŭ kome separata listo de padoj aŭ URL-oj en parentezoj, kiuj estu malfermataj uzante la apriorajn programojn de la sistemo, kiam la uzanto premas g dum la elemento estas selektita. Se provizita estas la listo, vidigita estos la listo de kiu oni povas elekti la malfermotan elementon.
@z TEMPOZONO N N N N tempozono, ez. US/Eastern.
@l LOKO N N N N teksto
@U UZANTO N N N N teksto
@c KUNTEKSTO N N N N teksto
@k ŜLOSILVORTO N N N N teksto kun eblaj duonpunktoj, ekz. @k unua:dua:tria:kvara. Ĉe grupigado/ordigado k1 referus al ‘unua’, ‘k2’ al ‘dua’ kaj ‘k3’ al ‘tria:kvara’.
@p PRIORITATO       N entjero inter 1 (plej alta prioritato) ĝis 9 (plej malalta prioritato).
@t ETIKEDOJ N N N N teskto de kome separita listo de tekstoj en parantezoj, ekz, @t (etikedo 1, etikedo 2).

Ripetado

Kampoŝlosilo Valoro Priskribo
@r RIPETO unu signa el d (tage), w (semajne), m (monate), y (jare) aŭ l (listo) priskribanta frekvencon de taskoripetado. Tiu ĉi kampo estas ĉiam deviga por ripetaj elementoj.
@i INTERSPACO pozitiva entjero laŭ kiu la tasko ripetas. Ekzemple, @r w @i 3 ripetiĝus ĉiun trian semajnon. Apriore: 1
@u ĜIS dato kiam la ripetoj ĉesu (svage analizita). Apriore: none, t.e. ripetado daŭru senfine.
@C NOMBRO entjera nombro da permesitaj ripetoj. Ekzemple, @d 2011-01-01 @r m @m (15, 30) @C 4 ripetiĝus 15-an de januaro, 30-an de januaro, 15-an de februaro kaj 15-an de marto 2011. Apriore: none, t.e. ripetado daŭru senfine.
@w SEMAJNOTAGO teksto au listo de tekstoj en parentezoj el MO (lundo), TU (mardo), WE (merkredo), TH (ĵaŭdo), FR (vendredo), SA (sabato), SU (dimanĉo) aŭ entjero aŭ listo de entjeroj de 0 (lundo) ĝis 6 (dimanĉo). Apriore: ĉiu tago de semajno. Ekzemple, @r m @w (MO(1), FR(-1)) ripetiĝus la unuan lundon kaj la lastan vendredon de ĉiu monato.
@W SEMAJNONUM entjera numero de semajno en jaro aŭ listo de numeroj de semajnoj de 0 ĝis 53. Apriore: ĉiu numero de semajno.
@m MONATOTAGO entjera numero de te tago en la semajno aŭ listo de numeroj de tagoj de 1 ĝis 31. Notu, ke @r m @m 31 ripetiĝus nur en monatoj kiuj havas 31 tagoj sed @r m @m -1 ripetiĝus la lastan tagon de ĉiu monato. Apriore: ĉiu tago de monato.
@M MONATONOM entjera numero de monato en la jaro aŭ listo de numeroj de 1 ĝis 12. Apriore: ĉiu numero de monato.
@+ INKLDATOJ dato aŭ listo de datoj aldonataj al la listo generata laŭ la rikura regulo. Ekzemple, @r m @m 1 @+ (Feb 5, Feb 7) ripetiĝus ĉiun unuan tagon de monato, kaj krome, la 5-an de februaro kaj 7-an de februaro. Notu ke per tiu ĉi kampo eblas difini precizajn datojn. Ekzemple, @r l @+ (Feb 28, Jul 3, Aug 27) ripetiĝus nur je la tri difinitaj datoj. Kiam @r l (listo) estis uzita, por la enigo @+ INKLDATOJ estas deviga kaj @d DATO estas nedeviga. Alikaze, enigo de @d DATO estas deviga kaj la @+ INKLDATOJ estas nedeviga. Apriore: none.
@- EKSKLDATOJ dato aŭ listo de datoj forigotaj de la listo generata laŭ la rikura regulo. Ekzemple, @r m @m 1 @- (Mar 1, Jun 1) ripetiĝus ĉiun unuan tagon de monato krom 1-a de marto kaj 1-a de majo. Apriore: none.
@S AGORDAPER entjero difinanta la daton de la listo de datoj kiu kongruus kun rikura regulo. Ekzemple, @r m @w (MO, TU, WE, TH, FR) @m (23, 24, 25) ripetiĝus ĉiun labortagon kiu estas 23-a, 24-a aŭ 25-a tago de la monato. Ekzemple, en junio 2011, tio okazus ĵaŭde 23-an kaj vendrede, 24-an. Aldonante @S -1, nur la lasta de tiuj - vendredo 24-an de junio estus uzita. Tiel @r m @w (MO, TU, WE, TH, FR) @m (23, 24, 25) @S -1 ripetiĝus la lastan labortagon de ĉiu monato kiu okazos 25-an aŭ pli frue. Apriore: none.
@o POSTTEMP Ĝi difinas kiel trakti pasintajn datojn de ripetaj taskoj. Eblas k (konservi), s (malatenti) aŭ r (rekomenci). Ĝi estas klarigata pli sube. Apriore: k.

Okazaĵoj kaj taskoj povas esti ripetataj uzanta pliajn kampoŝlosilojn kaj valorojn.

Ripeta tasko kiu estas finita je sia limdato estas neniu problemo. Sed kio okazu se ĝi estas finita frue aŭ fariĝas posttempa? En etm ekzistas tri opcioj:

@o k
Konservi la aktualan limdaton kiam ĝi fariĝas posttempa kaj uzi la sekvan limdaton laŭ la rikura regulo se ĝi estas finita frue. Ĝi estus konvena, ekzemple, por tasko ‘liveri impostodokumentojn’. La livero kun limdato 15-an de aprilo 2009 devas esti plenumita eĉ se ĝi estas posttempa kaj la livero de 2010 ne atingos limdaton ĝis 15-a de aprilo 2010 eĉ se livero de 2009 plenumiĝos frue.
@o s
Malatenti limdatojn kaj akomodi limdaton al la sekva ripeto de la unua limdato de rikura regulo je aŭ post la aktuala dato. Ĝi estus konvena, ekzemple, por la tasko ‘disponigi rubujon’ ĉar estas neniu senco disponigi ĝin marde se ĝi estas prenata lunde. Oni povas same atendi ĝis la sekva lundo por disponigi ĝin. Estas sensenca esti remorigata pri tio ĝis la sekva lundo.
@o r
Rekomenci la ripetojn baze de lasta plenumdato. Supozu ke oni volas falĉi gazonon ĉiun dekan tagon kaj se oni falĉis hieraŭ, oni estis jam naŭ tagoj post la limdato. Kaj oni volas la sekvan limdaton esti dek tagojn de morgaŭ, ne hodiaŭ. Simile, oni falĉus unu tagon tro frue se falĉante hieraŭ, tiam oni volus la sekvan limdaton esti dek tagojn de hieraŭ kaj ne de hodiaŭ.

Opcioj por Skizpanelo kaj Panelo de okupita tempo

Uzante grafikan fasadon, premu o por agordi opciojn por skiza panelo aŭ b por agordi opciojn por panelo de okupita tempo. Disponeblaj opcioj estas indikitaj sube per N.

Opcio Skiza Okupita Priskribo
-b KOMENCO N N dato. Montras nur elementojn post aŭ je la provizita dato (svage analizita) Oni povas enigi relativan daton, ekzemple -b -14 difinas KOMENCOn 14 tagojn antaŭ la aktuala dato. Ankaŭ relativaj esprimoj por monatoj povas esti uzataj, ekzemple -b -1/1 difinas KOMENCOn per la unua tago de la antaŭa monato.
-e FINO N N dato aŭ plusosoigno sekvata per entjero . Montras nur elementojn antaŭ (sed ne je) la provizita (svage analizita) dato aŭ por la provizita nombro da tagoj post difinita KOMENCO. Ekzemple, ambaŭ -b 7/1 -e 7/8 kaj -b 7/1 -e +7 montrus elementojn por sep tagoj:from 1-a ĝis 7-a de julio.
-g GRUPIPER N   disponeblaj por grupigado/ordigado ŝlosiloj estas: y (jaro), m (monato), d (tago), e (plivastiĝo), w (numero de semajno en jaro), q (numero de jarkvarono), c (kunteksto), l (loko), u (uzanto), s (tipo de elemeneto) kaj k1, k2, k3 (unua, dua kaj ĉiuj sekvaj ŝlosilvortoj). Fina grupiga opcio uzas -g F por grupigi kaj ordigi laŭ projektodosiero. Kiam tiu ĉi opcio estas uzita, aliaj grupigoj kaj komenca kaj fina datoopcioj estas malatentataj por vidigi ĉiujn elementojn skizitaj laŭ projektodosiero. Vidu diskuton pri grupigado kaj ordigado por pliaj detaloj.
-o FORIGI N N teksto konsistanta de disponeblaj literoj: a (okazaĵoj), b (komencaj datoj de taskoj), d (tuttagaj okazaĵoj), e (planataj okazaĵoj), n (notoj), r (memorigiloj), f (finitaj taskoj), u (sen-dataj taskoj), w (atendantaj taskoj), p (posttempaj taskoj) kaj t (aliaj taskoj). Se FORIGI komencas per !, tiam montri nur elementojn de specoj priskribitaj en FORIGI. Kontraŭe, montri nur elementojn ne priskribitaj en FORIGI. Nur elementoj kun plivastiĝo (agoj kaj okazaĵoj) vidigendas en panelo de okupita tempo.
-d DETALOJ N   0, 1 aŭ teksto konsistanta el kampoŝlosiloj aŭ *. Vidigas nur titolojn de grupoj se 0. Se 1, montras ankaŭ elementojn (branĉojn). Se teksto kun kampoŝlosiloj, tiam vidigas antaŭrigardon kun detaloj kongruaj kun la kampoŝlosiloj kaj la elementojn. Ekzemple -d ln vidigus antaŭrigardon kun elementoj kaj iliaj loko (l) kaj notoj (n). Se * tiam montras detalojn kun ĉiuj kampoŝlosiloj. Apriore: 1.
-T SUMUNUE N   01. Vidigas sumojn de tempo antaŭ la titolojn de grupoj se 1. Kontraŭe, post la titoloj de grupoj. Apriore: 0.
-s SERĈO N N regula esprimo. Vidigas elementojn, malatentante datojn, en kiuj ĉiu kampovaloro kongruas kun SERĈO (usklecoblinde). Aldonu krisignon ĉe la komenco por vidigi elementojn kiuj havas neniun kampovaloron kongruan kun SERĈO.
-c KUNTEKSTO N N regula esprimo. Vidigas elementojn kun kunteksto kongrua kun KUNTEKSTO (usklecoblinde). Aldonu krisignon ĉe la komenco por vidigi elementojn kiuj ne havas kuntekston kongruan kun KUNTEKSTO.
-k ŜLOSILVORTO N N regula esprimo. Vidigas elementojn kun ŝlosilvortoj kongruaj kun ŜLOSILVORTO (usklecoblinde). Aldonu krisignon ĉe la komenco por vidigi elementojn kiuj ne havas ŝlosilvortojn kongruajn kun ŜLOSILVORTO.
-p PRIORITATO N N regula esprimo. Vidigas elementojn kun prioritatoj kongruaj kun PRIORITATO. Ekzemple, -p [123] selektus elementojn kun tri plej altaj prioritatoj kaj -p ![123] selektus elementojn kun prioritato pli malalta ol 3 aŭ sen prioritato.
-t ETIKEDO N N regula esprimo. Vidigas elementojn kun etikedoj kongruaj kun ETIKEDO (usklecoblinde). Aldonu krisignon ĉe la komenco por vidigi elementojn kiuj ne havas etikedojn kongruajn kun ETIKEDO. Eblas pluroblaj uzoj de tiu ĉi opcio. Ekzemple, uzu -t etikedo 1 -t etikedo 2 por vidigi elementojn kun ambaŭ etikedo 1 kaj etikedo 2.
-l LOKO N N regula esprimo. Vidigas elementojn kun loko kongrua kun LOKO (usklecoblinde). Aldonu krisignon ĉe la komenco por vidigi elementojn kiuj ne havas lokojn kongruajn kun LOKO.
-u UZANTO N N regula esprimo. Vidigas elementojn kun uzantoj kongruaj kun UZANTO (usklecoblinde). Aldonu krisignon ĉe la komenco por vidigi elementojn kiuj ne havas uzantojn kongruajn kun UZANTO.
-P PROJEKTO N N regula esprimo. Vidigas elementojn kun projektotitolo kongrua kun PROJEKTO (usklecoblinde). Aldonu krisignon ĉe la komenco por vidigi elementojn kiuj ne havas projektotitolojn kongruajn kun PROJEKTO.
-f DOSIERO N N regula esprimo. Vidigas elementojn kun dosiernomoj kongruaj kun DOSIERO (usklecoblinde). Aldonu krisignon ĉe la komenco por vidigi elementojn kiuj ne havas dosiernomojn kongruajn kun DOSIERO.
-i INKL   N teksto. Unu aŭ pli da literoj el: B (okupita tempo) Apriore: Bfc.
-O EKO   N tempo. La ekkomenca aŭ la plej frua horo (svage analizitaj) konsiderata por vidigo de liberaj periodoj. Apriore: 8:00a.
-C FINO   N tempo. La fina aŭ la malplej frua horo (svage analizitaj) konsiderata por vidigo de liberaj periodoj. Apriore: 10:00p.
-m MINIMUM   N pozitiva entjero. La minimuma daŭro de libera periodo en minutoj, por esti vidigata. Apriore: 60.
-w BUFRO   N pozitiva entjero. Provizas bufron de BUFRO minutoj antaŭ kaj post okupitaj periodoj kalkulante liberajn periodojn. Apriore: 15.
-v VCAL N   eksporti vidigitajn elementojn en vCal formo en export.ics dosieron en la export dosierujo difinita en la etmrc dosiero.
-x VALOROJ N   kome separata listo de kampoŝlosiloj. Eksporti vidigataj elementojn en CSV (kome separataj valoroj) formo en export.ics dosieron en export dosierujo difinita en etmrc dosiero. Valoroj eksportataj por ĉiu elemento enhavas 1) identigilon de la elemento, 2) numeron de elementotipo, 3) priskribon (titolon) de elemento kaj, laŭvice, valoroj korespondaj al la kampoŝlosiloj de VALOROJ. Disponeblaj kampoŝlosiloj estas: y (jaro), m (monato), d (tago), e (plivastiĝo), p (prioritato), w (numero de semajno en jaro), q (numero de jarkvarono), c (kunteksto), k1, k2, k3 (unua, dua kaj ĉiuj sekvaj ŝlosilvortoj), l (loko), u (uzanto), P (projektonomo), t (etikedoj) kaj n (noto).

Komandlinia uzo

Funkciigi

e.py ?

por kompleta uzinformo:

dokumentitaj komandoj de |etm|_ X' (aŭ 'help X') por
detaloj pri komando X
=============================================================================
b  c  coloroj  d  e  f  helpo  j  m  n  numeroj  o  q  r  u  v  w

aŭ, ekzemple,

e.py ? o por ricevi skizon de uzinformoj:

Vidigas skizan reporton uzante liveritajn opciojn.
Opcioj:
-h, --help     monti ĉi tiun helpinformon kaj eliri
-b KOMENCO  dato. Montras elementojn komencantajn en tiu ĉi dato (svage analizita)
                kaj daŭrantaj ĝis FINO. Apriore: hodiaŭ.
-e FINO    dato. Montras elementojn komencantajn en tiu ĉi dato (svage analizita)
                kaj daŭrantaj ĝis FINO. Apriore: KOMENCO plus 6 tagoj.
-f DOSIERO        regula esprimo. Vidigas elementojn kun dosieronomoj
                kongruajn kun DOSIERO (usklecoblinde) en la KOMENCO ~ FINO
                periodo. Aldonu krisignon ĉe la komenco , t.e., prefere uzu !DOSIERO
                anstataŭ DOSIERO, por vidigi elementojn kiuj NE havas dosiernomojn
                kongruajn kun DOSIERO.
-P PROJEKTO     regula esprimo. Vidigas elementojn kun projektotitoloj
                kongruajn kun PROJEKTO (usklecoblinde), en la KOMENCO ~ FINO
                periodo. Aldonu krisignon ĉe la komenco , t.e., prefere uzu !PROJEKTO
                anstataŭ PROJEKTO, por vidigi elementojn kiuj NE havas projektotitolojn
                kongruajn kun PROJEKTO.
-c KUNTEKSTO     regula esprimo. Vidigas elementojn kun kuntekstoj
                kongruajn kun KUNTEKSTO (usklecoblinde), en la KOMENCO ~ FINO
                periodo.
                Aldonu krisignon ĉe la komenco , t.e., prefere uzu !KUNTEKSTO
                anstataŭ KUNTEKSTO, por vidigi elementojn kiuj NE havas kuntekstojn
                kongruajn kun KUNTEKSTO.
-k ŜLOSILVORTO     regula esprimo. Vidigas elementojn kun kuntekstoj
                kongruajn kun ŜLOSILVORTO (usklecoblinde), en la KOMENCO ~ FINO
                periodo.
                Aldonu krisignon ĉe la komenco , t.e., prefere uzu !ŜLOSILVORTO
                anstataŭ ŜLOSILVORTO, por vidigi elementojn kiuj NE havas kuntekstojn
                kongruajn kun ŜLOSILVORTO.
-t ETIKEDO         regula esprimo. Vidigas elementojn kun etikedoj
                kongruajn kun ETIKEDO (usklecoblinde), en la KOMENCO ~ FINO
                periodo. Aldonu krisignon ĉe la komenco , t.e., prefere uzu !ETIKEDO
                anstataŭ ETIKEDO, por vidigi elementojn kiuj NE havas etikedojn
                kongruajn kun ETIKEDO. Tiu ĉi opcio povas esti
                uzita pli ol unu fojon, ekz., uzu ``-t etikedo 1 -t etikedo 2`` por vidigi
                elementojn kun etikedoj kongruaj kun ambaŭ ``etikedo 1`` kaj ``etikedo 2``.
-u UZANTO        regula esprimo. Vidigas elementojn kun uzanto
                kongrua kun UZANTO (usklecoblinde), en la KOMENCO ~ FINO
                periodo. Aldonu krisignon ĉe la komenco , t.e., prefere uzu !UZANTO
                anstataŭ UZANTO, por vidigi elementojn kiuj NE havas uzantojn
                kongruajn kun UZANTO.
-l LOKO    regula esprimo. Vidigas elementojn kun loko
                kongrua kun LOKO (usklecoblinde), en la KOMENCO ~ FINO
                periodo.
                Aldonu krisignon ĉe la komenco , t.e., prefere uzu !LOKO
                anstataŭ LOKO, por vidigi elementojn kiuj NE havas lokon
                kongruan kun LOKO.
-p PRIORITATO     regula esprimo. Vidigas elementojn kun prioritatoj
                kongruaj kun PRIORITATO (usklecoblinde), en la KOMENCO ~ FINO
                periodo. Aldonu krisignon ĉe la komenco , t.e., prefere uzu !PRIORITATO
                anstataŭ PRIORITATO, por vidigi elementojn kiuj NE havas prioritatojn
                kongruajn kun PRIORITATO.
-s SERĈO      regula esprimo. Vidigas elementojn kun taskotitolo aŭ noto
                kongruaj kun SERĈO (usklecoblinde), en la KOMENCO ~ FINO
                periodo. Aldonu krisignon ĉe la komenco , t.e., prefere uzu !SERĈO
                anstataŭ SERĈO, por vidigi elementojn kiuj NE havas titolojn
                nek notojn kongruajn kun SERĈO.
-o FORIGI        teksto vidigi/kaŝi ``a`` okazaĵojn, ``b`` komencajn datojn de taskoj, ``d`` tutagaj
                okazaĵoj, ``e`` planitaj okazaĵoj, ``f`` finitajn taskojn, ``n`` notojn,
                ``r`` memorigilojn, ``t`` ĉiujn taskojn, ``u`` nefiksitajn taskojn, kaj/aŭ ``w`` atendantajn taskojn
                depende ĉu FORIGI enhavas ``a``, ``b``, ``e``, ``f``, ``n``,
                ``r``, ``t``, ``u`` kaj/aŭ ``w`` kaj komenciĝas per ``!`` (vidigi) aŭ ne
                komenciĝas per ``!`` (kaŝi). Apriore: none.
-g KOLJ        Opo de elementoj el ``y`` (jaro), ``m`` (monato), ``d`` (tago), ``s``
                (ordigo aŭ numero de tipo), ``e`` (plivastiĝo), ``w`` (numero de semajno
                en jaro), ``q`` (numero de jarkvarono), ``c`` (kunteksto), ``k1`` (unua ŝlosilvorto), ``k2``
                (dua ŝlosilvorto), ``k3`` (tria ŝlosilvorto), ``l`` (loko), ``n`` (nomo de elemento), ``f``
                (dosiernomo kaj nombro da linioj), ``u`` (uzanto), ``p``  (projektonomo) kaj
                ``i`` (identigilo). Ekzemple, la priora ``-g ((y, m, d),)``, ordigas laŭ
                kune jaro, monato kaj tago, por ricevi rezulton similan al
                |   Fri Apr 1 2011
                |       elementoj por 1-a de aprilo
                |   Sat Apr 2 2011
                |       elementoj por 2-a de aprilo
                |   ...
                Alia ekzemplo, ``-g ((y, q), m, d)``, ordigus laŭ jaro kaj
                kvaronjaro, sekve laŭ monato kaj fine laŭ tago rezultante per
                |   2011 2-a kvaronjaro
                |       Apr
                |           Fri 1
                |               elementoj por 1-a de aprilo
                |           Sat 2
                |               elementoj por 2-a de aprilo
                |   ...
                Fina grupiga opcio estas grupigi laŭ dosierpado uzante ``-g F``. Noto
                ke ``F`` ne estu kunigita kun iu alia grupiga
                opcio.
-d DETALOJ     teksto Kontrolas vidigon de detaloj de elementoj. Kun '-d 0',
                neniuj detaloj de elementoj estos vidigataj. Kun '-d 1' (la
                apriora), la prefikso kaj titolo (priskribo) estos
                vidigataj. Kun '-d len', ekzemple, dua linio de detaloj
                estus aldonita vidigante la lokon (l), plivastiĝon (e) kaj
                noton (n) de ĉiu elemento.
-T             bulea valoro Vidigas sumojn da minutoj ĉe la komenco anstataŭ ĉe
                la fino de la linio.
-x VALOROJ      kome separata listo de kampoŝlosiloj Eksporti vidigataj elementojn en
                CSV (kome separataj valoroj) formo en ``export.ics`` dosieron en la
                 ``export`` dosierujo difinita en ``etmrc`` dosiero. Valoroj
                eksportataj por ĉiu elemento enhavas 1) identigilon de la elemento, 2) numeron de
                elementotipo, 3) priskribon (titolon) de elemento kaj, laŭvice, valoroj
                korespondaj al la kampoŝlosiloj de VALOROJ. Disponeblaj kampoŝlosiloj estas:
                ``y`` (jaro), ``m`` (monato), ``d`` (tago), ``e`` (plivastiĝo), ``p`` (prioritato),
                ``w`` (numero de semajno en jaro), ``q`` (numero de jarkvarono), ``c`` (kunteksto), ``k1``, ``k2``,
                ``k3`` (unua, dua kaj ĉiuj sekvaj ŝlosilvortoj), ``l`` (loko), ``u`` (uzanto), ``P``
                (projektonomo), ``t`` (etikedoj) kaj ``n`` (noto).
-v             Eksporti elementojn en vCal/iCal formo en ``export.ics`` dosieron en la
                dosierujo difinita per ``export`` en la ``etmrc`` dosiero.

Oni povas funkciigi:

e.py

sen ajna opcio por malfermi dialogan version de komandlinia versio:

$ e.py
enter 'q' to quit or 'help' for usage information
etm:

Enigante ‘o’ ĉe invito, vidigas ion similan:

etm: o
Mer 24-a de aŭg 2011 (20) 4:00
    10:00a renkonto kun Kliento 1 [1]
    1:00p renkonto kun Kliento 2 [2]
    5:00p lunda, merkrada, vendreda posttagmeza okazaĵo [3]
    5:00p gimnastikaj ekzercoj [4]
        vertebra ekzercado [5]
        testa alarmo [6]
        telefona konferenco kun Kliento 1 [7]
    +1   prepari personan renkonton [8]
    +7   prepari tagmanĝon por renkonto kun Kliento 2 [9]
    +14   promocii |etm|_ [10]
        prepari monatan etaton [11]
        esploro por Kliento 2 [12]
        labori kun E malneto [13]
    X   E malneto [14]
    X   telefoni Klienton 2 [15]
    X   akvumi hejmajn vegetaĵojn [16]
        ekzemploj de |etm|_ [17]

Thu Aug 25 2011 (12) 6:45
    10:05a marda/ĵaŭda matena kaj posttagmeza okazaĵoj [18]
    12:00p departamenta tagmanĝo [19]
    2:50p marda/ĵaŭda matena kaj posttagmeza okazaĵoj [20]
    3:00p renkonto kun Kliento 3 re A [21]
        vertebra ekzercado [22]
        disponigi runujon [23]
        prepari personan renkonton [24]
        revizioj por A [25]
        labori kun E revizioj [26]

La numeroj en rektaj krampoj postigataj la elementojn povas esti uzitaj dialoge por redakti elementojn, ekz.:

etm: d 9

petus konfirmon kaj forigus elementon numero 9 (prepari tagmanĝon). Simile

etm: e 11

malfermus elementon numero 11 (monata reporto) uzante redaktilon difinitan per term_editor en la etmrc dosiero. Ceteraj dialogaj opcioj inkluzivas c (montri 3-monatgan kalendaron), f (finigi elementon), m (movi elementon en alian dosieron), n (krei novan elementon), r (reŝarĝi datenojn), u (reen finigu elementon) kaj v (kontroli ekziston de nova versio).

Numeroj de elementoj estas vidigataj nur en la dialoga sesio kaj povas esti (mal)kaŝataj per:

etm: numbers

La apriora valoro estas difinita en show_nums en la etmrc dosiero. Simile, la uzo de koloroj povas esti (mal)ŝaltata per:

etm: colors

La apriora valoro estas difinita en use_colors en la etmrc dosiero.

Eblas ankaŭ provizii opciojn por la komandlinio por uzi ne-dialogan version, ekz.:

e.py o -g(k1, (y,m), k2) > etato.txt

konservus la rezultan etaton rekte en la difinitan dosieron.

Finfine, oni povas funkciigi

e.pyw

por malfermi la wx(python)-an grafikan fasadon kaj premante F1 legi disponeblajn komandojn.

Alternative, la skripto:

#!/bin/bash
e.pyw &

povus aŭtomate ekfunkciigadi dum la startiga procezo. Ĉe OS X, nomigante tiun ĉi skripton uzante ‘command’ sufikson, ekzemple etm.command, ebligas aldoni ĝin al vian ensalutaj elementoj kaj/aŭ aldoni ĝin al la breto.

Postuloj

Oni bezonas python >= 2.5.2 (sed < 3.0), wxPython > 2.8.7 kaj la ne-norman sed facile instaleblan modulon dateutil > 1.4.1. Por eksporti liston en iCal postulas la pitonan modulon vobject.

wxPython estas aktive programata kaj estas ambaŭ facila kaj inda penon ĝisdatigi ĝin ĝis la plej lasta versio. Ekzistas mem-instalantaj kompilitaj programoj por ĉiuj vaste konataj sistemoj. Simple elektu tiun, kiu kongruas kun onia versio de Pitono. (Por ekscii la version de Pitono, funkciigu python -V en la terminalo.) Mi rekomendas uzi unikodan version antstaŭ la ANSI versio.

Se oni uzas aŭ setup.pyeasy_install por instali etm, dateutil kaj vobject estos aŭtomate instalitaj kun etm. Alikaze, oni povas ilin instali en kutima, pitona maniero. Elŝuti, malpaki, cd al la rezulta dosierujo kaj funkciigi sudo python setup.py.

Instalo/ĝisdatigo

etm povas esti instalita en kutima, pitona maniero: elŝuti, malpaki la fonton de etm en provizoran dosierujon, malfermi terminalon (en Vindozo - ‘Command Prompt’), cd al la provizora dosierujo kaj funkciigi:

sudo python setup.py install

Vindozuloj povas forigi sudo. Poste, la provizora dosierujo povas esti forigita. Tio elŝutos kaj instalos ĉiu postulata modulo (dateutil, vobject), instalos etm modulon en la site-packages subdosierujon de la pitona distribuo kaj instalos la funkcieblan e.py en la bin dosierujon de la pitona distribuo.

Se oni havas instalitan setuptools, oni povas malzorgi pri elŝuto kaj uzi:

sudo easy_install -U etm

aŭ por instali aŭ por ĝisdatigi etm ĝis la plej lasta versio.

Easy_install estas parto de pitona pakaĵo setuptools. Por ĝin instali elŝutu la konvenan por la pitonversio egg dosieron, ekz.:

setuptools-0.6c11-py2.6.egg.sh

Poste cd al la dosierujo enhavanta egg dosieron kaj, se necese, alinomu ĝin por forigi la .sh finaĵon:

mv setuptools-0.6c11-py2.6.egg.sh setuptools-0.6c11-py2.6.egg

La lasta paŝo estas funkciigi la (alinomitan) egg dosieron kvazaŭ ŝela skripto:

sudo sh setuptools-0.6c11-py2.6.egg

Setuptools instalos sin mem uzante la kongruan version de pitono (ekzemple python2.6) kaj aldonos easy_install plenumeblan dosieron en la kutima pozicio de pitonaj skriptoj.

Uzantoj de OS X

Memstara versio, ‘etm.app’, estas provizata por Mac OS X uzantoj kiel norma dmg dosiero. Elŝutu tiun ĉi dosieron, alklaku ĝin kaj trenu etm.app al via Application dosierujo. Notu ke tiu ĉi aplikaĵo disponeblas la grafikan version de etm sed ne la komandlinian.

Portempa / loka instalo

Se oni volus ekprovi etm sen instalado de sistemdosieroj aŭ oni ne havas root rajtoj sed volus instali etm por propra uzo, la procezo estas simpla. Malpaku la etm fontojn en konvenan dosierujon, cd en tiun dosierujon kaj funkciigu

./e.py [opcioj]

Tio ne postulas root rajotjn kaj ne instalos iujn sistemajn dosierojn, sed kreos en la hejma dosierujo de uzanto agordaĵojn, dateno- kaj alarmo-dosierojn menciitajn sube. Oni povas, certe, uzi kromnomojn aŭ simbolajn ligilojn al tiuj ĉi dosieroj por eviti bezonon iri al tiu ĉi dosierujo, ekzemple se tiuj ci dosieroj trovigas en ETMDIR, tiam oni povas aldoni al ~/.bash_profile la jenan linion:

alias e.py='ETMDIR/e.py'

anstataŭigante ETMDIR per la aktuala vojo. Tiu kromnomo funkcius en la maniero priskribita en Komandlinia uzo.

Uzantoj de etm versio pli frua ol 800 povas provi la novan version elŝutante ĝin, malpakante ĝin en portempan dosierujon, malfermante terminalon, irante al la portempa dosierujo kaj funkciigante aŭ ./e.py por komandlinia versio aŭ ./e.pyw por grafika versio. Tio vidigos la datumojn uzante la novan version neniel influante la ekzistantan instaladon.

Helpo

Helpo pri enigo

<Esc> nuligas enigon;

<Shift-Return> akceptas ĝin.

Premante <TAB> oni elektas enigon de listo de ŝablonoj.

Premu <Ŝovo> kaj <Spaceto> post enigo de @c [vorto], @k [vorto], @l [vorto]@z [vorto] por kompletigi [vorto]-n de kongrua listo de antaŭe uzitajn kuntekstoj (c), ŝlosilvortoj (k), lokoj l aŭ tmpozono (z).

Ripetado

Viziti friziston (tasko) ripetata (r) laŭ tagaj (d) interspacoj (i) de 14 tagoj kaj post plenumo (o), rekomencu (r) baze de la plenumdato:

- viziti friziston @d 2011-07-08 @r d @i 14 @o r

Disponigi rubujon (tasko) ripetata (r) laŭ semajnaj (w) interspacoj en tagoj de semajno (w) vendredo (FR) kaj, post la limdato malatentu ĝis la sekva (s) vendredo.

- disponigi rubujon @d 2011-07-08 @r w @w FR @o s

Pagotago (okazaĵo) la lastan labortagon de semajno de ĉiu monato. La @S -1 enigo kontrolas ĉu la lasta dato estas ambaŭ tago de semajno kaj enfalas en la tri lastaj tagoj de la monato. Ekzemple, kiam la lasta tago de la monato estas dimanĉo, tiam la elektita tago estas vendredo (FR), -3.

* pagotago @d 2010-07-01 @r m @w (MO, TU, WE, TH, FR)
    @m (-1, -2, -3) @S -1

Pagotago la lastan labortagon ĝis la 25-a de ĉiu monato.

* pagotago @d 2010-07-01 @r m @w (MO, TU, WE, TH, FR)
    @m (23, 24, 25) @S -1

Prepari repagon de aldonvalora imposto (tasko) jare (y) ĝis 15-a de aprilo kun alarmo komencanta (b) 30 tagojn antaŭ tiu dato

- kolekti impostokvitancojn @d 2012-04-15 @r y @M 4 @m 15 @b 30
+ preni W2 formularojn @d 2012-04-15 @r y @M 4 @m 15 @b 30
-- prepari repagon de la imposto @d 2012-04-15 @r y @M 4 @m 15 @b 30

Notu ke la + antaŭ ‘preni’ signifas ke ‘kolekti’ kunigos ‘preni’ kiel precedencoj por ‘prepari’ Se la repago devas esti plenumita ĝis la unua labortago post 14-an de aprilo, tiam la ripeta parto povus esti ŝanĝita al @r y @M 4 @m (15, 16, 17) @w range(0, 5) @S 1 kie range(0, 5) egalas al ‘(0,1,2,3,4)’ aŭ ‘(MO,TU,WE,TH,FR)’ kaj ‘@S 1’ kontrolas ĉu la unua dato estas labortago kaj estas post la 14-a.

Preni priskribitan kuracilon ĉiutage (okazaĵo) de la 23-a ĝis la 27-a je 10-a, 14-a, 18-a kaj 22-a horoj kaj estu avertata ĝuste je tiuj horoj.

* preni Rx @d 23 @s (10a, 2p, 6p, 10p) @r d @u 27 @a 0

Prezidenta balototago (okazaĵo) ĉiun kvaran jaron, la unuan mardon de novembro

* Presidena Balototago @d 2012-11-06 @r y @i 4 @M 11
    @m range(2, 9) @w TU

dum range(2, 9) egalas al (2,3,4,5,6,7,8).

etm dosieroj

Agordaj dosieroj

La dosierujo ‘~/.etm’ kaj la sekvaj dosieroj estas kreataj la unuan fojon oni funkciigas e.py.

~/.etm/etmrc:
Ĉiuj agordoj troviĝas en tiu ĉi dosiero. Ĝi estos kreita aŭtomate se ĝi ankoraŭ ne ekzistas, kaj provizita kun aprioraj valoroj. Tiu ĉi agorda dosiero estas mem-priskribita kaj povas esti libere redaktata. Se oni faros ŝanĝojn kiuj ne plaĉas, oni povas simple forigi la malbonvenan parton aŭ la tutan dosieron kaj ĝi estos rekreita kun aprioraĵojn la sekvan ekfunkciigon de e.py.
~/.etm/etmdata/:
Projektodosieroj estas, apriore, konservataj en tiu ĉi dosierujo kaj ĝiaj subdosierujoj, kvankam oni povas tion ŝanĝi en ‘~/.etm/rc’. Ĝi estas aŭtomate kreata kaj provizata per cirkuladaj projektodosieroj por okazaĵoj kaj taskoj por la antaŭa kaj aktuala monatoj kion priskribas parto Monataj datumdosieroj.
~/.etm/export/:
Views exported in iCal or CSV format are, by default, kept in this directory.

Dosieroj de kompletigolistoj

Dum enigo de elementoopcioj en detala panelo de grafika fasado, funkcias kompletigo por kunteksto, ŝlosilvortoj kaj loko, per premo de Str-Spacetoklaco. Ekzemple, se oni kreas aŭ redaktas la okazaĵon

* mia okazaĵo @c e| @d tue

kaj premas Str-Specetklavon kaj la kursoro troviĝas en loko indikata per ‘|’, tiam oni povas elekti kuntekston el listo de tiuj, kiuj komenciĝas per ‘e’. Kiu kunteksto apartenas al tiu ĉi listo, dependas de enhavo de ‘context.txt’ dosiero kaj ĉu ‘addFileContext’ estas ‘True’ aŭ ‘False’.

~/.etm/contexts.txt

Kuntekstoj aldonitaj al tiu ĉi dosiero, po unu en linio, estos elekteblaj dum Str-Spacetklavo kompletigo. Se ‘addFileContexts = True’, la kuntekstoj jam uzataj en la datumdosiero estos ankaŭ disponeblaj por Str-Spacetklavo kompletigo.

~/.etm/keywords.txt

Ŝlosilvortoj aldonitaj al tiu ĉi dosiero, po unu en linio, estos elekteblaj dum Str-Spacetklavo kompletigo. Se ‘addFileKeywords = True’, la slosilvortoj jam uzataj en la datumdosiero estos ankaŭ disponeblaj por Str-Spacetklavo kompletigo.

~/.etm/locations.txt

Lokoj aldonitaj al tiu ĉi dosiero, po unu en linio, estos elekteblaj dum Str-Spacetklavo kompletigo. Se ‘addFileLocations = True’, la lokoj jam uzataj en la datumdosiero estos ankaŭ disponeblaj por Str-Spacetklavo kompletigo.

Mallongigoj

Se la dosiero difinita per ‘abbreviationsFile’ in etmrc estas platteksta dosiero kun unu po mallongigo en linio, en formo “X|Y” kie X estas litercifera teksto sen spacetoj (la mallongigo) kaj Y estas la anstataŭiga teksto. Apero de ”:X:” en etm ago, okazaĵo, noto aŭ tasko estos anstataŭigita per “Y”, ekzemple, se abbreviations.txt enhavas la linion “chtc|Chapel Hill Tennis Club” tiam ”:chtc:” en okzaĵo fariĝus “Chapel Hill Tennis Club”.

Monataj datumdosieroj

Ofte estos konvene krei projektodosieron por havi kolekton de iuteme rilataj elementoj en facile kontrolebla formo de etato. Ofte, tamen, oni kreas elementojn kiuj estas sendependaj unu de alia. Estas neniu bezono krei apartan projektodosieron por tiaj cirkonstancoj. etm aŭtomate kreas dosierojn kiujn oni povas uzi por tiaj sendependaj elementoj.

Supozu ke aktuale estas julio 2011. Tiam etm aŭtomate kreas 07_actns.text en la 2011 subdosierujo de la vojo por ‘etmActions’ la unuan fojon ĝi estas funkciigita. Apriore, agoj kreaitaj dum julio estos skribitaj en tiun dosieron. Similaj dosieroj estos aŭtomate kreataj kaj iĝos aprioraj dum la sekvaj monatoj kaj jaroj venos. Simile okazos por okazaĵoj, notoj kaj taskoj.

Se oni volas forigi malnovajn enigoj, oni povas, certe, forigi la dosieron aŭ dosierujon, aŭ simple ŝanĝi nomon de la dosiero aŭ dosierujo al komenciĝanta poer ‘.’ (punkto) kaj, kiel kaŝitan dosieron, etm malatentus ĝin. Duaflanke, oni povas utiligi valorojn de ‘year_beg’ kaj ‘year_end’ en la etmrc dosiero por kontroli kiujn elementojn etm montru. Etm ĉiam procezas ĉiujn, nekaŝitajn *.text dosierojn de siaj datenaj dosierujoj. Sed ĝi ŝargas (enmemorigas) (1) nefiksitajn elementojn, (2) fiksitajn elementojn kun aperoj (datoj) inter 1-a de januaro de la jaro kiu estas ‘year_beg’ (apriore 1) jaroj antaŭ la kuranta jaro kaj 31-a de decembro de la jaro kiu estas ‘year_end’ (apriore 5) jaroj post la kuranta jaro, kaj por fiksitaj elementoj sen aperoj en tiu ĉi periodo, (3) la unua apero post kaj la lasta apero antaŭ tiu ĉi periodo. Tiel almenaŭ unufoja apero de ĉio estas atingebla, sed ripetoj estas limigitaj laŭ la difinita periodo.

Cirkulado de sekurkopioj

Sekurkopio de dosiero estas kreata antaŭ ĉiu ago de etm kiu povus ĝin ŝanĝi. Ekzemple antaŭ tasko en 02_tasks.text estus signita kiel finita, la dosiero unue estus kopiita en .02_tasks.bk1. Se .02_tasks.bk1 jam ekzistus, ĝi unue estus kopiita en .02_tasks.bk2. Simile, se .02_tasks.bk2 jam ekzistus, ĝi unue estus kopiita en .02_tasks.bk3 kaj tiel plu. Tiel, ĝis numbaks (3 apriore) cirkulantaj sekurkopioj estas konservitaj, kun plej lasta .bk1.

Protokolaj dosieroj

Ĉiu ago de etm ŝanĝanta datumdosieron, estas protokolata. Ekzemple, aldonante novan taskon al 07_evnts.text aldonus tempomarkitan enskribigon en 07_evnts.log:

### 2011-07-21 10:37:38 ###
[+] * Mendi bonŝancan tagmanĝon por kluba trofeo @d 2011-08-14 @s (6:30p) @e +3:00

Klavkombinoj

Ĝeneralaj

spaceto Grupigi laŭ jaro, monato kaj tago kombine kun nenio malatentita kaj kun la aktuala dato elektita.
eskapa klavo nuligi la aktualan agon kaj/aŭ vakigi la aktualan elekton kaj detalpanelon.
F1 Malfermi la helpofenestron. Tiu ĉi paĝo, Trarigardo estas la unua langeto.
F2 Vidigi etm ‘pri’ informon.
F3 Kontroli akireblecon de pli nova versio de etm.
F4 Vidigi 12-monatan kalendaron.
F5 Malfermi dato-kalkulilon.
F6 Vidigi informon pri loka vetero.
F7 Vidigi lokan informon pri suno kaj luno.
. (punkto) Ŝanĝi fokuson al la monata kalendaro.
, (komo) Ŝanĝi fokuson al la skizpanelo.
a starti novan agon aŭ baskuli tempumilon por la daŭranta ago.
A Se la aga tempumilo funkcias aŭ paŭzas, inviti por ŝanĝoj kaj registi la agon. Alikaze, krei novan agon sen uzo de la tempumilo.
b agordi raporton pri okupiteco.
c krei novan elementon uzante klonon de la aktuale elektita.
d forigi la aktuale elektitan elementon.
e krei novan eventon.
f marki la aktuale elktitan elementon kiel finita.
g se la aktuale elektita elemento enhavas @g (iri al) ligilon, tiam malfermi ĝin uzante la kutiman aplikacion de la sistema amstrumilo.
j iri al (svage analizita) dato kaj igi ĝin la aktuala.
m movi la aktuale elektitan elementon al alia projektodosiero.
n krei novan noton.
o agordi skizpanelon.
p malfermi la aktuale elektitan projekton uzante redaktilon difinitan en etm rc dosiero.
P krei novan projekton.
q Montri statuson de la liston de hodiaŭaj alrmoj.
t krei novan taskon.
u malfinigu la aktuale elektitan elementon.
Stir-q ĉesi funkciadon de etm.
Stir-s komenci uskleco ne usklecoblindan, regulespriman serĉadon de elementoj kiuj kongruas kun la provizita esprimo (datoj ne gravas).
0-9 agordi skizpanolon aŭ panelon de okupita tempo uzante elementoj de 0 ĝis 9 de display_shortcuts en etmrc.

Skizpanelo

Hejmen Elekti la unuan elementon en la skizo.
Finen Elekti la lastan elementon en la skizo.
PĝSup Rulumi la skizon supren je unu paĝo.
PĝSub Rulumi la skizon malsupren je unu paĝo.
Supren Supren (sagoklavo) Sen stirklavoj: Elekti antaŭan elementon. Ŝovklavo: Elekti antaŭan parencon. Stirklavo: Elekti la unuan parencon. *Ŝov kaj Stirklavoj: Elekti la unuan elementon.
Malsupren Malsupren (sagoklavo) Sen stirklavoj: Elekti sekvan elementon. Ŝovklavo: Elekti sekvan parencon. Stirklavo: Elekti la lastan parencon. Ŝov kaj Stirklavoj: Elekti la lastan elementon.
Maldesktren Maldekstren (sagoklavo) Sen stirklavoj: Elekti patran elementon. Ŝovklavo: Faldi la aktualan elementon kaj elekti la patran. Stirklavo: Elekti patran elementon kaj faldi ĝin. Ŝov kaj Stirklavoj: Faldi ĉiujn branĉojn rikure kaj tiam elekti praelementon.
Dekstren Dekstren (sagoklavo) Sen stirklavoj: Elekti la unuan idon. Ŝovklavo: Elekti la unuan idon kaj tiam malfaldi ĝin rikure. Stirklavo: Malfaldi la aktualan elementon rikure kaj tiam elekti la unuan idon. Ŝov kaj Stirklavoj: Malfaldi ĉiujn branĉojn rikure kaj tiam elekti la unan idon.
Stir-P presi Malfermi antaŭrigardon de elekto por preso. Se nenio estas elektita, tiam antaŭrigardi la tutan skizon. (Premante eskapoklavon en la skizpanelo oni nuligas la elekton.) Se branĉo estas elektita, tiam antaŭrigardi la branĉon. En ambaŭ kazoj malatenti falditajn partojn de la skizo. Fine, se elemento estas elektita, tiam antaŭrigardi ambaŭ la titolon kaj ĝiajn detalojn.
Stir-V vCal en tondejon Eksporti la elekton en vCal formato en la sisteman tondejon. Se nenio estas elektita, tiam eksporti la tutan skizon. Se branćo estas elektita, tiam eksporti elementojn de la branĉo. En ambaŭ kazoj malatenti partojn de la skizo kiuj estas falditaj. Finne, se elemento estas elektita, tiam eksporti nun la unuopan elementon.
Stir-F vCal en dosieron Ekspori la elekton en vCal formato en dosieron ‘export.ics’ en la dosierujo difinitan per ‘export’ en la etmrc dosiero. Se nenio estas elektita, tiam eksporti la tutan skizon. Se branćo estas elektita, tiam eksporti elementojn de la branĉo. En ambaŭ kazoj malatenti partojn de la skizo kiuj estas falditaj. Finne, se elemento estas elektita, tiam eksporti nun la unuopan elementon.
Stir-Y kopii en tondejon Kopii la elekton en la sisteman tondejon. Se nenio estas elektita, tiam kopii la tutan skizon. Se branĉo estas elektita, tiam kopii elementojn de la branĉo. En ambaŭ kazoj malatenti falditajn partojn de la skizo. Fine, se elemento estas elektita, tiam kopii ambaŭ la titolon kaj ĝiajn detalojn.
Enigklavo (kun elektita elemento aŭ duoble musklakanta elementon) Malfermi la elementon por redakti en detalpanelo.

Detalpanelo

Ŝov-Enigo prozecigi la elementon.
Eskapoklavo nuligi enigon (kun konfirmo)
Stir-Tab elekti kompletigon de la aktuala areo aŭ elementoopcio de listo de kongruaj elementoj.
Stir-Spaceto same kiel Stir-Tab

Krome, integritaj klavkombinoj por la ‘stylized text control’ (wx.stc) de http://www.yellowbrain.com/stc/keymap.html:

Suben Movas kursoron unu linion suben
Ŝov-Suben Movas kursoron unu linion suben etendigante elektaĵon ĝis la nova pozicio de la kursoro
Stir-Suben Rulumas la dokumenton suben
Supren Movas kursoron unu linion supren
Ŝov-Supren Movas kursoron unu linion supren etendigante elektaĵon ĝis la nova pozicio de la kursoro
Stir-Supren Rulumas la dokumenton supren
Maldekstren Movas kursoron unu signon maldekstren
Ŝov-Maldekstren Movas kursoron unu signon maldekstren etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Stir-Maldekstren Movas kursoron unu vorton maldekstren
Stir-Ŝov-Maldekstren Movas kursoron unu vorton maldekstren etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Alt-Maldekstren Movas kursoron ĝis la antaŭa ŝanĝo de uskleco
Alt-Ŝov-Maldekstren Movas kursoron ĝis la antaŭa ŝanĝo de uskleco etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Dekstren Movas kursoron unu signon dekstren
Ŝov-Dekstren Movas kursoron unu signon dekstren etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Stir-Dekstren Movas kursoron unu vorton dekstren
Stir-Ŝov-Dekstren Movas kursoron unu vorton dekstren etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Alt-Dekstren Movas kursoron ĝis la sekva ŝanĝo de uskleco
Alt-Ŝov-Dekstren Movas kursoron ĝis la sekva ŝanĝo de uskleco etendiĝante elektaĵon ĝis la nova pozicio de la kursoro.
Hejmen Movas kursoron al la unua videbla signo de linio. Se jam troviĝas tie - movas kursoron al la unua signo de la linio
Ŝov-Hejmen Kiel HEJMEN sed etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Stir-Hejmen Movas kursoron al la unua pozicio de la dokumento
Stir-Ŝov-Hejmen Movas kursoron al la unua pozicio de la dokumento etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Alt-Hejmen Movas kursoron al la unua pozicio de vidigata linio
Alt-Ŝov-Hejmen Movas kursoron al la unua pozicio de vidigata linio etendiĝante elektaĵon ĝis la nova pozicio de la kursoro.
Finen Movas kursoron al la lasta pozicio de vidigata linio
Ŝov-Finen Movas kursoron al la unua pozicio de vidigata linio etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Stir-Finen Movas kursoron al la lasta pozicio de la dokumento
Stir-Ŝov-Finen Movas kursoron al la lasta pozicio de la dokumento etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Alt-Finen Movas kursoron al la lasta pozicio de la vidigata linio
Alt-Ŝov-Finen Movas kursoron al la lasta pozicio de vidigata linio etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Antaŭa Movas kursoron unu paĝon supren
Ŝov-Antaŭa Movas kursoron unu paĝon supren etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Sekva Movas kursoron unu paĝon suben
Ŝov-Sekva Movas kursoron unu paĝon suben etendiĝante elektaĵon ĝis la nova pozicio de la kursoro
Forigi Forigas la tutan tekston de la dokumento
Ŝov-Forigi Tondas la elektaĵon en la tondujon
Stir-Forigi Forigas vorton dekstre de la kursoro
Stir-Ŝov-Forigi Forigas ĉion de la kursoro ĝis fino de la linio
Enigo Baskulas inter anstataŭiga kaj enmeta skriboreĝimoj
Ŝov-Enigo Algluas enhavon de la tondujo en la dokumenton anstataŭigante elektaĵon
Stir-Enigo Kopias la elektaĵon en la tondujon
Reen Forigas la elektaĵon, kaj sen elektaĵo forigas signon antaŭ la kursoro
Ŝov-Reen Forigas la elektaĵon, kaj sen elektaĵo forigas signon antaŭ la kursoro
Stir-Reen Forigas vorton antaŭ la kursoro
Alt-Reen Malfaras la lastan agon de la malfara historio
Stir-Ŝov-Reen Forigas ĉion de la kursoro ĝis komenco de la linio
Stir-Z Malfaras la lastan agon de la malfara historio
Stir-Z Refaras la sekvan agon de la malfara historio
Stir-X Tondas elektaĵon en la tondujon
Stir-C Kopias la elektaĵon en la tondujon
Stir-V Algluas enhavon de la tondujo en la dokumenton anstataŭigante la elektaĵon
Stir-A Elektas tutan tekston de la dokumento
Tab Se nenio estas elektita aŭ elektita estas nur unu linio, anstataŭas la elektaĵon per tabosigno. Se pli ol unu linio estas elektita, deŝovas la liniojn.
Ŝov-Tab Maldeŝovas la elektitajn liniojn
Enigo Enigas novan linion, povas uzi CRLF, CR aŭ LF depende de EOL reĝimo
Stir-Aldoni Pligrandigas la tekston je 1 grado
Stir-Subtrahi Malpligrandigas la tekston je 1 grado
Stir-Dividi Agordas normalan grandecon de la teksto. Ĝi revenas al ‘normala’, t.e. sen (mal)pligrandigo.
Stir-L Eltondas la aktualan linion
Stir-Ŝov-L Forigas la aktualan linion
Stir-T Anstataŭas la aktualan linion per la antaŭa
Stir-U Minuskligas la elektaĵon
Stir-Ŝov-U Majuskligas la elektaĵon

Licenco

Kopirajto (c) 2009-2011 Daniel Graham <daniel.graham@duke.edu>. Ĉiuj rajtoj rezervitaj.

Tiu ĉi programo estas libera; kopii ĝin aŭ ŝanĝi ĝin laŭ la GNU Ĝenerala Publika Permesilo (GPL) as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

http://www.gnu.org/licenses/gpl.html

Tiu ĉi programo estas disdonita kun la espero, ke ĝi utilos, tamen SEN IU AJN GARANTIO; sen eĉ la implicita garantio de KOMERCEBLECO aŭ TAŬGECO POR APARTA CELO. Vidu la GNU Ĝeneralan Publikan Permesilon por pliaj detaloj.