Handbuch für TreeLine

ein Informationsverwaltungsprogramm

von Doug Bell
Version 1.0.2
1 Juni 2007

Inhalt

Hintergrund
Features
Rechtliches
System-Anforderungen
    Linux
    Windows
Installation
    Linux
    Windows
TreeLine benutzen
Liste der Änderungen
Fragen, Kommentare, Kritik?

Hintergrund

Haben Sie auch Dutzende von Post-Its herumliegen, auf denen mehr oder weniger wichtige Informationen hingekritzelt sind? Oder verschiedenste Listen von Büchern, Filmen, Lesezeichen, Login-Daten, Adressen oder Aufgaben, die zu erledigen sind? Finden Sie sie, wenn Sie sie brauchen? Ich konnte das meistens nicht. Hier ist meine Antwort auf das Problem.

Einige würden TreeLine einen "Outliner" nennen, andere einen PIM ("Personal Information Manager"). Auf den Punkt gebracht verwaltet TreeLine fast jede Art von Information. Eine Baumstruktur macht es einfach, Dinge in Ordnung zu halten und wiederzufinden. Und jedes Element im Baum kann mehrere Felder enthalten, so dass sich eine Mini-Datenbank ergibt. Das Ausgabeformat für jedes Element kann frei definiert werden, uns das Ergebnis kann am Bildschirm angezeigt, gedruckt oder auch als Webseite exportiert werden.

Ich bin nicht in der Softwarebranche tätig. Deshalb stelle ich dieses Programm für jeden zur freien Verfügung. Es kann benutzt, weiterverbreitet und verändert werden. Sie dürfen es nur nicht in Programme integrieren, die selbst nicht unter einer freien Lizenz stehen. Wenn Sie diese Software nützlich finden, erzählen Sie es weiter. Und lassen Sie mich wissen, was Sie über TreeLine denken. Im Kapitel Fragen, Kommentare, Kritik? finden Sie, wie Sie mich erreichen können.


Features


Rechtliches

TreeLine ist freie Software; Sie können TreeLine gemäß den Regeln der GNU General Public License in der von der Free Software Foundation veröffentlichten Version 2 oder wahlweise einer beliebigen neueren Version weiterverbreiten.

Dieses Programm wird in der Hoffnung verbreitet, dass es nützlich sein wird, aber OHNE JEDE GARANTIE ODER GEWÄHRLEISTUNG. Beachten Sie die mitgelieferte Lizenzdatei LICENSE, um weitere Informationen zu bekommen.

Als eine besondere Ausnahmeregel erteilt der Autor die Erlaubnis, dieses Programm gegen die "Qt Non-Commercial Edition" zu linken und zu verbreiten, ohne den Quelltext von Qt mitzuliefern.


System-Anforderungen

Linux

TreeLine benötigt die folgenden Bibliotheken und Programme:

Windows


Installation

Linux

Entpacken Sie die Quelldateien aus der TreeLine tar-Datei, z.B. auf der Kommandozeile mit

"tar zvxf treeline.x.x.x.tar.gz"

(Ihre tar-Datei kann einen anderen Namen haben, je nach Version).

Wechseln Sie dann in das Verzeichnis TreeLine und führen Sie als Benutzer root das Kommando

"python install.py"

aus.

"python install.py -h" zeigt Ihnen die verfügbaren Optionen an.

Um TreeLine nicht wie standardmäßig vorgesehen nach /usr/local, sondern an eine andere Stelle zu installieren, verwenden Sie z.B.:

"python install.py -p /ihr/gewünschter/pfad"

Wenn Sie ein größeres Update, z.B. von Version 0.8.x auf 0.9.x, vornehmen oder die neuen Tastatur-Kürzel bearbeiten wollen, sollten Sie die alte Konfigurationsdatei ~/.treeline löschen oder umbenennen.

Um Übersetzungspakete für TreeLine zu installieren, laden Sie sich die "treeline-i18n-..." tar-Datei herunter, die zu Ihrer TreeLine-Installationsdatei passt (die Buchstaben am Ende der Versionsnummer der Übersetzungspakete können Sie ignorieren). Um TreeLine und die Übersetzungen zusammen zu installieren, entpacken Sie das Übersetzungspaket in das selbe Verzeichnis wie TreeLine selbst und installieren Sie dann wie oben beschrieben. Wenn TreeLine bereits installiert sein sollte, entpacken Sie das Übersetzungspaket in ein beliebiges Verzeichnis, wechseln in das Verzeichnis und führen dann das Installationskommando wie oben beschrieben mit den gleichen Optionen aus.

Windows

Die heruntergeladene Datei treeline-x.x.x-install.exe einfach ausführen. TreeLine wird dann installiert, und wahlweise werden auch Dateiverknüpfungen und ein Desktop-Symbol angelegt.

Wenn Sie bereits eine funktionsfähige TreeLine-Installation in der Version 0.7.0 oder besser haben, können Sie ein kleineres Download-Paket verwenden. Auch diese Datei treeline-x.x.x-upgrade.exe können Sie einfach ausführen, um TreeLine auf den neuesten Stand zu bringen.

Um die Rechtschreibprüfung von TreeLine zu benutzen, müssen Sie wie unter System-Anforderungen beschrieben ispell oder aspell installiert haben.

Wenn Sie ein größeres Update, z.B. von Version 0.8.x auf 0.9.x, vornehmen oder die neuen Tastatur-Kürzel bearbeiten wollen, sollten Sie die alte Konfigurationsdatei ~/.treeline löschen oder umbenennen.

Um Übersetzungspakete für TreeLine zu installieren, laden Sie sich die "treeline-i18n-..." exe-Datei herunter, die zu Ihrer TreeLine-Installationsdatei passt (die Buchstaben am Ende der Versionsnummer der Übersetzungspakete können Sie ignorieren). Zur Installation einfach die Datei ausführen.

Wenn Sie selbst die Quelldateien verändern oder Ihre eigenen PyQt-Programme für Windows schreiben wollen, gehen Sie nicht wie oben beschrieben vor, sondern installieren Python ( www.python.org), Qt ( www.trolltech.com) und PyQt ( www.riverbankcomputing.co.uk) jeweils wie dort beschrieben. Dann entpacken Sie die Quelldateien aus der Linux-Version (TreeLine tar-Datei) in ein beliebiges Verzeichnis und führen die Datei treeline.py aus.


TreeLine benutzen


Inhalt

Wir legen los!
    Einführung
    Beispieldateien
Grundlagen
    Ansichten
    Befehle
Navigation im Baum
    Tastatur-Kürzel
    Suchen
Den Baum bearbeiten
Formatierung und Elementtypen
Feldtypen
Verändern der Daten im Baum
Drucken
Umgang mit Dateien
Datei-Import
Datei-Export
    HTML
    Text mit Trennzeichen
    Lesezeichen
    Unspezifisches HTML
    XSLT
Plugins
    Beschreibung
    Installation
    Interface
Geläufige Probleme
    XML-Fehler
    Unicode-Fehler
    Drucken

Wir legen los!

Einführung

TreeLine ist wesentlich komplexer als es auf den ersten Blick aussieht. Deshalb ist es empfehlenswert, einen großen Teil dieses Handbuchs zu lesen, um TreeLine wirklich effektiv nutzen zu können.

Das Kapitel
Grundlagen beschreibt die verschiedenen Ansichten und das Auswählen von Elementen. Die Navigation im Baum auf der linken Bildschirmseite, wird im gleichnamigen Kapitel beschrieben, und das Kapitel Den Baum bearbeiten widmet sich den Bearbeitungsfunktionen im Elementbaum. Im nächsten Schritt lernen Sie, dass TreeLine mehr beherrscht als für jedes Element nur eine einzelne Textzeile anzuzeigen. Wie Sie selbst eigene Datentypen für jedes Datenelement definieren können, erklären die Kapitel Formatierung und Elementtypen und Feldtypen.

Beispieldateien

Verschiedene TreeLine-Beispieldateien können mit dem Menübefehl "Datei->Beispiele" geöffnet werden, die Sie direkt als Formatvorlagen oder als Beispiele für die Erstellung eigener Formate heranziehen können. Darunter sind (nach Schwierigkeit sortiert):


Grundlagen

Ansichten

Das Arbeitsfenster von TreeLine ist in zwei Bereiche aufgeteilt. Auf der linken Seite sieht man die komplette Baumstruktur, während in der rechten Fensterhälfte Informationen über das im Baum ausgewählte Element angezeigt wird.

Über die Reiter unten auf der rechten Fensterhälfte kann man zwischen drei verschiedenen Ansichten umschalten. Die "Ansicht" zeigt den formatierten Text für jedes Element und ist nicht bearbeitbar. Der "Editor" zeigt ein Textfeld für jedes Datenfeld eines Elements. Die "Überschriften-Liste" zeigt eine Liste von Element-Titeln (Überschriften), die wie in einem Text-Editor direkt bearbeitet werden können. Damit lassen sich z.B. sehr schnell Unterobjekte anlegen und dann später in der "Editor"-Ansicht mit Daten füllen.

Standardmäßig zeigt die rechte Fensterhälfte Informationen über das ausgewählte Element im oberen rechten Fensterviertel und Informationen über die Unterelemente ("Kinder") des ausgewählten Elements im unteren rechten Fensterviertel. Im Menü kann das mit "Ansicht->Ausgewähltes Element anzeigen" umgestellt werden. Nun wird nur noch das ausgewählte Element angezeigt. Wenn es sehr viele Unterelemente gibt, wird die kombinierte Ansicht langsam, vor allem in der "Editor"-Ansicht, und sollte am besten vermieden werden. Das Standardverhalten der rechten Fensterhälfte kann unter "Extras->Allgemeine Einstellungen" verändert werden.

Befehle

Die meisten Menü- und Symbolleistenbefehle beziehen sich auf die Elemente, die im Baum ausgewählt sind. In der Regel führen wirken sie sich auf das Element selbst oder seine Unterelemente aus. Mehrere Elemente können gleichzeitig ausgewählt sein. Halten Sie dazu die "Strg"-Taste und die Umschalttaste gedrückt ("Ctrl" und "Shift") und klicken Sie dann mit der Maus auf die gewünschten Elemente. Einige Befehle wie "Datei->Exportieren..." oder "Datei->Drucken..." beziehen sich nur auf das aktuelle Element, das einen gepunkteten Rahmen hat. Auch die Ansicht in der rechten Fensterhälfte bezieht sich immer auf das aktuelle Element.

Um Informationen zu einer neuen TreeLine-Datei hinzuzufügen, benutzen Sie den Befehl "Bearbeiten->Unterelement anlegen". Danach können Sie mit den anderen Einfügebefehlen im Menü "Bearbeiten" weitere Elemente einfügen. Alternativ können neue Unterelemente auch einfach in die "Überschriften-Liste" auf der rechten Seite eingetippt werden.


Navigation im Baum

Tastatur-Kürzel

Es gibt mehrere Tastaturkürzel, mit denen man sich durch die Baumansicht bewegen kann. Sie können die meisten Kürzel in der Konfigurationsdatei anpassen. Im folgenden werden die voreingestellten Tastaturkürzel beschrieben. Mit den Pfeiltasten "nach oben" und "nach unten" wählt man das nächst höhere bzw. niedrigere Element im Baum aus. Hält man dabei die "Strg"-Taste gedrückt, kann man direkt zum nächsten Element auf der gleichen Gliederungsebene springen. Unterelemente werden dann übersprungen. "Strg+U" springt zum Elternelement. Die Tasten "Pos1", "Ende", "Bild aufwärts" und "Bild abwärts" ermöglichen es, sehr schnell an den Anfang oder das Ende des Baums zu gelangen oder sich in großen Schritten durch einen langen Baum zu bewegen. Hält man die Umschalttaste ("Shift") gedrückt, dann kann man sich mit "Bild aufwärts" und "Bild abwärts" durch die Ansicht der Unterelemente im rechten unteren Fensterviertel bewegen.

Falls Sie die Kürzel an Ihre Vorlieben anpassen wollen, können Sie das in der TreeLine-Konfigurationsdatei tun ("~/.treeline" unter Linux, "treeline.ini" unter Windows).

Es gibt noch eine weitere nützliche Methode, um sich im Baum zu bewegen: Stellen Sie sicher, dass Sie sich im Baum befinden, z.B. in dem Sie ein beliebiges Element im Baum mit der Maus anklicken. Tippen Sie dann einfach den Anfangsbuchstaben des Elements ein, zu dem sie gelangen wollen. Wenn Sie z.B. "f" eingeben, springen Sie nach unten zum nächstfolgenden Element, dessen Überschrift mit "f" beginnt. Das lässt sich beliebig oft wiederholen, bis Sie das gesuchte Element erreicht haben. Um sich stattdessen nach oben zu bewegen, halten Sie zusätzlich die Umschalttaste gedrückt.

Suchen

Es gibt zwei Möglichkeiten, Elemente zu suchen. Sie können damit Elemente finden, die tief in der Baumstruktur versteckt liegen. Die erste Möglichkeit ist der Befehl "Extras->Suchen". Sie können damit Suchbegriffe eingeben, nach denen dann in allen Feldern aller Elemente gesucht wird. Die zweite Möglichkeit ist die inkrementelle Suche. Tippen Sie dazu einfach ein "/", gefolgt vom Suchbegriff. Während Sie tippen, springt das ausgewählte Feld jeweils zum nächsten Element, dessen Überschrift mit den bereits eingegebenen Buchstaben beginnt. Die vorausgehende Suche können sie mit "F3" (vorwärts) oder "Umschalttaste+F3" (rückwärts) wiederholen.

Die Voreinstellung ist, dass Suchtreffer, die Unterelemente haben, automatisch aufklappen. Dieses Verhalten können Sie unter "Extras->Allgemeine Einstellungen" abstellen.


Den Baum bearbeiten

Menü "Bearbeiten"

Mit Ausnahme von "Rückgängig" und "Wiederherstellen" beziehen sich die Befehle im Menü "Bearbeiten" auf die im Baum ausgewählten Elemente, bzw. auf den in der rechten Fensterhälfte ausgewählten Text. Beachten Sie, dass in der Regel auch die Unterelemente betroffen sind. Wenn Ein Element kopiert wird, werden z.B. auch alle Unterelemente mit kopiert.

"Einfügen" fügt das kopierte Element als letztes Unterelement des aktiven Elements ein. Mit "Bearbeiten->Text des Elements einfügen" ersetzen Sie nur die Überschrift des aktiven Elements mit der Überschrift des Elements in der Zwischenablage.

Kürzel

Es gibt einige Tricks, die das Bearbeiten im Baum vereinfachen. Sie können z.B. einfach ein Element anwählen und mit gedrückter linker Maustaste ein Element samt Unterelementen verschieben, bzw. es kopieren, wenn Sie zusätzlich die "Strg"-Taste gedrückt halten. Wenn Sie auf ein bereits ausgewähltes Element noch einmal klicken, können Sie es direkt umbenennen. Die "Entf"-Taste löscht das aktive Element, und die "Enter"-Taste fügt nach dem aktiven Element ein neues auf gleicher Ebene ein. Diese beiden Kürzel können unter "Extras->Allgemeine Einstellungen" deaktiviert werden.

Die rechte Fensterhälfte

In der rechten Fensterhälfte bietet die Ansicht "Editor" den direktesten Weg, um die Daten eines Elements zu bearbeiten. Wenn das bearbeitete Feld im Titel benutzt wird, zeigt der Baum sofort die jeweilige Änderung an. Die Felder erlauben die Eingabe von mehrzeiligem Text. Wenn nötig, wird ein Rollbalken angezeigt.

Wenn die Benutzung von HTML freigeschaltet ist (siehe weiter unten im Kapitel
Feldtypen), dann finden sich im Kontextmenü (erreichbar über die rechte Maustaste) unter "Text auszeichnen" Einträge, um HTML-Auszeichnungen wie "fett" oder "kursiv" hinzuzufügen.

Vom Kontextmenü kann auch ein externer Editor aufgerufen werden. Nachdem der Texteditor seine Änderungen gespeicher hat und beendet wurde, erscheint der Text in der Textbox in TreeLine. Der Editor kann mit Hilfe der Umgebungsvariable EDITOR gesetzt werden. Wenn die Variable nicht existiert, fragt TreeLine den Pfad zum gewünschten Editor bei der ersten Benutzung ab.

Die Ansicht "Überschriften-Liste", ebenfalls in der rechten Fensterhälfte, ist nützlich, um schnell die Titel von Unterelementen zu bearbeiten oder neue Unterelemente hinzuzufügen. Sie können natürlich auch eine Liste neuer Elemente direkt in die Überschriften-Liste hineinkopieren.

Rechtschreibprüfung

"Extras->Rechtschreibprüfung" öffnet einen Dialog, der für nicht im Lexikon gefundene Wörter einen Korrekturvorschlag anbietet und abfragt, ob unbekannte Wörter ins Wörterbuch aufgenommen werden sollen. Es wird der Text in allen Feldern aller Elemente geprüft.

Ein externes Programm (aspell oder ispell) muss installiert sein, um die Rechtschreibprüfung einsetzen zu können. Vgl.
System-Anforderungen. Die Standardeinstellung ist, dass das zur derzeitigen Spracheinstellung des Betriebssystems passende Lexikon benutzt wird. Falls Sie aspell benutzen, können Sie aber unter "Extras->Datei-Einstellungen einen anderen zweistelligen Ländercode (z.B. "en" für Englisch) für die geöffnete Datei angeben. Allerdings müssen die nötigen Lexika für aspell auch installiert sein. Auf ispell hat diese Option keinen Effekt.


Formatierung und Elementtypen

Den Typ eines Elements setzen

In der Standardeinstellung hat eine neue TreeLine-Datei zwei Typen von Elementen: "Hauptelement" und "Standard". Der Typ wird oben in der Editor-Ansicht für jedes Element angezeigt. Wie man eigene Elementtypen anlegt und Elementtypen anpasst, wird weiter unten beschrieben.

Um den Typ für ausgewählten Elemente zu ändern, verwenden Sie das Menü "Daten->Datentyp ändern". Mit "Daten->Datentyp für Unterelemente ändern" lassen sich die Datentypen in Unterlementen nach verschiedenen Kriterien ändern (nur direkte Unterelemente, alle Unterlemente, Elemente, die bestimmte Bedingungen erfüllen). Dieser Dialog kann geöffnet bleiben, während Sie weitere Elemente im Baum auswählen.

Der Dialog "Datentypen konfigurieren"

Die Datentypen werden mit dem Dialog "Daten->Datentypen konfigurieren" definiert (vgl. Abbildung 1). Der Typ wird oben im Dialog ausgewählt, und der Knopf "Liste ändern" führt zu den Funktionen zum Hinzufügen, Löschen und Umbenennen der verfügbaren Typen. Auf der linken Seite des Dialogs sind die Felder des gewählten Typs aufgeführt, mit Knöpfen zum Bearbeiten, Löschen und Umstellen der Felder.

Die rechte Hälfte zeigt die Formatierung für den Titel (wie er als Text in der Baumansicht verwendet wird) und das Ausgabeformat. Das Format kann aus beliebigem Text und eingebetteten Feldern bestehen. die Felder werden entweder in der Form "{*field_name*}" eingetragen oder mit den Knöpfen ">>" und "<<" an der letzten Position der Eingabeaufforderung hinzugefügt bzw. gelöscht.

Andere Feldverweise

Im Titel- und Ausgabeformat können auch Felder von Eltern- und Großelternelementen in der Form "{**feldname*}" bzw. "{***feldname*}", sowie "{*?feldname*}" (nächster Verwandter mit passendem Feld) verwendet werden.

Diese Felder können mit dem Knopf "Andere Felder" erzeugt und zur Feldliste hinzugefügt werden.

Auch Unterelemente können vom Dialog "Andere Felder" aus hinzugefügt werden. Die Daten aus dem Unterelement werden in die Ausgabe des Elternelements eingebunden. Standardmäßig werden die Felder dabei mit Kommas getrennt. Unter "Extras->Datei-Einstellungen" kann eine beliebige andere Zeichenkette (z.b. <br/>) angegeben werden.

Außerdem stellt der Dialog "Andere Felder" noch dateibezogene Felder wie Dateiname und Dateigröße zur Verfügung. Ein Beispiel mit dem Namen "sample_other_fields" finden Sie unter dem Menübefehl "Datei->Beispiele".

Formatierung von Überschriften

Wenn ein Element im Baum umbenannt wird, versucht TreeLine, den eingegebenen Titel gemäß dem Titelformat in die jeweiligen Felder des Elements aufzuspalten. Bei besonders komplexen Titelformatdefinitionen funktioniert das nicht immer zuverlässig. Vermeiden Sie beispielsweise zusammenhängende Felder, die nicht durch ein eindeutiges Trennzeichen abgegrenzt sind.

Wenn der eingegebene Text aus mehreren Zeilen besteht, wird nur die erste Zeile als Titel benutzt.

Übersprungene Zeilen

Wenn eine Zeile im Ausgabeformat ein oder mehrere Felder enthält und alle diese Felder für ein Element leer sind, wird die Zeile komplett übersprungen. Es wird auch keine Leerzeile angezeigt. Dies gilt nicht für Zeilen, die in der Formatierung absichtlich als Leerzeilen angelegt wurden und keine Felder enthalten. Außerdem bleiben sowohl <br/> als auch <hr/> am Ende einer übersprungenen Zeile erhalten.

HTML-Auszeichnungen (Tags)

Im Ausgabeformat können einfache HTML-Auszeichnungen benutzt werden, zum Beispiel "<b>fett</b>", "<u>unterstrichen</u>", "Zeilenumbruch<br/>", "<hr/>horizontale Linie" und verschiedene Schriftauszeichnungen. Komplexe verschachtelte Auszeichnungen ("block tags") sollten möglichst vermieden werden. Wenn Sie unter "Extras->Datei-Einstellungen" die Option "Vereinfachtes HTML ("Rich Text") in Formaten erlauben" abwählen, werden alle Auszeichnungen als Text behandelt und angezeigt. Ein Beispiel mit dem Namen "sample_color_items" finden Sie unter dem Menübefehl "Datei->Beispiele".



In den Datei-Einstellungen können Sie auch festlegen, ob nach jeder Formatzeile automatisch ein Zeilenumbruch eingefügt wird und ob Elemente jeweils durch eine Leerzeile getrennt werden. Den selben Effekt können Sie durch ein "<br/>" am Ende des Ausgabeformats erreichen. Alternativ bietet sich auch "<hr/>" an, um die Elemente mit einer horizontalen Linie abzutrennen.

Formatierungsbeispiele

Hier ist ein Formatierungsbeispiel für eine Liste von Büchern:

<hr/>"{*Titel*}"
(c) {*Copyright*}, Bewertung: {*Bewertung*}
{*Zusammenfassung*}

Beispieldateien mit verschiedenen Formatierungen ("sample_*.trl") sind im Verzeichnis "doc" Ihrer TreeLine-Installation zu finden. In SUSE Linux finden Sie diese Dateien unter "/usr/share/doc/packages/treeline". Sie können auch einfach den Menübefehl "Datei->Beispiele" verwenden. Vgl. auch das Kapitel
Beispieldateien

Symbole (Icons)

Die Icons für jedes Element können im Dialog "Daten->Datentypen konfigurieren" mit dem Knopf "Icon ändern" pro Datentyp festgelegt werden. Wenn Sie dort kein Icon auswählen, wird das Element im Baum ohne Icon angezeigt. In den allgemeinen Einstellungen können Sie die Anzeige von Icons im Baum komplett deaktivieren.

Unterelementtypen

Der Dialog "Datentypen konfigurieren" bietet auch eine Einstellung für den Standard-Untertyp. Wenn er eingestellt ist, wird dieser für alle neu angelegten Unterelemente des Elements benutzt. Wenn er nicht eingestellt ist, wird entweder der Typ des Elternelements oder das der Elemente auf gleicher Ebene benutzt.

Weitere Einstellungen

Im Dialog "Datentypen konfigurieren" können Sie unter "Weitere Einstellungen" ein Feld als verknüpfbares Feld festlegen. Dieses Feld wird für interne Verknüpfungen und von den Befehlen "Nach Verweisfeldern arrangieren" und "Nach Verweisfeldern abflachen" benutzt. Standardmäßig ist das erste Feld eines Elements das verknüpfbare Feld.

Sie können außerdem Präfix- und Suffix-Tags angeben. Diese werden selten benötigt, sind aber für Tabellen und Aufzählungen nützlich. Sie werden vor bzw. nach einer Gruppe von Unterelementen des jeweiligen Typs gesetzt. Für eine Tabelle können Sie beispielsweise als Präfix "<table border="1">" und als Suffix "</table>" angeben. Ein mögliches Ausgabeformat für das Element würde dann so aussehen:

<tr><td>"{*Title*}"</td><td>(c) {*Copyright*}</td></tr>

Ein Beispiel finden Sie als "sample_table_booklist" unter dem Menübefehl "Datei->Beispiele".

Elemente einer Ebene sollten in der Regel vom gleichen Typ sein oder zumindest die gleichen Präfix- und Suffix-Tags haben.

Basistypen und abgeleitete Datentypen

Datentypen können so eingestellt werden, dass sie ihre Feldeinstellungen von einem Basistyp beziehen. Das ermöglicht Datentypen mit unterschiedlicher Ausgabeformatierung, die die gleichen Felddaten benutzen. Alle Änderungen der Feldliste und der Feldtypem im Basistyp werden automatisch auch auf dessen abgeleitete Datentypen angewandt, bis auf die Ausgabeformatierung, die unabhängig vom Basistyp eingestellt werden kann.

Es gibt zwei Wege, abgeleitete Datentypen zu erzeugen: Wenn man über den Knopf "Liste ändern" den Dialog "Datentypen hunzufügen/entfernen" aufruft, kann man Datentypen kopieren. Dabei kann man die Option "neuer Dateityp erbt Änderungen vom Original" wählen. Außerdem kann man für einen existierenden Datentyp unter "Weitere Einstellungen..." im Feld "Abgeleitet vom Datentyp" einen Basisytp angeben.

Regelbasierte Dateitypen

Regelbasierte Dateitypen werden verwendet, um basierend auf dem Inhalt eines Elements einen Datentyp automatisch zuzuweisen. Eine Regel kann nur einem Basistyp und seinen zugeordneten abgeleiteten Typen zugewiesen werden. Das erlaubt die Automatische Verwendung von verschiedenen Ausgabeformatierungen und/oder Icons in Abhängigkeit der Felddaten.

Regeln können unter "Weitere Einstellungen..." über den Knopf "Regelbasierte Dateitypen anlegen" angelegt werden. Jede Regel besteht aus einem Feldnamen, einem Operator und einem Vergleichswert (vgl.
Abbildung 2). Beispiele für verfügbare Operatoren sind "ist gleich", "größer als", "kleiner als", "beginnt mit", "endet mit" und "enthält". Außerdem gibt es noch die Operatoren "Wahr" und "Falsch", die den Typ aller Elemente unabhängig vom Inhalt umschalten.

Für spezielle Feldtypen wie Datum, Zeit oder Boolsche Variablen verwenden Sie bitte für den Vergleichswert das gleiche Format wie im Editor-Fenster. Generell sollten Sie die Operatoren "beginnt mit", "endet mit" und "enthält" für solche Felder vermeiden, weil zum Vergleich das interne Datenformat, nicht das sichtbare Format, verwendet wird. Die Typen Datum und Zeit unterstützen zusätzlich den Vergleichswert "now" ("jetzt"), der dem aktuellen Datum und der Uhrzeit entspricht.

Erzeugen Sie weitere Regeln über den Knopf "Regel hinzufügen". Regeln können mit "und" oder "oder" verknüpft werden. "Regel entfernen" entfernt die letzte Regel in der Liste.

Regeln müssen nicht für alle Typen einer Familie gesetzt werden. Falls keine Regel für ein Element erfüllt ist, wird automatisch eine leere Regel ausgewählt.

Ein Beispiel finden Sie unter "Datei->Beispiele..." in der Datei "sample_conditional_todo".

Formate kopieren

Eine andere Methode, die Typfestlegungen zu ändern, besteht darin, die Formate von einer anderen TreeLine-Datei zu kopieren. Dazu gibt es den Dialog "Daten->Datentypen aus Datei übernehmen". Alle Typen aus der ausgewählten Datei werden kopiert. Typen mit gleichen Namen werden überschrieben, aber zusätzliche Typen, die in der Vorlage nicht vorkommen, bleiben in der aktuellen Datei erhalten.


Feldtypen

Feldoptionen

Im Dialog "Datentypen konfigurieren" öffnet der Knopf "Feldtyp" einen Dialog für die Formatierungseinstellungen des ausgewählten Felds. Mögliche Feldtypen sind "Text", "Zahl", "Auswahl", "Kombination (Mehrfachauswahl)", "Auswahl aus allen existierenden Werten (AutoChoice)", "Datum", "Zeit", "Boolsche Variable", "URL", "Pfad", "Interne Verknüpfung", "Ausführbare Verknüpfung", "E-Mail-Adresse" und "Bild". Präfix und Suffix werden angezeigt, sobald ein Feld nicht leer ist.

Je nach gewählter Textformatierung wird das Feld entweder als vereinfachtes HTML oder als Fließtext mit Zeilenumbruch ausgewertet. Im ersten Fall werden Zeilenumbrüche ignoriert und die Zeichen "<", ">" und "&" werden nur angezeigt, wenn sie gemäß dem HTML-Standard maskiert sind. Sie können in den allgemeinen Einstellungen die standardmäßig zu wählende Textformatierung für neue Elemente einstellen. Ein Beispiel mit dem Namen "sample_char_format" finden Sie unter dem Menübefehl "Datei->Beispiele".

Einige der Feldtypen verwenden eine Ausgabeformat. Der Knopf "Hilfe zu den Formaten" zeigt dann jeweils die verfügbaren Formatierungszeichen an. Wenn im Editor Einträge vorgenommen werden, die nicht zum Format passen, wird der Feldname fett dargestellt und die Ausgabe durch "#####" ersetzt.

Der Typ "Text"

"Text" ist der Standardtyp. Felder dieses Typs werden in der "Editor"-Ansicht in Textfeldern bearbeitet. Das Textfeld wird beim nächsten Anzeigen automatisch größer, wenn mehr Zeilen eingegeben wurden, als in das Feld passen. Die Höhe des Eingabefelds kann im Feldformat-Dialog auch explizit angegeben werden.

Die Typen "Auswahl", "Kombination (Mehrfachauswahl)" und "Boolsche Variable"

Die Typen "Auswahl" und "Kombination (Mehrfachauswahl)" erlauben die Auswahl von einem ("Auswahl") bzw. mehreren ("Kombination") Einträgen aus einer Liste. Die erlaubten Werte werden getrennt durch "/" im Ausgabeformat vorgegeben. Verwenden Sie "//", um das Zeichen "/" als Teil eines Werts anzugeben.

Der Typ "Boolsche Variable" funktioniert ähnlich wie Auswahl, aber akzeptiert nur Wertepaare wie "wahr/falsch", "ja/nein" und "1/0".

Der Typ "Zahl"

Das Ausgabeformat für den Typ "Zahl" wird über eine Zeichenkette definiert. "#" steht für eine optionale Ziffer, "0" für eine benötigte Ziffer. Beispielsweise wird die Zahl pi mit dem Format "#.#" als "3.1" und mit dem Format "00.00" als "03.14" dargestellt. Unabhängig vom gewählten Format werden links vom Komma oder Dezimalpunkt keine Ziffern abgeschnitten, weil das das Ergebnis verfälschen würde. Aber geben Sie immer eine ausreichende Anzahl von optionalen oder benötigten Ziffern an, um Rundungsfehler zu vermeiden.

Sie können sowohl den angelsächsischen Dezimalpunkt (".") als auch das deutsche Dezimalkomma (",") vorgeben. Als Tausender-Trennzeichen können Sie analog "\." für die deutsche und "\," für die angelsächsische Schreibweise benutzen. Eine große Zahl kann beispielsweise als "#\,###\,###.##" oder "#\.###\.###,##" definiert werden. Der Knopf "Hilfe zu den Formaten" zeigt die Formatierungsmöglichkeiten im Detail.

Im Gegensatz zu den meisten anderen Formaten wird das Ausgabeformat des Typs "Zahl" auch zur Anzeige im Editor verwendet. Solange das korrekte Dezimaltrennzeichen verwendet wird, kann TreeLine aber die meisten sinnvollen Eingaben korrekt auswerten.

Die Typen "Datum" und "Zeit"

Bei den Typen "Datum" und "Zeit" werden spezielle Zeichen im Ausgabeformat durch die Elemente des Datums ersetzt. Der Knopf "Hilfe zu den Formaten" zeigt die Formatierungsmöglichkeiten im Detail.

Das Datums- bzw. Zeitformat kann auch unter "Extras->Allgemeine Einstellungen->Formate im Editor" definiert werden. Das bezieht sich allerdings nur auf den Editor. Andere sinnvolle Eingabe werden vom Editor ebenfalls korrekt interpretiert, so lange die richtige Reihenfolge von Tag, Monat und Jahr eingehalten wird. Außerdem kann der Editor Wochentage nicht auswerten. Nicht auswertbare Eingaben führen dazu dass der Feldname fett angezeigt wird.

Unter "Weitere Einstellungen" können Sie als Standardwert für neu angelegte Elemente "jetzt" auswählen. Das hat den Effekt, dass das Datums- oder Zeitfeld beim Anlegen des neuen Elements automatisch das Anlegedatum als "Zeitstempel" speichert.

Verknüpfungen

Die Feldtypen "URL", "Pfad" und "E-Mail-Adresse" erzeugen in der Ausgabe klickbare Verknüpfungen. Die "URL" wird für Webadressen ("http://...") verwendet, "Pfad" für Dateipfade auf dem lokalen Rechner und "E-Mail-Adresse" für E-Mail-Adressen ("mailto:..."). Diese Verknüpfungen öffnen einen externen Webbrowser bzw. ein E-Mail-Programm, wenn sie in der Ansicht angeklickt werden. Unter Linux kann man den zu verwendenden Browser über die Umgebungsvariable "BROWSER" setzen. Zum Beispiel können Sie unter KDE mit "konqueror %s" Konqueror als Standardbrowser einstellen.

Es gibt auch interne Verknüpfungen, die bei einem Klick in der Ansicht das nächste Element auswählen, dessen verknüpfbares Feld der internen Verknüpfung entspricht. Wenn Verknüpfungen oder verknüpfbare Felder mehrzeilig sind, wird jede Zeile als eine separate Verknüpfung aufgefasst. Wenn gewünscht, kann das selbe Feld als Verknüpfung und verknüpfbares Feld dienen, so dass der Klick auf ein Schlüsselwort in einem Element das nächste Element mit dem gleichen Schlüsselwort auswählt. Interne Verknüpfungen werden in HTML als Anker in der Website exportiert. Bei mehrfach vorkommenden Verknüpfungszielen wird jedoch jeweils nur die oberste, nicht die jeweils nächste gefunden. Ein Beispiel mit dem Namen "sample_intern_links" finden Sie unter dem Menübefehl "Datei->Beispiele".

Die "Ausführbare Verknüpfung" versucht, den im Feld eingegebenen Text als Programm aufzurufen. Da dies eine Sicherheitslücke sein kann, läßt sich die Funktion in den allgemeinen Einstellungen deaktivieren. Man kann auch den Pfad zum ausführbaren Programm als Prefix für das Feld definieren und dann in das eigentliche Feld zusätzliche Argumente oder Dateinamen eingeben, die an das Programm übergeben werden sollen.

Der Typ "Bild" zeigt das Bild, dessen Pfad angegeben wurde, in der Ansicht. Sie können mit Qt2 (wie in der Windows-Version von TreeLine benutzt) GIF- und PNG-Bilder verwenden, mit Qt3 auch JPEG und andere gängige Bildformate.

Weitere Einstellungen

Der Knopf "Weitere Einstellungen" im Feldformat-Dialog ermöglicht es, einen Vorgabewert für das Feld zu definieren, der bei neuen Elementen automatisch vergeben wird.

Verknüpfungsfelder können statt der Ziel-URL auch einen alternativen Text aus einem anderen Feld anzeigen, das Sie aus einer Liste auswählen können.

Außerdem kann ein Feld zum Pflichtfeld gemacht werden. Pflichtfelder werden im Editor mit einem "*" gekennzeichnet. TreeLine erzwingt allerdings nicht das Ausfüllen von Pflichtfeldern.

Schließlich können Felder in der Editor-Ansicht versteckt werden.


Verändern der Daten im Baum

Kategoriebasierte Befehle

Das Menü "Daten" enthäöt Befehle, um die Daten nach Kategorien und verknüpfbaren Feldern neu zu arrangieren bzw. "abzuflachen". Diese Befehle werden dazu verwendet, automatisch unterhalb des ausgewählten Elements Gliederungsebenen einzufügen bzw. zu entfernen.

Der Befehl "Kategorieebene hinzufügen" ermöglicht es, ein oder mehr Felder auzuwählen, die die Unterelemente gemein haben. Diese Felder werden dazu benutzt, neue Elternelemente für diese Elemente zu erzeugen bzw. sie nach gemeinsamen Kategorien zu gruppieren. Beispielsweise kann man in einer Bücherliste die Felder "Vorname_des_Autors" und "Nachname_des_Autors" auswählen. Das Ergebnis wird ein Baum sein, in dem alle Bücher eines bestimmten Autors jeweils in einem eigenen Unterast abgelegt sind.

Der Befehl "Nach Kategorie abflachen" hat beinahe den gegenteiligen Effekt. Er eliminiert alle Unterelemente, die selbst Unterelemente haben, und überträgt ihre Datenfelder auf diese. Er benennt Felder um, anstatt Felder mit gleichem Namen zu überschreiben. Dennoch ist dieser Befehl am nützlichsten, wenn die "Kinder" und "Eltern" im Baum von verschiedenem Typ sind und einmalige Feldnamen besitzen.

Verweisbasierte Befehle

Die Befehle "Nach Verweisfeldern arrangieren" und "Nach Verweisfeldern abflachen" arrangieren Elemente neu, indem sie Verweise auf den Wert des verknüpfbaren Felds ihres Elternelements verwenden. Dazu ist es notwendig, dass die verknüpfbaren Felder eindeutige Werte, z.B. IDs, enthalten.

Der Befehl "Nach Verweisfeldern abflachen" fügt ein Feld mit der ID des Elternobjekts zu jedem Unterelement hinzu. Dann platziert es alle Elemente direkt unter dem ausgewählten Wurzelelement. Der Befehl "Nach Verweisfeldern arrangieren" macht das Gegenteil. Er platziert jedes Element unter dem Element mit der im Verweisfeld genannten ID. Wenn es mehrere Elemente mit der gleichen ID gibt, wird das nächste Element oberhalb verwendet. Elemente, deren Elternelemente nicht gefunden werden, werden direkt unter das ausgewählte Wurzelelement platziert.

Der Befehl "Nach Referenzdatei aktualisieren" verwendet eine separate Datei, um die Werte von fehlenden Feldern zu aktualisieren. Die Verweisfelder werden als Verknüpfungsschlüssel verwendet. Dann wird jedes Feld aus der Referenzdatei, das in der gerade bearbeiteten Datei fehlt, ergänzt. Felder können in der Originaldatei gelöscht werden, um eine Aktualisierung zu erzwingen. Dabei muss das Feld tatsächlich fehlen, nicht nur leer sein.

Sortierung

Im Menü "Daten" finden sich auch die Befehle "Unterelemente sortieren", "Elementtyp im Unterbaum sortieren" und "Unterbaum nach Titel sortieren". Die ersten beiden ermöglichen es, verschiedene Felder ein einer bestimmten Reihenfolge als Sortierschlüssel auszuwählen. Die Felder werden in der gewünschten Reihenfolge mit der linken Maustaste ausgewählt. Die Sortierrichtung wird mit der mittleren Maustaste bestimmt. "Unterelemente sortieren" wirkt sich nur auf die direkten Unterelemente der ausgewählten Elemente aus, während "Elementtyp im Unterbaum sortieren" alle Elemente unterhalb der ausgewählten Elemente sortiert, die einen bestimmten Typ haben. "Unterbaum nach Titel sortieren" sortiert den gesamten Baum durch, allerdings nur nach den Titeln (Überschriften), nicht nach speziellen Feldern.

Filtern

Der Befehl "Daten filtern" ermöglicht das Entfernen von Elementen nach benutzerdefinierten Regeln. Wenn es mehr als einen Datentyp innerhalb der ausgewählten Äste gibt, wird der zu filternde Typ zur Auswahl angeboten. Als nächstes können für jedes Feld des gewählten Typs Regeln definiert werden, die zu erfüllen sind. Mehrere dieser Regeln können mit "und" bzw. "oder" verknüpft werden. Verwenden Sie dazu den Knopf "Regel hinzufügen". Alle Unterelemente des gewählten Typs, die die Regeln nicht erfüllen, werden inklusive ihrer Kinder gelöscht. Der Dateiname wird um den Anhang "_filter" ergänzt, um versehentliches Überschreiben der ungefilterten Datei zu verhindern. Wenn die Datei bereits verändert war, wird vor dem Filtern angefragt, ob sie gespeichert werden soll. Einmal durchgeführt, läßt sich einee Filteraktion nicht rückgängig machen.

Nummerierung

Der Befehl "Nummerierung" fügt zu Unterelementen Nummernfelder hinzu. Die Nummernfelder werden nicht automatisch aktualisiert, wenn der Baum verändert wurde. Der Befehl muss dann wiederholt werden. Im Dialog wird ein neuer oder bereits existierender Feldname eingegeben. Außerdem kann angegeben werden, ob das ausgewählte Element in die Nummerierung einbezogen werden soll. Es gibt drei Arten der Nummerierung: "nur Nummer der jeweiligen Ebene anzeigen", "für jedes Element die volle Nummer (z.B. 1.5.4) anzeigen" und "nur direkte Unterelemente nummerieren". Es gibt die Standardformate "I, II..., A, B..., 1, 2..." für die erste Art der Nummereriung und "1, 2..., 1.1, 1.2..." für die zweite. Außerdem können für jede Ebene benutzerdefinierte Formate spezifiziert werden. Die benutzerdefinierten Formate sollten eines der folgenden Zeichen enthalten: "1", "A", "a", "I", or "i". Die Serie wird dann jeweils passend mit Zahlen, Buchstaben oder römischen Zahlen weitergeführt. Entscheidend ist das jeweils letzte Vorkommen des Zeichens. Alle vorherigen werden als Teil des Formats aufgefasst.

Die Auswahl ändern

Der Befehl "Ausgewählte Elemente ändern" ermöglicht das gleichzeitige Ändern der Werte für ein bestimmtes Datenfeld für alle ausgewählten Elemente. Wählen Sie einfach das gewünschte Feld aus und geben Sie den neuen Wert ein.


Drucken

Druckereinstellungen

Der Reiter "Ansicht" zeigt in der rechten Fensterhälfte die formatierte Ausgabe für das aktive Element und seine Unterelemente. Die formatierte Ausgabe kann auch gedruckt werden. Der Ausdruck beginnt beim aktiven Element und zeigt die Unterelemente eingerückt, wahlweise auch mit Linien, die die Baumstruktur visualisieren. Die Linien können es leichter machen, die Abhängigkeiten zwischen Elementen und Unterelementen zu erkennen, vor allem beim Ausdruck über mehrere Seiten hinweg. Beim Einsatz einiger HTML-Auszeichnungen kann es allerdings passieren, dass die Linien nicht wie gewünscht gezeichnet werden.

Das aktive Element kann ausgeblendet werden, ebenso Elemente, die sich in eingeklappten Ästen befinden.

Im Dialog "Druckereinstellungen" können außerdem die vom Drucker zu verwendeten Schriftarten, Randbreiten und die Zahl der Spalten angepasst werden.

In der Standardeinstellung lässt TreeLine keine Seitenumbrüche zwischen einem Element und dem ersten Unterelement zu. Falls Sie dies nicht wünschen, entfernen Sie bitte den Haken vor der Einstellung "Das erste Unterelement mit dem Elternelement zusammen anzeigen".

Kopf und Fuß

Im Dialog "Druckereinstellungen" findet sich auch ein Knopf, der den Unterdialog zum Einstellen der Kopf- und Fußzeilen für den Ausdruck öffnet. In den Eingabefeldern (jeweils links, mitte und rechts für Kopf und Fuß) können die auf der linken Seite des Dialogs aufgeführten Datenfelder mit beliebigem Text kombiniert werden, nach den selben Regeln wie für das Ausgabeformat im Dialog "Datentypen konfigurieren". Die Einstellungen für die Kopf- und Fußzeilen werden in der TreeLine-Datei abgespeichert.

Druckvorschau

Nachdem im Druckdialog "OK" gedrückt wurde, wird eine Vorschau des Ausdrucks angezeigt, wenn die Druckvorschau nicht deaktiviert wurde. Die Vorschau skaliert mit der Fenstergröße.

Probleme beim Drucken

Einige Probleme beim Drucken, z.B. Fehler bei den Randabständen oder dem Zeilenumbruch, können behoben werden, indem man eine Schriftart wählt, die der Drucker besser unterstützt.


Umgang mit Dateien

Dateien komprimieren

Als Standard verwendet TreeLine ein XML-Dateiformat. Um Platz zu sparen, können die Dateien im gzip-Format komprimiert gespeichert werden. Die Komprimierung lässt sich für einzelne Dateien unter "Extras->Datei-Einstellungen" oder vom "Speichern unter"-Dialog aus aktivieren. Es gibt auch eine allgemeine Einstellung, um das komprimierte Speichern zum Standard für neu erstellte Dateien zu machen.

Dateien verschlüsseln

Dateien können verschlüsselt und mit einem Passwort geschützt werden. Die Verschlüsselung lässt sich für einzelne Dateien unter "Extras->Datei-Einstellungen" oder vom "Speichern unter"-Dialog aus aktivieren. Es gibt auch eine allgemeine Einstellung, um das verschlüsselte Speichern zum Standard für neu erstellte Dateien zu machen. Die Verschlüsselung verwendet die SHA-Hashfunktion zur Verschlüsselung des Datenstroms und sollte recht sicher sein.

Automatisches Speichern

TreeLine kann auf Wunsch ungespeicherte Dateien in einem einstellbaren Zeitintervall mit einem dem Dateinamen angehängten "~" speichern. Das können Sie unter "Extras->Allgemeine Einstellungen" konfigurieren. Wenn TreeLine sauber beendet wird oder die Datei gespeichert wird, werden die Sicherungskopien automatisch entfernt.

Ansichtseinstellungen merken

Wenn eine kürzlich benutze Datei geöffnet wird, stellt TreeLine die zuletzt ausgeklappten bzw. eingeklappten Äste und die zuletzt ausgewählten Elemente wieder her. Diese Informationen werden in der Konfigurationsdatei von TreeLine gespeichert. Diese Funktion können sie in den allgemeinen Einstellungen deaktivieren.

Kommandozeile

Mit dem Befehl "treeline" können Sie auf der Kommandozeile und in Skripten Dateien importieren und exportieren. Damit lassen sich zum Beispiel automatisierte Konvertierungsläufe einrichten. Wenn Sie "treeline -h" aufrufen, werden die verfügbaren Optionen angezeigt. Wenn Sie die binäre Windows-Version von TreeLine verwenden, werden direkte Ausgaben auf dem Bildschirm unterdrückt. Verwenden Sie deshalb "treeline -h > log.txt" um die Ausgabe beispielsweise in die Datei "log.txt" umzuleiten.


Datei-Import

Text mit Trennzeichen

Eine TreeLine-Datei verwendet ein XML-Textformat. Auch andere Arten von Textdateien können von TreeLine gelesen werden. In diesem Fall zeigt TreeLine einen Dialog an, in dem die gewünschte Importmethode ausgewählt werden kann.

TreeLine öffnet Textdateien mit einer Baumstruktur, die durch eine bestimmte Anzahl von Tabulatoren am Beginn jeder Zeile strukturiert sind. In diesem Fall wird nur der Elementtitel importiert, keine anderen Felder. Diese Methode wird auch benutzt, um Dateien, die von sehr alten TreeLine-Versionen geschrieben wurden, zu öffnen.

Textdateien

Es gibt zwei Möglichkeiten des Imports von Textdateien. Die eine erzeugt für jede Zeile des Texts ein neues Element, die andere je eines pro Absatz, wobei Absätze durch Leerzeilen getrennt sein müssen. In beiden Fällen werden alle neuen Elemente direkte Unterelemente des Wurzelelements. Verschachtelte Kapitelstrukturen können nicht erkannt werden. Dies ist aber ein guter Ausgangspunkt. Weitere Dokumentstruktur kann später durch das Einrücken von Elementen hinugefügt werden.

Treepad-Dateien

Es gibt auch einen Filter zum Importieren von Dateien, die vom Shareware-Programm Treepad geschrieben wurden. Dabei werden nur Textelemente unterstützt.

Lesezeichen-Dateien

TreeLine kann sowohl das HTML-Lesezeichenformat von Mozilla, Firefox und Netscape als auch das XBEL-Format, das z.B. von Konqueror, Galeon oder Elinks benutzt wird, einlesen. Jedes Lesezeichen wird ein Element mit Name und Verknüpfungsfeld. Einige Informationen wie das letzte Besuchsdatum der Webseite oder die Verknüpfung auf das Icon gehen beim Import verloren. Ein Beispiel können Sie in der Datei "sample_bookmarks" finden. Die Beispiele finden Sie mit dem Menübefehl "Datei->Beispiele".

Unspezifisches XML

TreeLine importiert und exportiert XML-Dateien. Die benutzten Routinen sind nicht sehr intelligent. Jedes XML-Element wird ein TreeLine-Element und jedes XML-Attribute wird ein Feld dieses Elements. XML-Textinhalte werden Felder mit dem Namen "Element_Data". Damit lässt sich TreeLine als einfacher XML-Editor verwenden.


Datei-Export

HTML

Dateien werden mit dem Befehl "Datei->Exportieren" exportiert. Der Exportdialog kennt mehrere Arten des Exports:

"HTML als eine Datei" entspricht in etwa der Druckausgabe. Es gibt ähnliche Optionen. Der Kopf und der Fuß können eingebunden und die Zahl der Spalten definiert werden.

"HTML als Verzeichnisstruktur" exportiert eine Verzeichnisstruktur mit HTML-Dateien. Die Verzeichnisse werden nach dem Inhalt des ersten Datenfelds benannt. Dieser muss ein gültiger Dateinamen sein, und es darf in einem Verzeichnis kein Name doppelt vorkommen. Jede HTML-Datei ist eine Tabelle von Daten für eine Gruppe von Elementen auf der gleichen Gliederungsebene mit Verknüpfungen zu den Eltern- und Unterelementseiten.

Text mit Trennzeichen

Daten können als mit tabulatoren eingerückte Titellisten (altes TreeLine-Dateiformat) und Tabulator-getrennte Tabellen exportiert werden. Die Exportformate entsprechen den jeweiligen Importformaten. Beim Export als Tabelle wird nur die erste Unterebene des Baums verwendet. Es bietet sich oft an, die Datei vorher "abzuflachen" (also Hierarchieebenen zu entfernen).

Lesezeichen

TreeLine kann sowohl das HTML-Lesezeichenformat von Mozilla, Firefox und Netscape als auch das XBEL-Format, das z.B. von Konqueror, Galeon oder Elinks benutzt wird, schreiben.

Unspezifisches XML

TreeLine importiert und exportiert XML-Dateien. Die benutzten Routinen sind nicht sehr intelligent. Jedes TreeLine-Element wird ein XML-Element und jedes Feld dieses Elements wird ein XML-Attribut. Felder mit dem Namen "Element_Data" werden XML-Textinhalte. Damit lässt sich TreeLine als einfacher XML-Editor verwenden.

XSLT

Das Format einer TreeLine-Datei kann auch als XSLT-Stylesheet exportiert werden. Dieser kann zum Anzeigen der TreeLine-XML-Datei in einem dafür geeigneten Webbrowser benutzt werden, ohne dass vorher ein HTML-Export erfolgen muss. Beachten Sie, dass in der XSLT-Datei einige komplexe Feldformatierungen ignoriert werden.

Beim Export eines XSLT-Stylesheets wird eine Verknüpfung auf die Datei in die TreeLine-Datei geschrieben. Beachten Sie, dass die TreeLine-Datei gespeichert werden muss, um diese Änderung zu enthalten. Idealerweise sollte die TreeLine-Datei mit einer Dateiendung von ".xml" gespeichert werden, da diese von geeigneten Browsern dirket geöffnet werden können. Der Stylesheet muss nur nach Änderungen in der Format- oder Typdefinition neu generiert werden.

Wenn in einem nach XSLT zu exportierenden Datenformat HTML-Auszeichnungen verwendet werden, sollten sie dem XHTML-Standard entsprechen (z.B. <br/> statt <br>). Beim Export wird nach einem Namen für einen optionalen CSS-Stylesheet gefragt. Dieser Name wird in der TreeLine-Datei als Name für zukünfige Exporte gespeichert. Der Verweis auf den XSLT-Stylesheet kann mit dem Befehl "Extras->XSLT-Referenz entfernen" aus der TreeLine-Datei entfernt werden.


Plugins

Beschreibung

TreeLine hat eine Schnittstelle (Interface), um Erweiterungen, sogenannte Plugins, einzubinden.

Momentan verfügbare Plugins finden Sie auf der "Downloads"-Seite der TreeLine-Website.

Installation

Plugins werden installiert, indem Sie ihre Python-Datei (*.py) in das Verzeichnis "plugins" ("<prefix>/lib/treeline/plugins/" bei Linux bzw. "TreeLine\lib\plugins\" bei Windows) kopieren und TreeLine neu starten. Eine Liste der geladenen Plugins finden Sie unter "Hilfe->Über Plugins".

Es gibt auch eine Option "UserPluginDir" in der Konfigurationsdatei "~/.treeline" ("treeline.ini unter Windows) in Ihrem persönlichen Verzeichnis, mit der ein alternatives Plugin-Verzeichnis gewählt werden kann. Damit können Benutzer ohne Rechte als "root" oder Administrator Plugins installieren und benutzen.

Interface

Informationen über das Schreiben eigener Plugins finden Sie in der Datei "plugininterface.py" im TreeLine-Quellcode.


Geläufige Probleme

XML-Fehler

Eine Fehlermeldung "Fehler beim Laden des XML-Parsers" heißt in der Regel, dass TreeLine die benötigte XML-Bibliothek nicht gefunden hat. Unter Linux verwendet Python entweder expat oder das PyXML-Paket. Installieren Sie diese gegebenenfalls nach. Unter Windows dürfte dieser Fehler nur auftreten, wenn Dateien z.B. beschädigt sind oder versehentlich gelöscht wurden.

Unicode-Fehler

Wenn Sie Rechtecke zwischen jedem Buchstaben sehen und Texte hinten abgeschnitten sind, ist das vermutlich auf ein veraltetes PyQt-RPM auf einem Red Hat Linux-System zurückzuführen. Ein Upgrade von PyQt auf Version 3.7 oder neuer und des sip RPMs auf den selben Versionsstand sollte das Problem beheben.

Drucken

Einige Probleme beim Drucken, z.B. Fehler bei den Randabständen oder dem Zeilenumbruch, können behoben werden, indem man eine Schriftart wählt, die der Drucker besser unterstützt.


Liste der Änderungen

In der englischen Version des Handbuchs finden Sie die vollständige Liste von Änderungen ("Revision History").


Fragen, Kommentare, Kritik?

Es gibt eine Mailing-Liste für TreeLine-Benutzer.

Zum Anmeldgen, gehen Sie bitte auf die Webseite
www.bellz.org/mailman/listinfo/treeline.

Sie können mich auch per E-Mail unter "doug101 AT bellz DOT org" erreichen.

Ich freue mich über jegliches Feedback, auch Fehlerberichte (Bugreports). Sehen Sie auch von Zeit zu Zeit auf www.bellz.org nach neuen Versionen oder Updates.