# Variablen in Dokumenten

Mit einer Variablen können Sie &kword; auf einfache Weise dazu veranlassen ein Dokument in sehr spezieller Weise zu verändern, um die veränderliche Natur des Dokumentes oder Berichts wiederzuspiegeln.

Eine Variable kann eine Zahl sein ( zum Beispiel eine Seitenzahl, die Gesamtzahl der Seiten in einem Dokument usw.), ausgewählte Wörter (Kundenname, Produktname, Dateiname des Dokuments u.s.w), ein Datum, eine Uhrzeit, oder fast alles, was Sie sich wünschen.

Wenn eine Variable festgelegt ist, wird ein Platzhalter in das Dokument eingefügt. &kword; ersetzt diesen Platzhalter, immer dann, wenn er verwendet wird, durch den Wert der Variablen.

Variablen können entweder fest sein (das bedeutet, dass sie sich nicht mehr ändern, wenn sie einmal eingefügt sind), oder variabel (wobei der Platzhalter von &kword; aktualisiert wird, um den aktuellen Wert der Variablen anzuzeigen).

Dieses Kapitel beginnt mit einigen Beispielen häufig verwendeter Variablen ( Datum, Zeit, und Seitenzahlen ), dann werden Ihnen die verschiedenen Variablen einzeln erklärt. Schließlich wird gezeigt, wie Sie eigene Variablenfür Ihre Dokumente erstellen können.

## Datum und Zeit

Viele Briefe, Berichte und Dokumente enthalten Informationen über Datum oder Uhrzeit, auf sie sich beziehen. Informationen über Datum und Uhrzeit können den Zeitpunkt der Erstellung eines Dokumentes anzeigen ( sie bleiben fest, solange das Dokument besteht), oder z. B. den Zeitpunkt der letzten Änderung des Dokumentes anzeigen (der sich mit jeder Bearbeitung des Dokumentes ändert).

&kword; erlaubt sowohl feste wie variable Datums- und Zeit-Variablen in einem Dokument.

### Das Einfügen eines Datums

Wenn Sie ein Datum in das Dokument einzufügen wollen, platzieren Sie den Cursor dort im Text, wo das Datum eingefügt werden soll, und wählen auf der Menüleiste Einfügen VariableDatum . Daraufhin werden zwei Wahlmöglichkeiten angeboten: Aktuelles Datum (fest) und Aktuelles Datum (variabel).

Aktuelles Datum (fest)

  Wenn Sie diese Option wählen, wird das aktuelle Datum an der aktuellen Cursorposition eingefügt. Dieses Datum wird durch einen Abgleich mit der Systemuhr des Rechners festgelegt. Sobald es eingefügt word ist, ändert sich das Datum nicht mehr, auch wenn dann nicht, wenn &kword; aufgefordert wird die Dokument-Variablen zu aktualisieren.

  Dieses Element eignet sich besonders gut für das Datum der Erstellung eines Dokuments, oder wenn Daten in einem täglich zu erstellenden Arbeitsbericht eingebunden werden. Vergleichen Sie diese Option mit Aktuelles Datum(variabel).

Aktuelles Datum (variabel)

  Wenn Sie diese Option wählen, wird das aktuelle Datum an der aktuellen Cursorposition eingefügt. Das Datum wird durch einen Abgleich mit der Systemuhr des Computers festgelegt. Das Datum ändert sich, wenn &kword; aufgefordert wird die Dokument -Variablen zu aktualisieren.

  Diese Option eignet sich für jede Stelle im Dokument, an der immer das gerade aktuelle Datum benötigt wird. Vergleichen Sie diese Wahlmöglichkeit mit Aktuelles Datum (fest).

Wenn das Datum gewählt ist, erscheint ein Dialog.

Das obere Auswahlfeld legt das Erscheinungsbild der Variable fest. Ihre Wahlmöglichkeiten sind:

Regionales Format

  Dies fügt das Datum in dem Format ein, das im &kde;-Kontrollzentrum festgelegt ist.

  Wenn Sie diese Option wählen wollen, vergewissern Sie sich, dass das obere Auswahlfeld Regionales Format anzeigt. Eine Vorschau des Datumsformates sehen Sie unter dem Ankreuzfeld Benutzerdefiniert. Wenn Sie damit zufrieden sind, klicken Sie auf OK.

Vorgegebene Datumsformate

  &kword; enthält zwölf vorgegebene Datumformate. Diese vorgegebenen Formate genügen für die meisten auftretenden Anforderungsfälle. Wählen Sie einfach ein vorgebenes Format in dem oberen Kombinationsfeld aus. Eine Vorschau des Datumsformates sehen Sie unter dem Ankreuzfeld Benutzerdefiniert. Wenn Sie damit zufrieden sind, klicken Sie auf OK.

Benutzerdefiniertes Format

  Wenn Sie kein geeignetes Datumformat finden, können Sie Ihr eigenes Format auch selbst erstellen.

  Ein Datumformat besteht aus einer Reihe von Buchstaben und Zahlen, die nach bestimmten Regeln (die weiter unten erklärt werden) angeordnet werden, um ein vollständiges Datum zu erzeugen.

  Das Datumformat besteht aus Platzhaltern und Trennzeichen. Die Platzhalter werden in den folgenden drei Tabellen definiert.

  Tage

  Platzhalter für Tag | d | dd | ddd | dddd
  Ein Beispiel | 6 | 06 | Thu | Donnerstag

  Monate

  Platzhalter für Monat | M | MM | MMM | MMMM
  Ein Beispiel | 3 | 03 | Mar | März

  Jahr

  Platzhalter für Jahr | yy | yyyy
  Ein Beispiel | 02 | 2002

  Sie können die Platzhalter mit normalem Text (Trennzeichen) kombinieren, um ein vollständiges Datum zu erstellen.

  Ein Beispiel:

  tt/MM/jjjj wird übersetzt zu 06/03/2002

  und

  t. MMMM jjjj wird zu 6. März 2002

  Sie werden feststellen, dass sich nur die Platzhalter ändern. Leerzeichen, Kommas, Schrägstriche und anderer Text bleiben unverändert.

  Beachten Sie, dass Sie bei Platzhaltern die Groß-/Kleinschreibung beachten müssen. TT ist kein Platzhalter, nur tt.

  Um ein eigenes Datumsformat zu erstellen, markieren Sie das Ankreuzfeld Benutzerdefiniert.

  Geben Sie jetzt mit der Tastatur die Platzhalter und den Trennzeichentext in das obere Auswahlfeld ein. Sie können das Format auch in dem Auswahlfeld Einfügen auswählen, und der Platzhalter wird an der Cursorposition in das Datumsformat eingefügt.

Eine Vorschau des aktuellen Datumformats können Sie unter dem Benutzerdefiniert > Kontrollfeld sehen. Wenn das Datumformat richtig ist, klicken Sie auf OK, um die Datumsvariable in das Dokument einzufügen.

Wenn das Datum in das Dokument eingefügt, wurde kann es danach neu gestaltet und zwischen festem und variablen Datum umgeschaltet werden. Klicken Sie dazu mit der rechten Maustaste auf das Datum. Danach sehen Sie ein kleines Menü. Wählen Sie Variable ändern zu... und ein Untermenü wird sichtbar. Wählen Sie Ihre neue Variable oder neue Gestaltung im Menü aus, und die Variable wird sofort entsprechend aktualisiert.

### Die Zeit einfügen

Wenn Sie die Zeit in ein Dokument einfügen wollen, platzieren Sie den Cursor dort im Text, wo die Zeit eingefügt werden soll und wählen Sie auf der Menüleiste Einfügen VariableZeit . Zwei Wahlmöglichkeiten werden Ihnen daraufhin angeboten: Aktuelle Zeit (fest)und Aktuelle Zeit (variabel).

Aktuelle Zeit (fest)

  Wenn Sie diese Option wählen, wird die aktuelle Zeit an der Cursorposition eingefügt. Die Zeit wird durch Abgleich mit der Systemuhr des Rechners eingestellt. Sobald Uhrzeit einmal eingegeben ist, wird sie nicht mehr verändert, selbst dann nicht, wenn &kword; die Dokument-Variablen aktualisieren soll.

  Dieses Element eignet sich sehr gut für Zeitstempel. Vergleichen Sie diese Einstellung mit Aktuelle Zeit (variabel).

Aktuelle Zeit (variabel)

  Mit dieser Einstellung wird die aktuelle Zeit an der Cursorposition eingefügt. Die Zeit wird durch Ableich mit der Systemuhr des Rechners eingestellt. Die Zeit ändert sich, sobald &kword; zum Aktualisieren der Dokument-Variablen aufgefordert wird.

  Diese Einstellung eignet sich gut für alle Stellen in Ihrem Dokument, an denen immer die gerade aktuelle Zeit benötigt wird. Vergleichen Sie diese Einstellung mit Aktuelle Zeit (fest)

Jetzt sehen Sie einen Dialog.

Das oberste Auswahlfeld legt das Aussehen der Variablen fest. Sie können folgende Auswahl treffen:

Regionales Format

  Diese fügt die Zeit in dem Format ein, das im &kde;-Kontrollzentrum festgelegt wurde.

  Um diese Einstellung auszuwählen, sollten Sie sich vergewissern, dass das obere Auswahlfeld Regionales Format anzeigt. Eine Vorschau des Datumformates sehen Sie unter dem Ankreuzfeld Benutzerdefiniert. Wenn Sie damit zufrieden sind, klicken Sie auf OK.

Vorgegebene Zeitformate

  &kword; enthält fünf vorgegebene Zeitformate. Diese vorgegebenen Formate reichen für die allermeisten Anwendungsfälle aus. Wählen Sie ein vorgegebenes Format in dem oberen Auswahlfeld aus. Eine Vorschau des Zeitformates sehen Sie unter dem Ankreuzfeld Benutzerdefiniert. Wenn Sie damit zufrieden sind, klicken Sie auf OK.

Benutzerdefiniertes Format

  Wenn Sie kein geeignetes Zeitformat finden, können Sie Ihr eigenes Format auch selbst erstellen.

  Ein Zeitformat besteht aus einer Reihe von Buchstaben und Zahlen, die nach bestimmten Regeln (die weiter unten erklärt werden) angeordnet werden, um eine vollständige Zeitangabe zu erzeugen.

  Das Zeitformat besteht aus Platzhaltern und Trennzeichen. Die Platzhalter werden in den folgenden fünf Tabellen definiert.

  Stunden

  Platzhalter für Stunde | h | hh
  Ein Beispiel | 6 | 06

  Minuten

  Platzhalter für Minuten | m | mm
  Ein Beispiel | 3 | 03

  Sekunden

  Platzhalter für Sekunden | s | ss
  Ein Beispiel | 2 | 02

  Millisekunden

  Platzhalter für Millisekunden | zzz
  Ein Beispiel | 022

  Sekunden

  Platzhalter für AM/PM | ap | AP
  Ein Beispiel | am | AM

  Sie können die Platzhalter mit normalem Text (Trennzeichen) kombinieren, um eine vollständige Zeitangabe zu erstellen.

  Ein Beispiel:

  hh:mm:ss wird zu 06:23:13

  und

  h:mm ap wird zu 6:23 am

  Beachten Sie, dass nur die Platzhalter sich verändern. Leerzeichen, Kommas und anderer Text bleibt unverändert.

  Beachten Sie, dass Sie bei den Platzhaltern die Groß-/Kleinschreibung unterschieden wird. HH ist kein Platzhalter, nur hh.

  Wenn Sie ein eigenes Zeitformat erstellen wollen, markieren Sie das Ankreuzfeld Benutzerdefiniert.

  Geben Sie die Platzhalter und den Trennzeichentext in das obere Auswahlfeld ein. Sie können aber auch das Zeitformat in dem Auswahlfeld Einfügen auswählen, und der Platzhalter wird an der Position des Cursors in das Zeitformat eingefügt.

  Eine Vorschau des aktuellen Zeitformats können Sie unter dem Ankreuzfeld Benutzerdefiniert > sehen. Wenn das Zeitformat richtig ist, klicken Sie auf OK, um die Zeitvariable in das Dokument einzufügen.

Eine Vorschau des aktuellen Zeitformats können Sie unter dem Ankreuzfeld Benutzerdefiniert > sehen. Wenn das Zeitformat richtig ist, klicken Sie auf OK, um die Zeitvariable in das Dokument einzufügen.

Nachdem die Zeit in das Dokument eingefügt wurde, kann sie jederzeit neu gestaltet und zwischen fester und variabler Zeit umgeschaltet werden. Klicken Sie dazu einfach mit der rechten Maustaste auf die Zeit im Dokument. Danach sehen Sie ein kleines Menü. Wählen Sie Variable ändern zu... und ein Untermenü wird sichtbar. Wählen Sie Ihre neue Variable oder neue das neue Anzeigeforamt im Menü aus und die Variable wird sofort entsprechend aktualisiert.

## Seitennummerierung

Das Einfügen von Seitenzahlen in &kword; ist einfach.

Es gibt zwei Variablen, die sich auf Seitenzahlen beziehen: Aktuelle Seite und Anzahl Seiten

Um die aktuelle Seitenzahl einzufügen, platzieren Sie den Cursor dorthin, wo Sie die Zahl platzieren, wollen und wählen auf der Menüleiste Einfügen VariableSeite Seitenzahl . Die Seitenzahl wird an der aktuellen Cursorposition eingefügt.

Um die Gesamtzahl der Seiten einzufügen, platzieren Sie den Cursor dorthin, wo Sie die Variable haben wollen und wählen auf der Menüleiste Einfügen Variable Seite Anzahl Seiten . Die Gesamtzahl der Seiten wird jetzt eingefügt.

Seitenzahlen werden dynamisch aktualisiert, wenn das Dokument bearbeitet wird.

Seitenzahlen platziert man gewöhnlich am Besten in Kopf- und Fußzeilen. Das stellt sicher, dass die Seitenzahl auf jeder Seite an der richtigen Stelle auftaucht.

## Abschnittsüberschrift

Sie können den die Abschnittsüberschrift an jeder Stelle im Dokument einfügen, indem Sie auf der Menüleiste Einfügen VariableSeite Abschnittsüberschrift auswählen.

&kword; bestimmt Abschnittüberschrift indem es eine Suche vom Anfang der aktuellen Seite aus beginnt. Der erste Absatz mit dem Stil Überschrift 1 ist der Titel des Abschnittes. Wenn auf der aktuellen Seite keine Absätze sind, setzt &kword; die Suche auf den vorhergehenden Seiten fort bis es eine Abschnittsüberschrift findet.

## Andere Variablen

&kword; enthält noch andere, häufig verwendete Variablen. Diese Variablen beziehen sich auf das Dokument. Sie können diese Variablen einfügen, indem Sie auf der Menüleiste Einfügen VariableDokument-Information auswählen. Daraufhin wird eine Liste mit Variablen angezeigt. Die Variablen werden weiter unten detailliert dargestellt.

Variable | Ein Beispiel | Details
--- | --- | ---
Dateiname | Lebenslauf.kwd | Fügt den Dateinamen des Dokuments ein.
Autorenname | Josef Nutzer | Der Name des Autors, so wie er im Dialog Dokument-Information eingetragen ist.
Stadt | Frankfurt | Die Postleitzahl, so wie sie im Dialog Dokument-Information eingetragen ist.
Firma | KDE | Der Name der Firma, so wie er im DialogDokument-Information eingetragen ist.
Land | Deutschland | Der Name des Landes, so wie er im Dialog Dokument-Information eingetragen ist.
Verzeichnisname | /home/jnutzer/kword | Das ist der Name des Verzeichnisses, in dem das Dokument als Datei gespeichert ist. Der Dateiname ist im Verzeichnisnamen nicht enthalten.
Verzeichnis- und Dateiname | /home/jnutzer/kword/Zusammenfassung.kwd | Der Verzeichnis- und Dateiname der aktuellen Datei.
Zusammenfassung | Das ist eine aktuelle Zusammenfassung des Dokumentinhalts. | Die Zusammenfassung des Dokumentinhalts, wie sie im Dialog Dokument-Information eingetragen ist.
Dokumenttitel | Meine Zusammenfassung | Der Dokumenttitel, so wie er im Dialog Dokument-Information eingetragen ist.
E-Mail | jnutzer@kde.org | Die E-Mail-Adresse, so wie sie im Dialog Dokument Information eingetragen ist.
Fax | Jede gültige Telefonnummer | Die Fax-Nummer, so wie sie im Dialog Dokument-Information eingetragen ist.
Dateiname | Lebenslauf.kwd | Der vollständige Dateiname.
Dateiname ohne Erweiterung | Zusammenfassung | Der Dateiname wird ohne die Erweiterung des Dateinamens (normalerweise .kwd) dargestellt.
Postleitzahl | Jede gültige Postleitzahl | Die Postleitzahl, so wie sie im Dialog Dokument-Information eingetragen ist.
Straße | Hauptstr. 132 | Straße und Hausnummer, so wie sie im Dialog Dokument-Information eingetragen sind.
Telefon | Jede gültige Telefonnummer | Die Telefonnummer, so wie sie im Dokument-Information eingetragen ist.
Titel | Leiterin des Rechenzentrums | Der Titel, so wie er im Autor-Abschnitt des Dialogs Dokument-Information eingetragen ist.

Variablen, die nicht belegt sind, erscheinen als <leer>, bis Sie ihren Inhalt im Dialog Dokument-Information eingetragen haben.

## Benutzerdefinierte Variablen

&kword; verfügt über viele voreingestellte Variablen. Es kann aber auch der Fall eintreten, bei dem schön wäre, könnte man eigene Variablen für ein Dokument definieren.

Mit benutzerdefinierten Variablen können Sie eine unbegrenzte Zahl von Variablen für jedes Dokument erstellen.

### Das Erstellen einer Benutzerdefinierten Variable

Wenn Sie eine neue benutzerdefinierte Variable erstellen wollen, platzieren Sie den Cursor an die Stelle in Ihrem Dokument, wo die Variable eingefügt werden soll.

Wählen Sie auf der Menüleiste Einfügen VariableBenutzerdefiniert Neu Ein Dialog erscheint.

Geben Sie den Namen der Variable und ihren aktuellen Wert/Inhalt in die Textfelder ein.

Klicken Sie auf OK, um die neue Variable zu erstellen und sie an der aktuellen Cursorposition einzufügen. Klicken Sie auf Abbrechen, um die Erstellung der neuen Variable abzubrechen.

Jetzt können Sie an jeder Stelle in ihrem Dokument diese neue Variable einfügen.

### Das Ändern des Wertes einer Benutzerdefinierten Variable

Damit die Variablen von Nutzen sind, müssen Sie ihnen einen Wert/Inhalt zuweisen und diesen auch ändern können. Den Wert/Inhalt einer Variablen können Sie ändern, indem Sie:

Auf der Menüleiste Werkzeuge Benutzerdefinierte Variablen... auswählen. Ein Dialog erscheint.

Jede Zeile in dieser Tabelle steht für eine benutzerdefinierte Variable. Die erste Spalte enthält den Namen der Variablen und die zweite ihren Wert.

Wenn Sie den Wert einer Variablen ändern wollen, klicken Sie in das Textfeld rechts vom Namen der Variablen. Geben Sie dann den gewünschten Wert ein.

Wenn die Änderungen vollständig sind, klicken Sie auf OK und alle Variablen werden aktualisiert.

### Das Einfügen einer benutzerdefinierten Variablen

Um eine neue benutzerdefinierte Variable einzufügen, wählen Sie auf der Menüleiste Einfügen Variable Benutzerdefiniert . Die benutzerdefinierte Variable wird im Untermenü aufgelistet. Klicken Sie auf den Namen der Variablen und &kword; fügt die Variable mit ihrem aktuellen Wert an der Cursorposition ein.

## Das Aktualisieren der Werte aller Variablen

Sie können &kword; veranlassen, die Werte aller Variablen zu aktualisieren (um sicher zu sein, dass alle Variablen auf ihren aktuellen Wert gesetzt werden). Das ist besonders wichtig bei Datum und Zeit.

Wählen Sie einfach auf der Menüleiste Einfügen VariableAlle Variablen aktualisieren .

## Das Aktualisieren des Wertes einer Datums- oder Zeitvariablen

Sie können &kword; veranlassen einen einzigen Datums- oder Zeitwert zu aktualisieren und alle anderen unverändert lassen.

Platzieren Sie den Mauszeiger auf der Variablen, die Sie aktualisieren wollen und klicken Sie mit der rechten Maustaste. Ein Menü erscheint, das verschiedene neue Datum- oder Zeitformate anzeigt und die Möglichkeit Datum oder Zeit fest oder variabel einfügen. Wählen Sie die gewünschte Möglichkeit und die Variable wird entsprechend aktualisiert.