Kapitel 2. Dateiformat

Eine Tagebuchdatei ist eine einfache Klartextdatei. Leere Zeilen oder solche die mit zwei Bindestrichen („-“) beginnen, werden als Kommentar behandelt. Nichtleere Zeilen müssen mit einem Zeitstempel der Form „yyyy.MM.dd-HH:mm:ss“ beginnen, worauf ein oder mehrere Leerzeichen folgen müssen. Nachfolgend kommt eine doppelpunktgetrennte Liste von Kategorien und deren Unterkategorien. Der Zeitstempel zu Beginn der Zeile markiert dabei den Start einer Aktivität der angegebenen Kategorie, wobei jede startende Aktivität die unmittelbar vorangehende beendet. Eine Zeile mit nur einem Zeitstempel ohne Kategorie beendet einfach die vorangehende Aktivität, ohne eine neue zu beginnen. Kommentare zwischen dem Start und dem Ende einer Aktivität werden mit dieser assoziiert (stehen aber nicht im Zugriff über das GUI). Sie werden Ihre Position beim Speichern behalten. Aktivitäten müssen in der Datei durch ihren Startzeitpunkt sortiert vorliegen. Neue Aktivitäten werden vor allfälligen Kommentaren am Schluss der Datei eingefügt.

Ein Beispiel mag dies illustrieren:

-- FILE ---------------------------------------------------------------------
-- name       : work-boarderzone.diary
-- project    : BoarderZone: Development Environment
-- created    : Leon Poyyayil - 2004-01-25
-- language   : English
-- environment: the human readers mind ... ;-)
-- copyright  : (c) 1990-2024 by Leon Poyyayil (private), Switzerland
-- license    : this is free software licensed under the GPL. see COPYING
-----------------------------------------------------------------------------

-- log of the working hours spent in the boarderzone.net project

-----------------------------------------------------------------------------
-- timestamp          short job description
-----------------------------------------------------------------------------
2005.07.01-22:32:25   tool: FileBrowser: plugin architecture
2005.07.02-04:35:11   tool: FileBrowser: basic plugins
2005.07.02-08:37:08
2005.07.06-22:03:10   tool: FileBrowser: basic plugins
2005.07.07-00:43:22   admin: build: 225
2005.07.07-01:12:18

-- EOF ----------------------------------------------------------------------