# Variablen in Dokumenten

Mit einer Variablen können Sie auf einfache Weise &kword; dazu veranlassen ein Dokument in sehr spezieller Weise zu verändern. Ihre Anwendung macht die veränderbaren Eigenschaften des Dokumentes oder Berichts sichtbar.

Eine Variable kann eine Zahl sein ( zum Beispiel eine Seitenzahl, die Gesamtzahl der Seiten in einem Dokument u.s.w), 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; wird diesen Platzhalter, immer dann wenn er verwendet wird, durch den Wert der Variablen ersetzen.

Variablen können entweder fest sein (das bedeutet, daß 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 Besipielen 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 Zeiten denen sie zugeordnet werden. Informationen über Datum und Zeit können die Zeit der Erstellung eines Dokumentes anzeigen ( sie bleiben fest solange das Dokument besteht), oder das Datum und die Zeit können das Datum der letztenÄnderung des Dokumentes anzeigen (es ändert sich mit jedem neuen Tag).

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

### Ein Datum einfügen

Wenn Sie ein Datum in das Dokument einzufügen wollen platzieren Sie den Cursor (Eingabemarke) im Textfeld dort wo das Datum eingefügt werden soll und wählen auf der Menüleiste Einfügen Variable Datum . 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 Cursor (Eingabemarke) Position eingefügt. Dieses Datum wird durch einen Abgleich mit der Systemuhr des Computers festgelegt. Wenn es einmal eingefügt ist wird sich das Datum nicht mehr ändern, auch wenn &kword; aufgefordert wird die Dokument -Variablen zu aktualisieren.

  Dieses Element eignet sich besonders gut für das Datum der Erstellung des Dokuments, oder wenn Daten in einen Arbeitsbericht des Tages 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 Cursor (Eingabemarke) Position eingefügt. Dieses Datum wird durch einen Abgleich mit der Systemuhr des Computers festgelegt. Das Datum wird sich ändern, wenn &kword; aufgefordert wird die Dokument -Variablen zu aktualisieren.

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

Wenn das Datum gewählt ist erscheint ein Dialogfeld.

Das obere Ausklappfeld legt das Layout 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, daß das obere Ausklappfeld Regionales Format anzeigt. Eine Vorschau des Datumformates sehen Sie unter dem Benutzerdefiniert Kontrolfeld. Wenn Sie damit zufrieden sind klicken Sie auf OK.

Vorgefertigte Datumformate

  &kword; enthält 12 vorgefertigte Datumformate. Diese vorgefertigten Formate erfüllen in den meisten Fällen alle ihre Anforderungen. Wählen Sie einfach einvorgefertiges Format in dem oberen Ausklappfeld aus. Eine Vorschau des Datumformates sehen Sie unter dem Benutzerdefiniert Kontrollfeld. 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 | Thursday

  Monate

  Platzhalter für Monat | M | MM | MMM | MMMM
  Ein Beispiel: | 3 | 03 | Mar | March

  Jahr

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

  Sie können einfach 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, daß nur die Platzhalter sich ändern. Leerzeichen, Kommas, Schrägstriche und anderer Text bleibt unverändert.

  Sie sollten daran denken, daß Sie bei Platzhaltern die Groß-/Kleinschreibung beachten müssen. TT ist kein Platzhalter, nur tt

  Um ein eigenes Datumformat zu erstellen markieren Sie das Benutzerdefiniert Kontrollfeld.

  Geben Sie jetzt mit der Tastatur die Platzhalter und Trennzeichentext in das obere Ausklappfeld ein. Sie können das Format auch in dem Einfügen Ausklappfeld auswählen und der Platzhalter wird an der Cursorposition in das Datumformat 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 eingfügt wurde kann es danach neu gestaltet und zwischen festem und variablen Datum umgeschaltet werden. Klicken Sie dazu einfach 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 (Eingabemarke) im Textfeld dort, wo die Zeit eingefügt werden soll und wählen auf der Menüleiste Einfügen Variable Zeit . 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 Position des Cursors (Textmarke) eingefügt. Die Zeit wird durch Ableich mit der Systemuhr des Computers eingestellt. Wenn die Uhrzeit einmal eingegeben ist wird sie nicht mehr verändert, selbst 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 Position des Cursors eingefügt. Die Zeit wird durch Ableich mit der Systemuhr des Computers eingestellt. Die Zeit ändert sich wenn Sie wollen, daß&kword; die Dokument Variablen aktualisieren soll.

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

Jetzt sehen Sie einen Dialog.

Das oberste Ausklappfeld legt das Aussehen der Variablen fest. Sie können folgende Einstellungen vornehmen:

Regionales Format

  Diese fügt die Zeit in dem Format ein wie es im KDE-Kontrollzentrum festgelegt wurde.

  Um diese Einstellung auszuwählen sollten Sie überprüfen, daß das obere Ausklappfeld Regionales Format anzeigt. Eine Vorschau des Datumformates sehen Sie unter dem Benutzerdefiniert Kontrolfeld. Wenn Sie damit zufrieden sind klicken Sie auf OK.

Vorgefertigte Zeitformate

  &kword; enthält 5 vorgefertigte Zeitformate. Diese vorgefertigten Formate erfüllen in den meisten Fällen alle ihre Anforderungen. Wählen Sie einfach einvorgefertiges Format in dem oberen Ausklappfeld aus. Eine Vorschau des Zeitformates sehen Sie unter dem Benutzerdefiniert Kontrollfeld. 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 einfach 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, daß nur die Platzhalter sich verändern. Leerzeichen, Kommata und anderer Text bleibt unverändert.

  Es ist wichtig, daß Sie bei den Platzhaltern die Groß-/Kleinschreibung beachten. HH ist kein Platzhalter, nur hh.

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

  Tippen Sie mit der Tastatur die Platzhalter und den Trennzeichentext in das obere Ausklappfeld ein. Sie können aber auch das Zeitformat in dem Einfügen Kontrollfeld 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 Benutzerdefiniert > Kontrollfeld 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 Benutzerdefiniert > Kontrollfeld sehen. Wenn das Zeitformat richtig ist, klicken Sie auf OK um die Zeitvariable in das Dokument einzufügen.

Wenn die Zeit in das Dokument eingfügt wurde kann es danach 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 Gestaltung im Menü aus und die Variable wird sofort entsprechend aktualisiert.

## Seiten Nummerierung

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

Es gibt zwei Variablen die sich auf Seitenzahlen beziehen: Aktuelle SeiteundAnzahl Seiten

Um die aktuelle Seitenzahl einzufügen platzieren Sie den Cursor dort wo Sie die Zahl platzieren wollen und wählen auf der Menüleiste Einfügen Variable Seite Seitenzahl . Die Seitenzahl wird an der aktuellen Cursor Position eingefügt.

Um die Gesamtzahl der Seiten einzufügen platzieren Sie den Cursor dort 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 werden gewöhnlich am Besten innerhalb von Kopf- und Fußzeilen platziert. Das stellt sicher, daß jede Seite eine Seitenzahl am richtigen Platz hat.

## Abschnitt Titel

Sie können den Titel des Abschnitts an jeder Stelle im Dokument einfügen,indem Sie auf der Menüleiste Einfügen Variable Seite Abschnitt Titel auswählen.

&kword; bestimmt den Titel des Abschnittes indem es eine Suche vom Anfang der aktuellen Seite aus beginnt. Der erste Absatz mit dem Stil Head 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 einen Abschnitts Titel findet.

## Andere Variablen

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

Variable | Ein Beispiel: | Details
--- | --- | ---
Dateiname | Zusammenfassung.kwd | Fügt den Dateinamen des Dokuments ein.
Autorenname | Josef Nutzer | Der Name des Autors, so wie er imDokument Information Feld eingetragen ist.
Stadt | Frankfurt | Die Postleitzahl, so wie sie imDokument InformationFeld eingetragen ist.
Firma | KDE | Der Name der Firma, so wie er imDokument Information Feld eingetragen ist.
Land | Deutschland | Der Name des Landes, so wie er imDokument Information Feld eingetragen ist.
Verzeichnisname | /home/jnutzer/kword | Das ist der Name des Verzeichnisses in dem das Dokument gespeichert ist. Der Dateiname ist in der Verzeichnis Variablen 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 Dokument Information Feld eingetragen ist.
Dokumenttitel | Meine Zusammenfassung | Der Dokumenttitel, so wie er im Dokument Information Feld eingetragen ist.
E-Mail | jnutzer@kde.org | Die E-Mail Adresse, so wie sie im Dokument Information Feld eingetragen ist.
Fax | Jede gültige Telefonnummer | Die Fax-Nummer, so wie sie im Dokument Information Feld eingetragen ist.
Dateiname | Zusammenfassung.kwd | 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 imDokument InformationFeld eingetragen ist.
Straße | Hauptstr. 132 | Straße und Hausnummer so wie sie im Dokument Information Feld eingetragen sind.
Telefon | Jede gültige Telefonnummer | Die Telefonnummer, so wie sie im Dokument Information Feld eingetragen ist.
Titel | Leiterin des Rechenzentrums | Der Titel, so wie er im Autor-Abschnitt des Dokument Information Feldes eingetragen ist..

Variablen die nicht aktiviert sind erscheinen als <leer>, bis Sie ihren Inhalt im Dokumentinformation Feld eingetragen haben.

## Benutzerdefinierte Variablen

&kword; verfügt über viele voreingestellte Variablen. Sie können vielleicht abermit einem Dokument arbeiten für das sie eigene Variablen festlegen wollen.

Verwenden Sie Benutzerdefinierte Variablen und Sie können eine unbegrenzte Zahl von Variablen für jedes Dokument erstellen.

### Eine neue benutzerdefinierte Variable erstellen

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

Wählen Sie auf der Menüleiste Einfügen Variable Benutzerdefiniert Neu Ein Dialogfeld wird sichtbar.

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

Klicken Sie auf OK um den neuen Namen der Variable zu erstellen und ihn an der aktuellen Position des Cursors einzufügen. Klicken Sie auf Abbrechen um die Erstellung der neuen Variable abzubrechen.

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

### Den Wert/Inhalt einer benutzerdefinierten Variable ändern

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

Auf der Menüleiste Werkzeuge Benutzerdefinierte Variablen... auswählen. Daraufhin wird ein Dialogfeld sichtbar.

Jede benutzerdefinierte Variable hat eine Zeile in dieser Tabelle. Die erste Spalte enthält den Namen der Variablen und die zweite Spalte ihren Wert/Inhalt.

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.

### Eine benutzerdefinierte Variable einfügen

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

## Alle Werte der Variablen aktualisieren

Sie können &kword; veranlassen alle Werte der Variablen zu aktualisieren (um sicher zu sein, daß 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 Variable Alle Variablen aktualisieren .

## Den Wert einer Datum- oder Zeitvariablen aktualisieren

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 kleines Menü wird sichtbar, das verschiedene neue Datum- oder Zeitformat Optionen anzeigt und die Option, Datum oder Zeit entweder fest oder variabel zu formatieren. Wählen Sie die neue Option und diese Variable wird entsprechend aktualisiert.