{{htmlmetatags>
metatag-robots=(index,follow)
metatag-keywords=(Eclipse4LaTeX,portable,Freeware,kostenfrei,kostenlos,Editor,MiKTeX,Eclipse,TeXlipse,YAP,SumatraPDF,ohne Installation)
metatag-description=(LaTeX-Umgebung Eclipse4LaTeX)
}}
====== 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:anleitungen|LaTeX-Anleitung]] //Richter_LaTeX_Tipps// im Anhang A.2.
===== Einzelkomponenten =====
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.
^ Anwendung ^ Name ^ Lokaler Pfad auf PC ^ Link ^
| TeX-Distribution | MiKTeX 2.9 (portabel) | ''C:\progs\MiKTeX'' | [[http://www.miktex.org/]] |
| Editor | Eclipse 4.4.2 mit Plugin TeXlipse 1.5.0 | ''C:\progs\Eclipse'' | [[http://www.eclipse.org/]]\\ [[https://projects.eclipse.org/projects/science.texlipse]]\\ [[http://texlipse.sourceforge.net/|Alte Projektseite auf sourceforge.net]] |
| Wörterbücher | Jazzy für TeXlipse | ''C:\progs\TeXlipse_Dictionaries'' | [[http://sourceforge.net/projects/texlipse/files/dictionaries/|Download (de & en)]] |
| DVI-Betrachter | YAP 2.9.6200 (Bestandteil von MiKTeX) | ''C:\progs\MiKTeX\miktex\bin'' | -- |
| PDF-Betrachter | SumatraPDF 3.1.2 | ''C:\progs\SumatraPDF'' | [[http://www.sumatrapdfreader.org/]] |
===== Download =====
Voraussetzung für den Start von Eclipse ist eine installierte [[wpde>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:
- MiKTeX: Portable TeX-Distribution mit den wichtigsten Paketen (Datum siehe Dateiname)
- Eclipse4LaTeX: Editor, PDF-Betrachter & Wörterbücher
- Workspace: Verzeichnis, das alle LaTeX-Projekte und Eclipse-Einstellungen enthält.
| MiKTeX (portable) | 2.9 | 447 MB | {{:latex:miktex_2.9.6200_portable_mit_paketen_2017-02-17.zip}} |
| Eclipse4LaTeX | 4.4.2 | 77 MB | {{:latex:eclipse4latex_4.4.2__texlipse_1.5.0__sumatra_3.1.2.zip|}} |
| Eclipse-Workspace | -- | 211 kB | {{:latex:workspace_konfiguriert_beispiel__4.4.2_2017-02-17_ohne_vcs.zip|}} |
===== Einrichtung =====
- Die ersten beiden ZIP-Archive werden nach ''C:\progs'' entpackt.
- 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.
===== Start =====
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''.
{{:latex:eclipse_workspace_dialog.png|}}
Danach öffnet sich die Arbeitsoberfläche von Eclipse.
{{:latex:eclipse_texlipse_artikel.png|}}
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.
{{:latex:eclipse_sumatra_artikel.png|}}
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 [[latex:anleitungen|Richter_LaTeX_Tipps]] im Abschnitt 2.2.3 beschrieben.
===== Projekt-Einstellungen =====
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 -> [[wpde>Unicode]]: Unterstützt über 128.000 Zeichen
* Nicht empfohlen: [[wpde>ISO 8859-1|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 [[wpde>Device independent file format|DVI]]
* The two-letter ([[wpde>ISO_639|ISO 639]]) language code -> Sprachcode (en = Englisch, de = Deutsch)
===== MiKTeX-Pakete aktualisieren =====
MiKTeX und LaTeX werden regelmäßig weiterentwickelt. Beide können einfach mit dem MiKTeX-Update-Manager aktualisiert werden.
- 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.
- Im Traymenü unten rechts erscheint das MiKTeX-Icon. -> Rechtsklick -> //Update MiKTeX//
- (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//
- Aktualisierbare Elemente sind vorausgewählt
* Möglicherweise sind weitere Durchläufe nötig
* Manche Pakete bedürfen einer Reparatur: //to be repaired//
- //Weiter//
- //Update MiKTeX// solange durchführen bis keine Einträge mehr erscheinen:
* //There are currently no updates available.//
- Tray-Symbol -> Rechtsklick -> //MiKTeX Options//
- //Refresh FNDB//
- //Update Formats//
===== Problemlösungen =====
==== Java-Fehler bei Rückwärtssuche (Inverssuche) ====
| Fehlermeldung: | "Java version has value '1.8', but '1.7' is required." |
| Lösung: | Im Ordner ''C:\Windows\System32'' (32 Bit-Windows) oder ''C:\Windows\SysWOW64'' (64 Bit-Windows) die Dateien ''java.exe, javaw.exe'' und ''javaws.exe'' löschen. Diese stammen noch von einer älteren Java-Installation.\\ Aufruf des Betrachters mit Unterstützung der Inverssuche nur mit ''javaw.exe'' ohne Pfad. Eclipse: //Preferences \ Texlipse \ Viewer Settings -> Sumatra PDF -> Edit \ Viewer arguments// |
| Erklärung: | Seit Java 8 wird der Pfad ''c:\ProgramData\Oracle\Java\javapath\'' in die Umgebungsvariable PATH eingetragen. Dieser Ordner enthält symbolische Links zu jeder der drei Dateien, die auf das tatsächliche Java-Programmverzeichnis verweisen, z.B. ''c:\Program Files (x86)\Java\jre1.8.0_251\bin\java.exe'' |
==== Der DVI-Betrachter YAP startet nicht mehr ====
| Fehlermeldung: | "MiKTeX encountered an internal error." |
| Lösung: | Tray-Symbol starten: ''c:\progs\MiKTeX\miktex-portable.cmd''\\ Tray-Symbol -> Rechtsklick -> //MiKTeX Options//\\ //Refresh FNDB// + //Update Formats// |
| Erklärung: | Nach einer MiKTeX-Aktualisierungen müssen die Datenbank der bekannten Dateinamen (file name database, FNDB) und die Formatdateien aktualisiert werden. |