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

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

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Josef Andersson</mal:name>
      <mal:email>josef.andersson@fripost.org</mal:email>
      <mal:years>2016</mal:years>
    </mal:credit>
  </info>

<title>Byggverktyg</title>

<synopsis>
  <p>Syftet med byggverktygen är att generera ett dokument i PDF-, DVI- eller PS-format.</p>
</synopsis>

<links type="section"/>

<section id="overview">
  <title>Introduktion</title>

  <p>Flera olika verktyg kan användas för dokumentkompilering. Det finns några lågnivåkommandon och ett högnivåverktyg: Latexmk.</p>

  <table rules="rowgroups">
    <title>Lågnivåkommandon</title>
    <thead>
      <tr>
        <td><p>Etikett</p></td>
        <td><p>Kommando</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>Bibliografi</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>Att kompilera ett LaTeX-dokument kan innebära körning av flera lågnivåkommandon i speciell ordning och ett speciellt antal gånger. Här är ett exempel:</p>
  <screen its:translate="no">
$ latex document.tex
$ bibtex document.aux
$ latex document.tex
$ dvips -t a4 document.dvi
$ ps2pdf document.ps</screen>

  <p>Att använda ett verktyg på högre nivå som t.ex. Latexmk förenklar en hel del av denna process eftersom endast ett kommando krävs. Latexmk kan upptäcka hur många gånger kommandot <cmd>latex</cmd> eller <cmd>pdflatex</cmd> måste anropas och huruvida <cmd>bibtex</cmd> eller <cmd>makeindex</cmd> krävs. Som standard använder GNOME LaTeX Latexmk.</p>
</section>

<section id="execute">
  <title>Kör ett byggverktyg</title>

  <p>Det finns flera sätta att köra ett byggverktyg på:</p>
  <list>
    <item><p>Öppna menyn <gui style="menu">Bygg</gui>.</p></item>
    <item><p>Använd knapparna i huvudverktygsfältet.</p></item>
    <item><p>Använd genvägen: <key>F2</key> → <key>F11</key>.</p></item>
  </list>

  <p>Byggverktyget körs på den fil som är öppnad för tillfället. Om filen tillhör ett <link xref="projects">projekt</link> körs den med projektets huvudfil.</p>

  <note style="important">
    <title>Dolda byggverktyg</title>
    <p>Som standard är många byggverktyg dolda så att de inte kan köras. För att se hela listan av byggverktyg, aktivera eller konfigurera dem, läs avsnittet <link xref="#general_configuration"/>.</p>
  </note>
</section>

<section id="general_configuration">
  <title>Allmän konfiguration</title>

  <p>För att konfigurera byggverktygen, gå till <guiseq> <gui style="menu">Bygg</gui> <gui style="menu">Hantera byggverktyg</gui> </guiseq></p>

  <p>Du kommer att se en lista över alla standardbyggverktyg och en till lista med dina personliga byggverktyg. Det finns kryssruteknappar för att aktivera och inaktivera dem. När ett byggverktyg är inaktiverat är det inte möjligt att köra det. Du kan utföra en del åtgärder som att flytta ett verktyg upp eller ned, öppna dess egenskaper, ta bort eller kopiera det, skapa ett nytt, o.s.v.</p>

  <note style="tip">
    <p>Dubbelklick på ett byggverktyg kommer att öppna dess egenskaper.</p>
  </note>
</section>

<section id="jobs">
  <title>Jobben för ett byggverktyg</title>

  <p>I egenskaperna för ett byggverktyg är den kluriga delen att konfigurera jobben. Ett byggverktyg kan exekvera flera jobb. Varje jobb innehåller två delar information:</p>
  <list>
    <item><p>Kommandot som kan använda platshållare.</p></item>
    <item><p>Postprocessorn (se <link xref="#post-processors"/>).</p></item>
  </list>

  <p>När ett fel uppstår då ett jobb exekveras, kommer exekveringen att avbrytas så att efterföljande jobb inte startas.</p>
</section>

<section id="post-processors">
  <title>Postprocessorer</title>
  <p>Syftet med en postprocessor är att filtrera kommandoutdata och extrahera den användbara informationen. Fyra postprocessorer är tillgängliga:</p>

  <terms>
    <item>
      <title its:translate="no">no-output</title>
      <p>Utmatningen visas inte.</p>
    </item>
    <item>
      <title its:translate="no">all-output</title>
      <p>All utmatning visas, utan filter.</p>
    </item>
    <item>
      <title its:translate="no">latex</title>
      <p>Filtrera utmatningen för kommandona <cmd>latex</cmd> eller <cmd>pdflatex</cmd>. Det kan finnas tre typer av fel: kritiska fel, varningar eller felrutor. Det finns också en del annan användbar information: storleken på dokumenten, antalet sidor och antalet fel.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>Används för kommandot <cmd>latexmk</cmd>. Internt använder denna postprocessor andra kommandon: <em>latex</em> och <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
