Dirks Logbuch

German text below. / Deutscher Text weiter unten.

This new part of my mini series about Taskwarrior is about recurring tasks and priorities.

- Installation and basic operation
- Dates, dateformat, due dates and wait dates

Task supports currently up to three (four) priorities High, Medium and Low (and none), you can set them by adding a "pri:h" or "pri:m" or "pri:l" or "pri:" to your task.

This affects the display of your task list, higher priority tasks are appearing first if due dates are the same. As ever, you can change this behaviour by editing your config file. If you complete a task and you have higher priotity ones, you see a nag message, which can be configured in the config file as well.

Please check all lines containing "pri" in upper or lower case in your .taskrc.

Recurring tasks are a good possibility to organise repeating duties.

Example:

task add pri:h due:eom recur:monthly pay rent

This adds a high priority "pay rent" task which will be repeated every end-of-month. In fact it adds two (!) tasks, one is invisible and contains the "meta-data" of the task you are creating. And another one which is the due task to be done. If you try to remove the current due task you will be asked if you want to delete the due task and later on, if you want to delete the "master task" as well (this only happens, if you finished the recurring task at last one time).

task recurring

Shows all recurring tasks in one view.

The general command is

task add recur:frequency until:enddate

From the man-page:
due:due-date
Specifies the due-date of a task.
recur:frequency
Specifies the frequency of a recurrence of a task.
until:end-date-of-recurrence
Specifies the Recurrence end-date of a task.

Frequencies:
daily, day, 1d, 2d, ...
Every day or a number of days.
weekdays
Mondays, Tuesdays, Wednesdays, Thursdays, Fridays and skipping weekend days.
weekly, 1w, 2w, ...
Every week or a number of weeks.
biweekly, fortnight
Every two weeks.
quarterly, 1q, 2q, ...
Every three months, a quarter, or a number of quarters.
semiannual
Every six months.
annual, yearly, 1y, 2y, ...
Every year or a number of years.
biannual, biyearly, 2y
Every two years.

To be continued ...

Deutscher Text. / German text.

Dieser neue Teil meiner Miniserie über Taskwarrior handelt von sich wiederholenden Aufgaben und Prioritäten.

- Installation und einfache Aufgaben
- Datum, Datumsformat, Zieltermine und Wartedatum

Task unterstützt bis zu drei (vier) Prioritäten Hoch, Mittel, Niedrig (und keine), Ihr könnt durch Hinzufügen von "pri:h" oder "pri:m" oder "pri:l" oder "pri:" zur Aufgabe setzen.

Das beeinflusst die Darstellung der Aufgabenliste, höher priorisierte Aufgaben erscheinen zuerst, wenn die Fälligkeitsdaten die gleichen sind. Wie immer, so kann auch dass durch Veränderung der Konfigurationsdatei geändert werden. Wenn eine Aufgabe erledigt wird und höher priorisierte Aufgaben vorhanden sind, gibt es eine nervende Nachricht ("nag message"), die auch konfiguriert werden kann.

Bitte prüft einmal alle Zeilen in der .taskrc, die "pri" in Gross- oder Kleinschreibung enthalten.

Sich wiederholende Aufgaben sind eine gute Möglichkeit, wiederkehrende Tätigkeiten zu organisieren.

Beispiel:

task add pri:h due:eom recur:monthly Miete zahlen

Das fügt eine neue "Miete zahlen"-Aufgabe mit hoher Priorität hinzu, die an jedem Monatsende (eom = end-of-month) wiederholt wird. Tatsächlich werden aber zwei (!) Aufgaben hinzugefügt. Eine ist unsichtbar und enthält die Rahmendaten der erzeugten Aufgabe. Eine weitere Aufgabe ist die terminierte Aufgabe, die zu erledigen ist. Wenn Du die Aufgabe löschen willst, wirst Du gefragt, ob Du die Aufgabe mit den Rahmendaten auch löschen möchtest (das passiert aber erst, wenn wenigstens eine Wiederholung erledigt worden ist).

task recurring

zeigt alle sich wiederholenden Aufgaben.

Das generelle Kommando ist

task add recur:frequency until:enddate

Aus der man-page (Handbuch-Seite):

due:due-date
Spezifiziert das Fälligkeitsdatum der Aufgabe.
recur:frequency
Spezifiziert die Wiederholungs-Frequenz der Aufgabe.
until:end-date-of-recurrence
Spezifiziert das Enddatum der Wiederholungen.

Frequenzen:
daily, day, 1d, 2d, ...
Jeden Tag oder alle Anzahl von Tagen.
weekdays
Montags, Dienstags, Mittwochs, Donnerstags, Freitags, Wochenende wird übersprungen.
weekly, 1w, 2w, ...
Wöchentlich oder alle Anzahl von Wochen.
biweekly, fortnight
Alle zwei Wochen.
quarterly, 1q, 2q, ...
Alle drei Monate oder alle Anzahl von Quartalen.
semiannual
Alle sechs Monate.
annual, yearly, 1y, 2y, ...
Jährlich oder alle Anzahl von Jahren.
biannual, biyearly, 2y
Alle zwei Jahre.

Fortsetzung folgt ...

German text below. / Deutscher Text weiter unten.

The next part of my mini series about Taskwarrior is about dates, dateformat, due dates and wait dates.

Previous part

The standard date format is m/d/Y. That means the following:

m minimal-digit month, for example 1 or 12
d minimal-digit day, for example 1 or 30
y two-digit year, for example 09
D two-digit day, for example 01 or 30
M two-digit month, for example 01 or 12
Y four-digit year, for example 2009
a short name of weekday, for example Mon or Wed
A long name of weekday, for example Monday or Wednesday
b short name of month, for example Jan or Aug
B long name of month, for example January or August
V weeknumber, for example 03 or 37
H two-digit hour, for example 03 or 11
N two-digit minutes, for example 05 or 42
S two-digit seconds, for example 07 or 47

And, you guess it, it is configurable. Since I am not familiar with the American way of printing dates, I modified the dateformat for everything to YMD. This can be done in ~/.taskrc

$ grep ^dateformat ~/.taskrc

dateformat=YMD                         # Preferred input and display date format

dateformat.holiday=YMD                 # Preferred input date format for holidays

dateformat.report=YMD                  # Preferred display date format for reports

dateformat.annotation=YMD-HN                   # Preferred display date format for annotations

With this in mind, you can set dates to your tasks. "due" manages the due date of your task, "wait" edits a task to not show up in lists before that specific day.

task shell # makes it a lot easier since you do not need to type the word "task" before any command

task> add Pay rent

Created task 1

task> list



ID Project Pri Due Active Age    Description

 1                        8 secs Pay rent



1 task

task> 1  due:20100731

Modified 1 task

task> list



ID Project Pri Due      Active Age   Description

 1             20100731        1 min Pay rent



1 task

task> quit

Did you notice that the color changed?

I want to do that task tomorrow and I do not want to be bothered with seeing it before tomorrow.

task> 1 wait:20100729

Modified 1 task

task> list

No matches.

Apart from using abolut dates, you can use relative ones as well.

task ... due:today
task ... due:yesterday
task ... due:tomorrow
task ... due:23rd # next occuring 23rd
task ... due:eow # end of week
task ... due:eom # end of month
task ... due:eoy # end of year
task ... due:fri # next occuring Friday
task ... due:wed # next occuring Wednesday (not today!)

The next version of taskwarrior will have the "start of" commands as well.

With this very basic knowledge you can already do a lot of work, I will talk/write about recurring tasks later on.

task add due:20100731 wait:20100724 Pay rent

task add due:20100831 wait:20100824 Pay rent

task add due:20101225 wait:eom Buy christmas presents

To be continued ...

Deutscher Text. / German text.

In diesem zweiten Teil über Taskwarrior geht es um Daten (Termine), Datumsformate, Zieltermine und Wartetermin.

Letzte Episode

Das Standard-Datumsformat ist m/d/Y, was das folgende bedeutet:

m minimale Ziffern für den Monat, beispielsweise 1 oder 12
d minimale Ziffern für den Tag, beispielsweise 1 or 30
y zwei Ziffern für das Jahr, beispielsweise 09
D zwei Ziffern für den Tag, beispielsweise 01 oder 30
M zwei Ziffern für den Monat, beispielsweise 01 oder 12
Y four-digit year, beispielsweise 2009
a Kurzname des Wochentags in englischer Sprache, beispielsweise Mon oder Wed
A Langname des Wochentags in englischer Sprache, beispielsweise Monday oder Wednesday
b Kurzname des Monats (Englisch), beispielsweise Jan oder Aug
B Langname des Monats (Englisch), beispielsweise January oder August
V Wochennummer, beispielsweise 03 oder 37
H die Stunde mit zwei Ziffern, beispielsweise 03 oder 11
N die Minute mit zwei Ziffern, beispielsweise 05 oder 42
S die Sekunde mit zwei Ziffern, beispielsweise 07 oder 47

Und, wie Ihr wahrscheinlich vermutet, ist das konfigurierbar. Da ich mit dem amerikanischen Datumsformat nichts anfangen kann, habe ich es auf YMD gesetzt (D.M.Y) wäre auch möglich. Das kann in der Datei ~/.taskrc eingestellt werden.

$ grep ^dateformat ~/.taskrc

dateformat=YMD                         # präferiertes Ein- und Ausgabedatumsformat

dateformat.holiday=YMD                 # Bevorzugtes Eingabedatumsformat für Urlaub und Feiertage

dateformat.report=YMD                  # Bevorzugtes Ausgabedatumsformat für Reports

dateformat.annotation=YMD-HN                   # Bevorzugtes Ausgabedatumsformat für Anmerkungen

Mit dem im Hinterkopf könnt Ihr Daten an Eure Aufgaben hängen. "due" für Zieltermine, "wait" für Wartezeiten bis zu dem die Aufgabe in den Übersichten ausgeblendet wird.

task shell # das macht es ein bisschen einfacher, da braucht man nicht mehr "task" vor jedem Kommando zu tippen

task> add Miete zahlen

Created task 1

task> list



ID Project Pri Due Active Age    Description

 1                        8 secs Miete zahlen



1 task

task> 1  due:20100731

Modified 1 task

task> list



ID Project Pri Due      Active Age   Description

 1             20100731        1 min Miete zahlen



1 task

task> quit

Habt Ihr gesehen, dass sich die Farbe geändert hat?

Ich möchte die Aufgabe morgen erledigen und heute nicht mehr in meiner Liste haben.

task> 1 wait:20100729

Modified 1 task

task> list

No matches.

Losgelöst von absoluten Datumsangaben können auch relative verwendet werden (immer in englischer Sprache)

task ... due:today # Heute
task ... due:yesterday # Gestern
task ... due:tomorrow # Morgen
task ... due:23rd # der nächste 23te
task ... due:eow # Ende der Woche
task ... due:eom # Ende des Monats
task ... due:eoy # Ende des Jahres
task ... due:fri # der nächste Freitag
task ... due:wed # der nächste Mittwoch (nicht heute!)

In der nächsten Version von Taskwarrior wird es auch die "start of" Daten geben (sow, som, soy).

Mit dem bis jetzt erreichten Basiswissen, kann bereits eine grosse Menge an Arbeit erledigt werden. Über wiederkehrende Aufgaben schreibe ich später.

task add due:20100731 wait:20100724 Miete zahlen

task add due:20100831 wait:20100824 Miete zahlen

task add due:20101225 wait:eom Weihnachtsgeschenke kaufen

Fortsetzung folgt ...

German text below. / Deutscher Text weiter unten.

With this series of articles I want to introduce Taskwarrior, a command line tool for task management.

The reasons for my decision to use Takswarrior are quite simple:
• It is easy to learn.
• It is unbelievable powerful.
• It is platform independent (I use it on Windows and Ubuntu, via ssh even from my smartphone)
• It has an active development.
• I can influence the project by making suggestions.
• An Ubuntu personal package archive (PPA) exists.
• I know Federico, who showed some of the possibilities at German Ubucon 2009.

Installation:

On Ubuntu 9.04 or newer:
On older versions:
On Windows (using Cygwin):
Install gcc, make, ncurses, libncurses, libncurses-devel with the graphical setup tool. Update: Meanwhile you can find the recent version in the graphical setup tool.
Further possibilities are explained on the download page.

Do a quick check:

Comments are very welcome, consider contributing to Taskwarrior as well.

... to be continued.

German text. / Deutscher Text.

Mit dieser kleinen Artikelreihe möchte ich gerne Taskwarrior, ein Kommandozeilenwerkzeug zur Aufgabenverwaltung vorstellen.

Die Gründe für meine Entscheidung, Taskwarrior zu nutzen, sind relativ einfach:
• Es ist leicht zu erlernen.
• Es ist unglaublich mächtig.
• Es ist plattformübergreifend (Ich nutze es unter Windows und Ubuntu, via ssh sogar von meinem Smartphone)
• Es wird aktiv weiterentwickelt.
• Ich kann das Projekt durch eigene Vorschläge beeinflussen.
• Es gibt ein Ubuntu personal package archive (PPA).
• Ich kenne Federico, der ein paar Möglichkeiten auf der deutschen Ubucon 2009 vorgestellt hat.

Installation:

Unter Ubuntu 9.04 oder neuer:
Unter älteren Versionen:
Unter Windows (mit Cygwin):
Installiert gcc, make, ncurses, libncurses, libncurses-devel mit dem grafischen Setup Tool. Update: Mittlerweile ist die aktuelle Version auch mit dem grafischen Setup Tool installierbar.
Weitere Möglichkeiten sind auf der Download-Seite beschrieben.

Eine kleine Überprüfung:

Kommentare sind willkommen, überlegt Euch ob Ihr das Projekt unterstützen wollt.

Fortsetzung folgt ...