# Das Handbuch zu &kile;

Jonathan
Pechta
Federico
Zenith

    federico.zenith@member.fsf.org

Holger
Danielsson

    holger.danielsson@versanet.de

Thomas
Braun
Michel
Ludwig

    michel.ludwig@kdemail.net

Felix
Mauch

    felix_mauch@web.de

Johannes
Obermayr

    johannesobermayr@gmx.de

Übersetzung
2003
Jonathan Pechta
2003
2005
2006
Federico Zenith
2005
2006
Holger Danielsson
2007
Thomas Braun
2007
2011
Michel Ludwig
2011
Felix Mauch
22.Mai 2011
2.1
&FDLNotice;

&kile; ist ein Quelltext-Editor und Baukasten für &tex; und &latex;.

KDE
kdeextragear
Kile
LaTeX
TeX

## Einleitung

### Voraussetzungen

Um &kile; zu benutzen, müssen folgende Komponenten auf dem System installiert sein:

- K Desktop Environment (&kde;): &kde; ist eine bekannte quelloffene Arbeitsflächenumgebung.

- &Qt;: &Qt; ist eine Bibliothek für C++ zur Erstellung von grafischen Benutzeroberflächen und Netzwerkunterstützung und wird zum Kompilieren von &kile; benötigt.

- &latex;: Eine professionelle Schriftsetzungs-Anwendung. Unter Unix-artigen Systemen wird wahrscheinlich auf das Paket &texlive; bzw. &tetex; (für ältere Systeme) zurückgegriffen.

Die meisten dieser Komponenten können in der verwendeten &Linux;-Distribution enthalten sein. Für die Installation sollte die Dokumentation der Distribution bzw. Installations-&CD;/DVD herangezogen werden.

&kile; ist möglicherweise bereits als kompiliertes Paket in Ihrer &Linux;-Distribution enthalten. Suchen Sie nach &kile; mit dem Paketverwaltungsprogramm Ihrer Distribution.

### Zielgruppe

Dieses Handbuch ist für jedermann - unabhängig von den Erfahrungen mit &latex;, &kde;, &kile; oder &Linux;.

Fortgeschrittene Anwender müssen diese Handbuch wohl kaum lesen. Es werden jedoch alle Vorschläge zur Dokumentation berücksichtigt. Ist die Unterstützung zu diesem Projekt oder dessen Dokumentation gewünscht, sollte der Kontakt über die &kile;-Webseite hergestellt werden.

Haben Sie Fragen zu &kile;? Treten beim Kompilieren von &kile; Fehler auf? Möchten Sie neue Funktionen hinzugefügt haben? Alle diese technischen Fragen sollten auf der Mailing-Liste kile-devel@lists.sourceforge.net angesprochen werden.

## Einleitung

### Grundsätzliches

#### Über &kile;

&kile; ist eine integrierte &latex;-Umgebung für die &kde;-Arbeitsfläche. &kile; bietet die Möglichkeit zur Nutzung aller &latex;-Funktionen in einer grafischen Oberfläche und innerhalb dieser einen einfachen, unmittelbaren und maßgeschneiderten Zugang zu allen &latex;-Programmen. Des Weiteren bietet &kile; die Möglichkeit zum Vervollständigen, Kompilieren, Nachbearbeiten und Fehlersuchen innerhalb des Quelltextes sowie Umwandlungs- und Ansichtswerkzeuge für diesen. Abschließend genannt werden müssen der leicht zu bedienende Assistent, die &latex;-Referenz und die vielseitige Projektverwaltung.

#### &kile; und die &kate;-Editorkomponente

&kile; verwendet die &kate;-Editorkomponente, deshalb sind die meisten Editiermöglichkeiten von &kate; geerbt und &kile; erweitert diese Möglichkeiten, um &latex; Dokumente zu bearbeiten. Um mehr über die &kate;-Editorkomponente und seine Fähigkeiten zu erfahren, sollten Sie die &kate;-Webseite lesen.

#### Was ist &latex;?

&latex; ist ein Textverarbeitungssystem, das von &tex; abstammt. &tex; wurde ursprünglich im Jahr 1977 von Donald Knuth entwickelt, um ihn bei der professionellen Gestaltung seiner Arbeit zu unterstützen und dabei Ergebnisse wie im professionellen manuellen Schriftsatz zu erreichen. &latex; wurde von Leslie Lamport entwickelt, um Autoren einen automatisierten Schriftsatz zu bieten (insbesondere für das teure und mühsame Setzen von mathematischen Formeln und Ausdrücken, die daher von Dollar-Zeichen ($) in &latex; eingeschlossen sind). Heutzutage können Anwender mit Textverarbeitungsprogrammen Dokumente im im Schriftsatz erstellen. Jedoch wird oftmals ein Dokument mit einem guten Aussehen gewünscht, ohne dass hierfür mehrere Stunden benötigt werden. &latex; übernimmt diese Aufgabe und lässt dem Autor die Zeit, um sich über den Inhalt und nicht das Aussehen des Dokuments Gedanken zu machen. Ja - es wird gut aussehen ...

#### Aussprache der seltsamen Schriftsetzung

Es ist eine lustige Tradition von &tex;-basierten Paketen, dass diese die seltsamste Aussprache und Schriftsetzung ermöglichen. Es wird angenommen, dass &tex; vom griechischen τεχ (lat. tech abstammt. Es existiert eine Vielzahl an Erklärungen, aber am wahrscheinlichsten ist, dass &tex; ursprünglich für die Erstellung technischer Berichte entwickelt wurde und hierbei die Möglichkeit der korrekten und einfachen Schriftsetzung von mathematischen Formeln bietet (und keine teure, zeitaufwendige und frustrierende Beschäftigung).

Für &tex; scheint die folgende Aussprache korrekt zu sein: TECH, wie im Griechischen. Viele sprechen &tex; falsch als TEK oder TEKS aus.

Für &latex; ist die richtige Aussprache: LAY-TECH. Während das ursprüngliche &tex; schwierig zu bedienen ist, kann auch ein Laie (engl. lay) &latex;-Makros verwenden. Eine weniger anspruchsvolle aber realistischere Erklärung ist, dass es vom Nachnamen von Leslie Lamport abstammt.

### &latex;-Ein-Mal-Eins

-Das &latex;-Schriftsetzungssystem ist ähnlich zu anderen Auszeichnungssprachen wie &XML; (mit dem viele Dokumentarten [und auch diese Dokumentation] erstellt werden) oder &HTML; (für Webseiten). Die generelle Idee dabei ist, spezielle Schlagwörter (sog. tags) zu verwenden, um dem Programm (Textverarbeitung, Webbrowser oder dem &latex;-Kompilierer) mitzuteilen, wie der Text dargestellt werden soll. &kile; bietet eine ganze Reihe solcher tags im Menü LaTeX.

Hier wird nur eine gute Übersicht zu &latex; gegeben, diese Dokumentation ist kein umfassendes Buch über &latex;. Um &latex; richtig zu lernen, sollten Sie sich ein Buch besorgen, das sich ausführlich mit diesem Thema befasst.

Genauso wie in jeder anderen Auszeichnungssprache besteht ein &latex;-Dokument aus einer Einleitung, in der die allgemeingültigen Eigenschaften wie Papierformat, Seitennummerierung und Textgröße festgelegt werden sowie einen Körper, der den Text des Dokuments enthält. Die Einleitung enthält mindestens den Befehl `\documentclass`, der Körper beginnt mit dem Befehl `\begin{document}` und muss mit dem Befehl `\end{document}` wieder geschlossen werden.

### Grundzüge von &kile;

#### Schnelleinstiegs-Assistent

Der Schnelleinstiegs-Assistent von &kile; ist eine nützliche Funktion für die schnelle Erstellung eines Dokuments in &kile;. Die Auswahl des Assistenten (Menü) bietet einige Möglichkeiten für die Erstellung des Dokuments. Es können auch einige auf das Dokument bezogene Einstellungen vorgenommen werden.

Dokumentklassen:

- Dokumentklassen: Hiermit wird die Art des zu erstellenden Dokuments gewählt: Artikel (article), Buch [book], Brief [letter], Bericht [report], Artikel (DIN) [scrartcl], Bericht (DIN) [scrreprt], Buch (DIN) [scrbook], Projektor [beamer], Folien [prosper] oder benutzerdefiniert.

- Schriftgröße: Hiermit wird die Schriftgröße in (pt) angegeben.

- Papierformat: Hiermit wird die Seitengröße festgelegt.

- Kodierung: Hiermit wird die Zeichenkodierung eingestellt. Es sollte die Zeichenkodierung des Systems verwendet werden. Moderne Systeme verwenden zunehmend die UTF-8-Kodierung als Standard. Bestenfalls sollte UTF-8 oder UTF-8X gewählt werden (zur korrekten Verarbeitung der &latex;-Dokumente).

- Zusätzliches: Hiermit können weitere Einstellungen für die Ausgabe vorgenommen werden.

Pakete

Diese Liste enthält die meist verwendeten Zusatzpakete für &latex;. Für die Einbindung müssen sie lediglich im Ankreuzfeld ausgewählt werden.

Dokumenteigenschaften

- Autor: Hier wird der Name des Autors eingetragen.

- Titel: Hier wird der Titel (Name) des Dokuments eingetragen.

- Datum: Hier wird das Datum (Erstellungstag) des Dokuments eingetragen.

#### Vordefinierte Vorlagen

Die vordefinierten Vorlagen in &kile; sind:

- Leeres Dokument: Ein leeres Dokument, um alles selbst in die Hand zu nehmen.

- Artikel: Ein kurzes Dokument (ohne Unterteilung in Abschnitte).

- Bericht: Ein mittelgroßes Dokument für Berichte (z. B. wird die Seitenzahl in der Ecke angegeben).

- Buch: Ein vollwertiges Dokument (z. B. für die Erstellung von Universitätsbüchern).

- Brief: Ein Format für Briefe.

- Projektor, Folien: Präsentationen im `.pdf`-Format mit einem bestechenden Design und voller &latex;-Unterstützung.

- Powerdot: Powerdot ist der Nachfolger des Paketes `seminar` und `HA-Prosper`. Es hat nicht so viele Einstellungsmöglichkeiten wie Beamer, aber es ist einfach zu nutzen und erstellt wirklich schöne PDF-Präsentationen.

- Artikel (DIN), Buch (DIN), Bericht (DIN), Brief (DIN): Die Dokumentklassen von KOMA-Script (zur Einhaltung der deutschen DIN-Vorschriften). Sie sollten bei der Erstellung deutscher Texte immer Verwendung finden.

- Xelatex: eine veränderte `Artikel`-Vorlage zum Benutzen von `XeLaTeX`.

Beachten Sie, dass alle diese Vorlagen an Ihre eigenen Bedürfnisse angepasst werden können.

Neue Anwender müssen sich nun keine Sorgen machen. Es handelt sich lediglich um eine kurze Beschreibung der verfügbaren Funktionen. Weitergehende Informationen hierzu finden Sie im Abschnitt .

#### Syntaxhervorhebung

&kile; bietet - genauso wie andere Quelltext-Editoren - die Hervorhebung der verwendeten Befehle, Einstellungen und Elemente (sowie der unpassenden). Durch &kile; wird eine einfache Problemsuche ermöglicht: Sind zum Beispiel größere Bereiche eines Textes auf dem Bildschirm in grüner Farbe, liegt es mit großer Wahrscheinlichkeit daran, dass eine mathematische Umgebung nicht geschlossen wurde.

#### Automatische Vervollständigung der Umgebungen

Mit der automatischen Vervollständigung der Umgebungen wird bei Eingabe eines neuen Befehls (z. B. `\begin{Befehl}`) von &kile; automatisch eine Leerzeile (zur Eingabe des Textes) und die dazugehörige Zeile zum Schließen des Befehls erzeugt (z. B. `\end{Befehl}`). Diese Funktion kann im Menü Einstellungen&kile; einrichten ...LaTeX Befehle deaktiviert werden.

#### Sprung zum Strukturelement

Alle Dokumente sind normalerweise in einige Elemente unterteilt. &latex; ermöglicht die Unterteilung des Dokuments in folgende Elemente (part ist das höchste und subparagraph das unterste Element):

- \part

- \chapter

- \section

- \subsection

- \subsubsection

- \paragraph

- \subparagraph

Bei der Ansicht des Dokuments in der Strukturansicht können die einzelnen Elemente durch einen Mausklick auf das jeweilige gewechselt und angesehen werden.

#### Rückwärtssuche

Bei der Erstellung der eigenen &latex;-Dateien kann die Rückwärtssuche sehr hilfreich sein. Sobald eine `&DVI;`-Datei [geräteunabhängige Datei (engl. DeVice Independent File)] oder eine PDF-Datei erstellt wurde, springt &kile; durch einen Klick mit der linken Maustaste und gleichzeitigem Drücken der &Shift;-Taste im Betrachter zur entsprechenden Zeile im &latex;-Quelltext.

Eine `&DVI;`-Datei enthält eine Beschreibung des formatierten Dokuments und auch andere Informationen wie die Schriftart und ist neben `PDF` die übliche Ausgabeart von &tex; oder &latex;. Es gibt viele Werkzeuge zur Ansicht, Umwandlung und zum Ausdrucken von `&DVI;`-Dateien für verschiedene Systeme und Geräte.

#### Vorwärtssuche

Bei Verwendung der Rückwärtssuche sind die Elemente der `&DVI;`- oder PDF-Datei mit dem Editor verknüpft und sobald auf ein Element in der `&DVI;`- oder PDF-Datei geklickt wurde, wird zum dazugehörigen Abschnitt im &latex;-Quelltext gesprungen. Die Vorwärtssuche ist das genaue Gegenteil davon. Sobald auf einen Abschnitt im &latex;-Quelltext geklickt wurde, wird zur entsprechenden Stelle im Betrachter gesprungen.

### Die Werkzeugleiste

- Neu: Hiermit kann ein neues Dokument erstellt werden.

- Öffnen: Zur Öffnung eines gespeicherten Dokuments.

- Schließen: Das aktuelle Dokument wird geschlossen.

- Master-Dokument: Diese Funktion wird bei der Arbeit mit mehreren Dateien verwendet. Mit einem Master-Dokument wird die Arbeit mit anderen eingebunden `.tex`-Dateien vereinfacht. Bei der Verwendung eines Projekts kann ein projektweites Master-Dokument über Projekt Projekteinstellungen eingestellt werden.

- Schnellbau: Der &latex;-Quelltext wird kompiliert und das Ergebnis automatisch angezeigt, sofern keine Fehler im Quelltext vorliegen.

- Dateiüberwachungsmodus: In diesem Modus wird die `&DVI;`-Datei auf Änderungen „überwacht“ und es erfolgt kein Aufruf von &okular; nach dem Schnellbau.

- Protokoll ansehen: Die Protokolldatei wird zur Fehlersuche angezeigt.

- Vorheriger Fehler: Springt zum vorhergehenden Fehler innerhalb der Protokolldatei (`.log`-Datei) und hebt die Fehler im Quelltext hervor.

- Nächster Fehler: Springt zum nächsten Fehler innerhalb der Protokolldatei (`.log`-Datei) und hebt die Fehler im Quelltext hervor.

- Anhalten: Das aktuelle Werkzeug wird angehalten.

- LaTeX: &latex; wird auf das aktuelle Dokument angewendet.

- DVI-Betrachter: Startet den `&DVI;`-Betrachter.

- DVI zu PS: Wandelt eine `&DVI;`-Datei in eine &PostScript;-Datei (`PS`) um.

- PS-Betrachter: Startet den &PostScript;-Betrachter.

- PDFLaTeX: &pdflatex; wird auf das aktuelle Dokument angewendet.

- PDF-Betrachter: Startet den PDF-Betrachter.

- DVI zu PDF: Wandelt eine `&DVI;`-Datei in eine `PDF`-Datei um.

- PS zu PDF: Wandelt eine `PS`-Datei in eine `PDF`-Datei um.

- HTML-Betrachter: Zeigt erstellte `&HTML;`-Dateien an.

- DVI-Vorwärtssuche: Springt zu der Seite der &DVI;-Datei, die zur aktuellen Zeile im Editor gehört.

- PDF-Vorwärtssuche: Springt zu der Seite der PDF-Datei, die zur aktuellen Zeile im Editor gehört.

Bei Betrachtung der Bearbeiten-Werkzeugleiste sollten die drei großen Auswahlfelder auffallen. Die Auswahlfelder wurden für das schnelle Einfügen gemeinsamer Elemente in das Dokument entwickelt. Das erste Auswahlfeld ist für die schnelle Gliederung des Dokuments in Teile, Kapitel, Abschnitte, ... Die verfügbaren &latex;-Befehle für die Unterteilung sind:

- Teil: Höchste Ebene der Gliederung eines Dokuments.

- Kapitel: Beginnt ein neues Kapitel.

- Abschnitt: Beginnt einen neuen Abschnitt.

- Unterabschnitt: Beginnt einen neuen Unterabschnitt.

- Unter-Unterabschnitt: Eine zweite Unterteilung zwischen Unterabsatz und Paragraf.

- Paragraf: Beginnt einen neuen Paragraf.

- Unterabsatz: Beginnt einen neuen Unterabsatz.

Das Auswahlfeld Weitere ist zum Einfügen von Artikeln wie z. B. Stichworte, Fußnoten oder Verweise. Die verfügbaren Möglichkeiten sind:

- Bezeichnung: Mit diesem Befehl wird eine Bezeichnung für einen Abschnitt, ein Bild oder anders Element erstellt.

- Stichwort: Erstellt einen Eintrag im Stichwortverzeichnis.

- Fußnote: Erstellt eine Fußnote im Dokument.

- Bezug: Wird für den Verweis auf eine festgelegte Bezeichnung verwendet (Auswahl über ein Auswahlfeld möglich).

- Seitenbezug: Im Unterschied zu Bezug erfolgt der Verweis auf eine Seite und nicht auf ein Strukturelement.

- Zitat: Erstellt einen Verweis mit Daten anderer Schriftstücke.

Das Auswahlfeld Weitere
Das Auswahlfeld Weitere

Das Auswahlfeld Weitere

Auswahl des Labels für einen Bezug
Auswahl des Labels für einen Bezug

Auswahl des Labels für einen Bezug

Beim Verwenden von Zitat wird eine Auswahlliste mit literarischen Einträgen angezeigt. Bei &bibtex; funktioniert dies nur, wenn die Datei zu einem Projekt gehört. Für das Bearbeiten von &bibtex;-Dateien sind entsprechende Editoren notwendig. Der Autor hat gute Erfahrungen mit &kbibtex; und &kbib;. Die &bibtex;-Dateien können natürlich auch in &kile; von Hand geschrieben werden.

Das letzte Auswahlfeld mit dem Namen Größe wird für die Festlegung der Schriftgröße verwendet. Es können die Schriftgrößen für den Haupttext, die Fußnoten usw. festgelegt werden. Es stehen folgende Schriftgrößen zur Verfügung:

- Winzig klein: Die kleinste Schriftgröße.

- Sehr klein (wie Indizes): Eine sehr kleine Schriftgröße.

- Kleiner (wie Fußnoten): Eine kleinere Schriftgröße (in Fußnotengröße).

- Klein: Eine kleine Schriftgröße.

- Normal: Die normale Schriftgröße.

- Groß: Eine große Schriftgröße.

- Größer: Eine größere Schriftgröße.

- Sehr groß: Eine sehr große Schriftgröße.

- Riesig: Eine noch größere Schriftgröße.

- Gigantisch: Die größte Schriftgröße.

## Schnelleinstieg

### Anfängerkurs zur Erstellung eines &latex;-Dokuments in &kile;

Beim Aufruf von &kile; stehen zwei Auswahlmöglichkeiten zur Verfügung: 1. Der Assistent für die Erstellung eines neuen Dokuments durch Auswahl der Dokumentenart und Festlegend der Einstellungen. 2. Das Dokument kann von Grund auf mit der Hand geschrieben werden.

    \documentclass[12pt]{article}
    \begin{document}
            Ein Beispieltext (in LaTeX).
    \end{document}

Jedes &latex;-Dokument beginnt mit dem Befehl `\documentclass[Einstellung]{Klasse}`, wobei `{Klasse}` die Dokumentenart festlegt.

Durch Eingabe des obigen Quelltext-Beispiels wird die folgende Ausgabe erreicht:

Kompilierter Text in der `&DVI;`-Ausgabe
Kompilierter Text in der `&DVI;`-Ausgabe

Kompilierter Text in der `&DVI;`-Ausgabe

Die Klammern nach dem Befehl `\documentclass` enthalten die Einstellungen für den Befehl. Die Einstellung `[12pt]` legt die Schriftgröße fest. Wird die Schriftgröße nicht zu Beginn festgelegt, kann dies auch später im Text geschehen.

Sobald das obige Quelltext-Beispiel eingegeben wurde muss der &latex;-Quelltext kompiliert werden. Der einfachste Weg hierzu ist die Verwendung des Menüs Bauen oder des Knopfs Schnellbau.

&Alt;2 ist das Tastaturkürzel für das Kompilieren des Quelltextes.

Der Quelltext muss vor dem Kompilieren gespeichert werden. &kile; führt die Speicherung automatisch aus.

Schlägt das Kompilieren des Dokuments fehl, sollte in der Protokolldatei nach den Fehlern gesucht werden. Bei Verwendung von Schnellbau sollte &okular; automatisch gestartet werden. Ist dies nicht der Fall, sollte ebenfalls die Protokolldatei beachtet werden.

### Umgebungen

Eine Umgebung (engl. environment) ist ein Text, der anders als das restliche Dokument behandelt wird. Wird beispielsweise ein Bericht mit der Schriftgröße 12 erstellt und nur ein paar Sätze sollen eine andere Schriftgröße haben. Der Befehl `\begin{environment}`, `\huge` und `\end{environment}` ermöglicht sodann die Änderung der Schriftgröße innerhalb der Umgebung zu „Riesig“ (engl. huge).

Die Änderungen werden lediglich innerhalb der Umgebung (von `\begin{environment}` bis `\end{environment}`) berücksichtigt. Es gibt keine Beschränkung (Anzahl) für die Änderungen innerhalb einer Umgebung.

Es gibt viele Möglichkeiten zur Erhöhung der Lesbarkeit und Benutzerfreundlichkeit des Dokuments. Es können beispielsweise bestimmte Schriftarten, Fettdruck, Kursivdruck, Unterstreichungen, usw. hinzugefügt werden. Diese Befehle enden entweder mit dem Befehl `\end` oder automatisch am Ende der Umgebung.

- `\begin{emph}`: Dieser Befehl ist für den Kursivdruck und ist solange gültig, bis er mit einem `\end{emph}` oder einer anderen Umgebung geschlossen wird. Ein einzelnes Wort in einem Satz kann mit `\emph{Wort}` kursiv dargestellt werden.

- `\textbf{Fettgedruckter Text}`: Dieser Befehl ist für den Fettdruck.

- `\quote`: Erstellt ein Zitat im Dokument. Das Zitat beginnt mit `\begin{quote}` und endet mit `\end{quote}`.

- `\center`: Zentriert den Text.

- `\verse`: Erstellt einen Absatz für Gedichte.

- `\itemize`: Erstellt eine Strich-Aufzählung.

### &kile; verwenden

Nachdem der Hintergrund zum Schreiben des Quelltextes mit der &latex;-Auszeichnungssprache dargestellt wurde, folgt nun eine Schritt-für-Schritt-Anleitung für die Erstellung eines Dokuments in &kile;.

1. &kile; aufrufen.

2. Im Menü Assistent Schnellstart aufrufen, das Format auswählen und die Einstellungen festlegen.

3. Sobald im Assistenten ein bisschen Text eingegeben wurde, sollten ein paar Anpassungen für die bessere Lesbarkeit des Dokuments vollzogen werden. Hierzu sollten mindestens ein Zitat, ein paar Stellen im Fett- und Kursivdruck und ein Gedicht zur Anwendung kommen, um die Unterschiede dieser Befehle zu sehen.

4. Die Datei unter dem Namen `intro.tex` speichern.

5. Das Dokument mittels Tastenkürzel &Alt;2 oder Knopf LaTeX bauen.

6. DVI-Betrachter auswählen.

7. Jetzt kann der neue Text betrachtet werden.

8. Sobald das Dokument angesehen wurde, kann mittels Editor-Ansicht oder &Ctrl;E wieder zum Editor zurückgekehrt werden (beim internen Betrachter). Bei einem externen Betrachter muss dessen Fenster geschlossen werden.

Das ist es - Das erste &latex;-Dokument ist erstellt.

Sobald die `&DVI;`-Datei erstellt wurde, kann das Dokument ausgedruckt oder in eine &PostScript;/`PDF`-Datei umgewandelt werden. Einfach ausprobieren und Spaß haben.

### `&DVI;`-Dateien

`&DVI;` ist ein geräteunabhängiges Dateiformat (engl. DeVice Independent). Diese Dateien werden von &tex; oder &latex; für die Lesbarkeit von einigen Treibern des Computers erstellt. Es gibt viele verschiedene Arten der `.dvi`-Ausgabe wie Drucker, &PostScript;/`PDF`-Umwandler oder Computerbildschirme.

#### `&DVI;`-Datei ansehen

Der Knopf DVI betrachten in der Werkzeugleiste sollte bereit aufgefallen sein.

#### `&DVI;`-Datei ausdrucken

Für das Drucken einer &DVI;-Datei sind dieselben Schritte wie für die Erstellung des Dokuments nötig (siehe ). Beim 7. Schritt - nach dem Klicken auf DVI betrachten - kann dann das Dokument mittels Datei Drucken (im Betrachter) ausgedruckt werden (sofern der Drucker richtig eingestellt ist).

#### `&DVI;`-Dateien umwandeln

Die Werkzeugleiste ermöglicht die Umwandlung der `&DVI;`-Datei in andere Formate. Sobald die `&DVI;`-Datei aus dem &latex;-Quelltext erstellt wurde, kann die Umwandlung in gewünschte andere Formate mittels der Knöpfe in der Werkzeugleiste beginnen.

### Vorwärtssuche zwischen &kile; und &okular;

Die Vorwärtssuche ermöglicht den direkten Sprung vom Editor zur dazugehörigen Position innerhalb der `&DVI;`- oder PDF-Datei.

&kile; bietet eine entsprechende Einstellung für alle &latex;-Binärdateien. Hierzu muss lediglich Modern unter Einstellungen Kile einrichten ...Werkzeuge Bauen ausgewählt werden.

Um die Vorwärtssuche auszuführen, muss der Mauszeiger in einer Zeile des Quelltextes positioniert und anschließend auf Vorwärtssuche geklickt werden. Der Sprung zur entsprechenden Stelle im Betrachter erfolgt sodann.

### Rückwärtssuche zwischen &kile; und &okular;

Die Rückwärtssuche ist beim Schreiben eines &latex;-Dokuments sehr hilfreich. Wenn alles richtig eingestellt ist, kann sie in &okular; durch Klicken mit der &LMB; und der &Shift;-Taste ausgeführt werden. &kile; lädt die &latex;-Quelldatei und springt zur entsprechenden Stelle. Um die Rückwärtssuche verwenden zu können, muss die &latex;-Datei mit der Einstellung Modern kompiliert werden.

Die folgenden Voraussetzungen sind für die Rückwärtssuche notwendig:

- Die Quelldatei wurde erfolgreich kompiliert.

- Der Editor, den Sie verwenden möchten, muss in &okular; eingestellt werden.

Mit dieser Funktion in &okular; wird mit einem Klick der &LMBn; und dem Gedrückthalten der &Shift;-Taste im `&DVI;`- oder PDF-Dokument das entsprechende &latex;-Dokument von &kile; geöffnet und zur entsprechenden Zeile gesprungen. Hierzu muss &kile; in &okular; als Texteditor festgelegt werden (Einstellungen Okular einrichten ...Editor)

&okular; einrichten
&okular; einrichten

&okular; einrichten

### Fehlerbehebung

Sollte beim Verwenden von Schnellbau der &DVI;-Betrachter nicht öffnen, kann ein Fehler vorliegen. Sollte ein Fehler vorliegen, wird dies in der Protokolldatei bzw. im Nachrichtenfenster zusammenfassend angezeigt.

Die Protokolldatei erklärt die Fehlerquelle im Quelltext. Im Editor können dann die Knöpfe Vorheriger LaTeX-Fehler und Nächster LaTeX-Fehler für Sprünge zwischen den Fehlern verwendet werden. Die Protokolldatei gibt immer die Zeile an, in der der Fehler erscheint. Um die fehlerhafte Zeile zu betrachten, muss auf den Fehler im Protokoll geklickt werden und &kile; springt zur fehlerhaften Zeile.

## Ein neues Dokument erstellen

Sobald auf den entsprechenden Knopf in der Werkzeugleiste geklickt wird, erscheint ein Fenster zur Auswahl der zu verwendenden Vorlage für das Dokument. Die voreingestellten Möglichkeiten sind:

- Leeres Dokument

- Artikel

- Projektor

- Buch

- Folie

- Powerdot

- Brief

- Bericht

- Artikel (DIN) -> vom KOMA-Skript-Paket

- Buch (DIN) -> vom KOMA-Skript-Paket

- Brief (DIN) -> vom KOMA-Skript-Paket

- Bericht (DIN) -> vom KOMA-Skript-Paket

- PDF

- XeLaTeX

Bei Auswahl von Leeres Dokument kann ein Dokument entweder von Grund auf neu geschrieben oder der Assistent zur schnellen Erstellung eines neuen Dokuments verwendet werden. Weitere Informationen hierzu sind im Abschnitt enthalten.

### Vorlagen

Häufige Anwender von &latex; verwenden meist die gleiche Einleitung für nahezu alle Dokumente. Vorlagen können in &kile; erstellt, gespeichert und geladen werden, um die Erstellung eines neuen Dokuments zu erleichtern.

#### Eine neue Vorlage erstellen

Um eine neue Vorlage zu erstellen, muss entweder eine bestehende &tex;-/&latex;-Datei geöffnet oder eine neue Datei erstellt werden. &kile; kann eine neue Vorlage mittels Öffnen eines bestehenden Dokuments und Auswahl von Datei Vorlage aus Dokument erstellen ... erstellen.

#### Automatisches Ersetzen einstellen

Beim Erstellen eines neuen Dokuments aus ein Vorlage mittels Datei Neu werden einige Zeichenketten durch andere Daten ersetzt (z. B. Name oder Zeichenkodierung). Diese Variablen können in Einstellungen Kile einrichten ...Einstellungen Allgemein eingestellt werden.

Beim Erstellen der eigenen Vorlage ist es daher notwendig zu wissen, welche Zeichenketten von welchen Variablen ersetzt werden:

- `$$AUTHOR$$`: Diese Zeichenkette wird durch die Eingabe in Autor ersetzt.

- `$$DOCUMENTCLASSOPTIONS$$`: Diese Zeichenkette wird durch die Eingabe in Dokumentklasse ersetzt. Typischerweise wird sie folgendermaßen verwendet: `\documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}`.

- `$$INPUTENCODING$$`: Sollte in Kodierung beispielsweise `latin1` ausgewählt werden, wird diese Zeichenkette durch `\input[latin1]{inputenc}` ersetzt.

#### Eine Vorlage mit dem Assistenten erstellen

Der einfachste Weg zum Erstellen einer Vorlage ist die Verwendung des Assistenten und das damit verbunde Einfügen der Befehle im Editor. Sobald das Dokument auf diese Weise erstellt wurde müssen folgende Schritte vollzogen werden:

1. Die Datei speichern

2. Das Menü Datei öffnen

3. Vorlage aus Dokument erstellen ... auswählen

4. Die erforderlichen Änderungen an der Vorlage vornehmen

5. Einen Namen für die neue Vorlage eingeben

6. Auf OK drücken, um die Vorlage zum Menü hinzuzufügen.

Beim Erstellen eines neuen Dokuments kann dann die eigene Vorlage anstatt der standardmäßigen ausgewählt werden.

#### Eine Vorlage aus jeglicher Datei erstellen

Eine Vorlage kann aus jeglichen &latex;-Dateien erstellt werden. Wird eine einfache Weise zur Erstellung einer Vorlage gewünscht, sollte nach einer im Internet gesucht und die unter beschriebenen Schritte durchgeführt werden.

Möglicherweise soll ein vollwertiges Poster im DIN-A0-Format erstellt werden. Diese Poster sieht man meist in wissenschaftlichen Veranstaltungen und &latex; wird beim Erstellen eines attraktiven und einprägenden Posters hilfreich sein. Eine Vorlage für Poster im DIN-A0-Format gibt es auf der Webseite von Jonathan Marchini (aber auch weitere sind vorhanden). Hierfür ist das Paket `a0poster` notwendig, welches üblicherweise nicht standardmäßig mit &tex; ausgeliefert wird. Es kann hier heruntergeladen werden und muss sich dann im selben Ordner wie die &latex;-Datei befinden.

#### Eine Vorlage entfernen

Zum Entfernen einer Vorlage aus &kile; müssen die folgenden Schritte ausgeführt werden:

1. Das Menü Datei Vorlage entfernen ... öffnen

2. Ein Fenster mit allen Vorlagen erscheint und eine davon ist auszuwählen

3. Nach dem Drücken auf OK wird die Vorlage entfernt.

Die mit einem Stern (*) markierten Vorlagen können ohne die notwendigen Berechtigungen nicht entfernt werden.

## &latex;-Dokumente bearbeiten

&kile; verwendet &kate; als internen Editor. &kate; ist ein Texteditor für Programmierer mit der Möglichkeit des Lesens und Hervorhebens von vielen verschiedenen Arten von Textdateien (darunter auch &latex; und &bibtex;). Viele Einstellungen für &kate; können im Menü Werkzeuge direkt aus &kile; heraus vorgenommen werden.

Um mehr über &kate; und seine Möglichkeiten zu erfahren sollte das Handbuch zu Kate herangezogen werden. Anwender von &kile; können dort direkt mit dem Lesen des Kapitels Arbeiten mit dem Editor von &kate; beginnen.

### Die &latex;-Referenz

&kile; bietet eine sehr praktische &latex;-Befehlsreferenz, welche über das Menü Hilfe LaTeX-Referenz aufgerufen werden kann. Sie enthält eine ausführliche Beschreibung nahezu aller Befehle, die in &latex; Verwendung finden können sowie deren Syntax.

### Cursor-Bewegungen

Für die Auswahl eines Textes gibt es folgende Möglichkeiten:

- Die linke Maustaste gedrückt halten und die Maus bewegen, um den Text hervorzuheben.

- Ein einfacher Klick auf ein Wort, um den Cursor dorthin zu bewegen.

- Ein Doppelklick, um ein komplettes Wort auszuwählen.

- Ein Doppelklick mit gedrückter Strg-Taste, um das &tex;-Wort auszuwählen. Das bedeutet, dass auf diese Weise beim Klicken auf `\par` von `\par\bigskip` lediglich `\par` ausgewählt wird.

- Ein dreifacher Mausklick, um den kompletten Satz auszuwählen.

Beim Ziehen des Textes mit gedrückter linker Maustaste wird der ausgewählte Text automatisch in die Zwischenablage kopiert.

Bei Verwendung der Pfeiltasten mit gedrückter &Shift;taste können Teile des Quelltextes im Editorfenster ausgewählt werden.

### Klammern

Die Klammervervollständigung ist ein visuelles Werkzeug mit dem der Editor verdeutlicht, welche Klammern zusammengehören. Beim Öffnen einer beliebigen `.tex`-Datei und anschließende Auswahl einer Klammer - egal ob runde (), eckige [] oder geschweifte {} - wird der Editor die gewählte und die dazugehörige Klammer in gelb hervorheben (Standardfarbe, die verändert werden kann).

### Hervorhebungen

&kile; hat die Möglichkeit die verschiedensten Arten von Quelltexten zu durchsuchen und diese hervorzuheben. Beispielsweise unterscheiden sich die &latex;-Befehle vom normalen Text und auch die mathematischen Formeln sind durch eine andere Farbe hervorgehoben.

### Sprungmarken

Viele Assistenten können zusätzliche Sprungmarken einfügen. Dabei handelt es sich um eine eigene Art von Lesezeichen innerhalb des Textes. Die Menüeinträge Bearbeiten Sprungmarken oder die entsprechenden Tastenkürzel ermöglichen den Sprung zur nächsten oder letzten Sprungmarke. Dabei wird auch diese Sprungmarke hervorgehoben, sodass sie bei der ersten Eingabe eines Zeichens automatisch gelöscht wird.

Sprungmarken
Sprungmarken

&Ctrl;&Alt;Pfeil rechts Nächste Sprungmarke

  Springt zur nächsten Sprungmarke im Text (sofern vorhanden).

&Ctrl;&Alt;Pfeil links Vorherige Sprungmarke

  Springt zur vorherigen Sprungmarke im Text (sofern vorhanden).

### Auswahl

Das Bearbeiten ist wahrscheinlich einer der Hauptaspekte beim Verwenden eines Programms wie &kile;. Obwohl &kate; bereits hervorragende Möglichkeiten bietet, wurden in &kile; wichtige Funktionen für das Schreiben eines &latex;-Quelltextes hinzugefügt. &latex; benötigt immer viele Umgebungen und Gruppen und deshalb unterstützt &kile; spezielle Befehle für deren Auswahl. Unter Bearbeiten Auswählen sind die folgenden Befehle zur Textauswahl enthalten:

Bearbeiten Auswählen
Bearbeiten Auswählen

&Ctrl;&Alt;S,E Umgebung (Inhalt)

  Wählen Sie eine Umgebung ohne die umrahmenden Markierung. Wird dieser Befehl aufgerufen, wenn bereits eine Umgebung ausgewählt ist, erweitert &kile; den Abschnitt bis zur nächsten umliegenden Umgebung.

&Ctrl;&Alt;S,F Umgebung (Außerhalb)

  Wählen Sie eine Umgebung mit den sie umgebenden Markierungen. Dieser Abschnitt wird durch einen zweiten Aufruf dieses Befehls erweitert.

&Ctrl;&Alt;S,T TeX-Gruppe (Inhalt)

  Wählt den Inhalt einer &tex;-Gruppe aus (ohne umschließende Befehle).

&Ctrl;&Alt;S,U TeX-Gruppe (Außerhalb)

  Wählt eine &tex;-Gruppe komplett aus (einschl. umschließender Befehle).

&Ctrl;&Alt;S,M Mathematische Gruppe

  Wählt eine mathematischen Gruppe komplett aus (einschl. umschließender Befehle).

&Ctrl;&Alt;S,P Absatz

  Wählt einen kompletten Absatz aus (Gruppe von Zeilen, die auf beiden Seiten eine leere Zeile enthalten). Mit einem Absatz ist dabei nicht ein Text mit durchgängigen Zeilen gemeint (wie in anderen Texteditoren). Diese erweiterte Bedeutung schließt damit Tabellen, &latex;-Befehle und alle anderen Zeilen des Quelltextes ein. Die einzig beudeutende Sache in &kile; ist damit, dass die Absätze durch zwei leere Zeilen getrennt sind.

&Ctrl;&Alt;S,L Zeile

  Wählt die Textzeile unter der aktuellen Cursor-Position aus.

&Ctrl;&Alt;S,W TeX-Gruppe

  Wählt das Wort unter der aktuellen Cursor-Position aus. Diese Auswahl hat auch eine erweiterte Bedeutung, da dieser Befehl auch &latex;-Befehle mit einem Rückwärtsschrägstrich (`\`) und einem zusätzlichen Stern (`*`) am Ende auswählt.

#### Wählen Sie die &latex;-Befehle

&kile; besitzt die fortgeschrittene Funktion &latex;-Befehle auszuwählen. Wenn Sie beispielsweise folgendes eingegeben haben

    Text \bfseries\itshape weiterer Text

und ein Doppelklick auf einen der &latex;-Befehle, wählt beide aus. Aber oft wollen Sie nur einen der Befehle auswählen. Dies ist möglich durch Nutzung der &Ctrl;-Taste. Sie müssen die &Ctrl;-Taste gedrückt halten und eine Doppelklick wählt lediglich den gewünschten Befehl aus.

### Entfernen

Zum Löschen eines Teils des Dokuments kann natürlich dieser zuerst ausgewählt und durch Drücken der Taste Entf entfernt werden. &kate; bietet das Tastenkürzel &Ctrl;K mit dem die gesamte Zeile entfernt wird. &kile; bietet mit eigenen Befehlen hierfür eine schnellere Möglichkeit. Unter Bearbeiten Entfernen sind die folgenden Befehle zum Löschen des Textes enthalten:

Bearbeiten Entfernen
Bearbeiten Entfernen

&Ctrl;&Alt;T,E Umgebung (Inhalt)

  Entfernt den Inhalt einer Umgebung (ohne umschließende Befehle).

&Ctrl;&Alt;T,F Umgebung (Komplett)

  Entfernt die komplette Umgebung (einschl. umschließender Befehle).

&Ctrl;&Alt;T,T TeX-Gruppe (Inhalt)

  Entfernt den Inhalt einer &tex;-Gruppe (ohne umschließende Klammern).

&Ctrl;&Alt;T,U TeX-Gruppe (Komplett)

  Entfernt die komplette &tex;-Gruppe (einschl. umschließender Klammern).

&Ctrl;&Alt;T,M Mathematische Gruppe

  Entfernt die aktuelle mathematische Gruppe (einschl. der math. Befehle).

&Ctrl;&Alt;T,P Absatz

  Entfernt einen kompletten Absatz. Die Definition für einen Absatz in &kile; ist in der Beschreibung zu Bearbeiten Auswählen Absatz enthalten.

&Ctrl;&Alt;T,I Bis Zeilenende

  Entfernt den Text von der aktuellen Cursor-Position bis zum Zeilenende.

&Ctrl;&Alt;T,W TeX-Wort

  Entfernt das Wort oder den &latex;-Befehl unter der aktuellen Cursor-Position.

### Umgebung

Es wurde bereits verdeutlicht, dass Umgebungen eine zentrale Rolle in &latex; spielen. Deshalb bietet &kile; fünf weitere Befehle unter Bearbeiten Umgebung für eine möglichst einfache Arbeit mit &latex;.

Bearbeiten Umgebung
Bearbeiten Umgebung

&Ctrl;&Alt;E,B Zum Anfang springen

  Mit diesem Befehl wird zum Anfang der aktuellen Umgebung gesprungen (egal wo die aktuelle Position ist). Der Cursor wird direkt vor dem Befehl zum Öffnen der Umgebung platziert.

&Ctrl;&Alt;E,E Zum Ende springen

  Mit diesem Befehl wird zum Ende der aktuellen Umgebung gesprungen (egal wo die aktuelle Position ist). Der Cursor wird direkt hinter dem Befehl zum Schließen der Umgebung platziert.

&Ctrl;&Alt;E,M Übereinstimmung

  Wenn sich der Cursor vor oder innerhalb des Befehls `\begin{Umgebung}` befindet, wird zum Ende der Umgebung gesprungen (oder umgekehrt).

&Ctrl;&Alt;E,C Schließen

  Bei der Eingabe von vielen verschachtelten Umgebungs-Befehlen kann schnell der Überblick darüber verloren gehen. Dieser Befehl schließt die zuletzt geöffnete Umgebung, sodass die verschachtelte Umgebungsstruktur nicht zerstört wird.

&Ctrl;&Alt;E,A Alle schließen

  Schließt alle offenen Umgebungen (nicht nur die zuletzt geöffnete).

### &tex;-Gruppe

&kile; bietet auch spezielle Befehle für die &latex;-Gruppen, die durch Klammern `{ ... }` bestimmt werden. Unter Bearbeiten TeX-Gruppe sind ein paar wichtige Befehle, die denen aus Bearbeiten Umgebung entsprechen.

Bearbeiten TeX-Gruppe
Bearbeiten Auswählen

&Ctrl;&Alt;G,B Zum Anfang springen

  Mit diesem Befehl wird zum Anfang der aktuellen Gruppe gesprungen (egal wo die aktuelle Position ist). Der Cursor wird direkt vor der geschweiften öffnenden Klammer platziert.

&Ctrl;&Alt;G,E Zum Ende springen

  Mit diesem Befehl wird zum Ende der aktuellen Gruppe gesprungen (egal wo die aktuelle Position ist). Der Cursor wird direkt hinter der geschweiften schließenden Klammer platziert.

&Ctrl;&Alt;G,M Übereinstimmung

  Wenn sich der Cursor vor oder hinter der geschweiften Klammer einer &tex;-Gruppe # befindet, wird zum anderen Ende der Gruppe gesprungen (oder umgekehrt).

&Ctrl;&Alt;G,C Schließen

  Bei der Eingabe von vielen verschachtelten geschweiften Gruppen-Klammern kann schnell der Überblick darüber verloren gehen. Dieser Befehl schließt die zuletzt geöffnete Gruppe, sodass die verschachtelte Struktur der &tex;-Gruppen nicht zerstört wird.

### Doppelte Anführungszeichen

In &latex; werden zwei einfache Anführungszeichen als Gänsefüsschen verwendet. Für die zweckbringende Umsetzung wird in &kile; das Zeichen " für zwei einfache Anführungszeichen verwendet. Auch für das Beenden der Anführung wird das Zeichen " verwendet. &kile; kennt diesen Fall und fügt zwei schließende Anführungszeichen für &latex; ein.

Für das Einfügen eines Gänsefüsschens sind zwei " (also "") notwendig.

Dieses automatische Einfügen der doppelten Anführungszeichen kann unter Einstellungen Kile einrichten ...LaTeX ein- und ausgeschalten werden.

Doppelte Anführungszeichen
Doppelte Anführungszeichen

Es können auch länderspezifische Einstellungen (z. B. `ngerman` oder `french`) und damit deutsche oder französische Anführungszeichen verwendet werden. Es sind auch viele weitere Sprachen verfügbar.

### Intelligenter Zeilenumbruch

Beim Drücken von &Ctrl;Eingabetaste fügt &kile; einen intelligenten Zeilenumbruch ein. Falls sich die aktuelle Position innerhalb einer Listen-Umgebung (z. B. `enumerate` oder `itemize`) befindet, fügt &kile; nicht nur einen Zeilenumbruch sondern zugleich den Befehl `\item` ein.

Innerhalb einer Tabellen-Umgebung schließt &kile; die aktuelle Zeile mit `\\` mit einem anschließenden Zeilenumbruch ab.

Innerhalb eines &latex;-Kommentars beginnt &kile; die neue Zeile mit `%`.

Sogar noch besser - &kile; ist intelligent genug, um voreingestellte &latex;- oder benutzerdefinierte Umgebungen zu unterstützen. Diese können unter Einstellungen&kile; einrichten ...LaTeX hinzugefügt werden.

### Intelligenter Tabulator

Einige Anwender möchten die Spalten in Tabellen-Umgebungen und dabei alle Et-Zeichen (&) untereinander anordnen. &kile; versucht dies zu ermöglichen. Beim Drücken von &Alt;&Shift;& sucht &kile; nach dem nächsten Tabulator in der darüberliegenden Zeile. Obwohl dieser Tabulator möglicherweise nicht der dazugehörige ist, fügt &kile; einigen Zwischenraum für die Spaltenposition des aktuellen Tabulators hinzu.

## Quelltext-Vervollständigung

Obwohl &kate; bereits eine gute Quelltext-Vervollständigung bietet, wurde diese in &kile; um spezielle Befehle (meist für &latex;) noch erweitert. Es sind fünf verschiedene Modi eingebaut. Davon arbeiten drei nach Bedarf und die anderen beiden sind für die automatische Vervollständigung. Alle diese Modi können für unterschiedliche Arbeitsweisen unter Einstellungen Kile einrichten ...Vervollständigen eingestellt werden.

### Automatische Umgebungs-Vervollständigung

Beim Beginn eine neuen Umgebung mittels dem Befehl `\begin{Umgebung}` wird &kile; automatisch den Befehl `\end{Umgebung}` nach einer leeren Zeile (für den Text) hinzufügen.

Die automatische Vervollständigung kann in den Einstellungen (Einstellungen&kile; einrichten ...LaTeX Umgebungen) abgeschalten werden.

Vervollständigung einer „equation“-Umgebung
Vervollständigung einer „equation“-Umgebung

Vervollständigung einer „equation“-Umgebung

### &latex;-Befehle

Bei der Eingabe einiger Buchstaben kann die Vervollständigung für &latex;-Befehle und normale Wörter mittels Bearbeiten Vervollständigen(La)TeX-Befehl oder dem Tastenkürzel &Ctrl;&Shift;Leertaste aktiviert werden. &kile; liest zuerst die Buchstaben von der aktuellen Position des Cursors nach links und stoppt beim ersten Zeichen, das kein Buchstabe ist (z. B. Leerschritt oder Rückwärtsschrägstrich). Sollte das Eingelesene mit einem Rückwärtsschrägstrich (= /) beginnen, wird &kile; die Vervollständigung der &tex;- oder &latex;-Befehle aktivieren. Anderenfalls wird die Vervollständigung über das normale Wörterbuch (ohne &latex;-Befehle) aktiviert. Abhängig vom gewählten Modus wird eine Auswahlliste geöffnet, in der alle Befehle oder Wörter enthalten sind, die mit dem bereits Eingegebenem bzw. dem Eingelesenem beginnen. Mit den Pfeiltasten kann durch diese Liste geblättert und ein Eintrag mittels der Eingabetaste oder einem Doppelklick mit der Maus ausgewählt werden

Vervollständigung eines &latex;-Befehls
Vervollständigung eines &latex;-Befehls

Beim Drücken der Rücktaste wird der letzte Buchstabe der Eingabe entfernt und möglicherweise vergrößert sich dadurch die Vervollständigungsliste. Andererseits kann sich die Liste durch Eingabe eines weiteren Buchstaben auch verkleinern.

Soll keiner der Vorschläge Verwendung finden, kann der Dialog mittels Esc verlassen werden.

Alle Befehle werden mit einer kurzen Beschreibung ihrer Parameter geschrieben. Die Beschreibungen werden natürlich bei Auswahl eines Befehls entfernt. Alternativ können von &kile; auch Sprungmarken eingefügt werden, sodass ein einfach Sprung zu diesen Positionen mittels Bearbeiten Sprungmarken Nächste Sprungmarke möglich ist und die gewünschten Parameter dann eingefügt werden können.

Vervollständigung eines &latex;-Befehls
Vervollständigung eines &latex;-Befehls

Unter Einstellungen&kile; einrichten ...&kile;Vervollständigen können Einstellungen zu diesen Listen vorgenommen werden. Es können verschiedene Wörterlisten für &tex;- und &latex;-Befehle sowie Wörterbücher des allgemeinen Sprachgebrauchs ausgewählt werden.

Wenn Sie die Option LaTeX-Befehle anzeigen, werden die Einträge aller ausgewählten cwl-Dateien für die &latex;-Befehlsvervollständigung in einer getrennten Ansicht der Seitenleiste von &kile;. Dadurch haben Sie einen guten Überblick, welche Befehle verfügbar sind und welche Parameter und Optionen für eine Vervollständigung eingegeben werden müssen oder eingegeben werden können. Es ist möglich Einträge mit einem Mausklick auszuwählen und das Dokument einzufügen, dabei alle benannten Parameter und Optionen entfernt.

&latex;-Befehle in der Seitenleiste
&latex;-Befehle in der Seitenleiste

Jede Wortliste wird in einer eigenen Ansicht dargestellt. Bei vielen benutzten Wortlisten könnte das Hauptfenster von &kile; größer als der Bildschirm werden. Um das zu vermeiden, ist die Anzahl von Wortlisten in &kile; auf maximal 10 begrenzt. Ist dieser Wert immer noch zu groß für Ihren Bildschirm, dann sollten Sie diesen Wert verringern.

### Umgebungen

Der Befehlsmodus ist für die Vervollständigung von Umgebungen nicht nützlich. Es müssen immer ein paar Buchstaben mit `\begin` eingegeben werden und der Aufruf des Vervollständigungsmodus wird eine große Liste mit Umgebungsbefehlen zur Folge haben. Andererseits werden die Umgebungen so oft verwendet, dass &kile; einen speziellen Modus für die Vervollständigung der Umgebungen zur Verfügung stellt.

Beim Aufruf des Vervollständigungsmodus über das Menü Bearbeiten Vervollständigen Umgebung oder das Tastenkürzel &Alt;&Shift;Leertaste wird der Befehl zum Öffnen der Umgebung automatisch eingefügt und es erscheint `\begin{`. Danach kann die Umgebungsvervollständigung auf einfachste Art und Weise fortgesetzt und durch Drücken der Eingabetaste beendet werden.

Vervollständigung eines &latex;-Befehls
Vervollständigung eines &latex;-Befehls

Nachdem dies vollzogen ist, wird die Umgebung automatisch wieder geschlossen. Sobald &kile; erkennt, dass es sich um eine Listenumgebung handelt, wird sogar noch ein erster `\item`-Befehl mit eingefügt.

Vervollständigung eines &latex;-Befehls
Vervollständigung eines &latex;-Befehls

Unter Einstellungen&kile; einrichten ...&kile;Vervollständigen können Einstellungen zu diesen Listen vorgenommen werden. Dieser Modus verwendet die Wörterliste des Vervollständigungsmodus für &tex;- und &latex;-Befehle.

### Abkürzungen

&kile; unterstützt benutzerdefinierte Listen von Abkürzungen, die sofort durch längere Zeichenketten ersetzt werden. Die Listen können unter Einstellungen Kile einrichten ...Kile Vervollständigen eingerichtet werden. Als Beispiel einer Abkürzungsliste dient die Datei `example.cwl`, in der beispielsweise der Eintrag `L=\LaTeX` enthalten ist.

Wird beispielsweise der Buchstabe `L` eingegeben und der Wortvervollständigungsmodus über das Menü Bearbeiten Vervollständigen Abkürzung oder das Tastenkürzel &Ctrl;&Alt;Leertaste eingeleitet, wird der Buchstabe `L` durch die Zeichenkette `\LaTeX` ersetzt.

Die Vervollständigung von Abkürzungen funktioniert auch mit Zeilenumbruch `%n` und dem Platzhalter `%C` für die Cursor-Position, wenn diese Zeichen im Erweiterungstext benutzt werden. Haben Sie zum Beispiel diesen Eintrag

    en1=\begin{enumerate}%n\item %C%n\end{enumerate}%n

in der Vervollständigungsdatei und rufen die Vervollständigung für die Abkürzung auf, erhalten Sie das unten angezeigte Ergebnis. Dabei kennzeichnet `x` die endgültige Cursor-Position,

    \begin{enumerate}
            \item x
    \end{enumerate}

#### Abkürzungen

Wenn Sie die Einstellung Abkürzungen aktivieren, werden alle Abkürzungen in einer Ansicht in der Seitenleiste gezeigt. Damit haben Sie einen guten Überblick über alle definierten Abkürzungen.

### Automatische Vervollständigungsmodi

#### &latex;-Befehle

Sie können einen automatischen Vervollständigungsmodus für &latex;-Befehle aktivieren. Wenn eine bestimmte Mindestanzahl an Buchstaben (als Voreinstellung drei) eingegeben wurde, erscheint ein Auswahlfenster mit einer Liste aller passenden &latex;-Befehle. Sie können einen dieser Vorschläge auswählen oder das Auswahlfenster einfach ignorieren und weitere Buchstaben eingeben. Die Einträge in der Vervollständigungsliste ändern sich bei der Eingabe, um immer einen passenden Vorschlag für das bisher eingegebene Wort zu liefern.

Auf der Seite Einstellungen Kile einrichten ... Kile Vervollständigen können Sie diesen Modus ein- und ausschalten und den Schwellwert einstellen.

Vervollständigung einer „equation“-Umgebung
Vervollständigung einer „equation“-Umgebung

#### Geschriebene Wörter

Große Wörterbücher sind für die automatische Vervollständigung nicht hilfreich. Jedoch wurde festgestellt, dass viele Wörter in einem Dokument mehr als einmal geschrieben werden. Damit bietet &kile; die Vervollständigung für alle bereits geschriebenen Wörter. Sie können diese Vervollständigung manuell hervorrufen, indem Sie &Ctrl;Leertaste drücken. Beachten Sie das diese Vervollständigung eine andere ist als der Vervollständigungsmodus von &latex;-Befehlen.

Dieser Modus kann im Menü Einstellungen Kile einrichten ...Editor Bearbeitung Autovervollständigung ein- oder ausgeschaltet werden. Hier kann auch der Minimale Wortlänge für Vervollständigung festgelegt werden.

### Eigene Vervollständigungsdateien schreiebn

Die neueste Beschreibung des Formats der Vervollständigungs-Dateien finden Sie unter CWL-Dateiformat.

Die Vervollständigungs-Dateien können im Unterordner `~/.kde/share/apps/kile/complete/<mode>/` des Persönlichen Ordners installiert werden. `mode` steht dabei für `abbreviation` (Abkürzung), `dictionary` (Wörterbuch) oder `tex`.

## Assistenten und Dialoge

### Schnelleinstiegs-Assistent

Dieser Assistent wurde bereits im Abschnitt beschrieben.

### Grafiken einfügen

Der Dialog Grafik einbinden gestaltet das Einfügen von Grafiken so einfach wie möglich. Diesen Dialog öffnen Sie mit LaTeX Bild einbinden in der Menüleiste. Einen Überblick der Grundlagen zu den Grafikformaten finden Sie in den Abschnitten und .

Grafisches Element einfügen
Grafisches Element einfügen

1. Wählen Sie eine Grafikdatei im JPEG-, PNG-, PDF-, EPS-Format oder als mit „zip“ oder „gzip“ gepackte EPS-Datei aus. Haben Sie &imagemagick; installiert und in &kile; auf der Seite Einstellungen Kile einrichten ... LaTeX Grafiken die Benutzung aktiviert, dann wird die Breite und Höhe der Grafik automatisch angezeigt. Wenn &imagemagick; die Auflösung ermitteln kann, wird die Größe auch in Zentimetern angezeigt.

2. Entscheiden Sie, ob Ihr Bild auf der Seite zentriert werden soll.

3. Legen Sie fest, ob `\graphicspath` für Ihre Grafikdatei verwendet werden soll.

   Als Voreinstellung müssen Grafikdateien im selben Ordner wie das Master-Dokument gespeichert werden. Es ist jedoch auch möglich, andere Ordner zu verwenden, um eine bessere Übersicht zu behalten. Ohne den Befehl `\graphicspath` fügt &kile; den vollständigen Pfad zur Grafikdatei ein. Wenn Sie jedoch `\graphicspath` in der Einleitung wie folgt verwenden:

       \graphicspath{{/Pfad/zu/Grafiken}{/anderer/Pfad/zu/weiteren/Grafiken}}

   und diese Einstellung aktivieren, benutzt &kile; nur den Dateinamen ohne Pfad,

   Ein weiteres Beispiel: Angenommen Sie benutzen den Befehl `\graphicspath` wie folgt:

       \graphicspath{{./}{camera/}{images/}}

   &latex; sucht dann im aktuellen Ordner, dann in `camera` und schließlich in `images`, um Ihre Grafikdatei zu finden.

4. Wenn Sie entweder nur die Höhe oder nur die Breite eingeben, wird das Seitenverhältnis beibehalten und die Grafik an die gewünschte Größe angepasst. Geben Sie sowohl Werte für Höhe und Breite ein, werden Sie mit unterschiedlichen Faktoren vergrößert. Das ist möglicherweise nicht beabsichtigt. Im Dialog werden oben Informationen über die ursprüngliche Größe der Grafik angezeigt.

5. Geben Sie einen Winkel ein, um den die Grafik im Uhrzeigersinn gedreht werden soll.

6. Die Information über die Begrenzungslinien wird automatisch bestimmt, wenn Sie eine Grafikdatei auswählen. Diese Information ist nur für &latex;- und Bitmap-Grafiken erforderlich. Mehr Informationen dazu finden Sie im Abschnitt EPS-Grafik.

   Wenn &latex; ein Begrenzungsfeld benötigt und Sie die dafür erforderliche Datei nicht erzeugen möchten, unterstützt Sie &kile; dabei. Andererseits gibt &pdflatex; eine Warnung aus, wenn Sie eine PNG- oder JPG-Grafik mit dieser Einstellung einfügen möchten. Dieses Ankreuzfeld aktiviert oder deaktiviert diese Einstellung.

7. Ändern Sie die Größe des Bildes um den gewünschten Faktor. Mit &eg; 0,5 hat es die halbe, mit 2,0 die doppelte Größe. Wenn Sie diese Einstellung benutzen, müssen Sie keine Breite oder Höhe für das Bild angeben.

8. Auf der Karteikarte Bild beschneiden können Sie Ihr Bild auf allen vier Seiten zuschneiden.

9. Schließlich müssen Sie noch angeben, ob das Bild in eine „Figure“-Umgebung eingebettet werden soll, oder in eine „Wrapfigure“-Umgebung, wenn der Text um die Grafik herum fließen soll.

   Wenn Sie die Wrapfigure-Umgebung verwenden möchten, müssen Sie das Paket „wrapfig“ in der Einleitung einfügen.

   In beiden Fällen können Sie einen Titel und Beschriftung für das Bild eingeben. Im Allgemeinen ist es anzuraten, ein eigenes Präfix für jede Art von Beschriftung zu verwenden. Normalerweise wird `Abb.` für Bilder verwendet

10. Haben Sie die „Figure“-Umgebung gewählt, können Sie angeben, wie &latex; die Grafik anordnen soll.

11. In der „Wrapfigure“-Umgebung gibt es folgende Einstellungen:

    1. Wählen Sie eine Regel zur Positionierung Ihrer Grafik und legen Sie fest, ob die Abbildung von Text umflossen werden soll. Für ein zweiseitiges Dokument können Sie angeben, ob die Abbildung innen oder außen auf der Seite angeordnet werden soll.

    2. Geben Sie ein, wieviele Zeilen Sie umbrechen möchten. Wählen Sie hier nichts aus, versucht &latex; dies so gut wie möglich selbst zu bestimmen.

    3. Bestimmen Sie einen Überhang zur ausgewählten Seite. Dies ist besonders dann sinnvoll, wenn Ihr Dokument mehrere Spalten hat und Sie die Abbildung über mehr als eine Spalte verteilt haben möchten oder wenn die Abbildung auf zwei Spalten aufgeteilt werden soll.

    4. Wählen Sie die Breite der Abbildung. Dieser Wert sollte etwas größer als die tatsächliche Breite des Bildes sein, damit der umfließende Text etwas Abstand hat.

### Tabellen und Tabulatoren

Eines der mühseligsten Arbeiten in &latex; ist das Schreiben einer Matrix- oder Tabellenumgebung. Alle Elemente müssen richtig eingefügt werden und die Syntax muss korrekt sein. Eine Einrückung hilft bei dieser Aufgabe, es geht aber noch einfacher: Benutzen Sie in &kile; die Menüeinträge Assistent Feld oder Assistent Tabelle. Dann erhalten Sie ein Eingabeformular wie eine Matrix, die einfach auszufüllen ist. Im Dialog gibt es außerdem einige Einstellungen für den Schriftsatz der Tabelle.

Einfügen einer Tabellenumgebung
Einfügen einer Tabellenumgebung

In der Werkzeugleiste oben im Dialog können Sie `Ausrichtung` einer Zelle und einen `Schriftstil` festĺegen, Zellen `verbinden` und `teilen` und einen `Rand` und `Farben` für Schrift und Hintergrund wählen. Ganz recht finden Sie den Knopf Inhalt der Zwischenablage einfügen. Damit können Sie eine Tabelle aus der Zwischenablage in den Dialog einfügen. Damit können Sie zum Beispiel Tabellen aus einer Tabellenkalkulation einfügen.

Unten im Dialog können Sie die Zahl der Zeilen und Spalten festlegen und weiter Einstellungen vornehmen.

- Mit der Einstellung Name wählen Sie aus, welche Umgebung für Ihre Daten benutzt werden soll.

- Sie können die vertikale Ausrichtung der Zellen kann mit der Einstellung Parameter eingestellt werden. Dies ist nur in Umgebungen verfügbar, die diese Funktion unterstützen.

- Sie können *-Version verwenden auswählen, wenn sie für die gewählte Umgebung existiert. Aktivieren Sie diese Einstellung, dann müssen Sie auch eine Tabellenbreite angeben.

- Tabellen sehen manchmal besser aus, wenn Sie die Einstellung Booktabs-Paket verwenden aktivieren.

- Natürlich können Sie das gesamte Feld auch Zentrieren.

- Sprungmarken einfügen erleichtert die Eingabe des Inhalts im Editor. Mit dieser Einstellung fügt &kile; Platzhalter für Sprungmarken für jedes Element in der Tabelle ein.

Mit Assistent Tabulatoren

### Einfügen von Gleitobjekten

&kile; unterstützt Sie beim Einfügen von Gleitobjekten. Mit Assistent Gleitobjekte öffnen Sie einen Dialog, um eine neue Abbildungs- oder Tabellen-Umgebung einzufügen.

Einfügen eines Gleitobjekts
Einfügen eines Gleitobjekts

Um ein neues Gleitobjekt einzufügen, führen Sie folgende Schritte durch:

1. Wählen Sie, ob eine Abbildung oder eine Tabelle eingefügt werden soll.

2. Stellen Sie die Regeln für die gewünschte Position ein.

3. Geben Sie einen Namen für das Gleitobjekt ein.

4. Geben Sie eine Bezeichnung für das neue Gleitobjekt ein. &kile; schlägt automatisch ein passendes Präfix vor, &eg; „Abb.“ die Bilder und „Tab.“ für Tabellen.

### Einfügen von Mathematik-Umgebungen

Das Einfügen der vielen verschiedenen Mathematik-Elemente kann ziemlich mühsam sein. &kile; unterstützt Sie dabei mit Assistent Mathematik aus dem Menü.

Einfügen eines Mathematik-Elements
Einfügen eines Mathematik-Elements

Einstellungen:

- Name: Wählen Sie einen Typ für das Mathematikelement, das Sie einfügen möchten.

- Ohne Nummerierung: Damit schalten Sie die Nummerierung für normalerweise fortlaufend nummerierte Elemente wie Gleichungen ab.

- Abstandsbefehl um Gruppen zu trennen: In einer Umgebung wie zum Beispiel „alignat“, in der mehrere Gruppen vorkommen dürfen, können Sie bei mehr als einer Gruppe einen Abstandsbefehl bestimmen. Jeder gültige Abstandsbefehl des Mathematikmodus ist hier erlaubt wie &eg; \quad.

- Standard-Tabulator: Wählen Sie einen der vordefinierten Tabulatoren. Normalerweise ist hier bereits eine passende Voreinstellung ausgewählt.

- Abgesetzter Modus: Für Umgebungen wie Matrizen oder Feldern können Sie auswählen, in welcher Mathematikumgebung der Text angezeigt werden soll

- Sprungmarken einfügen: Mit dieser Einstellung fügt &kile; Platzhalter für Sprungmarken für jedes Element im mathematischen Text ein.

### &PostScript;-Werkzeuge

`PS`-Dateien sind nicht so bekannt wie `PDF`-Dateien, bieten aber eine hervorragende Grundlage für Änderungen und Neuanordnungen von Seiten. Wird die `PDF`-Ausgabe benötigt, so können die Seiten mit ein paar &PostScript;-Werkzeugen neu angeordnet und dann mit `ps2pdf` in eine `PDF`-Datei umgewandelt werden.

Der &PostScript;-Assistent, den Sie mit Assistent Postscript-Werkzeuge starten, bietet eine Auswahl der am häufigsten benötigten Umstellungen. Die Änderungen werden mit den Programmen `pstops` und `psselect` durchgeführt. Diese Programmen finden Sie in den meisten Distributionen im Paket `psutils`. Ist eines der Programme nicht installiert, werden die zugehörigen Einträge nicht zur Auswahl angeboten.

Dialog „Umordnen einer Postscript-Datei“
Dialog „Umordnen einer Postscript-Datei“

Wählen Sie zuerst eine Eingabedatei. Findet &kile; ein passende Datei zu dem Master-Dokument, ist sie bereits als Eingabedatei vorgegeben. Sie können natürlich immer noch jede beliebige andere Datei auswählen. Wählen Sie dann die Ausgabedatei und eine der möglichen Umwandlungen. Nun müssen Sie nur noch angeben, ob nur die Umwandlung ausgeführt oder auch &okular; zur Anzeige des Ergebnisses aufgerufen werden soll.

1 DIN A5-Seite + leere Seite --> DIN A4

  Fügt eine A5-Seite zusammen mit einer leeren Seite auf einer A4-Seite ein. Wenn zwei A5-Seiten zusammengefügt werden, werden Sie um 90° gedreht und auf der A4-Seite im Querformat angeordnet.

  DIN A5-Seite + leere Seite
  DIN A5-Seite + leere Seite
1 DIN A5-Seite + Duplikat --> DIN A4

  Fügt eine A5-Seite und ein Duplikat auf einer A4-Seite zusammen.

  1 DIN A5-Seite + Duplikat --> DIN A4
  1 DIN A5-Seite + Duplikat --> DIN A4
2 DIN A5-Seiten --> DIN A4

  Fügt zwei aufeinander folgende A5-Seiten auf einer A4-Seite zusammen.

  Zwei DIN A5-Seiten zusammenfügen
  Zwei DIN A5-Seiten zusammenfügen
2 DIN A5L-Seiten --> DIN A4

  Fügt zwei aufeinander folgende A5-Seiten im Querformat auf einer A4-Seite zusammen.

4 DIN A5-Seiten --> DIN A4

  Fügt vier aufeinander folgende A5-Seiten auf einer A4-Seite zusammen. Die A5-Seiten müssen auf 71 % verkleinert werden, damit sie auf die Seite passen.

  4 DIN A5-Seiten --> DIN A4
  4 DIN A5-Seiten --> DIN A4
1 DIN A4-Seite + leere Seite --> DIN A4

  Fügt eine A4-Seite zusammen mit einer leeren Seite auf einer A4-Seite ein. Wenn zwei A4-Seiten auf einer A4-Seite zusammengefügt werden, müssen Sie auf 71% verkleinert und im Querformat angeordnet werden.

  1 DIN A4-Seite + leere Seite --> DIN A4
  1 DIN A4-Seite + leere Seite --> DIN A4
1 DIN A4-Seite + Duplikat --> DIN A4

  Fügt eine A4-Seite und ein Duplikat auf einer A4-Seite zusammen.

  1 DIN A4-Seite + Duplikat --> DIN A4
  1 DIN A4-Seite + Duplikat --> DIN A4
2 DIN A4-Seiten --> DIN A4

  Fügt zwei aufeinander folgende A4-Seiten auf einer A4-Seite zusammen.

  Zwei DIN A4-Seiten zusammenfügen
  Zwei DIN A4-Seiten zusammenfügen
2 DIN A4L-Seiten --> DIN A4

  Fügt zwei aufeinander folgende A4-Seiten im Querformat auf einer A4-Seite zusammen.

Gerade Seiten auswählen

  Alle geraden Seiten eines Dokuments.

Ungerade Seiten auswählen

  Alle ungeraden Seiten eines Dokuments.

Gerade Seiten auswählen (in umgekehrter Reihenfolge)

  Alle geraden Seiten eines Dokuments in umgekehrter Reihenfolge.

Ungerade Seiten auswählen (in umgekehrter Reihenfolge)

  Alle geraden Seiten eines Dokuments in umgekehrter Reihenfolge.

Reihenfolge der Seiten umkehren

  Kehrt die Reihenfolge aller Seiten eines Dokuments um.

Alle Seiten kopieren (sortiert)

  Kopiert alle Seiten eines Dokuments. Sie müssen die Anzahl der sortierten Kopien auswählen.

  Alle Seiten kopieren (sortiert)
  Alle Seiten kopieren (sortiert)
Alle Seiten kopieren (unsortiert)

  Kopiert alle Seiten eines Dokuments. Sie müssen die Anzahl der nicht sortierten Kopien auswählen.

  Alle Seiten kopieren (unsortiert)
  Alle Seiten kopieren (unsortiert)
pstops: Wählen Sie Parameter

  Es gibt viele mögliche Einstellungen für `pstops` und `psselect`. Benötigen Sie spezielle Einstellungen, können Sie das Programm `pstops` auch direkt mit dieser Option aufrufen. Lesen Sie dazu das Handbuch für alle möglichen Einstellungen.

psselect: Wählen Sie Parameter

  Sie können `psselect` mit einer ausgewählten Option aufrufen. Bitte lesen Sie das Handbuch zu `psselect` für alle möglichen Optionen.

### Dokumentstatistik

Der Statistikdialog in Datei Statistik gibt eine Überblick über über die aktuelle Auswahl, das Dokument oder das Projekt. In dieser Statistik wird die Anzahl der Wörter und Zahlen, die &latex;-Befehle und -Umgebungen und auch die Zahl der Zeichen für jeden Typ angegeben.

Die Statistik kann als Text oder als formatierte &latex;-Tabelle kopiert werden.

Haben Sie einen Text ausgewählt und öffnen den Statistikdialog, werden die Informationen nur für den ausgewählten Text angegeben. Öffnen Sie den Dialog ohne eine Textauswahl, wird die Statistik für alle geöffneten Dateien angezeigt. Möchten Sie die Daten für Ihr gesamtes Projekt sehen, wählen Sie zuerst Projekt Alle Projektdateien öffnen und öffnen dann den Statistikdialog.

Ein Hinweis zur Genauigkeit der angegebenen Zahlen: Es wird einiger Aufwand betrieben, um ein richtiges Ergebnis zu liefern, &eg; K\"uhler zählt als ein Wort und Befehl mir sechs bzw. zwei Zeichen. Es gibt aber andere Kombinationen, in denen Teile von Befehlen als Wörter und umgekehrt gezählt werden. Der Algorithmus wurde für Sprachen wie Englisch und Deutsch entwickelt und getestet. Verlassen Sie sich daher nicht ausschließlich auf die Angaben im Programm. Schreiben Sie einen Bericht, der nur aus einer bestimmten Anzahl von Wörtern bestehen darf, überprüfen Sie vorher, ob die Genauigkeit der Berechnung für Sie ausreicht.

## Besondere Tags in &latex;

### Die &latex;-Tag-Bibliothek verwenden

&latex; enthält Tausende von Tags für Symbole und Sonderzeichen. Am einfachsten können diese Tags über die Seitenleiste links neben dem Editorfenster eingefügt werden.

Das Seitenleistenmenü
Das Seitenleistenmenü

Das Seitenleistenmenü

Die folgenden Typen sind vorhanden:

- Am meisten Verwendete

- Beziehungen

- Operatoren

- Pfeile

- Mathematik

- Text

- Trennzeichen

- Griechisch

- Sonderzeichen

- Kyrillische Zeichen

- Benutzerdefiniert

Die Kurzinfos der Symbole zeigen die &latex;-Befehle und zusätzlich erforderliche Pakete.

Drücken Sie die &Shift;-Taste und klicken auf ein Symbol, dann wird `$\symbolcmd$` eingefügt. Mit der &Ctrl;-Taste wird das Symbol eingefügt und in geschweifte Klammern eingeschlossen.

Wenn Sie einen Befehl einfügen, für den ein noch nicht in die &latex;-Umgebung eingeschlossenes Paket erforderlich ist, wird im Protokollfenster eine Warnung ausgegeben.

Die erste Karteikarte enthält die Am meisten Verwendeten Symbole. Alle ins Dokument eingefügten Symbole werden auch hier für einen schnellen und einfachen Zugriff eingefügt. Die Reihenfolge der Anzeige wird durch die neu eingefügten Symbole nicht verändert. Statt dessen wird ein Referenzzähler verringert. Enthält die Liste mehr als 30 Einträge, wird das Element mit der niedrigsten Referenzzahl entfernt.

Die Symbolliste Benutzerdefiniert enthält Ihre eigenen Symbole. Um diese zuerstellen, benötige Sie das Programm „gesymb“ und die Datei „definitions.tex“ aus dem &kile;-Quelltextpaket. Zusätzlich brauchen Sie einen &latex;-Compiler und &dvipng; (Version 1.7 oder neuer). Dann erstellen Sie eine &latex;-Datei mit `\input{definitions}`, um die unten aufgeführten Befehle verfügbar zu machen. Dann erstellt `gesymb mysymbols.tex user`, das &latex; und &dvipng; aufruft, die Symbole. Kopieren Sie sie in den Ordner `$HOME/.kde/share/apps/kile/mathsymbols/user/` und starten Sie &kile; neu.

Folgende Befehle sind in „definitions.tex“ enthalten:

- `\command[\optarg]{\symbol}`: Fügt das Symbol `\symbol` in die Liste ein, das optionale Argument `\optarg` gibt den Befehl an, der durch &kile; eingefügt werden soll. Ist kein Argument angegeben, wird der Standardwert benutzt.

- `\mathcommand[\optarg]{\symbol}`: Wie vorher, nur dass das erforderliche Argument für den Befehl im Mathematikmodus eingefügt wird.

- `\pkgs[arg]{pkg}`: Legt fest, das der in dieser Zeile angegebene Befehl das &latex;-Paket `pkg` mit dem optionalen Argument `arg` benötigt. Dies muss vor dem Befehl `\command` stehen und überschreibt jede Paketangabe, die von der „neededpkgs“-Umgebung festgelegt wurde.

- `\begin{neededpkgs}[pkgs-args]{pkgs} ... \end{neededpkgs}`: Hat den gleichen Effekt wie oben, aber für alle eingeschlossenen Befehle.

Zur Vollständigkeit ist hier folgendes Beispiel angegeben:

    \documentclass[a4paper,10pt]{article}
    \usepackage{amssymb}
    \input{definitions}
    %
    \begin{document}
    \pagestyle{empty}
    %
    \begin{neededpkgs}{amssymb}
    \mathcommand{\surd}
    \pkgs{amsmath}\mathcommand[\ddddot{}]{\ddddot{a}}
    \mathcommand{\angle}
    \end{neededpkgs}
    \command{\"A}
    \mathcommand{\exists}
    \mathcommand[\stackrel{}{}]{\stackrel{abc}{=}}

    %\begin{neededpkgs}[russian,koi8-r,T2C,]{babel,inputenc,fontenc,mathtext}
    %
    %   \end{neededpkgs}
    % this would need to include the packages
    % \usepackage{mathtext}
    % \usepackage[T2C]{fontenc}
    % \usepackage[russian]{babel}
    % \usepackage[koi8-r]{inputenc}
    %  just to explain the format
    \end{document}

### Bibitems verwenden

`\bibitem` ist ein Befehl, der für das Einfügen eines Verweises in einer `thebibliography`-Umgebung in Ihrem Dokument benutzt wird. Die richtige Syntax für `\bibitem` ist `\bibitem[label]{key}`.

Das optionale Argument `[label]` können Sie verwenden, um ein eigenes Beschriftungssystem für das Literaturverzeichnis zu benutzen. Ist dieses Argument nicht angegeben, werden die Einträge in aufsteigender Reihenfolge [1], [2], [3], &etc; durchnummeriert.

Das Argument `{key}` wird als Referenz und Verknüpfung der Befehle `\bibitem` und `\cite` und der darin enthaltenen Informationen benutzt. Der Befehl `\cite` enthält die Beschriftung, die dem Element `\bibitem` zugeordnet ist. Dieses Element ist von einer `thebibliography`-Umgebung eingeschlossen und enthält die Referenzdaten. Beide zusammengehörigen Befehle `\bibitem` und `\cite` müssen den gleichen Schlüssel `{key}` haben. Am einfachsten ist es, die Schlüssel aus dem Nachnamen des Autors zu generieren. Die zweiten geschweiften Klammern in der `thebibliography`-Umgebung geben den längsten erwarteten Beschriftungtext des Literaturverzeichnisses. Mit `{foo}` können Sie jeder kürzere oder gleich lange Beschriftung als der Ausdruck `foo` verwenden. Fehler bei diesem Parameter können zu unschönen Einzügen im Literaturverzeichnis führen.

Das Literaturverzeichnis ist ein eigener vom Hauptdokument getrennter Abschnitt. Ein Beispiel für den Quelltext für ein Vorlesungsverzeichnis:

    \begin{thebibliography}{50}
            \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm...donuts}. Evergreen Terrace Printing Co.,
                              Springfield, SomewhereUSA, 1998
    \end{thebibliography}

Ihr Hauptquelltext sollte dann den Ort der Information bezüglich des Elements `\bibitem` mit dem Befehl `\cite` angeben. Der Quelltext sollte etwa so aussehen:

    Meine Doktorarbeit über die Philosophie der „Simpsons“\Copyright meines Lieblingsbuches \cite{Simpson}.

Bei vielen Referenzen ist es schwierig, sich die richtigen Zitatschlüssel zu merken. Dabei kann Sie &kile; unterstützen. LaTeX Referenzen cite öffnet einen Dialog mit einer Liste der Zitatschlüssel. Wählen Sie daraus die richtige Referenz und und eine Literaturstelle wird in Ihr Dokument eingefügt. Um die Liste der Schlüssel zu aktualisiern, speichern Sie entweder die Datei oder benutzen Bearbeiten Dokumentstruktur aktualisieren bzw. den Kurzbefehl F12. Haben Sie die Quelltextvervollständigung aktiviert, zeigt &kile; eine Liste aller `bibitem`-Einträge an, wenn Sie den Befehl `\cite` einfügen.

Das endgültige Ergebnis im Literaturverzeichnis des Dokuments sieht dann folgendermaßen aus:

`[1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998.`

&kile; kann auch mit &bibtex;-Editoren wie &kbibtex; zusammenarbeiten, um das Einfügen von Zitaten zu vereinfachen. Wenn eine &bibtex;-Datei zum Projekt hinzugefügt wird, kann &kile; Sie bei der Vervollständigung der Zitatbefehle unterstützen, wie vorher beschrieben.

### Benutzerdefinierte Tags

In &kile; können Sie benutzerdefinierte Tags erstellen. Ein Tag funktioniert wie ein Kurzbefehl, der Befehle ausführt oder häufig benutzen Text einfügt. Das können zum Beispiel Sätze wie `Ich arbeite lieber mit \LaTeX\ als mit \TeX\` und `Was würde ich ohne &Linux; machen?` sein. Um benutzerdefinierte Tags für diese Sätze zu erstellen, öffnen Sie mit LaTeX Benutzerdefinierte Tags Tags bearbeiten ... einen Dialog zur Definition und Bearbeitung.

Der Dialog „Tags bearbeiten“
Der Dialog „Tags bearbeiten“

Der Dialog „Tags bearbeiten“

Aufruf eines benutzerdefinierten Tags
Aufruf eines benutzerdefinierten Tags

Aufruf eines benutzerdefinierten Tags

Der Name des Tags wird im Feld Menüeintrag eingeben und der auszuführende Befehl im Feld Wert. Haben Sie hier Befehle eingegeben, dann können Sie mit dem Kurzbefehl &Ctrl;&Shift;1 für das erste Tag den Satz `Ich arbeite lieber mit \LaTeX\ als mit \TeX\` und mit dem Kurzbefehl &Ctrl;&Shift;2 für das zweite Tag den Satz `Was würde ich ohne &Linux; machen?` einfügen.

#### Platzhalter in benutzerdefinierten Tags

Es gibt einige Platzhalter, die Sie in benutzerdefinierten Tags verwenden können: `%B`, `%C`, `%M` und `%S`.

- `%B`: wird durch eine Sprungmarke ersetzt.

- `%C`: An diese Stelle wird der Cursor nach dem Einfügen des benutzerdefinierten Tags gesetzt.

- `%M`: Bedeutet markierten Text. Der ausgewählte Text wird anstelle von `%M` eingesetzt, wenn benutzerdefinierte Tags eingefügt werden.

- `%S`: Wird durch den Namen der Quelldatei ohne die Dateierweiterung ersetzt.

In den folgenden Bildschirmfotos werden diese Funktionen an Beispielen erläutert. Zuerst wird eine Zahl wie zum Beispiel `2` im Text ausgewählt. Dann drücken Sie &Ctrl;&Shift;1 oder wählen LaTeX Benutzerdefinierte Tags Frac. Als Ergebnis wird `\frac{2}{}` und der Cursor steht zwischen den letzten geschweiften Klammern.

## Bauwerkzeuge

### Kompilieren, Umwandeln und Ansehen

Um das Ergebnis der Arbeit begutachten zu können, muss zunächst der Quelltext kompiliert werden. Alle Bauwerkzeuge sind gruppenweise in den Menüs Erstellen Kompilieren, Erstellen Konvertieren und Erstellen Ansicht zusammengefasst.

Für das Kompilieren des Quelltextes für Betrachter wie &okular; oder die weitere Umwandlung kann das Tastenkürzel &Alt;2 verwendet werden. Danach kann die `&DVI;`-Datei im standardmäßigen Betrachter mittels &Alt;3 angesehen, mittels &Alt;4 die `&DVI;`-Datei in eine `PS`-Datei umgewandelt und mittels &Alt;5 die `PS`-Datei angesehen werden.

#### &bibtex;

Wenn Sie das Paket &bibtex; für die Einträge des Literaturverzeichnisses benutzen, müssen Sie normalerweise nach einem bestimmten Schema kompilieren. Das heisst Sie rufen zuesrt &latex;, dann &bibtex; und dann zum zweiten mal &latex; auf. &kile; erkennt automatisch, dass zusätzliche Pakete wie &bibtex;, &makeidx; und &asymptote; aufgerufen werden müssen. Diese Verhalten können Sie im Menü im Einrichtungsdialog auf der Seite Werkzeuge Erstellen für die Werkzeuge &latex; und &pdflatex; auf der Karteikarte Allgemein mit der Einstellung Zusätzliche Werkzeuge automatisch starten ändern.

#### MetaPost und &asymptote;

Möchten Sie Ihr Dokument mit den Zeichenprogrammen MetaPost oder &asymptote; kompilieren, wählen Sie Erstellen Kompilieren Metapost oder Erstellen Kompilieren&asymptote;.

#### &pdflatex;

Es gibt noch einen weitere Möglichkeit, Ihr Dokument in eine PDF-Datei zu kompilieren: Benutzen Sie &pdflatex;, das aus der Quelle direkt eine PDF-Datei erzeugt. Benutzen Sie dazu den Kurzbefehl &Alt;6 und lassen sich dann das kompilierte Ergebnis mit &Alt;7 anzeigen.

Außerdem können Sie eine PS-Datei in eine PDF-Datei mit &Alt;8 oder direkt in eine &DVI;-Datei in eine PDF-Datei mit &Alt;9 umwandeln.

&pdflatex; statt &latex; zu verwenden, ist manchmal einfacher oder gewohnt, aber das kompilierte Ergebnis kann auch voneinander abweichen.

#### &latex; in Webseiten umwandeln

Möchten Sie Ihre Arbeit im Internet veröffentlichen und nicht nur auf Papier, dann verwenden Sie das Programm latex2html. Sie können es mit Erstellen Kompilieren LaTeX to Web aus dem Menü aufrufen. Das Ergebnis wird in einen Unterordner des aktuellen Arbeitsordner geschrieben. Sie können es mit Erstellen Ansicht ViewHTML aus dem Menü ansehen.

#### Übergabe von Befehlszeilenparametern

Möchten Sie einige besondere Befehlszeilen-Parameter für das Kompilieren, Umwandeln oder die Werkzeugansichten benutzen, können Sie diese Befehlsaufrufe auf der Seite Einstellungen Kile einrichten ...Werkzeuge Erstellen anpassen.

### Schnellvorschau

Bei der Arbeit mit &latex; dauert es immer einige Zeit, bis Sie das Ergebnis betrachten können. &latex; muss den Quelltext kompilieren und zur Anzeige muss ein weiteres Programm aufgerufen werden. Das ist ziemlich lästig, wenn Sie zum Beispiel nur einige Zeichen in einer schwierig zu setzenden Gleichung geändert haben. &kile; bietet einen Modus Schnellvorschau, in dem nur ein Teil des Dokuments kompiliert wird, um Zeit zu sparen. Es gibt vier verschiedene Modi, die mit acht Einstellungen kombiniert werden können.

Schnellvorschau
Schnellvorschau

Alle Einstellungen erfolgen in Einstellungen Kile einrichten... Werkzeuge Vorschau.

Einrichtung der Schnellvorschau
Einrichtung der Schnellvorschau

#### Auswahlmodus

Der Benutzer muss einen Teil des Dokuments auswählen. Mit dem Menüeintrag Erstellen Schnellvorschau Markierter Bereich oder dem Kurzbefehl &Ctrl;&Alt;P,S werden die ausgewählten Programme gestartet. &kile; liest die Einleitung des Haupttextes ein, damit alle Pakete und benutzerdefinierten Befehle eingefügt werden. Sie können zwischen acht vordefinierten Einstellungen wählen.

- LaTeX+&DVI; (eingebetteter Betrachter)

- LaTeX+&DVI; (&okular;)

- LaTeX+PS (eingebetteter Betrachter)

- LaTeX+PS (&okular;)

- PDFLaTeX+PDF (eingebetteter Betrachter)

- PDFLaTeX+PDF (&okular;)

- XeLaTeX+PS (eingebetteter Betrachter)

- XeLaTeX+PDF (&okular;)

Dies sollte für alle Situationen ausreichen, in denen eine schnelle Vorschau erforderlich ist.

#### Umgebungsmodus

Häufig möchten Sie eine Vorschau der aktuellen Umgebung sehen, besonders bei mathematischen Umgebungen, die manchmal schwierig zu schreiben sind. &kile; ermöglicht diese Art von schneller Vorschau. Dazu müssen Sie keinen Teil des Dokuments auswählen. Benutzen Sie Erstellen Schnellvorschau Umgebung oder den Kurzbefehl &Ctrl;&Alt;P,E. Dann wird die aktuelle Umgebung kompiliert und angezeigt.

#### Teildokument-Modus

Besteht ein großes Projekts aus vielen einzelnen Dokumenten, dauert das kompilieren des gesamten Projekts sehr lange, auch wenn Sie den Quelltext nur in einem Dokument geändert haben. &kile; kann nur ein Teildokument kompilieren und anzeigen. Wählen Sie dazu Erstellen Schnellvorschau Teildokument oder den Kurzbefehl &Ctrl;&Alt;P,D.

#### Mathematik-Modus

Mit der Vorschau für den Mathematikmodus können Sie die gerade bearbeitete Mathematikumgebung ansehen. &kile; liest die Einleitung des Hauptdokuments ein und kompiliert dann nur die Mathematikumgebung, in der sich der Cursor gerade befindet. Wählen Sie dazu Erstellen Schnellvorschau Mathematik-Umgebung oder den Kurzbefehl shortcut &Ctrl;&Alt;P,M.

#### Schnellvorschau in der Fußleiste

Anstatt der Anzeige der Vorschau in einem zusätzlichen Fenster kann &kile; auch so eingestellt werden, das die Fußleiste zur Darstellung des kompilierten Ergebnisses verwendet wird. Diese Einstellung finden Sie auf der Seite Werkzeuge Vorschau im Einrichtungsdialog.

### Grafik-Dateiformate

#### &latex; und &pdflatex;

Wenn &pdflatex; die Paketen `graphics` oder `graphicx` benutzt, können damit PNG- oder JPG-Dateien korrekt in die Formate &DVI; oder PDF kompiliert werden, aber keine EPS-Dateien. Umgekehrt funktioniert das Kompilieren mit &latex; zu &DVI; und die Umwandlung zu PS und PDF mit EPS-Dateien, aber nicht mit PNG- und JPG-Dateien.

Viele Benutzer möchten PDF-Dokumente erzeugen, aber auch mit dem hervorragenden Paket Pstricks &PostScript;-Grafiken erstellen. Oder Sie möchten die &PostScript;-Ausgabe von mathematischer und wissenschaftlicher Software wie Mathematica, Maple oder MuPAD weiter bearbeiten. Diese &latex;-Benutzer müssen zuerst in &PostScript; kompilieren, auch wenn Sie eigentlich PDF-Dokumente erzeugen möchten, da diese Programme &PostScript;-Quelltext produzieren, der von &pdflatex; nicht verarbeitet werden kann. Auch in diesem Fall kann &kile; Sie unterstützen und Ihre Arbeit erleichtern.

#### Umwandeln von Grafiken

Möchten Sie sowohl &PostScript;-Quelltext als auch PNG- oder JPG-Datein in einem Dokument benutzen, gibt es mehrere Arbeitsweisen:

- Möchten Sie JPG- oder PNG-Grafikdateien in eine Datei im PS-Format umwandeln, können Sie zuerst auch nur &pdflatex; mit der Ausgabe in &DVI; benutzen und dann mit dvips eine PS-Datei erstellen. &pdflatex; ist ein geeignetes Werkzeug für diese Aufgabe, solange Ihr Quelle keinen &PostScript;-Quelltext enthält.

- Sie können EPS-Dateien in das PNG oder andere Formate umwandeln, indem Sie Programme wie Gimp oder &imagemagick; und &pdflatex; verwenden.

- Die Umwandlung von EPS-Grafiken in PDF-Grafiken sollte mit dem Programm `epstopdf`. Dieses Programm ist in jeder &tex;-Distribution enthalten. Die weitere Bearbeitung erfolgt dann mit &pdflatex;. Damit werden qualitativ hochwertige Grafiken erzeugt, das Ergebnis kann mit den folgenden Einstellungen beeinflußt werden:

      -dAutoFilterColorImages=false
              -dAutoFilterGrayImages=false
              -sColorImageFilter=FlateEncode
              -sGrayImageFilter=FlateEncode
              -dPDFSETTINGS=/prepress
              -dUseFlateCompression=true

  Erlaubt Ihr System `shell-escape`, dann kann diese Umwandlung auch direkt ohne Zwischenschritte erfolgen. Daz müssen Sie das Paket epstopdf einschließen, das Bestandteil aller &tex;-Distributionen ist. Benutzen Sie dazu den Befehl `\usepackage{epstopdf}`. Als Quelltext verwenden Sie zum Beispiel

              \includegraphics[width=5cm]{test.eps}

  Wenn Sie nun &pdflatex; mit der Option `--shell-escape` aufrufen, wird die Grafik `test.eps` automatisch in die Datei `test.pdf` umgewandelt.

  Diese Umwandlung wird bei jeder Ausführung von &pdflatex; durchgeführt. Haben Sie Ihren Grafik-Befehl implizit angegeben mit:

              \includegraphics[width=5cm]{test}

  dann prüft das Programm epstopdf ob die Datei `test.pdf` bereits vorhanden ist. In diesem Fall wird dieser Ausführungsschritt übersprungen.

- Sie können die Umwandlung auch in der anderen Richtung durchführen und mit &latex; und der Grafikumwandlung PS-PDF arbeiten. Das funktioniert nicht immer gut, da die EPS-Einbindung von JPG- oder PNG-Formaten zu großen Dateien und damit zu unnötig großen Dokumenten führt. Das hängt jedoch stark von den verwendeten Grafikprogrammen ab, da EPS andere Grafiken einbinden kann, dies aber nicht von allen Programme gleich gut unterstützt wird. Einige dieser Programme erstellen eine JPG-Datei mit Vektoren und verschiedenen Skripten, was zu riesig großen Dateien führt. Alle Grafikformate können mit &imagemagick; in das EPS-Format umgewandelt werden. jpg2ps ist ein weiteres Programm, das diese Umwandlung korrekt ausführt.

- Sie können auch eine automatisch Umwandlung benutzen. Dann werden alle Grafikdateien beim Kompilieren in EPS umgewandelt und dann in das PS-Dokument eingefügt. Das ist eine bequeme Vorgehensweise, aber Sie müssen Ihr System dafür richtig einstellen. Dies wird im Abschnitt EPS-Grafiken erläutert.

#### Benutzen Sie die richtige Datei für ein Grafikformat

- EPS ist eine grafische Vektorskriptsprache, die alle Linien und Punkte der Grafik beschreibt. Auch bei einer Vergrößerung über die Standardgröße hinaus ist die Qualität der Anzeige immer noch hoch. Es ist am Besten für Diagramme und Vektorgrafiken geeignet, die direkt für das EPS-Format erzeugt werden. Trotz einer geringen Größe der Grafik ist die Anzeige sehr klar und scharf.

- PNG (oder das veraltete &GIF;) ist ein verlustfreies Dateiformat mit guter Komprimierung und Qualität. Es ist gut für Diagramme. eingescannte Zeichnungen, oder alle Grafiken, der Schärfe erhalten bleiben soll, geeignet. Für Fotos ist es manchmal weniger geeignet.

- JPG ist ein verlustbehaftetes Format, die Komprimierungsrate ist besser als beim PNG-Format, dafür gehen aber auch einige Bilddetails verloren. Bei Fotos ist das unerheblich, kann aber zu einer niedrigen Qualität für Diagramme, Zeichnungen führen und manchmal verschwinden dünne Linien. Benutzen Sie dann das EPS- oder PNG-Format.

Denken Sie daran: Das Ergebnis ist nur so gut wie die Eingabedaten. Keine Umwandlung kann aus einem Bild in schlechter Qualität ein Bild mit hoher Qualität machen.

### EPS-Grafiken

EPS-Grafikdateien sind das traditionelle Format, um Grafikdateien in &latex; einzufügen. Auf den Mailinglisten finden sich viele Fragen zu EPS-Grafiken, daher werden hier einige wichtige Aspekte dazu angesprochen und erläutert, wie das Einfügen von EPS-Grafiken in &kile; funktioniert.

#### &latex; und EPS-Grafiken

Benutzen Sie &latex; um PS- oder PDF-Ausgaben zu erzeugen, haben Sie wahrscheinlich einige Probleme mit Grafiken. Sie müssen EPS-Grafiken (Encapsulated &PostScript;) verwenden, aber keine JPEG- oder PNG-Dateien. Letztere können Sie mit Umwandlungsprogrammen wie `convert` aus dem Paket &imagemagick;bearbeiten.

Die EPS-Dateien werden sowohl von &latex; als auch von der &DVI;-PS-Umwandlung benutzt.

- &latex; sucht in der EPS-Datei nach den Begrenzungslinien des Bildes, um mit dieser Information den nötigen Platz für die Grafik bereitzustellen.

- Das Umwandlungs-Programm &DVI;-PS liest die EPS-Dateien und fügt die Grafiken in die PS-Datei ein.

Dies hat einige Konsequenzen:

- &latex; liest die EPS-Datei nicht ein, wenn die Parameter der Begrenzungslinien im Befehl zum Einfügen der Grafik angegeben wird.

- &latex; kann nur Dateien im ASCII-Format lesen, daher wird die Information über die Begrenzungslinien aus komprimierten EPS-Dateien oder Dateien in anderen Formaten nicht erfasst.

- Die EPS-Grafiken werden nicht in die &DVI;-Dateien eingebunden. Da die EPS-Dateien aber für die Umwandlung von &DVI;-Dateien in PS-Dateien benötigt werden, müssen sie immer zusammen mit den &DVI;-Dateien verschoben werden.

Nun starten Sie &latex; und ein &DVI;-PS-Umwandlungsprogramm wie dvips erzeugt Ihr &PostScript;-Dokument. Möchten Sie ein PDF-Dokument als Ausgabedatei, benutzen Sie `dvips` mit der Option `-Ppdf` und starten dann `ps2pdf`. Für diese Lösung gibt es viele Informationen.

#### Verarbeitung von &PostScript; in &kile;

&kile; hilft Ihnen, die Informationen über die Begrenzungslinien zu ermitteln. Wenn Sie das Paket &imagemagick; installiert haben, kann &kile; diese Information aus der EPS-Datei ermitteln und als Option einfügen. Dies erfolgt automatisch, wenn Sie die Grafikdatei auswählen. Diese Vorgehensweise hat zwei Vorteile:

- Die Information ist bereits im Dialog eingelesen und muss nicht später von &latex; ermittelt werden.

- Noch wichtiger ist es, dass die Breite und Höhe des Bildes berechnet werden kann, wenn die Auflösung bekannt ist. Diese Information wird oben im Dialog angezeigt und gibt Ihnen Hinweise bei der Skalierung von Grafiken.

- &kile; kann auch gepackte EPS-Dateien in den Archivformaten „zip“ und „gzip“ lesen. Diese gepackten Dateien sind erheblich kleiner als nicht komprimierte EPS-Dateien. Diese Funktion kann aber nur mit bestimmten Systemeinstellungen und einer Änderung Ihrer lokalen Grafikeinstellung benutzt werden. Dies wird im Abschnitt Bitmap-Grafik erläutert.

#### &PostScript; und Bitmap-Grafiken

Wenn Ihr System die Option `shell-escape` unterstützt, können in &kile; mit der richtigen Einstellung des &tex;-Systems Bitmap-Grafiken einfach eingefügt werden. JPEG- oder PNG-Grafikdateien müssen nicht umgewandelt werden, dies erfolgt automatisch, wenn die &DVI;-Datei in das PS-Format umgewandelt wird.

&latex;benötigt Informationen über die Datei-Erweiterungen. Das Paket `graphicx` sucht nach einer Datei `graphics.cfg`, die in Ihrem Pfad für &latex;-Dokumente enthalten sein muss. Suchen Sie nach Einträgen wie zum Beispiel:

    \DeclareGraphicsRule{.pz}{eps}{.bb}{}%
       \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
       \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
       \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
       \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{}%

und ersetzen Sie diese Zeilen durch:

    \DeclareGraphicsRule{.pz}{eps}{.bb}{}%
       \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
       \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
       \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
       % changed or new graphic rules
       \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}%   zipped EPS
       \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}%   gzipped EPS
       \DeclareGraphicsRule{.jpg}{eps}{}{`convert #1 eps:-}%         JPEG
       \DeclareGraphicsRule{.gif}{eps}{.bb}{`convert #1 eps:-}%      GIF
       \DeclareGraphicsRule{.png}{eps}{.bb}{`convert #1 eps:-}%      PNG
       \DeclareGraphicsRule{.tif}{eps}{.bb}{`convert #1 eps:-}%      TIFF
       \DeclareGraphicsRule{.pdf}{eps}{.bb}{`convert #1 eps:-}%      PDF-graphics

Sie finden diese Datei zum Beispiel in Debian-Systemen unter `/etc/texmf/latex/graphics.cfg`. Am besten kopieren Sie diese Datei in Ihren lokalen Tex-Pfad und ändern dann diese Datei. Lesen Sie im &tex;-Handbuch Ihrer Distribution nach, wie Sie eine Liste der &tex;-Ordner ermitteln können.

Mit dieser Einrichtungsdatei können Sie Bitmap-Grafiken und komprimierte EPS-Dateien im „zip“- oder „gzip“-Format in &latex; einfügen. Der Befehl für die Umwandlung wird mit `dvips` angegeben. Dabei werden keine zusätzlichen Dateien erzeugt. Das ergebnis des Umwandlungsprozesses wird direkt in eine PS-Datei eingefügt. &latex; muss nur die Größe der Grafik kennen. Diese Information ist in den Begrenzungslinien enthalten, die von &kile; aus gelesen wird.

Dieses Verfahren wird von einigen Leuten als unsicher eingeschätzt. Auf jeden Fall benötigen Sie die Information über die Begrenzungslinien nicht, &kile; ermittelt diese Information aus allen Grafikformaten.

#### &pdflatex; und EPS-Grafiken

Wie bereits festgestellt, kann &pdflatex; keine EPS-Grafikdateien verarbeiten, dazu sind Umwandlungsprogramme wie epstopdf nötig. Fügen Sie dazu das Paket `epstopdf` nach dem Paket `graphicx` ein.

    \usepackage[pdftex]{graphicx}
       \usepackage{epstopdf}

Nun können Sie bereits EPS-Grafikdateien einfügen, wenn Sie `pdflatex` mit der Option `--shell-escape` aufrufen, aber es ist mit weiteren Anpassungen des Grafiksystems sogar möglich, EPS-Dateien im „zip“- oder „gzip“-Format zu verarbeiten. Dazu muss noch einmal die Datei `graphics.cfg` angepasst werden. Suchen Sie dieses Mal nach:

    % pdfTeX läuft im PDF-Modus
       \ExecuteOptions{pdftex}%

und fügen einige Zeilen hinzu:

    % pdfTeX läuft im PDF-Modus
       \ExecuteOptions{pdftex}%
       \AtEndOfPackage{%
          \g@addto@macro\Gin@extensions{.eps.gz,.eps.zip}%
          \@namedef{Gin@rule@.eps.gz}#1{{pdf}{.pdf}{`gunzip -c #1 | epstopdf -f
    >\Gin@base.pdf}}%
          \@namedef{Gin@rule@.eps.zip}#1{{pdf}{.pdf}{`unzip -p #1 | epstopdf -f
    >\Gin@base.pdf}}%
       }%

Mit diesen Zeilen sollte &pdflatex; EPS-Dateien verarbeiten könne, dann gibt es wahrscheinlich keine weiteren Probleme mit Grafiken.

### Das Master-Dokument

Definieren Sie ein Dokument als Master, dann können Sie mit einzelnen Dateien arbeiten. Dann besteht das gesamte Projekt aus dem Master-Dokument und untergeordneten Teildokumenten. Haben Sie mit dem Menüeintrag in Einstellungen das aktuelle Dokument als Master-Dokument festgelegt, betreffen alle Befehle aus dem Menü Erstellen nur dieses Dokument, auch wenn Sie in Teildokumenten arbeiten. Sie können sogar das Master-Dokument schließen und trotzdem weiter arbeiten.

### Fehlerbehandlung

Wenn Sie ein Dokument kompiliert haben und dabei Fehler oder Warnungen aufgetreten sind, wird eine Zusammenfassung im Fenster Protokoll und Meldungen angezeigt. Um alle Ausgaben des Kompiliervorgangs zu anzusehen, wählen Sie Erstellen Protokoll ansehen oder benutzen Sie den Kurzbefehl &Alt;0. In der Ausgabe werden alle Fehler und Warnungen hervorgehoben.

Ansicht des Protokolls
Ansicht des Protokolls

Ansicht des Protokolls

In der Protokolldatei können Sie von einer Nachricht zur Nächsten springen, indem Sie die Menüeinträge Erstellen Nächster / Vorheriger LaTeX-Fehler Nächste / Vorherige LaTeX-Warnung oder die zugehörigen Aktionen aus der Werkzeugleiste verwenden.

Um zur Zeile im &latex;-Quelltext zu gehen, der den Fehler oder die Warnung verursacht hat, klicken Sie auf den Fehler oder die Warnung im der Ansicht Protokoll und Nachrichten. Dann springt der Cursor zur zugehörigen Quelltextzeile.

### Der Dateiüberwachungsmodus

Bei Verwendung des Befehls Schnellbau wird normalerweise ein Betrachter nach dem Kompilieren aufgerufen. Sollte kein eingebundener Betrachter verwendet werden, so wird sich jedesmal ein neues Fenster öffnen.

Wenn Sie das Erscheinungsbild Ihres Dokuments anpassen, werden Sie sehr häufig die Schnellvorschau verwenden und damit viele Anzeigeprogrammfenster auf Ihrer Arbeitsfläche öffnen und leicht die Übersicht verlieren. Um das zu verhindern, können Sie den Dateiüberwachungsmodus aktivieren, dann wird in der Schnellvorschau kein Anzeigeprogrammfenster geöffnet.

Dieser Modus ist natürlich nicht sinnvoll für eingebettete Betrachter, da Sie sie auf jeden Fall schließen müssen, um zurück zur Bearbeitung des Dokuments zu kommen und wieder zu kompilieren.

## Navigieren im &latex;-Quelltext

### Verwendung der Strukturansicht

Die Ansicht Dokumentstruktur zeigt die Elemente und Abschnitte des in &kile; erstellten Dokuments in einer Baumansicht und ermöglicht eine schnelle Navigation. Um zu einer Beschriftung, einem Kapitel, einem Abschnitt oder Unterabschnitt zu gehen, klicken Sie mit der &LMB; auf diese Elemente in der Baumansicht und der Cursor springt zum Beginn des gewählten Elements.

Wenn Sie eine getrennte &latex;-Datei mit `\input` oder `\include` in Ihren Quelltext einschließen, werden die Namen dieser Dateien in der Ansicht Dokumentstruktur angezeigt. Doppelklicken Sie auf die Namen, u die zugehörigen Dateien im Editorfenster zu öffnen.

Im Hierarchiebaum finden Sie auch einen eigenen Zweig mit den im Text benutzen Beschriftungen.

#### Verwendung des Kontextmenüs

Die meisten Elemente in der Strukturansicht haben viele Menüeinträge im Kontextmenü, das durch Klicken mit der &RMBn; geöffnet wird. Dazu ein Bildschirmfoto der Strukturansicht:

Verwendung der Strukturansicht
Verwendung der Strukturansicht

Sie sehen in der Dokumentenstruktur einige Beschriftungen und Abschnittselemente, zwei Abbildungsumgebungen und drei Bilder. Klicken Sie mit der &RMB; auf die Abschnittselemente, erscheint ein Kontextmenü mit nützlichen Menüeinträgen. Alle Befehle im Kontextmenü wie Auswählen, Entfernen oder Kommentar betreffen alle Zeilen in dem Abschnitt.

Kontextmenü für Gliederungseinträge
Kontextmenü für Gliederungseinträge

Klicken Sie auf eine Abbildung oder Tabelle, um ein Kontextmenü für Referenzen zu öffnen. Klicken Sie mit der &RMBn; auf ein Grafikelement, enthält das Kontextmenü Einträge für Programme, die diese Grafiken anzeigen können.

Kontextmenü für Abbildungen/Tabellen und grafische Elemente
Kontextmenü für Abbildungen/Tabellen und grafische Elemente

#### Strukturansicht aktualisieren

Um die Strukturansicht zu aktualisieren, wählen Sie entweder Bearbeiten aktualisieren, benutzen den Kurzbefehl F12 oder speichern Ihr Dokument, dann aktualisiert &kile; die Ansicht der Dokumentstruktur.

### Lesezeichen

Lesezeichen enthalten verweise auf Textabschnitte oder Textzeilen im &kile;-Dokument. Um ein Lesezeichen zu setzen, wählen Sie eine bestimmte Zeile in Ihren Dokument und drücken dann &Ctrl; B. Dann fügt &kile; ein Lesezeichen für diese Zeile ein. Außerdem können Sie eine Zeile in Ihrem Dokument hervorheben und im Menü Lesezeichen Lesezeichen setzen verwenden.

Die Lesezeichen können mittels Lesezeichen Alle Lesezeichen löschen entfernt werden.

## Projekte

### Mit Projekten arbeiten

In &kile; können Sie Projekte erstellen und damit arbeiten. Ein Projekt is eine Gruppe von &latex;-, Grafik-, &bibtex;- und anderen Dateien, die alle Informationen enthalten, um Ihr gesamtes Dokument zu erzeugen. Ein typisches Projekt besteht aus einem Dokument mit mehreren Kapiteln in verschiedenen `.tex`-Dateien. Alle einzelnen Dateien sind in einem Projekt zusammengefaßt, das erleichtert die Bearbeitung. Die Beschreibung des Projekts wird in einer besonderen Datei mit der Erweiterung `.kilepr` gespeichert.

Ein Projekt hat folgende zusätzliche Funktionen:

- Es muss kein Master-Dokument bestimmt werden, das erfolgt in &kile; automatisch.

- Projektdateien können mit Erstellen Archivieren als Archiv zusammen gefasst werden.

- Die Ansicht Dateien- und Projekte zeigt an, welche Dateien zum Projekt gehören.

- Nach dem Öffnen eines Projekts wird jede bereits früher geöffnete Datei mit der ursprünglichen Kodierung und Hervorhebung wieder geöffnet.

- Quelltext-Vervollständigung funktioniert über alle Projektdateien.

- Referenz-Vervollständigung funktioniert über alle Projektdateien.

- Zitat-Vervollständigung funktioniert über alle Projektdateien.

- Die Suche funktioniert über alle Projektdateien.

- Benutzerdefinierte Befehle für Schnellbau und &makeidx; können festgelegt werden.

Alle projektspezifischen Befehle finden Sie im Menü Projekte. Damit können Sie Ihre Projekte öffnen, schließen und verwalten.

### Ein Projekt erstellen

Ein neues Projekt wird über das Menü Projekt Neues Projekt .... Hierbei werden folgende Informationen für das Projekt abgefragt:

- Titel des Projekts

- Name der Projektdatei (`*.kilepr`)

- Dateiname

- Art des Dokuments: Leeres Dokument, Artikel, Buch, Brief, Bericht, ...

Beim Ausfüllen des Dateinamen-Fensters muss der relative Pfad von der `.kilepr`-Projektdatei angegeben werden.

### Datei- und Projektansicht

Die Ansicht Dateien und Projekte können Sie über den Knopf in der Seitenleiste ein- und ausschalten. In dieser Ansicht wird die Struktur des Projekts, die darin enthaltenen Dateien und der Name der `.kilepr`-Datei, die die Informationen des Projekts speichert, dargestellt. Das Hinzufügen, Entfernen und Ändern von Einstellungen für das Projekt erfolgt in der Ansicht Dateien und Projekte.

Datei- und Projektansicht
Datei- und Projektansicht

Datei- und Projektansicht

### Dateien hinzufügen und entfernen

Um eine Datei in Ihr Projekt einzufügen, öffnen Sie eine beliebige &tex;-Datei, klicken mit der &RMBn; auf den Namen in der Ansicht Dateien und Projekte und wählen aus dem Kontextmenü Zum Projekt hinzufügen. Haben Sie mehrere Projekte geöffnet, erscheint ein Dialog, in dem Sie angeben können, zu welchem Projekt die Datei hinzugefügt werden soll.

Sie können auch mit der &RMBn; auf den Projektnamen in der Ansicht Dateien und Projekte klicken und aus dem Kontextmenü Dateien hinzufügen ... wählen. Damit öffnen Sie einen Dateiauswahldialog.

Datei zu einem Projekt hinzufügen
Datei zu einem Projekt hinzufügen

Datei zu einem Projekt hinzufügen

Um eine Datei aus einem Projekt zu entfernen, klicken Sie mit der &RMBn; auf den Dateinamen und wählen Aus Projekt entfernen . Damit wird die Datei nicht gelöscht, sondern nur aus der Liste der Projektdateien in der `.kilepr`-Datei entfernt.

#### Archivieren eines Projekts

Mit &kile; können Sie Ihr gesamtes Projekt einfach archivieren, indem Sie alle Dateien in ein einziges Archiv (auch tarball genannt) packen. Dazu klicken Sie mit der &RMBn; auf den Projektnamen in der Ansicht Dateien und Projekte oder wählen aus dem Menü Projekt Archivieren.

In der Voreinstellung werden alle Dateien im Projekt zum Archiv hinzugefügt. Möchten Sie eine bestimmte Datei davon ausschließen, klicken Sie in der Ansicht Dateien und Projekte mit der &RMBn; auf den Dateinamen und deaktivieren die Einstellung In Archiv einbinden.

Das Archiv wird im Projektordner, der die `.kilepr`-Datei enthält, mit dem Befehl `tar` ausgeführt.

### Projekteinstellungen

&kile; hat einige Einstellungen für Ihr Projekt, die bestimmt werden müssen. Um diese Einstellungen zu ändern, klicken Sie mit der &RMBn; auf den Projektnamen und wählen im Kontextmenü Projekt-Einstellungen. Dann können Sie folgendes ändern:

- Der Titel des Projekts.

- Standard-Dateierweiterungen

- Das Master-Dokument

- Der Schnellbau-Befehl

- Die Optionen für &makeidx;.

### Schließen eines Projekts

Um ein Projekt zu schließen, wählen Sie die Ansicht Dateien und Projekte in der Seitenleiste. Klicken mit der &RMBn; auf den Projektnamen und wählen aus dem Kontextmenü Schließen. Damit wird Ihr Projekt einschließlich aller zugehörigen Dateien geschlossen. Der Projektname wird dann auch zu den Einträgen in Zuletzt geöffnete Projekte ... im Menü Projekte hinzugefügt.

## Dokument-Kodierung

Im &kile;-Editor ist es möglich, Texte in der für Ihr Dokument geeigneten Zeichenkodierung zu lesen und zu speichern. Damit können Sie zum Beispiel Sonderzeichen mit Akzenten aus den Französisch oder Italienisch direkt in &latex;-Dokumenten verwenden. Die Zeichenkodierung eines Dokuments kann auf zwei Arten eingestellt werden.

- Die Standardkodierung für alle Dokumente können Sie in Einstellungen Kile einrichten ...Editor einstellen.

  Einstellung der Standard-Kodierung
  Einstellung der Standard-Kodierung

- Um die Kodierung für ein Dokument einzustellen, können Sie außerdem die gewünschte Kodierung im Assistenten für neue Dokumente einstellen.

&latex; selbst kann nur den begrenzten ASCII-Zeichensatz verarbeiten. Daher können Sonderzeichen nicht direkt benutzt werden. Um Sonderzeichen trotzdem eingeben zu können, wird eine besondere Schreibweise wie zum Beispiel `\"e` for `ë` verwendet. Das Paket inputenc unterstützt Sie bei diesen Sonderzeichen. Es wird in der Einleitung mit `\usepackage[latin1]{inputenc}` eingebunden, dabei gibt das optionale Argument die zu verwendende Kodierung, in den meisten Fällen `utf8`, an. Damit übersetzt &latex; for der Kompilierung alle eingegebenen `ë`s in `\"e`s. Weitere Informationen finden Sie in der Dokumentation um Paket inputenc. Denken Sie aber in jedem Fall daran, Ihre Datei tatsächlich in der Kodierung zu speichern, die für das Paket inputenc angegeben wurde.

Aus dieser Vielzahl von verschiedenen Tabellen zu Zeichenkodierung entstehen ebenso viele Probleme: Sie können zum Beispiel ein Lehrbuch für Türkisch in französisch schreiben, aber Sie müssen auf die Sonderzeichen in einer der beiden Sprachen verzichten. Um diese Probleme zu vermeiden, sollte Unicode benutzt werden. In &Linux;-Systemen wird im allgemeinen UTF-8verwendet. &Windows;® dagegen benutzt das unhandliche und weniger flexible UCS-2. In den meisten Distributionen wird bereits UTF-8 als Kodierung verwendet. Deshalb sollten Sie das Argument `utf8` für das Paket `inputenc` in der Einleitung benutzen.

### Das Paket &ucs;

Ist das Paket &ucs; nicht auf Ihrem Rechner installiert, gehen Sie wie folgt vor:

- Laden Sie das Paket &ucs; von CTAN.

- Um es zu installieren, entpacken Sie die heruntergeladenen Dateien in Ordner, der in Ihrer $`TEXINPUTS`-Umgebungsvariable enthalten ist. Diese Einstellung können Sie auch in &kile; vornehmen.

    \usepackage{ucs}
    \usepackage[utf8]{inputenc}

### XeLaTeX

Wenn Sie `XeLaTeX` benutzen, müssen Sie nur das Paket `xltxtra` laden. Alle abhängigen und erforderlichen Pakete werden dann automatisch mit geladen.

    \usepackage{xltxtra}

### &cjk;-Unterstützung

Unterstützung die Sprachen mit Symbolschriften einzubauen, kann ziemlich schwierig sein. Außer der Installation von Programm-Paketen muss noch einiges eingestellt werden.

Ihre &Linux;-Distribution hat möglicherweise bereits Pakete für &cjk; (Chinesisch, Japanisch, Koreanisch). Damit ersparen Sie sich die Zeit alles von Hand zu installieren. Überprüfen Sie das mit Ihrer Paketverwaltung, ehe Sie weiterlesen.

Mit dem Paket &ucs; ist es möglich, kurze Texte als &cjk;-Text zu schreiben. Diese Verfahren ist aber stark eingeschränkt, da unter anderem Zeilenumbrüche nicht verarbeitet werden. Stattdessen wird hier erklärt, wie das komplette Paket &cjk;-&latex; installiert und sowohl für die Nutzung mit &latex; und &pdflatex; eingerichtet wird. Ein großer Teil dieser Informationen stammt von Pai H. Chou's Seite über die Einrichtung von &pdflatex;.

1. Laden Sie das Paket &cjk; herunter. Entpacken Sie die Dateien in einen passen Unterordner von $`TEXMF` wie bereits mit dem Paket &ucs; weiter oben (siehe ). Die Dateien werden in einen Ordner namens `CJK/X_Y.Z` entpackt.

2. Jetzt müssen Sie eine Schriftart herunterladen, die alle benötigten Zeichen enthält. Sie können jede beliebige `*.ttf`-Datei verwenden, die diese Bedingung erfüllt, aber hier wird Cyberbit benutzt. Entpacken Sie die Dateien und benennen Sie `Cyberbit.ttf` zu `cyberbit.ttf` um, damit es keine Probleme mit Groß-/Kleinschreibung gibt.

   Verschieben Sie `cyberbit.ttf` zusammen mit `Unicode.sfd` in einen Ordner und erzeugen Sie die `*.tfm`- und `*.enc`-Dateien mit dem Befehl ``$ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@``. Falls dabei Probleme auftreten und nicht all Dateien (mehrere Hundert) erstellt werden, laden Sie sowohl die `*.tfm`- und `*.enc`-Dateien herunter.

   Verschieben Sie die `*.tfm`-Dateien in einen passenden Ordner wie `$`TEXMF`/fonts/tfm/bitstream/cyberbit/`. Die `*.enc`-Dateien sollten in `$`TEXMF`/pdftex/enc/cyberbit/` installiert werden.

3. Nun ist eine Zuordnungsdatei nötig, die die `*.enc`-Dateien mit der Schriftart verbindet. Laden Sie `cyberbit.map` herunter und installieren Sie diese Datei im Ordner `$`TEXMF`/pdftex/config/`.

4. Laden Sie dann noch die Datei `c70cyberbit.fd` herunter und installieren Sie sie in einem passenden Ordner wie zum Beispiel `$`TEXMF`/tex/misc/`.

5. Zum Schluß muss eine „&PostScript; Type 1“-Schriftart erzeugt werde, um mit &latex; erstellte &DVI;-Dateien lesen zu können. Führen Sie den Befehl ``$ ttf2pfb cyberbit.ttf -o cyberbit.pfb`` aus und kopieren Sie die entstandene Datei `cyberbit.pfb` in einen Ordner wie zum Beispiel `$`TEXMF`/fonts/type1/cyberbit/`.

6. Nun verschieben Sie die Datei `cyberbit.ttf` zu den anderen Schriftarten, damit sie von &latex; gefunden wird. Das ist zum Beispiele ein Ordner namens `$`TEXMF`/fonts/truetype/`.

7. Überprüfen Sie, dass in der Einrichtungsdatei `$`TEXMF`/web2c/texmf.cnf` die Zeile mit `TTFONTS` nicht auskommentiert ist und auf den Ordner zeigt, in dem Sie `cyberbit.ttf` gespeichert haben.

8. Damit &pdflatex; die &cjk;-Schriftarten benutzen kann, müssen sie in der Datei `$`TEXMF`/pdftex/config/pdftex.cfg` die Zeile `map +cyberbit.map` einfügen. Damit ist die Einrichtung für &pdflatex; abgeschlossen.

9. Um &latex; so einzustellen, dass es &DVI;-Dateien mit &cjk;-Zeichen erzeugen kann, müssen Sie die Zeile `cyberbit@Unicode@ cyberbit.ttf` in die Datei `ttfonts.map` einfügen. Diese Datei sollte sich im Ordner `$`TEXMF`/ttf2pk/` befinden. aber möglicherweise müssen Sie sie erst suchen.

10. Jetzt müssen Sie noch das Programm ``texhash`` ausführen, dann ist die Installation abgeschlossen.

Die ordnungsgemäße Einrichtung kann durch Kompilieren dieser Testdatei festgestellt werden.

#### Problembeseitigung für &cjk;

Es gibt viele mögliche Fehlerquellen bei der manuellen Einrichtung von &cjk;. Bei Problemen prüfen Sie die im Folgenden genannten Punkte:

- Da Sie &latex; als normaler Benutzer und nicht als Systemverwalter ausführen, müssen Sie allen Benutzern erlauben, die neuen Dateien zu lesen. Benutzen Sie dazu den Befehl `chmod` für alle neu installierten Ordner und Dateien.

- Wenn &latex; eine &DVI;-Datei ohne Probleme schreibt, sie aber nicht richtig angezeigt wird, liegt die Ursache wahrscheinlich in der automatischen Generierung von `*.pk`-Schriften. Die Schriften sollten für die Anzeige einer &DVI;-Datei jedesmal neu generiert werden, aber dabei können eine Reihe von Fehlern auftreten. Überprüfen Sie die benutzerdefinierte Zeile in `ttfonts.map` als erstes. Möglicherweise ist Ihr Programm `ttf2pk`, das vom &DVI;-Betrachter aufgerufen wird, ohne Unterstützung für die kpathsea-Bibliotheken kompiliert worden. Dann finden Sie in der Ausgabe von ``ttf2pk` `--version`` keinen Hinweis auf kpathsea. Da diese Bibliotheken aber gebraucht werden, müssen Sie ein anderes Paket für `ttf2pk` suchen oder FreeType 1 selbst neu kompilieren.

#### Wie kann Ich &cjk; in Unicode eingeben?

Es gibt verschiedene Eingabetreiber, die Auswahl wird auch durch persönliche Vorlieben beeinflusst. De Autor verwendet Skim, eine Portierung des Treibers für Scim &kde;. Lesen Sie in der Dokumentation zu Ihrer Distribution nach, wie Sie diese Programme installieren können. Die Einrichtung der Programme kann manchmal schwierig sein, für Skim müssen Sie eine Umgebungsvariable ``XMODIFIERS`="@im=SCIM"` definieren, bevor X gestartet wird.

## Skripte

### Skripte in &kile;

Die Skript-Funktion von &kile; erlaubt das Ausführen von ECMAScript-Quelltext. Die Skripte können über Skripte in der Seitenleiste verwaltet werden.

### API-Referenz

In diesem Abschnitt wird die Programmierschnittstelle für Skripte in &kile; beschrieben.

Die API-Skripte sind noch nicht endgültig entwickelt und können sich in weiteren Versionen von &kile; noch ändern.

Als erstes muss gesagt werden, dass die Ausführungsumgebung der Skripte in &kile; ein systemweites Objekt (= kile) mit den folgenden Methoden besitzt:

(kile).`currentTextDocument()`

  Gibt das Objekt `KileTextDocument` zurück, das dem aktuell geöffneten Textdokument entspricht. Ist kein aktives Textdokument vorhanden, wird `null` zurückgegeben.

(kile).`getInputValue(`caption`, `label`)`

  Öffnet einen Dialog mit dem angegebenen Titel und Textfeld. Gibt den vom Benutzer eingegebenen Wert zurück.

Objekte vom Typ `KileTextDocument` repräsentieren für Textdokumente in &kile;. Sie haben folgende Eigenschaften:

(KileTextDocument).`backspace()`

  Löscht das Zeichen unmittelbar vor der aktuellen Cursor-Position und verschiebt den Cursor um ein Zeichen im Text zurück.

(KileTextDocument).`cursorLeft()`

  Bewegt den Cursor zum vorherigen Zeichen im Text.

(KileTextDocument).`cursorRight()`

  Bewegt den Cursor zum nächsten Zeichen im Text.

(KileTextDocument).`insertText(`text`)`

  Fügt den Text in der Variablen `text` an der aktuellen Cursor-Position in das Dokument ein.

(KileTextDocument).`insertBullet()`

  Fügt an der aktuellen Cursor-Position eine Sprungmarke in das Dokument ein.

(KileTextDocument).`nextBullet()`

  Wählt die erste Sprungmarke im Dokument direkt nach der aktuellen Cursor-Position.

(KileTextDocument).`previousBullet()`

  Wählt die erste Sprungmarke im Dokument direkt vor der aktuellen Cursor-Position.

(KileTextDocument).`up()`

  Bewegt den Cursor zur vorherigen Zeile im Dokument.

(KileTextDocument).`down()`

  Bewegt den Cursor zur nächsten Zeile im Dokument.

(KileTextDocument).`cursorLine()`

  Gibt die Zeile zurück, in der sich der Cursor gerade befindet.

(KileTextDocument).`cursorColumn()`

  Gibt die Spalte zurück, in der sich der Cursor gerade befindet.

(KileTextDocument).`setCursorLine(`line`)`

  Setzt den Cursor in die durch den Parameter `line` angegebene Zeile.

(KileTextDocument).`setCursorColumn(`column`)`

  Setzt den Cursor in die durch den Parameter `column` angegebene Spalte.

## Hilfe

### Hilfe-Dokumente

&latex; ist ein recht ausgeklügeltes System, in dem die grundlegenden Funktionen durch eine Vielzahl von zusätzlichen Paketen erweitert werden können. &kile; bietet eine Menge unterschiedlichster Hilfen zur Unterstützung der Anwender.

LaTeX-Referenz

  Eine alphabetische Auflistung der gebräuchlichsten &latex;-Befehle.

TeX-Dokumentation

  &tetex; und &texlive; werden mit vielen Hilfe-Dokumenten ausgeliefert. Darin enthalten ist eine Dokumentation für alle enthaltenen Pakete und eine zusätzliche &latex;-Referenz.

LaTeX

  Eine vollständige Referenz für &tex; und seine „Freunde“. Hierbei handelt es sich nicht nur um eine Beschreibung aller Programme, aber ein paar wichtige Pakete werden beschrieben. Es ist vielmehr eine vollständige Bedienungsanleitung für die &latex;-Befehle enthalten und ist somit ideal für die Suche nach einer bestimmten Formatierung. Da es sich hierbei um ein sehr großes Dokument handelt, gibt es in &kile; drei Lesezeichen als Verweis auf die einzelnen Teile.

LaTeX-Befehl

  Eine weitere alphabetische Auflistung der gebräuchlichsten &latex;-Befehle.

LaTeX-Thema

  Eine Beschreibung der wichtigen Themen zu &latex;.

LaTeX-Umgebung

  Eine alphabetische Auflistung der gebräuchlichsten &latex;-Umgebungen.

### Kontexthilfe

In &kile; gibt es eine Kontexthilfe, die mit dem Kurzbefehl &Ctrl;&Alt;H,K aufgerufen werden kann. In Einstellungen Kile einrichten... Kile Hilfe können Sie auswählen, ob in &kile; die &latex;-Referenz oder das &tetex;/&texlive;-Hilfesystem (die Voreinstellung) benutzt wird.

Sprungmarken
Sprungmarken

### Suche nach Schlagwörtern

Aufgrund der Menge an Hilfe-Dokumenten mit denen &tetex;/&texlive; ausgeliefert wird, ist das Finden des richtigen Dokuments nicht immer einfach. Um diese Suche zu erleichtern, enthält &tetex;/&texlive; die kleine Anwendung `texdoctk`, die eine Datenbank aller Hilfe-Dokumente zur Verfügung stellt. Auf diese Datenbank kann in &kile; mit einer grafische Oberfläche zugegriffen werden.

Sprungmarken
Sprungmarken

Alle Dokumente sind in Kategorien eingeteilt. Außerdem kann nach Paketnamen oder Schlagwörtern gesucht werden. &kile; zeigt dann nur die Hilfe-Dokumente an, in denen der Suchtext vorkommt.

Sprungmarken
Sprungmarken

Ein Doppelklick mit der Maus oder das Betätigen der Leertaste öffnet den Betrachter für das ausgewählte Dokument. Es kann sich hierbei um ein beliebiges Dokument handeln, nicht nur um &DVI;-, PS-, PDF- oder &HTML;-Dokumente. &kile; benutzt die &kde;-Einstellungen, um ein passendes Anzeigeprogramm zu starten.

### Benutzerdefinierte Hilfe

Neben der nicht veränderbaren &tetex;/&texlive;-Dokumentation gibt es in &tetex; ein flexibles erweiterbares System für Hilfedokumente, Im Menü Hilfe in &kile; ist ein besonderes Untermenü Benutzerdefinierte Hilfe. Hier können eigene Dokumente ins Menü eingebunden werden. Das können wichtige Teile der &tetex;/&texlive;-Dokumentation oder auch eigene Dokumente sein. Auch &URL;s (Adressen im Internet) können hier benutzt werden.

Öffnen Sie die Seite Einstellungen&kile; einrichten ...&kile;Hilfe. Klicken Sie auf den Knopf Einrichten, um Einträge der Benutzerhilfe zu bearbeiten. Sie können Menüeinträge hinzufügen, entfernen, deren Position im Menü verschieben und Trennlinien einfügen, um die Struktur des Menüs Ihren Wünschen anzupassen.

Dialog: Benutzerhilfe einrichten
Dialog: Benutzerhilfe einrichten

Mit Hinzufügen ... öffnen Sie einen weiteren Dialog, in dem Sie einen Namen für den Menüeintrag eingeben und die zugehörige lokale Hilfedatei oder &URL; auswählen können. Klicken auf das zweite Symbol rechts neben dem Eingabefeld startet &konqueror;, damit kann die richtige &URL; ermittelt werden.

Dialog: Neuen Hilfeeintrag hinzufügen
Dialog: Neuen Hilfeeintrag hinzufügen

Nachdem die Einrichtung fertiggestellt ist, werden alle Einträge im Menü Hilfe von &kile; unter Benutzerdefinierte Hilfe angezeigt.

Menü „Benutzerdefinierte Hilfe“
Menü „Benutzerdefinierte Hilfe“

## Danksagungen und Lizenz

&kile; ist ein quelloffener und benutzerfreundlicher &latex;-/&tex;-Quelltexteditor, der auf allen Systemen mit installierter &kde;-Arbeitsflächenumgebung ausgeführt werden kann. &kde; ist für unterschiedliche Architekturen einschließlich &Linux;- und Unix-ähnlichen Systemen verfügbar.

Viel Dank gebührt denen, die sich an der Weiterentwicklung des &kile;-Projekts beteiligen und dafür viele Stunden für die Entwicklung von Werkzeugen opfern, die wir alle unter Beachtung der &GNU;-Lizenz verwenden können. Aktuelle Informationen zu den Beitragenden gibt es im Menü Hilfe Über &kile;.

Viel Dank gebührt auch allen weiteren Beitragenden.

Übersetzung: Johannes Obermayr johannesobermayr@gmx.de

&underFDL; &underGPL;

&documentation.index;