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

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

<title>Összeállítási eszközök</title>

<synopsis>
  <p>Az összeállítási eszközökkel PDF, DVI vagy PS formátumú dokumentumok készíthetők.</p>
</synopsis>

<links type="section"/>

<section id="overview">
  <title>Bevezetés</title>

  <p>Egy dokumentum összeállításához többféle eszköz használható. Van néhány alacsony szintű parancs, és egy magas szintű parancs: a Latexmk.</p>

  <table rules="rowgroups">
    <title>Alacsony szintű parancsok</title>
    <thead>
      <tr>
        <td><p>Címke</p></td>
        <td><p>Parancs</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>Irodalomjegyzék</p></td>
        <td its:translate="no"><p><cmd>bibtex</cmd></p></td>
      </tr>
      <tr>
        <td><p>Tárgymutató</p></td>
        <td its:translate="no"><p><cmd>makeindex</cmd></p></td>
      </tr>
    </tbody>
  </table>

  <p>Egy LaTeX dokumentum összeállítása egyszerre több alacsony szintű parancs, megadott sorrendben és több alkalommal történő végrehajtását is megkövetelheti. Egy példa erre:</p>
  <screen its:translate="no">
$ latex document.tex
$ bibtex document.aux
$ latex document.tex
$ dvips -t a4 document.dvi
$ ps2pdf document.ps</screen>

  <p>Egy, a Latexmk-hoz hasonló felső szintű eszköz használata nagyban leegyszerűsíti ezt a folyamatot, mert csak egy parancsra van szükség. A Latexmk valójában önállóan meg tudja állapítani, hogy hányszor szükséges a <cmd>latex</cmd> vagy a <cmd>pdflatex</cmd> parancs végrehajtása, illetve, hogy szükséges-e a <cmd>bibtex</cmd> vagy a <cmd>makeindex</cmd> használata. A LaTeXila alapértelmezetten a Latexmk-t használja. </p>
</section>

<section id="execute">
  <title>Egy összeállítási eszköz futtatása</title>

  <p>Egy összeállítási eszköz végrehajtásának többféle módja van:</p>
  <list>
    <item><p>Nyissa meg az <gui style="menu">Összeállítás</gui> menüt.</p></item>
    <item><p>Használja a fő eszköztár gombjait.</p></item>
    <item><p>Használja az <key>F2</key> → <key>F11</key> gyorsbillentyűt.</p></item>
  </list>

  <p>Az összeállítási eszköz az éppen megnyitott fájlon kerül végrehajtásra. Ha az illető fájl egy <link xref="projects">projekthez</link> tartozik, akkor a projekt fő fájlján lesz végrehajtva.</p>

  <note style="important">
    <title>Rejtett összeállítási eszközök</title>
    <p>Alapértelmezésben számos összeállítási eszköz rejtve van, ezért ezeket nem lehet futtatni. Az összeállítási eszközök teljes listájának megtekintéséhez, aktiválásukhoz, vagy beállításukhoz olvassa el az <link xref="#general_configuration"/> részt.</p>
  </note>
</section>

<section id="general_configuration">
  <title>Általános beállítás</title>

  <p>Az összeállítási eszközök beállítását az <guiseq> <gui style="menu">Összeállítás</gui><gui style="menu">Összeállítási eszközök kezelése</gui> </guiseq> menüpont alatt végezheti el.</p>

  <p>Itt látni fogja az alapértelmezett és a saját összeállítási eszközök külön listáját. Az eszközöket a jelölőnégyzetek segítségével engedélyezheti vagy tilthatja le. Ha egy összeállítási eszköz le lett tiltva, akkor azt nem lehet végrehajtani sem. További műveleteket is elvégezhet, például megváltoztathatja az eszközök sorrendjét, megnyithatja az eszközök tulajdonságait, másolhat vagy törölhet egy adott eszközt, illetve új eszközt hozhat létre.</p>

  <note style="tip">
    <p>Egy dupla kattintás az illető összeállítási eszköz tulajdonságait nyitja meg.</p>
  </note>
</section>

<section id="jobs">
  <title>Egy összeállítási eszköz műveletei</title>

  <p>Az összeállítási eszközök tulajdonságait illetően a műveletek beállítása igényli a legnagyobb figyelmet. Egy összeállítási eszköz több művelet végrehajtására is képes. Minden egyes művelet kétféle információt tartalmaz:</p>
  <list>
    <item><p>A helyőrzők kezelésére alkalmas parancsot.</p></item>
    <item><p>A posztprocesszort (lásd: <link xref="#post-processors"/>).</p></item>
  </list>

  <p>Ha egy művelet végrehajtása során hiba történik, az összeállítási eszköz futtatása leáll, így a soron következő műveletek nem indulnak el.</p>
</section>

<section id="post-processors">
  <title>Posztprocesszorok</title>
  <p>Egy posztprocesszor feladata a parancskimenet szűrése és a hasznos információk kivonatolása. Négy posztprocesszor áll rendelkezésre:</p>

  <terms>
    <item>
      <title its:translate="no">no-output</title>
      <p>A kimenet egyszerűen nem jelenik meg.</p>
    </item>
    <item>
      <title its:translate="no">all-output</title>
      <p>A teljes kimenet megjelenik, szűrés nélkül.</p>
    </item>
    <item>
      <title its:translate="no">latex</title>
      <p>A <cmd>latex</cmd> vagy a <cmd>pdflatex</cmd> parancs kimenetének szűrése. Háromféle hibatípus létezik: kritikus hiba, figyelmeztetés vagy bad box. A további hasznos információk között szerepel a dokumentum mérete, az oldalak száma, és a talált hibák száma.</p>
    </item>
    <item>
      <title its:translate="no">latexmk</title>
      <p>A <cmd>latexmk</cmd> parancshoz használatos. Ez a posztprocesszor belsőleg további parancsokat használ: <em>latex</em> és <em>all-output</em>.</p>
    </item>
  </terms>
</section>
</page>
