programme:emacs

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung
Vorhergehende Überarbeitung
Letzte Überarbeitung Beide Seiten der Revision
programme:emacs [25.05.2008 18:25]
tquaritsch angelegt
programme:emacs [01.03.2010 16:39]
Michael Hammer
Zeile 1: Zeile 1:
 ====== Emacs ====== ====== Emacs ======
  
-{{:programme:emacs_preview_toc_1024.png?200 }}+{{:programme:emacs_toc.png?300 }}
  
-Im Folgenden wird beschrieben, wie Emacs für die Verwendung von LaTeX eingerichtet werden kann. Der Screenshotzeigt Emacs mit Preview-LaTeX und dem Inhaltsverzeichnis von RefTeX.+Im Folgenden wird beschrieben, wie Emacs für die Verwendung von LaTeX eingerichtet werden kann. Der Screenshotzeigt Emacs mit [[http://www.gnu.org/software/auctex/|AUCTeX]] und dem Inhaltsverzeichnis von [[http://www.gnu.org/software/auctex/reftex.html|RefTeX]].
  
 +===== AUCTeX Mode =====
  
-~~CLEARFLOAT~~ +==== Syntax Highlighting ====
- +
-{{ :programme:emacs_nw_cite_1024.png?200}} +
- +
-Emacs kann auch im Textmodus verwendet werden (hier wird im unteren Buffer eine  +
-Referenz ausgesucht, die nach Auswahl in ein \cite eingebunden wird).  +
- +
- +
-~~CLEARFLOAT~~ +
- +
-\\ +
- +
-Problemlösungen und genauere Anleitungen der Pakete findet man auf der jeweiligen Homepage von AUCTeX und RefTeX. +
- +
-===== Syntax Highlighting =====+
  
-Die Übersichtlichkeit eines LaTeX-Dokumentes wird erhöht, wenn sich Befehle farblich unterscheiden:+Die Übersichtlichkeit eines LaTeX-Dokumentes wird erhöht, wenn sich Befehle farblich unterscheiden. Darüber hinaus sind im linken screenshot die preview Möglichkeiten von AUCTeX dargestellt.
  
-{{:programme:emacs_color_full.png?400}} {{:programme:emacs_nocolor_full.png?400}}+{{:programme:emacs_color.png?350}} {{:programme:emacs_nocolor.png?350}}
  
-Die Datei ~/.emacs muß um folgende Zeilen erweitert werden:+Für die farbliche Darstellung (und die vergrößerte Überschriftenschrift) muss die Datei ''~/.emacs'' eventuell um folgende Zeilen erweitert werden. Der globale ''font-lock-mode'' steuert das Verhalten. Im folgenden code snippet wird dieser für alle modes aktiviert die ''font-lock'' unterstützen.
  
 <code lisp> <code lisp>
-  ----------------------------- ~/.emacs ------------------------------ 
   (cond ((fboundp 'global-font-lock-mode)   (cond ((fboundp 'global-font-lock-mode)
   ;; Turn on font-lock in all modes that support it   ;; Turn on font-lock in all modes that support it
Zeile 35: Zeile 21:
   ;; Maximum colors   ;; Maximum colors
   (setq font-lock-maximum-decoration t)))   (setq font-lock-maximum-decoration t)))
-  ----------------------------- ~/.emacs ------------------------------ 
 </code> </code>
  
 +Der AUCTeX Mode erleichtert die Arbeit mit LaTeX-Dokumenten erheblich: es werden Makros bereitgestellt, mit deren Hilfe Überschriften, Umgebungen und Befehle sehr schnell eingefügt werden können. AUCTeX erkennt, ob mit dem nächsten 'auszuführenden Befehl' der Buffer kompiliert werden muß, ob der Viewer geöffnet werden kann oder ob man mit BibTeX kompilieren soll. Einen ersten Überblick erhält man auf der [[http://www.gnu.org/software/auctex/|AUCTeX Homepage]]. Wie dieser Major-Mode für Emacs zu installieren ist, hängt wiederum vom Paketverwaltungssystem der verwendeten Linux Distribution ab. Auch unter Windows ist [[http://www.gnu.org/software/auctex/download-for-windows.html|AUCTeX zum download verfügbar]].
  
-===== AUCTeX Mode =====+Um AUCTeX-Mode bei .tex-Dokumenten verwenden zu können, sind eventuell noch folgende Einträge in ''~/.emacs'' nötig:
  
-Der AUCTeX Mode erleichtert die Arbeit mit LaTeX-Dokumenten erheblich: es werden Makros bereitgestellt, mit deren Hilfe Überschriften, Umgebungen und Befehle sehr schnell eingefügt werden können. AUCTeX erkennt, ob mit dem nächsten 'auszuführenden Befehl' der Buffer kompiliert werden muß, ob der Viewer geöffnet werden kann oder ob man mit BibTeX kompilieren soll. Einen ersten Überblick erhält man auf der [[http://www.gnu.org/software/auctex/|AUCTeX Homepage]]. Wie dieser Major-Mode für Emacs zu installieren ist, hängt wiederum vom Paketverwaltungssystem der verwendeten Distribution ab. Wird das Paket von der Distribution nicht zur Verfügung gestellt, wird man sicherlich auf oben genannter Homepage oder [[http://www.rpmfind.net|rpmfind]] fündig. +<code lisp>
- +
-Um AUCTeX-Mode bei .tex-Dokumenten verwenden zu können, sind ein folgende Einträge in ~/.emacs nötig: +
- +
-<code  lisp> +
-  ----------------------------- ~/.emacs ------------------------------+
   (setq TeX-auto-save t)   (setq TeX-auto-save t)
   (setq TeX-parse-self t)   (setq TeX-parse-self t)
   (setq-default TeX-master nil)   (setq-default TeX-master nil)
-  ----------------------------- ~/.emacs ------------------------------ 
 </code> </code>
  
-==== Übersicht der wichtigsten AUCTeX Befehle ====+==== Übersicht einiger wichtigen AUCTeX Befehle ====
  
-  * LaTeX-environment (C-c C-e) Dies fügt eine LaTeX-Umgebung ein. Führt man den Befehl z.B. in einem leeren .tex-Dokument aus, schlägt AUCTeX vor, ein \documentclass einzufügen, und fragt anschließend nach den gewünschten Optionen.Da sich die Liste von möglichen Umgebungen ändert, wenn zusätzliche Pakete geladen werden, sollte nach Einfügen eines neuen Pakets (wie amsmath) AUCTeX aktualisiert werden (LaTeX -> Miscellaneous -> Reset AUCTeX oder (C-u C-c C-n)). +  * LaTeX-environment (C-c C-e) fügt eine LaTeX-Umgebung ein. Führt man den Befehl z.B. in einem leeren .tex-Dokument aus, schlägt AUCTeX vor, ein \documentclass einzufügen, und fragt anschließend nach den gewünschten Optionen. Da sich die Liste von möglichen Umgebungen ändert, wenn zusätzliche Pakete geladen werden, sollte nach Einfügen eines neuen Pakets (wie amsmath) AUCTeX aktualisiert werden (LaTeX -> Miscellaneous -> Reset AUCTeX oder (C-u C-c C-n)). Wird der Befehl in mitten eines Dokumentes ausgeführt so lassen sich damit sehr einfach Umgebungen im Stile ''\begin{$env} \end{$env}'' erzeugen
-  * LaTeX-section (C-c C-s) Damit wird eine Überschrift eingefügt+  * LaTeX-section (C-c C-s) erzeugt eine Überschrift. 
-  * TeX-command-master (C-c C-c) LaTeX wird ausgeführt. Nach erneutem Ausführen des Makros wird entweder ein weiteres Mal LaTeX ausgeführt (falls noch unaufgelöste Referenzen vorhanden sind), oder ein Viewer gestartet. Eine Übersicht der möglichen ausführbaren Befehle erhält man, indem man nach (C-c C-c) die Tabulatortaste drückt.+  * TeX-command-master (C-c C-c) für das LaTeX Kommando aus. Nach erneutem Ausführen des Makros wird entweder ein weiteres Mal LaTeX ausgeführt (falls noch unaufgelöste Referenzen vorhanden sind), oder ein Viewer gestartet. Eine Übersicht der möglichen ausführbaren Befehle erhält man, indem man nach (C-c C-c) die Tabulatortaste drückt.
   * C-c C-t C-p (ab AUCTeX version 11.50) Zwischen PDF/DVI-mode wechseln. Je nachdem wird das Dokument nach Aufruf von TeX-command-master mit "pdflatex" oder "latex" kompiliert.   * C-c C-t C-p (ab AUCTeX version 11.50) Zwischen PDF/DVI-mode wechseln. Je nachdem wird das Dokument nach Aufruf von TeX-command-master mit "pdflatex" oder "latex" kompiliert.
  
-==== Links ====+==== Arbeiten mit Masterdokument ====
  
-  * [[http://www.gnu.org/software/auctex/|AUCTeX Homepage]] +Wir empfehlen folgende Ergänzung in der ''~/.emacs'' vorzunehmen:
-  * [[http://www.gnu.org/software/auctex/manual/|AUCTeX Online Dokumentation]] +
-  * [[http://www.gnu.org/software/auctex/manual/auctex.pdf|Manual (PDF)]] +
-  * [[http://ftp.gnu.org/gnu/auctex/11.50-extra/tex-ref.pdf|Reference Card (pdf)]]+
  
 +<code lisp>
 +(setq-default TeX-master nil)
 +</code>
 +
 +Das führt dazu, dass emacs beim Erstellen einer neuen *.tex Datei automatisch nach der Masterdatei fragt. Damit sollte am Ende des Dokumentes folgende Zeilen auftauchen:
 +
 +<code>
 +%%% Local Variables: 
 +%%% mode: latex
 +%%% TeX-master: "main"
 +%%% End: 
 +</code>
 +
 +Falls Sie immer den selben Dateinamen für das Masterdokument verwenden könnten sie auch diesen Namen direkt in der ''~/.emacs'' Datei angeben, z.B.:
 +
 +<code lisp>
 +(setq-default TeX-master "main")
 +</code>
 +
 +==== Preview-LaTeX ====
 +
 +Ein empfehlenswertes Feature ist auch das in AUCTeX mittlerweile inkludierte Preview-LaTeX. Dieses rendert wahlweise Formel, Bilder, Überschriften,.. in den Editor: 
 +
 +{{:programme:emacs_color.png?600}}
 +
 +Preview-LaTeX ist relativ einfach zu verwenden - (C-c C-p C-d) rendert alle vorhandenen Grafiken, Formeln usw. des vorliegenden Dokuments. Bewegt man den Cursor in eine Formel, kann diese editiert werden, mit (C-c C-p C-p) erhält man die gerenderte Vorschau.
  
 ===== RefTeX Mode ===== ===== RefTeX Mode =====
Zeile 72: Zeile 75:
 RefTeX bietet Unterstützung beim Beschriften und Referenzieren von Konstruktionselementen (section, figure,..). Navigation durch das Inhaltsverzeichnis sind möglich, und auch das Zitieren mit BibTeX wird unterstützt. Der linke Screenshot zeigt das Inhaltsverzeichnis mit Navigationsbalken, rechts wird eine einzufügende Referenz ausgesucht: RefTeX bietet Unterstützung beim Beschriften und Referenzieren von Konstruktionselementen (section, figure,..). Navigation durch das Inhaltsverzeichnis sind möglich, und auch das Zitieren mit BibTeX wird unterstützt. Der linke Screenshot zeigt das Inhaltsverzeichnis mit Navigationsbalken, rechts wird eine einzufügende Referenz ausgesucht:
  
-{{:programme:emacs_toc_full.png?400}} {{:programme:emacs_ref_full.png?400}}+{{:programme:emacs_toc.png?350}} {{:programme:emacs_reference.png?350}}
  
-RefTeX ist ab Emacs-20.2 bei der Grundinstallation enthalten, für XEmacs kann es nachträglich installiert werden. Sollte RefTeX im Paketverwaltungssystem der verwendeten Distribution nicht enthalten sein, kann man es von der [[http://zon.astro.uva.nl/~dominik/Tools/reftex/|RefTeX Homepage]] beziehen. Die Konfigurationsdatei ~/.emacs muß folgendermassen angepaßt werden:+RefTeX ist in aktuellen Emacs Version bei der Grundinstallation enthalten, für XEmacs kann es nachträglich installiert werden. Sollte RefTeX im Paketverwaltungssystem der verwendeten Distribution nicht enthalten sein, kann man es von der [[http://www.gnu.org/software/auctex/reftex.html|RefTeX Homepage]] beziehen. Die Konfigurationsdatei ~/.emacs sollte folgendermassen angepaßt werden:
  
 <code lisp> <code lisp>
-  ----------------------------- ~/.emacs ------------------------------ 
   (add-hook 'LaTeX-mode-hook 'turn-on-reftex)   ; with AUCTeX LaTeX mode   (add-hook 'LaTeX-mode-hook 'turn-on-reftex)   ; with AUCTeX LaTeX mode
-  (add-hook 'latex-mode-hook 'turn-on-reftex)   ; with Emacs latex mode 
-  (add-hook 'LaTeX-mode-hook 'LaTeX-math-mode) 
- 
-  (setq reftex-plug-into-AUCTeX t 
-        reftex-enable-partial-scans t) 
- 
-  (setq reftex-use-external-file-finders t) 
-  (setq reftex-external-file-finders 
-        '(("tex" . "kpsewhich -format=.tex %f") 
-          ("bib" . "kpsewhich -format=.bib %f"))) 
-  ----------------------------- ~/.emacs ------------------------------ 
 </code> </code>
  
Zeile 99: Zeile 90:
   * C-c [ greift auf die eingetragene Bibliography-Datei zu, diese kann anschliessend nach Einträgen untersucht werden - die ausgewählte Referenz wird per /cite eingefügt.   * C-c [ greift auf die eingetragene Bibliography-Datei zu, diese kann anschliessend nach Einträgen untersucht werden - die ausgewählte Referenz wird per /cite eingefügt.
  
-==== Links ====+===== Links =====
  
-  * [[http://remote.science.uva.nl/~dominik/Tools/reftex/|RefTeX Homepage]] +  * [[http://www.gnu.org/software/auctex/|AUCTeX Homepage]] 
-  * [[http://remote.science.uva.nl/~dominik/Tools/reftex/reftex-nutshell.html|RefTeX in a Nutshell]] +  * [[http://www.gnu.org/software/auctex/reftex.html|RefTeX Homepage]]
-  * [[http://remote.science.uva.nl/~dominik/Tools/reftex/reftex.html|RefTeX Online Dokumentation]] +
-  * {{:docs:reftex.pdf|RefTeX Manual}}+
  
  
  
-===== Preview-LaTeX ===== 
- 
-Ein empfehlenswertes Paket ist auch Preview-LaTeX. Dieses rendert wahlweise Formel, Bilder, Überschriften,.. in den Editor:  
- 
-{{:programme:emacs_preview_full.png?400}} 
- 
-Entweder das Paket über die Linuxdistribution installieren, oder von der [[http://preview-latex.sourceforge.net/|Homepage]] beziehen. AUCTeX muß jedoch schon auf dem System installiert sein. In ~/.emacs ist folgender Eintrag notwendig: 
- 
-<code lisp> 
-  ----------------------------- ~/.emacs ------------------------------ 
-  (load "preview-latex.el" nil t t) 
-  ----------------------------- ~/.emacs ------------------------------ 
-</code> 
- 
-Dies kann jedoch auch von der Distribution abhängen, bei Gentoo sollte 
- 
-<code lisp> 
-  ----------------------------- ~/.emacs ------------------------------ 
-  (load "/usr/share/emacs/site-lisp/site-gentoo") 
-  ----------------------------- ~/.emacs ------------------------------ 
-</code> 
- 
-zu Beginn der Datei ~/.emacs eingetragen werden. 
- 
-Preview-LaTeX ist relativ einfach zu verwenden - (C-c C-p C-d) rendert alle vorhandenen Grafiken, Formeln usw. des vorliegenden Dokuments. Bewegt man den Cursor in eine Formel, kann diese editiert werden, mit (C-c C-p C-p) erhält man die gerenderte Vorschau. 
- 
-==== Links ==== 
  
-  * [[http://preview-latex.sourceforge.net/|Preview-LaTeX Homepage]] 
-  * [[http://preview-latex.sourceforge.net/manual/index.html|Preview-Latex Online Dokumentation]] 
programme/emacs.txt · Zuletzt geändert: 31.08.2010 13:33 von Michael Hammer