Handbuch für TreeLine

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.

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.

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.

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.

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.

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.

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.

"Extras->Rechtschreibprüfung" öffnet einen Dialog, der für nicht im Lexikon gefundenen 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.

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.

Die Datentypen werden mit dem Dialog "Daten->Datentypen konfigurieren" definiert. 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.

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.

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.

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.

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.

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.

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".

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.

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.

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>

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

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.

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.

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.

"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" 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".

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.

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.

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.

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.

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.

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.

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.

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.

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. 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.

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.

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.

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".

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.

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.

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.

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 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.

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.

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.

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.

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.

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.

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

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.

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.

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.

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).

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.

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.

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.

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

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

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.

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

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.

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.

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.