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 oder die weitere Umwandlung kann das Tastenkürzel 2 verwendet werden. Danach kann die -Datei im standardmäßigen Betrachter mittels 3 angesehen, mittels 4 die -Datei in eine PS-Datei umgewandelt und mittels 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 zuerst 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 6 und lassen sich dann das kompilierte Ergebnis mit 7 anzeigen.
Außerdem können Sie eine PS-Datei in eine PDF-Datei mit 8 oder direkt in eine -Datei in eine PDF-Datei mit 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 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+ (eingebetteter Betrachter)
LaTeX+ ()
LaTeX+PS (eingebetteter Betrachter)
LaTeX+PS ()
PDFLaTeX+PDF (eingebetteter Betrachter)
PDFLaTeX+PDF ()
XeLaTeX+PDF (eingebetteter Betrachter)
XeLaTeX+PDF ()
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 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 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 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 oder PDF kompiliert werden, aber keine EPS-Dateien. Umgekehrt funktioniert das Kompilieren mit LATEX zu 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 -Grafiken erstellen. Oder Sie möchten die -Ausgabe von mathematischer und wissenschaftlicher Software wie Mathematica, Maple oder MuPAD weiter bearbeiten. Diese LATEX-Benutzer müssen zuerst in kompilieren, auch wenn Sie eigentlich PDF-Dokumente erzeugen möchten, da diese Programme -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 -Quelltext als auch PNG- oder JPG-Dateien 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 benutzen und dann mit dvips eine PS-Datei erstellen. PDFLATEX ist ein geeignetes Werkzeug für diese Aufgabe, solange Ihr Quelle keinen -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. Das 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 ) 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 ) verwenden, aber keine JPEG- oder PNG-Dateien. Letztere können Sie mit Umwandlungsprogrammen wie convert aus dem Paket ImageMagickbearbeiten.
Die EPS-Dateien werden sowohl von LATEX als auch von der -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 -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 -Dateien eingebunden. Da die EPS-Dateien aber für die Umwandlung von -Dateien in PS-Dateien benötigt werden, müssen sie immer zusammen mit den -Dateien verschoben werden.
Nun starten Sie LATEX und ein -PS-Umwandlungsprogramm wie dvips erzeugt Ihr -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 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.

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 -Datei in das PS-Format umgewandelt wird.
LATEXbenö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 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.