<?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</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>Several different tools can be used for a document compilation. There are some
  low-level commands, and one higher-level tool: 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, LaTeXila 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>Use the buttons in the main toolbar.</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>
    To configure the build tools, go to:
    <guiseq>
      <gui style="menu">Build</gui>
      <gui style="menu">Manage Build Tools</gui>
    </guiseq>
  </p>

  <p>You will see the list of all the default build tools, and a second list
  with your personal build tools. There are check buttons to enable or disable
  them. When a build tool is disabled, it's not possible to execute it. You can
  perform some actions, like moving a tool up or down, open its properties,
  delete or copy it, create a new one, etc.</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>In the properties of a build tool, the tricky part is to configure the jobs.
  A build tool can execute several jobs. Each job contains two pieces of
  information:</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>When an error occurs during a job's execution, the execution of the build
  tool is aborted, so the next jobs are not launched.</p>
</section>

<section id="post-processors">
  <title>Nachbearbeitung</title>
  <p>The purpose of a post processor is to filter the command output and extract
  the useful information. Four post processors are available:</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>
