LaTeX-Umgebung Eclipse4LaTeX

Eclipse4LaTeX ist eine Zusammenstellung von kostenfreien Programmen, die das Arbeiten mit LaTeX unter dem Betriebssystem Microsoft Windows ermöglichen und ohne Installation funktionieren (portable Software). Die LaTeX-Umgebung sollte nur von schnellen Datenträgern gestartet werden.

Die detaillierte Beschreibung für die Zusammenstellung und Einrichtung aller Einzelkomponenten von Eclipse4LaTeX finden Sie in meiner LaTeX-Anleitung Richter_LaTeX_Tipps im Anhang A.2.

In den nächsten Abschnitten werden die nötigen Schritte für das Einrichten des vorkonfigurierten Eclipse4LaTeX auf Ihrem PC beschrieben. Als Wurzelverzeichnis wurde C:\progs gewählt und mit Schreibrechten (Vollzugriff) für jeden Nutzer (Gruppe Benutzer oder Jeder) versehen. Jede Komponente der LaTeX-Umgebung erhält ein eigenes Unterverzeichnis. Zum Verteilen auf andere Rechner müssen nur diese Verzeichnisse auf einen mobilen Datenträger kopiert bzw. gepackt werden und auf dem anderen Rechner an gleicher Stelle wieder eingefügt werden. Bei dieser Vorgehensweise müssen danach keine Pfade in den Programmen angepasst werden.

Die folgende Tabelle führt die enthaltenen Komponenten auf. Die Downloads befinden sich im nächsten Abschnitt.

Voraussetzung für den Start von Eclipse ist eine installierte Java-Laufzeitumgebung (JRE) in 32 Bit.

• Download: https://www.java.com/de/download/manual.jsp
• Variante Windows Offline (32 Bit), ca. 66 MB → z.B. jre-8u251-windows-i586.exe
• Eine 64-Bit-Variante für Eclipse + TeXlipse für aktuelle Java-Versionen, die nur 64-Bit unterstützen, ist in Planung.

Eclipse4LaTeX ist in drei Downloads aufgeteilt:

1. MiKTeX: Portable TeX-Distribution mit den wichtigsten Paketen (Datum siehe Dateiname)
2. Eclipse4LaTeX: Editor, PDF-Betrachter & Wörterbücher
3. Workspace: Verzeichnis, das alle LaTeX-Projekte und Eclipse-Einstellungen enthält.

1. Die ersten beiden ZIP-Archive werden nach C:\progs entpackt.
2. Das dritte ZIP-Archiv wird auf dem Laufwerk entpackt, wo Ihre Daten liegen. Das könnte z.B. D: sein, so dass der Workspace in D:\Workspace liegt.

Die ausführbare Datei von Eclipse ist: C:\progs\Eclipse4LaTeX\eclipse.exe. Von dieser kann eine Verknüpfung auf dem Desktop erstellt und nach Eclipse4LaTeX umbenannt werden. Der nach dem Start erscheinende Dialog fragt nach dem Ort des Workspace. Voreingestellt ist D:\Workspace.

Danach öffnet sich die Arbeitsoberfläche von Eclipse.

Links befindet sich der Project Explorer, der das Projekt Test mit den Dateien enthält. In der Mitte ist das Editor-Fenster mit der LaTeX-Datei document.tex mit einer einfachen Dokumentstruktur zu sehen. Diese wird im rechten Fenster (View) Outline nochmal dargestellt. Die unterste View Console beinhaltet die Ausgabe des LaTeX-Übersetzungsvorgangs. Dieser startet, wenn das geänderte Dokument gespeichert wird (Tastenkombination Strg+S). Durch das Umschalten auf die View Problems – links neben Console – sieht man eine Zusammenfassung aufgetretener Fehler und Warnungen. Ein Doppelklick auf einen Fehler führt zum Sprung an die Dokumentposition, wo der Fehler auftrat.

Die erstellte PDF-Datei kann mit Strg+4 oder im Menü Latex \ Preview Document in SumatraPDF angeschaut werden.

Durch einen Doppelklick in das PDF wird auf Eclipse umgeschaltet und an die entsprechende Position im TeX-Dokument gesprungen. Das ist für die Bearbeitung sehr nützlich.

Die Einstellungen für die Synchronisation von Editor und Betrachter sind in Eclipse4LaTeX bereits alle vorgenommen worden und in Richter_LaTeX_Tipps im Abschnitt 2.2.3 beschrieben.

Diese werden entweder im Menü Project \ Properties oder links im Project Explorer mit einem Rechtsklick auf das Projekt → Properties aufgerufen. Wichtigste Einstellungen sind:

• Resource → Text file encoding (Zeichenkodierung der TeX-Dokumente)
  • Vorzugsvariante: UTF-8 → Unicode: Unterstützt über 128.000 Zeichen
  • Nicht empfohlen: ISO-8859-1 (Latin1): nur 256 Zeichen verfügbar (westeuropäische Sprachen)
• Latex Project Properties
  • Main TeX File → Hauptdokument
  • Output File → Ausgabedokument
  • Output Format → PDF oder DVI
  • The two-letter (ISO 639) language code → Sprachcode (en = Englisch, de = Deutsch)

MiKTeX und LaTeX werden regelmäßig weiterentwickelt. Beide können einfach mit dem MiKTeX-Update-Manager aktualisiert werden.

1. In den Ordner c:\progs\MiKTeX\ wechseln
   • Datei ausführen: miktex-portable.cmd oder miktex-portable.lnk
   • Die zweite Datei (Verknüpfung) kann auch auf den Deskop kopiert, umbenannt und dort gestartet werden.
2. Im Traymenü unten rechts erscheint das MiKTeX-Icon. → Rechtsklick → Update MiKTeX
   1. (o) I want to get packages from a remote package repository:
      • (o) Use the nearest package repository
      • oder: (o) Let me choose a remote package repository
      • Weiter → Searching
   2. Aktualisierbare Elemente sind vorausgewählt
      • Möglicherweise sind weitere Durchläufe nötig
      • Manche Pakete bedürfen einer Reparatur: to be repaired
   3. Weiter
3. Update MiKTeX solange durchführen bis keine Einträge mehr erscheinen:
   • There are currently no updates available.
4. Tray-Symbol → Rechtsklick → MiKTeX Options
   1. Refresh FNDB
   2. Update Formats