<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" id="build_tools" xml:lang="de">

<info>
  <link type="guide" xref="index"/>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Mario Blättermann</mal:name>
      <mal:email>mario.blaettermann@gmail.com</mal:email>
      <mal:years>2011-2012, 2015, 2017-2018</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Benjamin Steinwender</mal:name>
      <mal:email>b@stbe.at</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  </info>

<title>Erstellungswerkzeuge</title>

<synopsis>
  <p>Der Zweck der Erstellungswerkzeuge ist die Erzeugung eines Dokuments im PDF-, DVI- oder PS-Format.</p>
</synopsis>

<links type="section"/>

<section id="overview">
  <title>Einführung</title>

  <p>Verschiedene Werkzeuge können zur Kompilierung eines Dokuments verwendet werden. Es gibt einige einfache Befehle und ein fortgeschrittenes Werkzeug: Latexmk.</p>

  <table rules="rowgroups">
    <title>Einfache Befehle</title>
    <thead>
      <tr>
        <td><p>Bezeichnung</p></td>
        <td><p>Befehl</p></td>
      </tr>
    </thead>
    <tbody its:translate="no">
      <tr>
        <td><p>LaTeX → DVI</p></td>
        <td><p><cmd>latex</cmd></p></td>
      </tr>
      <tr>
        <td><p>LaTeX → PDF</p></td>
        <td><p><cmd>pdflatex</cmd></p></td>
      </tr>
    </tbody>
    <tbody its:translate="no">
      <tr>
        <td><p>DVI → PDF</p></td>
        <td><p><cmd>dvipdf</cmd></p></td>
      </tr>
      <tr>
        <td><p>DVI → PS</p></td>
        <td><p><cmd>dvips</cmd></p></td>
      </tr>
      <tr>
        <td><p>PS → PDF</p></td>
        <td><p><cmd>ps2pdf</cmd></p></td>
      </tr>
    </tbody>
    <tbody>
      <tr>
        <td><p>Bibliografie</p></td>
        <td its:translate="no"><p><cmd>bibtex</cmd></p></td>
      </tr>
      <tr>
        <td><p>Index</p></td>
        <td its:translate="no"><p><cmd>makeindex</cmd></p></td>
      </tr>
    </tbody>
  </table>

  <p>In die Kompilierung eines LaTeX-Dokuments werden einige einfache Befehle einbezogen, in einer bestimmten Reihenfolge und einer bestimmten Anzahl der Aufrufe. Hier ein Beispiel:</p>
  <screen its:translate="no">
$ latex document.tex
$ bibtex document.aux
$ latex document.tex
$ dvips -t a4 document.dvi
$ ps2pdf document.ps</screen>

  <p>Mit einem fortgeschritteneren Werkzeug wie Latexmk lässt sich der Vorgang vereinfachen, da nur ein Befehl erforderlich ist. Tatsächlich können diese Werkzeuge erkennen, wie oft die Befehle <cmd>latex</cmd> oder <cmd>pdflatex</cmd> aufgerufen werden müssen, und ob <cmd>bibtex</cmd> oder <cmd>makeindex</cmd> notwendig sind. Per Vorgabe verwendet GNOME LaTeX das Werkzeug Latexmk.</p>
</section>

<section id="execute">
  <title>Ein Erstellungswerkzeug ausführen</title>

  <p>Es gibt verschiedene Wege, ein Erstellungswerkzeug auszuführen:</p>
  <list>
    <item><p>Öffnen Sie das <gui style="menu">Erstellen</gui>-Menü.</p></item>
    <item><p>Verwenden Sie die Knöpfe in der Hauptwerkzeugleiste.</p></item>
    <item><p>Verwenden Sie die Tastenkürzel: <key>F2</key> → <key>F11</key>.</p></item>
  </list>

  <p>Das Erstellungswerkzeug wird auf die aktuell geöffnete Datei angewendet. Falls die Datei zu einem <link xref="projects">Projekt</link> gehört, wird die Hauptdatei des Projekts verwendet.</p>

  <note style="important">
    <title>Verborgene Erstellungswerkzeuge</title>
    <p>Standardmäßig sind zahlreiche Erstellungswerkzeuge verborgen, so dass sie nicht ausgeführt werden können. Um eine vollständige Liste der Erstellungswerkzeuge anzuzeigen, zu aktivieren oder zu konfigurieren, lesen Sie den Abschnitt <link xref="#general_configuration"/>.</p>
  </note>
</section>

<section id="general_configuration">
  <title>Allgemeine Konfiguration</title>

  <p>Um die Erstellungswerkzeuge zu konfigurieren, öffnen Sie: <guiseq> <gui style="menu">Erstellen</gui> <gui style="menu">Erstellungswerkzeuge verwalten</gui> </guiseq></p>

  <p>Eine Liste aller Erstellungswerkzeuge wird angezeigt. Über Ankreuzfelder können Sie diese anzeigen oder verbergen. Wenn ein Erstellungswerkzeug verborgen ist, ist es nicht möglich, es auszuführen. Sie können einige Aktionen ausführen, wie ein Werkzeug nach oben oder unten verschieben, dessen Eigenschaften betrachten, es löschen oder kopieren, ein neues Werkzeug erstellen usw.</p>

  <note style="tip">
    <p>Doppelklicken Sie auf eines der Erstellungswerkzeuge, um dessen Eigenschaften zu öffnen.</p>
  </note>
</section>

<section id="jobs">
  <title>Aufgaben eines Erstellungswerkzeuges</title>

  <p>Der schwierige Teil in den Eigenschaften eines Erstellungswerkzeugs ist die Einrichtung der Zuweisung von Aufgaben. Ein Erstellungswerkzeug kann verschiedene Aufgaben ausführen. Jede Aufgabe beinhaltet zwei Informationen:</p>
  <list>
    <item><p>Der Befehl, welcher Platzhalter enthalten kann.</p></item>
    <item><p>Die Nachbearbeitung (siehe <link xref="#post-processors"/>).</p></item>
  </list>

  <p>﻿Wenn während der Ausführung eines Auftrags ein Fehler auftritt, wird die Ausführung des Build-Tools abgebrochen und die nächsten Aufträge werden nicht gestartet.</p>
</section>

<section id="post-processors">
  <title>Nachbearbeitung</title>
  <p>Der Zweck der Nachbearbeitung ist die Filterung der Befehlszeilenausgabe und das Erhalten nützlicher Informationen. Vier Nachbearbeitungswerkzeuge sind verfügbar:</p>

  <terms>
    <item>
      <title its:translate="no">no-output</title>
      <p>Die Ausgabe wird nicht angezeigt.</p>
    </item>
    <item>
      <title its:translate="no">all-output</title>
      <p>Die vollständige Ausgabe wird angezeigt, ohne Filterung.</p>
    </item>
    <item>
      <title its:translate="no">latex</title>
      <p>Die Ausgabe der Befehle <cmd>latex</cmd> oder <cmd>pdflatex</cmd> wird gefiltert. Drei Fehlertypen sind möglich: kritische Fehler, Warnungen oder »Bad Boxes«. Es gibt außerdem weitere Informationen: die Größe des Dokuments, die Seitenanzahl und die Anzahld der Fehler.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>Wird für den Befehl <cmd>latexmk</cmd> verwendet. Intern ruft dieses Nachbearbeitungswerkzeug weitere Befehle auf: <em>latex</em> und <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
