<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kappname "&kdvi;">
  <!ENTITY package "kdegraphics">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % German "INCLUDE"
><!-- change language only here -->
]>

<book lang="&language;">
  <bookinfo>
    <title
>Das Handbuch zu &kdvi;</title>
    <authorgroup>
      <author
> <firstname
>Stefan</firstname
> <surname
>Kebekus</surname
> <affiliation
> <address
> <email
>kebekus@kde.org</email
> </address
> </affiliation
> </author>
      <othercredit role="translator"
> <firstname
>Robert</firstname
><surname
>Gogolok</surname
><affiliation
> <address
><email
>robertgogolok@gmx.de</email
></address
></affiliation
> <contrib
>Übersetzung des Handbuchs</contrib
> </othercredit
><othercredit role="translator"
> <firstname
>Marco</firstname
><surname
>Wegner</surname
><affiliation
> <address
><email
>mail@marcowegner.de</email
></address
></affiliation
> <contrib
>Übersetzung des Handbuchs</contrib
></othercredit
> <othercredit role="translator"
> <firstname
>Stefan</firstname
><surname
>Winter</surname
><affiliation
> <address
><email
>mail@stefan-winter.de</email
></address
></affiliation
> <contrib
>Übersetzung der Programmoberfläche</contrib
></othercredit>
    </authorgroup>
    
    <copyright>
      <year
>2001</year>
      <holder
>Stefan Kebekus</holder>
    </copyright>
    
    <legalnotice
>&FDLNotice;</legalnotice>
    
    <date
>2002-04-27</date>
    <releaseinfo
>1.00.00</releaseinfo>
    
    <abstract>
      <para
>Dieses Handbuch beschreibt &kdvi; der Version 1.0</para>
    </abstract>
    
    <keywordset>
      <keyword
>KDE</keyword>
      <keyword
>linux</keyword>
      <keyword
>TeX</keyword>
      <keyword
>DVI</keyword>
    </keywordset>
    
  </bookinfo>
  
  <chapter id="introduction">
    <title
>Einleitung</title>
    
    <para
>&kdvi; ist ein Plugin für die Anwendung &kviewshell;. Dieser Plugin ermöglicht &kviewshell; die Darstellung von Dokumenten im Format &DVI; (<literal role="extension"
>.dvi</literal
>), die vom Schriftsatz-System TeX erzeugt werden. &kdvi; unterstützt viele Erweiterungen des Standards von &DVI;, darunter die Einbindung von &PostScript;-Grafiken oder Hyperlinks. Weitere Details, Beispiele und alle technischen Spezifikationen finden Sie in der Datei <filename
>KDVI-features.dvi</filename
> (oder auch der zugehörigen Quelldatei <filename
>KDVI-features.tex</filename
>).</para>
    
    <para
>Für aktuelle Informationen schauen Sie auf die <ulink url="http://devel-home.kde.org/~kdvi"
>Homepage von &kdvi;</ulink
>. </para>
    
    <para
>TeX ist ein qualitativ hochwertiges Schriftsatz-System für den naturwissenschaftlichen, besonders aber den mathematischen Schriftsatz. Weitere Informationen über TeX und &DVI; finden Sie unter <ulink url="http://www.tug.org"
>homepage of the TeX user group</ulink
> oder der deutschen Seite <ulink url="http://www.dante.de"
>German DANTE e.V.</ulink
>. </para>
  </chapter>
  
  
  <chapter id="starting">
    <title
>&kdvi; starten</title>
    
    <para
>Gewöhnlich wird &kdvi; durch das Anklicken einer <literal role="extension"
>.dvi</literal
>-Datei im Dateimanager gestartet. Es gibt aber auch den Befehl <command
>kdvi</command
>, der &kviewshell; mit dem bereits geladenen Plugin &kdvi; startet. Der Viewer kann also mit dem Befehl <userinput
><command
>kdvi</command
> <parameter
>irgendein_pfad/datei.dvi</parameter
></userinput
> gestartet werden. Ebenfalls möglich ist die Eingabe von <userinput
><command
>kdvi</command
> <parameter
>irgendein_pfad/datei</parameter
></userinput
> genauso wie  <userinput
><command
>kdvi</command
> <parameter
>irgendein_pfad/datei.</parameter
></userinput
> auf einer Konsole. Falls Sie mit dem Internet verbunden sind, können Sie auch auf Dateien zugreifen, die sich auf anderen Rechnern befinden, indem Sie eine &URL; als Parameter angeben. Dies könnte zum Beispiel so aussehen: <userinput
><command
>kdvi</command
> <parameter
>http://irgendein_pfad/datei.dvi</parameter
></userinput
>. </para>

    <para
>Falls Sie eine &URL; als Parameter angeben, kann &kdvi; direkt zu einer bestimmten Stelle in der &DVI;-Datei gehen. Geben Sie zum Beispiel <userinput
><command
>kdvi</command
> <parameter
>file:datei.dvi#43</parameter
></userinput
> ein, wird &kdvi; die Seite 43 öffnen. Falls in der Datei Informationen zur Quelldatei enthalten sind, wird eine Eingabe wie <userinput
><command
>kdvi</command
> <parameter
>file:/datei.dvi#src:43datei.tex</parameter
></userinput
> &kdvi; dazu veranlassen, die Stelle in der &DVI;-Datei zu suchen, die zur Zeile 43 in der TeX-Datei <parameter
>datei.tex</parameter
> gehört. Sie werden diese Option selten verwenden &mdash; lesen Sie jedoch unter <link linkend="forward-search"
>Vorwärtssuche</link
>, wie Sie Ihren Editor einrichten müssen, um &kdvi; automatisch zu starten. </para>

    <warning
><para
>Vergessen Sie nicht die Angabe von <userinput
>file:</userinput
> vor dem Dateinamen, oder das Ergebnis wird vermutlich nicht das gewünschte sein. Die Eingabe von <userinput
><command
>kdvi</command
> <parameter
>file:datei.dvi#43</parameter
></userinput
> beispielsweise öffnet Seite 43 der Datei <filename
>datei.dvi</filename
>. Der Befehl <userinput
><command
>kdvi</command
> <parameter
>datei.dvi#43</parameter
></userinput
> bewirkt jedoch, dass &kdvi; versuchen wird, die Datei <filename
>datei.dvi#43</filename
> zu öffnen.</para>
    </warning>

    <para
>Es gibt eine weitere Option, die Sie vermutlich nicht selbst anzugeben brauchen. Bei der Eingabe des Befehls <userinput
><command
>kdvi</command
> <parameter
>--unique</parameter
> <parameter
>irgendein_pfad/datei.dvi</parameter
></userinput
> wird &kdvi; die Datei öffnen, wenn diese Datei noch in keinem anderen Fenster geöffnet wurde. Ansonsten wird dieses Fenster von &kdvi; in den Vordergrund gebracht. Ein Befehl wie <userinput
><command
>kdvi</command
> <parameter
>--unique</parameter
> <parameter
>file:datei.dvi#43</parameter
></userinput
> kann in Shell-Skripten dazu verwendet werden, dass eine laufende Instanz von &kdvi; die Seite 43 öffnet.</para>

    <para
>Die üblichen Parameter, die von &Qt;- und &kde;-Anwendungen benutzt werden, funktionieren auch: <userinput
><command
>kdvi</command
> <option
>-style</option
> <parameter
>windows</parameter
> <option
>-display</option
> <parameter
>:0</parameter
> <option
>-geometry</option
> <parameter
>400x400+0+0</parameter
> <option
>-caption</option
> <parameter
>&quot;DVI&quot;</parameter
></userinput
> </para>
  </chapter>
  
  
  <chapter id="print">
    <title
>&DVI;-Dateien drucken</title>
    
    <para
>&kdvi; kann Ihre &DVI;-Dateien über das &kde;-Drucksystem ausdrucken. Intern verwendet &kdvi; das Programm <command
>dvips</command
>, um &PostScript;-Datei zu erzeugen, die dann an den Drucker weitergeleitet werden. Das heißt also, dass <command
>dvips</command
> auf Ihrem Rechner installiert sein muss, wenn Sie mit &kdvi; drucken möchten. Das Programm <command
>dvips</command
> verwendet seine eigenen Einrichtungsdateien und seine eigenen Einstellungen, die aber für die meisten Zwecken vollkommen genügen. Wenn Sie jedoch optimale Druckresultate wünschen, sollten Sie <command
>dvips</command
> selbst einrichten und sicherstellen, dass ein MetaFont standardmäßig vorhanden ist, der am besten zu Ihrem Drucker passt. Auf vielen System befindet sich die <ulink url="info:/dvips"
>GNU-texinfo documentation of <command
>dvips</command
></ulink
>. Schauen Sie auch nach einer Datei, die <filename
>dvips.dvi</filename
> oder ähnlich heißt.</para>
  </chapter>

  <chapter id="export">
    <title
>&DVI;-Dateien in andere Formate exportieren</title>

    <para
>Falls Sie Ihre Dateien in den Formaten &PostScript; oder PDF abspeichern möchten, dann ist es nicht empfehlenswert, die Druckfunktion zu verwenden und die Ausgabe in eine Datei umzuleiten. Verwenden Sie stattdessen die Funktionen zum Exportieren. Mit diesen Funktionen können Sie Dateien in viel besserer Qualität erzeugen, die viele der Besonderheiten des Formates DVI erhalten. Außerdem sehen diese Dateien gewöhnlich besser aus in solchen Anwendungen wie dem <application
>Acrobat Reader</application
> von Adobe. Die Funktionen zum Exportieren finden Sie im Menü <guimenu
>Datei</guimenu
>.</para>

    <section id="export-ps">
      <title
>Nach &PostScript; exportieren</title
> 

      <para
>Wie beim Drucken wird auch hier das externe Programm <command
>dvips</command
> verwendet, um die &PostScript;-Datei zu erzeugen. Enthält die &DVI;-Datei Hyperlinks, so werden diese auch in die &PostScript;-Datei eingefügt. Falls Sie ein Experte sind und eine Ausgabe erzeugen möchten, die für einen bestimmten Drucker optimiert ist, sollten Sie <command
>dvips</command
> möglicherweise von Hand starten und den korrekten MetaFont-Modus selbst wählen.</para>
    </section>

    <section id="export-pdf">
      <title
>Nach <acronym
>PDF</acronym
> exportieren</title
> 

      <para
>Um <acronym
>PDF</acronym
>-Dateien von hoher Qualität zu erzeugen, verwendet &kdvi; das Programm <command
>dvipdfm</command
> zur Umwandlung der &DVI;-Dateien in das Format <acronym
>PDF</acronym
>. Falls Sie an einem Rechner arbeiten, auf dem eine ältere Version des Schriftsatz-Systems TeX installiert ist, kann es vorkommen, dass das Programm <command
>dvipdfm</command
> auf Ihrem Rechner nicht vorhanden ist. In diesem Fall müssen Sie die Druckfunktion verwenden, um eine Ausgabe im Format <acronym
>PDF</acronym
> zu erzeugen.</para>

      <warning
> <para
>Falls Sie die erzeugten Dateien im <application
>Acrobat Reader</application
> von Adobe anschauen, dann kann es vorkommen, dass einige der Schriftarten nicht sehr gut aussehen, obwohl der Ausdruck sehr gut ist und das Dokument in <application
>ghostview</application
> ebenfalls sehr gut aussieht. Dies ist ein bekanntes Problem des <application
>Acrobat Reader</application
> bei der Verwendung von Bitmap-Schriftarten. Zum Zeitpunkt, da dieses Handbuch geschrieben wurde, schien die einzig praktikable Möglichkeit zur Umgehung dieses Problems die Vermeidung von Bitmap-Schriftarten zu sein.</para>
      </warning>
    </section>
  </chapter>
  

  <chapter id="inverse-search">
    <title
>Inverse Suche verwenden</title>
    <anchor id="inv-search"
></anchor>

    <para
>Inverse Suche ist eine sehr nützliche Funktion, wenn Sie selbst ein TeX-Dokument schreiben. Wenn alles korrekt eingerichtet ist, dann können Sie in &kdvi; mit der <mousebutton
>mittleren</mousebutton
> Maustaste (falls keine Dreitastenmaus vorhanden ist, kann auf einigen Systemen die <mousebutton
>linke</mousebutton
> und <mousebutton
>rechte</mousebutton
> Maustaste gleichzeitig gedrückt werden). Daraufhin wird sich Ihr bevorzugter Editor öffnen, die TeX-Quelldatei laden und zum richtigen Absatz springen. Um inverse Suche verwenden zu können, tun Sie das Folgende:</para>


    <procedure
> <step
> <para
>Erstellen Sie eine &DVI;-Datei, die Informationen für die inverse Suche enthält. Wie dies geschieht, erfahren Sie im Abschnitt <link linkend="inverse-search-tex"
>TeX-Dateien für die inverse Suche erstellen</link
> weiter unten. Falls Sie die Funktionen zur inversen Suche nur testen möchten, können auch die Beispieldatei <filename
>KDVI-features.dvi</filename
> verwenden.</para
> </step
> <step
> <para
>Teilen Sie &kdvi; mit, welchen Editor Sie verwenden möchten. Wählen Sie dazu einen Editor im Dialog <guilabel
>Einstellungen</guilabel
> (Sie erreichen diesen Dialog durch Auswahl von <guimenuitem
>DVI-Einstellungen</guimenuitem
> im Menü <guimenu
>Einstellungen</guimenu
>). Der nächste Abschnitt dieser Dokumentation, <link linkend="opt-rendering"
>Aufbauen</link
>, erklärt diesen Dialog genauer.</para
> </step
> <step
> <para
>Einige Editoren müssen von Hand gestartet werden oder erfordern zusätzliche Einstellungen. Eine Beschreibung aller unterstützten Editoren finden Sie im Abschnitt <link linkend="inverse-search-editor"
>Den Editor einrichten</link
> weiter unten.</para
> </step
> <step
> <para
>Testen Sie Ihre Einrichtung. Öffnen Sie dazu eine &DVI;-Datei in &kdvi; und klicken Sie mit der <mousebutton
>mittleren</mousebutton
> Maustaste in &kdvi;. Der Editor sollte sich öffnen und die TeX-Datei anzeigen.</para
> </step
> </procedure>


    <section id="inverse-search-tex">
      <title
>TeX-Dateien für die inverse Suche erstellen</title>
      <para
>Grundsätzlich gibt es zwei Wege, um &DVI;-Dateien zu erzeugen, die Informationen für die inverse Suche enthalten: Sie können entweder ein TeX/LaTeX-Programm verwenden, dass die notwendigen automatisch erstellt und einfügt oder Sie können ein Extra-Paket verwenden, das in TeX/LaTeX geschrieben ist.</para>
      <itemizedlist
> <listitem
> <para
>Ein TeX-Programm, das die notwendigen Informationen automatisch erstellt und einfügt, ist sicherlich die bevorzugte Methode zum Einfügen der Informationen für die inverse Suche. Allerdings gab es zum Zeitpunkt der Erstellung dieses Handbuches noch kein solches Programm für &UNIX;. Es heißt jedoch, dass die nächste Version der TeX-Distribution von <ulink url="http://www.tetex.org"
>TeTeX</ulink
> die inverse Suche unterstützen wird. </para
> </listitem
> <listitem
> <para
></para
> </listitem
> </itemizedlist>

      <tip
> <para
>Inverse Suche kann sehr sinnvoll sein, wenn Sie ein Dokument selbst erstellen. Bevor Sie die &DVI;-Datei jedoch veröffentlichen, sollten Sie diese Informationen wieder entfernen.</para
> </tip>

    </section>

    <section id="inverse-search-editor">

    <title
>Den Editor einrichten</title>
    
    <para
>Während die inverse Suche generell mit den meisten Editoren sehr gut zusammenarbeitet, erfordern einige dieser Editoren etwas mehr Aufwand, bevor die inverse Suche mit Ihnen funktioniert. Dieser Abschnitt erklärt, wie Sie Ihren Editor einrichten sollten.</para>

    <section id="editor-setup-emacs">
      <title
><application
>Emacs</application
></title>

      <para
><application
>Emacs</application
> arbeitet gut mit &kdvi; zusammen. Das eigentliche Verhalten von <application
>Emacs</application
> hängt dabei hauptsächlich von den Einstellungen ab. Dabei lässt sich <application
>Emacs</application
> vollständig auf die eigenen Bedürfnisse anpassen, wenn man gewillt ist, sich durch die Programmierung mit Lisp zu kämpfen.</para>

      <para
>&kdvi; verwendet das Programm <command
>emacsclient</command
>, um <application
>Emacs</application
> steuern zu können.</para>
      <important
> <para
>Für das Programm <command
>emacsclient</command
> ist es erforderlich, dass <application
>Emacs</application
> läuft, und dass der <application
>Emacs-Server</application
> in <application
>Emacs</application
> gestartet wurde. Die inverse Suche wird nicht optimal funktionieren, solange nicht <application
>Emacs</application
> wie auch der <application
>Emacs-Server</application
> gestartet sind.</para
> </important>

      <para
>Um den <application
>Emacs-Server</application
> zu starten, können Sie einen der folgenden Schritte ausführen:</para>
      <procedure
> <step
> <para
>In <application
>Emacs</application
> können Sie den <application
>Emacs-Server</application
> starten, indem Sie <userinput
> <keycombo action="seq"
><keycap
>M</keycap
><keycap
>x</keycap
></keycombo
> <command
>server-start</command
></userinput
> eingeben.</para
> </step
> <step
> <para
>Fügen Sie die Zeile <programlisting>

    (server-start)

</programlisting
> zu Ihrer Datei <filename
>.emacs </filename
> hinzu. Starten Sie danach <application
>Emacs</application
> neu.</para
> </step
> </procedure>

      
      <tip
> <itemizedlist
> <listitem
> <para
>Stellen Sie sicher, dass <application
>Emacs</application
> installiert ist. Versuchen Sie <command
>emacs</command
> von der Kommandozeile zu starten.</para
> </listitem
> <listitem
> <para
>&kdvi; verwendet den Befehl <command
>emacsclient</command
>, um <application
>Emacs</application
> zu steuern. Stellen Sie sicher, dass <command
>emacsclient</command
> auf Ihrem System verfügbar ist. Geben Sie dazu auf einer Befehlszeile <userinput
><command
>emacsclient</command
> <parameter
>Name einer Textdatei</parameter
></userinput
> ein. Dies sollte die Datei im Editor <application
>Emacs</application
> öffnen.</para
> </listitem
> <listitem
> <para
>Falls <command
>emacsclient</command
> nicht startet und eine Fehlermeldung wie <computeroutput
>unable to connect to local</computeroutput
> ausgibt, dann stellen Sie sicher, dass <application
>Emacs</application
> läuft. Außerdem ist es notwendig, dass der <application
>Emacs-Server</application
> gestartet ist. Geben Sie dazu <userinput
><keycombo action="seq"
> <keycap
>M</keycap
><keycap
>x</keycap
></keycombo
> <command
>server-start</command
></userinput
> in <application
>Emacs</application
> ein.</para
> </listitem
> <listitem
> <para
>Falls Sie möchten, dass das Fenster automatisch in den Vordergrund geholt wird, dann fügen Sie die Funktion <function
>raise-frame</function
> zum <quote
>server-switch-hook</quote
> hinzu. Geben Sie dazu <userinput
> <keycombo action="seq"
><keycap
>M</keycap
><keycap
>x</keycap
></keycombo
> <command
>customize-variable</command
> <keycap
>RET</keycap
> <command
>server-switch-hook</command
></userinput
> in das Textfeld ein.</para
> </listitem
> <listitem
> <para
>Falls Sie Ihre Eingabe seit dem letzten Speichern geändert haben, wird <application
>Emacs</application
> sie folgendes fragen: <computeroutput
>Revert buffer from file ...? (yes or no)</computeroutput
>. Sie werden hier möglicherweise <emphasis
>no</emphasis
> eingeben wollen, da das erneute Einlesen der Datei bedeutet, dass <emphasis
>alle Ihre Änderungen verloren gehen</emphasis
>!</para
> <para
>Das Verhalten von <command
>gnuclient</command
>, nämlich die Änderungen automatisch zu laden, ist vermutlich besser &mdash; fügen Sie dazu die folgenden Zeilen zur Datei <filename
>.emacs</filename
> hinzu, um das Verhalten von <command
>gnuclient</command
> mit <command
>emacsclient</command
> zu emulieren:</para
> <programlisting>

	(defadvice server-visit-files (around save-buffers last activate)
	  "Try to emulate gnuclient behaviour with emacsclient.
	Works only for visiting one buffer at a time."
	  (let* ((filen (car (car (ad-get-arg 0))))
		 (buf (get-file-buffer filen))
		 (this-buf-modified-p nil))
	    ;;; the following is copied from server-visit-files, with
	    ;;; a modification for the `verify-visited-file-modtime' test
	    (if (and buf (set-buffer buf))
		(if (file-exists-p filen)
		    ;;; if the file has changed on disk, reload it
		    ;;; using `find-file-noselect'
		    (if (not (verify-visited-file-modtime buf))
			(progn
			  (find-file-noselect filen)
			  ;;; if user answered `no', reset modtime anyway
			  ;;; so that server-visit-files doesn't realize the
			  ;;; difference:
			  (set-visited-file-modtime)))
		  ;;; if file exists no longer, we let server-visit-files
		  ;;; deal with that
		  t)
	      (setq buf (find-file-noselect filen)))
	    (setq this-buf-modified-p (buffer-modified-p buf))
	    (set-buffer buf)
	    (set-buffer-modified-p nil)
	    ad-do-it
	    (set-buffer-modified-p this-buf-modified-p)))

</programlisting
> </listitem
> </itemizedlist
> </tip>
    </section>

    <section id="editor-setup-kate">
      <title
>&kate;</title
> 

      <para
>Leider unterstützt der &kde;-Editor &kate; die inverse Suche nicht sehr gut. Ein Klick mit der <mousebutton
>mittleren</mousebutton
> Maustaste in der &DVI;-Datei wird immer eine neue Instanz von &kate; öffnen, selbst wenn &kate; bereits läuft und die TeX-Datei bereits geladen ist. Noch schlimmer ist, dass &kate; den Cursor nicht an den Anfang des Absatzes bewegt.</para>
    </section>

    <section id="editor-setup-nedit">
      <title
><application
>NEdit</application
></title>

      <para
><application
>NEdit</application
> arbeitet im Allgemeinen sehr gut. Das Klicken in eine &DVI;-Datei sollte ein neues Fenster öffnen. Falls die TeX-Datei bereits in einem anderen Fenster von <application
>NEdit</application
> geöffnet ist, dann zeigt das neue Fenster eine andere Ansicht dieses Puffers. Ansonsten wird die TeX-Datei geladen. Nachdem sich das Fenster geöffnet hat, dann hebt <application
>NEdit</application
> die erste Zeile des korrekten Absatzes hervor.</para>
      <tip
> <procedure
> <step
> <para
>Stellen Sie sicher, dass <application
>NEdit</application
> installiert ist. Versuchen Sie <command
>nedit</command
> von der Kommandozeile zu starten.</para
> </step
> <step
> <para
>&kdvi; verwendet den Befehl <command
>ncl</command
>, um <application
>NEdit</application
> zu steuern. Stellen Sie sicher, dass <command
>ncl</command
> auf der Kommandozeile verfügbar ist. Geben Sie dazu <userinput
><command
>ncl</command
> <parameter
>-noask</parameter
></userinput
> ein. Dies sollte eine Instanz von <application
>NEdit</application
> öffnen. Falls <command
>ncl</command
> nicht verfügbar ist, dann könnte es sein, dass Sie eine alte Version von <application
>NEdit</application
> verwenden. In diesem Fall sollten Sie entweder auf eine neuere Version aktualisieren oder die Einstellung <guilabel
>Benutzerdefinierter Editor</guilabel
> aus dem Dialog <guilabel
>Einstellungen</guilabel
> verwenden.</para
> </step
> </procedure
> </tip>
    </section>

    <section id="editor-setup-xemacs">
      <title
><application
>XEmacs</application
></title>

      <para
><application
>XEmacs</application
> arbeitet gut mit &kdvi; zusammen. Das eigentliche Verhalten von <application
>XEmacs</application
> hängt dabei sehr stark von den Einstellungen ab. Wie gewohnt können Sie <application
>XEmacs</application
> vollständig anpassen, wenn Sie gewillt sind, sich durch die Programmierung mit Lisp zu kämpfen.</para>

      <para
>&kdvi; verwendet das Programm <command
>gnuclient</command
>, um <application
>XEmacs</application
> zu steuern.</para>
      <important
> <para
>Das Programm <command
>gnuclient</command
> setzt voraus, dass <application
>XEmacs</application
> läuft, und dass das Programm <application
>gnuserv</application
> in <application
>XEmacs</application
> gestartet wurde. Die inverse Suche wird nicht funktionieren, solange nicht <application
>XEmacs</application
> wie auch <application
>gnuserv</application
> gestartet sind.</para
> </important>

      <para
>Um <application
>gnuserv</application
> zu starten, können Sie einen der folgenden Schritte ausführen:</para>
      <itemizedlist
> <listitem
> <para
>Starten Sie <application
>gnuserv</application
> in <application
>XEmacs</application
>, indem Sie <userinput
><keycombo action="seq"
><keycap
>M</keycap
><keycap
>X</keycap
></keycombo
> <command
>gnuserv-start</command
></userinput
> eingeben.</para
> </listitem
> <listitem
> <para
>Fügen Sie die Zeile <programlisting>

    (gnuserv-start)

</programlisting
> zur Datei <filename
>.xemacs</filename
> hinzu. Falls Sie eine aktuellere Version von <application
>XEMacs</application
> verwenden, dann wird <filename class="directory"
>.xemacs</filename
> ein Verzeichnis sein. In diesem Fall sollten Sie die Zeile zur Datei <filename
>.xemacs/init.el</filename
> hinzufügen. Starten Sie danach <application
>XEmacs</application
> neu.</para
> </listitem
> </itemizedlist>

      <para
>Falls nicht für jeden Aufruf des Editors ein neues Fenster geöffnet werden soll und das offene Fenster automatisch in den Vordergrund geholt werden soll, dann setzen Sie für <quote
>Gnuserv Frame</quote
> den Wert <quote
>Use selected frame</quote
> und fügen die Funktion <function
>raise-frame</function
> zu <quote
>Visit Hook</quote
> hinzu. Geben Sie <userinput
> <keycombo action="seq"
><keycap
>M</keycap
><keycap
>x</keycap
></keycombo
> <command
>customize-group</command
> <keycap
>RET</keycap
> <command
>gnuserv</command
></userinput
> ein, um diese Einstellungen vornehmen zu können.</para>

      <tip
> <itemizedlist
> <listitem
> <para
>Stellen Sie sicher, dass <application
>XEmacs</application
> installiert ist. Versuchen Sie dazu <command
>xemacs</command
> auf der Kommandozeile ein.</para
> </listitem
> <listitem
> <para
>&kdvi; verwendet das Programm <application
>gnuclient</application
>, um <application
>XEmacs</application
> zu steuern. Stellen Sie sicher, dass <command
>gnuclient</command
> auf der Kommandozeile verfügbar ist. Geben Sie dazu <userinput
><command
>gnuclient</command
> <parameter
>Name einer Textdatei</parameter
></userinput
> ein. Dies sollte ein neues Fenster von <application
>XEmacs</application
> öffnen.</para
> </listitem
> <listitem
> <para
>Falls <command
>gnuserv</command
> nicht startet und eine Fehlermeldung wie <computeroutput
>unable to connect to local</computeroutput
> ausgibt, dann stellen Sie sicher, dass <application
>XEmacs</application
> läuft. Außerdem ist es notwendig, dass <application
>gnuserv</application
> gestartet ist. Geben Sie dazu <userinput
><keycombo action="seq"
> <keycap
>M</keycap
><keycap
>x</keycap
></keycombo
> <command
>gnuserv-start</command
></userinput
> in <application
>XEmacs</application
> ein.</para
> </listitem
> <listitem
> <para
>Falls nicht für jeden Aufruf des Editors ein neues Fenster geöffnet werden soll und das offene Fenster automatisch in den Vordergrund geholt werden soll, dann setzen Sie für <quote
>Gnuserv Frame</quote
> den Wert <quote
>Use selected frame</quote
> und fügen die Funktion <function
>raise-frame</function
> zu <quote
>Visit Hook</quote
> hinzu. Geben Sie <userinput
> <keycombo action="seq"
><keycap
>M</keycap
><keycap
>x</keycap
></keycombo
> <command
>customize-group</command
> <keycap
>RET</keycap
> <command
>gnuserv</command
></userinput
> ein, um diese Einstellungen vornehmen zu können.</para
> </listitem
> </itemizedlist
> </tip>
    </section>

    <section id="editor-setup-gvim">
      <title
><application
>VI iMproved</application
> / &GUI;</title>

      <para
>&kdvi; unterstützt <command
>vim</command
>, aber das Ergebnis ist nicht sehr berauschend. Ein Klick mit der <mousebutton
>mittleren</mousebutton
> Maustaste in eine &DVI;-Datei wird immer ein neues Fenster von <command
>vim</command
> öffnen, selbst wenn <command
>vim</command
> schon läuft und die TeX-Datei bereits geöffnet ist.</para>
      <tip
> <itemizedlist
> <listitem
> <para
>Stellen Sie sicher, dass <application
>VIM/GUI</application
> installiert ist. Versuche Sie dazu <command
>gvim</command
> auf der Kommandozeile einzugeben.</para
> </listitem
> </itemizedlist
> </tip>
    </section>
    </section>

  </chapter>


  <chapter id="forward-search">
    <title
>Vorwärtssuche</title>

    <para
>Die Vorwärtssuche ermöglicht das direkte Springen vom Texteditor an die zugehörige Position in der &DVI;-Datei. Da die Vorwärtssuche vom Editor unterstützt werden muss, werden von &kdvi; im Moment nur <application
>Emacs</application
> und <application
>XEmacs</application
> unterstützt. Andere Editoren werden hoffentlich bald hinzukommen.</para>

    <para
>Um Vorwärtssuche verwenden zu können, gehen sie folgendermaßen vor:</para>
    <itemizedlist
> <listitem
> <para
>Richten Sie Ihren Editor ein &mdash; dies wird weiter unten beschrieben.</para
> </listitem
> <listitem
> <para
>Fügen Sie Quelltextinformationen zu Ihrer &DVI;-Datei hinzu. Dies können Sie &zb; durch Verwendung des Paketes <command
>srcltx</command
> erreichen und wurde bereits im Abschnitt <link linkend="inverse-search-tex"
>TeX-Dateien für die inverse Suche erstellen</link
> beschrieben.</para
> </listitem
> <listitem
> <para
>Falls Sie <application
>Emacs</application
> verwenden und alles korrekt eingerichtet ist, dann drücken Sie einfach <userinput
><keycombo action="simul"
>&Strg;<keycap
>X</keycap
></keycombo
> <keycombo action="simul"
>&Strg;<keycap
>J</keycap
></keycombo
></userinput
>. Jetzt öffnet sich &kdvi; und springt an die Stelle in der &DVI;-Datei, die zu derjenigen in der TeX-Datei gehört, an der Sie sich gerade im Editor befinden.</para
> </listitem
> </itemizedlist>

    <section id="forward-search-editor">
      <title
>Den Editor für die Vorwärtssuche einrichten.</title>
      
      <section id="forw-editor-setup-emacs">
	<title
><application
>Emacs</application
></title>
	
	<para
>Um Vorwärtssuche in <application
>Emacs</application
> verwenden zu können, folgen Sie diesen Anweisungen:</para>

	<itemizedlist
> <listitem
> <para
></para
> </listitem
> <listitem
> <para
>Fügen Sie die Zeilen <programlisting>

(add-to-list 'load-path (expand-file-name "~/emacs-scripts/"))
(require 'kdvi-search)
(add-hook 'LaTeX-mode-hook (lambda () (local-set-key "\C-x\C-j" 'kdvi-jump-to-line)))
(add-hook 'tex-mode-hook (lambda () (local-set-key "\C-x\C-j" 'kdvi-jump-to-line)))

</programlisting
> zur Datei <filename
>.emacs</filename
> hinzu. Starten Sie jetzt <application
>Emacs</application
> neu.</para
> </listitem
> <listitem
> <para
>Öffnen Sie <application
>Emacs</application
>, laden Sie eine TeX-Datei und erzeugen Sie daraus eine &DVI;-Datei. Geben Sie danach entweder den Befehl <userinput
><keycombo action="simul"
><keycap
>M</keycap
><keycap
>x</keycap
> </keycombo
><command
>kdvi-jump-to-line</command
></userinput
> ein oder drücken Sie <userinput
><keycombo action="seq"
><keycombo action="simul"
>&Strg;<keycap
>X</keycap
></keycombo
> <keycombo action="simul"
>&Strg;<keycap
>J</keycap
></keycombo
></keycombo
> </userinput
>. Es kann passieren, dass <application
>Emacs</application
> Sie nach einem so genannten <quote
>master file</quote
> fragt. Dies ist dann sinnvoll, wenn Sie eine TeX-Datei verwenden, das andere Dateien einfügt: das <quote
>master file</quote
> ist die Datei auf der obersten Ebene, die die anderen Dateien einfügt. <application
>Emacs</application
> wird Sie möglicherweise bitten, den Namen der Masterdatei <quote
>als lokale Variable</quote
> zu speichern, &dh; als Kommentar am Ende der Datei. Geben Sie entweder <userinput
>yes</userinput
> oder <userinput
>no</userinput
> ein um fortzufahren.</para
> </listitem
> </itemizedlist>

	<tip
> <itemizedlist
> <listitem
> <para
>Stellen Sie sicher, dass <application
>Emacs</application
> installiert ist. Versuchen Sie <command
>emacs</command
> von der Kommandozeile zu starten.</para
> </listitem
> <listitem
> <para
>Falls <application
>Emacs</application
> &kdvi; nicht starten kann, dann finden Sie die Ausgabe im Puffer <guilabel
>kdvi-output</guilabel
>.</para
> </listitem
> </itemizedlist
> </tip>
      </section>

      <section id="forw-editor-setup-xemacs">
	<title
><application
>XEmacs</application
></title>
	
	<para
>Um <application
>XEmacs</application
> einzurichten, folgen Sie den Schritten zur Einrichtung von <application
>Emacs</application
> <link linkend="forw-editor-setup-emacs"
>weiter oben</link
>. Ändern Sie jedoch in diesem Fall die Datei <filename
>.xemacs</filename
> und nicht <filename
>.emacs</filename
>. Falls Sie eine aktuelle Version von <application
>XEmacs</application
> verwenden, dann kann es sein, dass <filename class="directory"
>.xemacs</filename
> ein Verzeichnis ist. Ändern Sie in diesem Fall die Datei <filename
>.xemacs/init.el</filename
>. </para>
      </section>
    </section>

  </chapter>

  <chapter id="preferences">
    <title
>Der Dialog <guilabel
>Einstellungen</guilabel
></title>
    <anchor id="opts"
></anchor>

    <para
>Der Dialog <guilabel
>Einstellungen</guilabel
> kann geöffnet werden, indem Sie <guimenuitem
>DVI-Einstellungen</guimenuitem
> aus dem Menü <guimenu
>Einstellungen</guimenu
> auswählen.</para>

    <para
>Der Dialog besteht aus zwei Karteikarten, <guilabel
>Schriftarten</guilabel
> und <guilabel
>Aufbauen</guilabel
>.</para>

    <sect1 id="opt-fonts">
      <title
>Die Einstellungen zu den <guilabel
>Schriftarten</guilabel
></title>

      <para
>Das folgende Bild zeigt den Einstellungsdialog von &kdvi;.</para>

      <screenshot
> <screeninfo
>Die Karteikarte <guilabel
>Schriftarten</guilabel
></screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="optionrequester1.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Die Karteikarte <guilabel
>Schriftarten</guilabel
></phrase
> </textobject
> </mediaobject
> </screenshot>

      <variablelist
> <varlistentry
> <term
><guilabel
>MetaFont-Modus</guilabel
> </term
> <listitem
> <para
>Diese Option legt die Schriftart fest, die &kdvi; zur Anzeige benutzen wird. Durch sorgfältige Optimierung der Einstellungen ist es hier möglich, die Anzeige zu verbessern. Wenn Sie jedoch kein Experte in <command
>MetaFont</command
> sind und nicht wissen, was Sie tun, ist es nicht ratsam, diese Einstellungen zu ändern. Sie sollten einen Blick in den Abschnitt <link linkend="mfmodes"
>Häufig gestellte Fragen</link
> dieses Handbuchs werfen.</para
> <para
>Sichere Werte sind <guilabel
>1200 dpi / Lexmark S</guilabel
> für gute Qualität oder <guilabel
>600 dpi / LaserJet 4</guilabel
> für mittlere Qualität und schnellere Darstellung.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Fehlende Schriften erzeugen</guilabel
></term
> <listitem
> <para
>Kreuzen Sie diese Option an, wenn Sie möchten, dass &kdvi; das Programm <command
>MetaFont</command
> in dem (sehr wahrscheinlichen) Fall aufruft, dass &kdvi; Dokumente in Schriftarten darzustellen versucht, die nicht schon vorher erzeugt wurden. Sie sollten diese Option auf jeden Fall setzen.</para
> </listitem
> </varlistentry
> </variablelist>
    </sect1>

    <sect1 id="opt-rendering">
      <title
>Die Optionen zum <guilabel
>Aufbauen</guilabel
></title>

      <para
>Das folgende Bild zeigt das zweite Feld des Einstellungsdialogs von &kdvi;.</para>

      <screenshot
> <screeninfo
>Die Karteikarte <guilabel
>Aufbauen</guilabel
></screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="optionrequester2.png" format="PNG"/></imageobject
> <textobject
> <phrase
>Die Karteikarte <guilabel
>Aufbauen</guilabel
></phrase
> </textobject
> </mediaobject
> </screenshot>

      <variablelist
> <varlistentry
> <term
><guilabel
>PostScript-Besonderheiten anzeigen</guilabel
></term
> <listitem
> <para
>Wenn diese Option gewählt wurde, zeigt &kdvi; &PostScript;-Graphiken an, die in der &DVI;-Datei eingebettet sind. Sie möchten diese Option vielleicht setzen.</para
> <para
>Wenn eine externe &PostScript;-Datei nicht gefunden werden kann, zeichnet &kdvi; einen roten Kasten zur Warnung an ihre Stelle. Leider ist der Aufbau von &PostScript;-Graphiken sehr langsam in der aktuellen Version von &kdvi;. Wir werden die Geschwindigkeit in späteren Versionen verbessern. Wenn diese Option deaktiviert ist, wird &kdvi; entweder einen grauen Kasten als Platzhalter für die Graphik anzeigen oder diesen Zwischenraum leer lassen.</para
> <note
> <para
>Es gibt keinen Standardweg, um &PostScript;-Graphiken in eine &DVI;-Datei einzubetten. Es kann deshalb passieren, dass &kdvi; eine Graphik, die mit anderen Programmen gut funktioniert, nicht korrekt darstellen kann. Ältere Versionen von <command
>xdvi</command
> und <command
>dvips</command
> unterstützen die Ausführung von externen Befehlen. Dies ist ein hohes Sicherheitsrisiko und deshalb bewusst nicht in &kdvi; eingebaut. Technische Informationen zu den verschiedenen unterstützten Verfahren zur Einbindung von &PostScript; kann in der Datei <filename
>KDVI-features.dvi</filename
> gefunden werden.</para
> </note
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Verknüpfungen anzeigen</guilabel
></term
> <listitem
> <para
>Kreuzen Sie dies an, wenn Sie möchten, dass &kdvi; Verknüpfungen (Hyperlinks) anzeigt. Die entsprechenden Stellen des Textes  werden blau unterstrichen. Die Aktivierung dieser Einstellung ist in der Regel zu empfehlen.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Editor für inverses Suchen</guilabel
></term
> <listitem
> <para
>Falls Sie die <link linkend="inverse-search"
>inverse Suche</link
> verwenden möchten - eine sehr nützlich Funktionen, wenn Sie Ihre TeX-Dokumente selbst schreiben - dann müssen Sie angeben, welchen Editor Sie dafür verwenden möchten und wie dieser Editor von &kdvi; gestartet werden kann. Im gezeigten Beispiel hat sich der Anwender für den Editor <application
>NEdit</application
> entschieden. Wenn Sie einen der voreingestellten Editoren aus dem Kombinationsfeld <guilabel
>Editor</guilabel
> verwenden, dann muss nichts weiter getan werden. Falls Sie einen anderen Editor verwenden möchten, dann wählen Sie <guilabel
>Benutzerdefinierter Editor</guilabel
> aus dem Kombinationsfeld <guilabel
>Editor</guilabel
> und geben die Kommandozeile ein, mit dem der Editor gestartet wird. Verwenden Sie die Platzhalter <token
>%f</token
> und <token
>%l</token
>, die dann durch den Namen der TeX-Datei und die Zeilennummer in der TeX-Datei ersetzt werden.</para
> <para
>Falls Sie einen Editor verwenden, der nicht unterstützt wird, dann senden Sie bitte eine E-Mail an <email
>kebekus@kde.org</email
> und teilen uns mit, welchen Befehl Sie auf der Kommandozeile eingegeben haben und wie Sie Ihren Editor eingerichtet haben.</para
> </listitem
> </varlistentry
> </variablelist>

    </sect1>
  </chapter>

  <chapter id="faq">
    <title
>Häufig gestellte Fragen</title>

    <qandaset>
      <qandaentry>
	<question id="fontgen">
	  <para
>Was passiert, wenn &kdvi; die Meldung <computeroutput
>Bitmap-Schriftarterzeugung läuft</computeroutput
> anzeigt? Und warum dauert dies so lange?</para>
	</question>
	<answer>
	  <para
>Viele der Schriftarten, die gewöhnlich in TeX-Dokumenten verwendet werden, müssen von MetaFont erzeugt werden. MetaFont ist eine Sprache ähnlich TeX (in den meisten TeX-Distributionen enthalten), die eine Beschreibung der Schriftart in einen Rasterfont umwandelt (<literal role="extension"
>.pk</literal
>-Dateien). Rasterfonts können an den Drucker gesendet oder in einer Anwendung wie &kdvi; zur Anzeige verwendet werden. MetaFont versucht dabei, die bestmögliche Ausgabe für Ihren Drucker zu erzeugen. Das Programm weiß &zb;, dass ein Pixel in einem Tintenstrahldrucker ein runder Punkt ist, und dass benachbarte Punkte oft miteinander <quote
>verschmieren</quote
>. Pixel in einem Laserdrucker sind dagegen rechteckig, und ein einzelner Punkt wird oft überhaupt nicht erstellt.</para>

	  <para
>Solche stark optimierten Bitmap-Schriftarten zu erzeugen, dauert gewöhnlich recht lange. Da TeX-Dokumente gewöhnlich sehr viele verschiedene Schriftarten verwenden, ist dies besonders auffällig. Wir können hier nur um Ihre Geduld bitten. Jedoch speichern die meisten TeX-Distributionen diese <literal role="extension"
>.pk</literal
>-Dateien für eine bestimmte Zeit (&zb; 100 Tage). Wenn Sie also auf das gleiche Dokument öfter zugreifen, dann werden die <literal role="extension"
>.pk</literal
>-Dateien erneut verwendet und müssen nicht jedesmal neu erstellt werden.</para>
	</answer>
      </qandaentry>

      <qandaentry>
	<question id="mfmodes">
	  <para
>Was ist der MetaFont-Modus?</para>
	</question>
	<answer>
	  <para
>Um Bitmap-Schriftarten zu erzeugen, die für Ihren Drucker optimiert sind (sehen Sie hierzu auch die Antwort zur ersten Frage), enthält MetaFont eine Datenbank mit Druckertypen &mdash; suchen Sie nach der Datei <filename
>modes.mf</filename
>. Ein MetaFont-Modus ist dabei nur der Name eines Eintrags. Zum Beispiel beszieht sich der Name <quote
>ljfour</quote
> auf den Eintrag in dieser Datenbank, der einen &Hewlett-Packard; LaserJet 4 beschreibt. Einem MetaFont-Modus folgt gewöhnlich eine Zahl. Diese gibt die Auflösung an. Der LaserJet &zb; kann sowohl in 300 als auch in 600 dpi drucken. Deshalb würde <quote
>ljfour/600</quote
> eine vollständige Beschreibung sein.</para>
	</answer>
      </qandaentry>

    </qandaset>
  </chapter>


  <chapter id="credits-and-license">
    <title
>Mitwirkende und Lizenz</title>

    <para
>&kdvi;</para>

    <para
>&kdvi; basiert auf dem eigenständigen Programm &kdvi; 0.4.3 von Markku Hihnala. Dieses Programm wiederum basiert auf <application
>xdvi</application
> Version 18f, das mehrere Autoren hat.</para>

    <para
>Copyright für die Dokumentation 2001 Stefan Kebekus <email
>kebekus@kde.org</email
></para>

    <para
>Übersetzung des Handbuchs: Robert Gogolok <email
>robertgogolok@gmx.de</email
> und Marco Wegner <email
>mail@marcowegner.de</email
></para
> <para
>Übersetzung der Programmoberfläche: Stefan Winter <email
>mail@stefan-winter.de</email
></para>
    
&underGPL;
&underFDL;

  </chapter>
    
&documentation.index;

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

