<?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">

<info>
  <link type="guide" xref="index"/>
</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>Using a higher-level tool such as Latexmk simplify a lot all this process,
  since only one command is required. Indeed, Latexmk can detect how many times the
  <cmd>latex</cmd> or <cmd>pdflatex</cmd> command must be called, and whether
  <cmd>bibtex</cmd> or <cmd>makeindex</cmd> is required. By default,
  <app>Enter TeX</app> uses 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>Open the <gui style="menu">Build</gui> menu.</p></item>
    <item><p>Verwenden Sie die Knöpfe in der Hauptwerkzeugleiste.</p></item>
    <item><p>Use the shortcut: <key>F2</key> → <key>F11</key>.</p></item>
  </list>

  <p>The build tool is executed on the currently opened file. If the file belongs to a
  <link xref="projects">project</link>, it is executed on the project's main file.</p>

  <note style="important">
    <title>Verborgene Erstellungswerkzeuge</title>
    <p>By default, a lot of build tools are hidden, so they can't be executed. To view
    the full list of build tools, activate or configure them, read the
    <link xref="#general_configuration"/> section.</p>
  </note>
</section>

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

  <p>
    To configure the build tools, go to:
    <guiseq>
      <gui style="menu">Build</gui>
      <gui style="menu">Manage Build Tools</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>The post processor (see <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>Filter the output of the <cmd>latex</cmd> or <cmd>pdflatex</cmd> commands.
      There can be three types of errors: critical errors, warnings, or bad boxes. There
      are also some other useful information: the size of the document, the number of
      pages, and the number of errors.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>Used for the <cmd>latexmk</cmd> command. Internally, this post processor uses
      other ones: <em>latex</em> and <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
