<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="guide" style="task 2column" id="gedit-plugins-snippets" xml:lang="hu">
  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-default-plugins"/>
    <desc>Töredékek használata gyakran használt szövegdarabok gyakori beszúrására.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Hammer Attila</mal:name>
      <mal:email>hammera at pickup dot hu</mal:email>
      <mal:years>2014.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Kelemen Gábor</mal:name>
      <mal:email>kelemeng at gnome dot hu</mal:email>
      <mal:years>2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2017.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Őry Máté</mal:name>
      <mal:email>orymate at gmail dot com</mal:email>
      <mal:years>2007, 2008.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Úr Balázs</mal:name>
      <mal:email>ur.balazs at fsf dot hu</mal:email>
      <mal:years>2014, 2015, 2017, 2019, 2022.</mal:years>
    </mal:credit>
  </info>

  <title>Töredékek</title>

  <p>A <app>Töredékek</app> bővítmény kényelmes megoldást kínál ismétlődő kóddarabok beszúrására a fájljaiba. Egy HTML-töredék az <code>&lt;img&gt;</code> címkéhez például beszúrhatja a címke nyitó és záró részeit, valamint rögzített helyeket a kép attribútumainak megadásához. Ez egyszerűbbé és gyorsabbá teheti a kód írását.</p>

  <section id="enable-snippets">
    <title>Töredékek bővítmény engedélyezése</title>

    <p>A <gui>Töredékek</gui> bővítmény engedélyezéséhez:</p>

    <steps>
      <item>
        <p>Válassza a <guiseq><gui style="menu">gedit</gui><gui style="menuitem">Beállítások</gui><gui style="tab">Bővítmények</gui></guiseq>.</p>
      </item>
      <item>
        <p>Válassza a <gui style="menuitem">Töredékek</gui> bejegyzést a bővítmény engedélyezéséhez.</p>
      </item>
    </steps>
  </section>

  <section id="browse-snippets">
    <title>Töredékek tallózása</title>

    <p>Az elérhető töredékek tallózásához:</p>
    <steps>
      <item>
        <p>Válassza az <guiseq><gui style="menu">Eszközök</gui> <gui style="menuitem">Töredékek kezelése</gui></guiseq> lehetőséget.</p>
        <note style="important">
          <p>Győződjön meg róla, hogy a szintaxis megfelelően van beállítva. A <app>gedit</app> ablak alján lévő állapotsor megjeleníti az aktuális nyelvbeállítást. Ez a nyelvbeállítás teszi lehetővé a gedit számára a megfelelő töredékek beszúrását. A <app>gedit</app> általában felismeri a használt fájl nyelvét vagy szintaxisát, de néha saját kezűleg kell ezt beállítani.</p>
          <figure>
            <desc>Ebben a példában a nyelv a HTML.</desc>
            <media type="image" mime="image/png" src="figures/gedit-html-snippet.png"/>
        </figure>
        </note>
      </item>
      <item>
        <p>Az adott nyelvhez vagy szintaxishoz elérhető töredékeket.</p>
      </item>
    </steps>
  </section>

  <section id="using-snippets">
    <title>Töredékek használata</title>

    <p>Egy töredék beszúrásához a jelenlegi dokumentumba:</p>

    <steps>
      <item>
        <p>Írja be a kívánt töredék nevét bárhová a jelenlegi dokumentumba.</p>
      </item>
      <item>
        <p>Nyomja meg a <key>Tab</key> billentyűt a bevitt kifejezéshez társított töredék beszúrásához.</p>
      </item>
    </steps>
  </section>

    <section id="example-insert-snippet">
    <title>Töredék példa felhasználása</title>

    <p>Ha például a szintaxist <em>HTML</em>-re állította, akkor írja be a <code>head </code> szót, nyomja meg a <key>Tab</key> billentyűt. A szöveg automatikusan kiegészítésre kerül a töredékké valahogy így:</p>

    <code>
      &lt;head&gt;
      &lt;meta http-equiv="Content-type" content="text/html; charset=utf-8" /&gt;
      &lt;title&gt;Oldalcím&lt;/title&gt;
      &lt;/head&gt;
    </code>

  </section>

  <section id="adding-snippets">
    <title>Töredékek hozzáadása</title>

    <p>Felvehet globálisan (nyelvfüggetlenül) vagy adott szintaxisban működő töredékeket.</p>

    <steps>
      <item>
        <p>Válassza az <guiseq style="menu"><gui style="menuitem">Eszközök</gui> <gui style="menuitem">Töredékek kezelése</gui></guiseq> lehetőséget.</p>
      </item>
      <item>
        <p>A <gui>Töredékek kezelése</gui> oldalsávból válassza ki a kívánt szintaxist, és kattintson a „+” gombra az adott szintaxishoz meglévő töredékek felsorolásához.</p>
        <note style="tip">
          <p>Globálisan működő (azaz ha nincs adott szintaxis vagy nyelv beállítva a dokumentumhoz) töredék hozzáadásához válassza a <gui>Töredékek kezelése</gui> oldalsáv <gui>Globális</gui> elemét.</p>
        </note>
      </item>
      <item>
        <p>Új töredék hozzáadásához kattintson a „+” ikonra a <gui>Töredékek kezelése</gui> oldalsávon.</p>
      </item>
      <item>
        <p>Írja be az új töredék nevét. A töredék neve eltérhet a felvenni kívánt töredéktől.</p>
      </item>
      <item>
        <p>Az <gui style="group">Aktiválás</gui> szakaszban meg kell adnia egy kifejezést a <gui style="input">Tab aktiváló:</gui> szövegmezőben. A töredéket ezen a kifejezés használatával fogja tudni beszúrni.</p>
        <note style="tip">
          <p>Ha egy töredéket gyorsbillentyűvel szeretne beszúrni, akkor a <gui style="input">Gyorsbillentyű:</gui> szövegmezőre kattintás után nyomja le a kívánt billentyűkombinációt. Miután megnyomta és felengedte a billentyűket, a gyorsbillentyű be lesz állítva.</p>
        </note>
      </item>
      <item>
        <p>A <gui style="input">Szerkesztés</gui> mezőben adja meg a töredék kívánt szövegét. A változókat a <code>${n}</code> használatával jelölheti, ahol az <em>n</em> a felvett változók sorrendjét jelző szám.</p>
      </item>
    </steps>

  </section>

  <section id="example-add-snippet">
    <title>Új töredék példa</title>

    <p>Tegyük fel, hogy létrehozott egy töredéket, és a <gui style="input">Tab aktiváló</gui> alatt az <var>üdvözlet</var> kifejezést adta meg. A <gui style="input">Szerkesztés</gui> mező a következőt tartalmazza:</p>

    <code>
      &lt;üdvözlet&gt;Szia ${1:csodás}${2:bámulatos} világ!
      &lt;/üdvözlet&gt;
    </code>

    <p>Ezt a töredéket az <var>üdvözlet</var> szó dokumentumba beírásával és a <key>Tab</key> billentyű lenyomásával szúrhatja be. A következő szövegtöredék kerül beszúrásra:</p>

    <code>
      &lt;üdvözlet&gt;Szia csodásbámulatos világ!&lt;/üdvözlet&gt;
    </code>

    <p>A „csodálatos” és „bámulatos” szavak az aktuális szóhasználattól függően törölhetők vagy megtarthatók. Ehhez nyomja le a <key>Tab</key> billentyűt a „csodálatos” és „bámulatos” közti választáshoz, és a <key>Del</key> billentyűt a nem kívánt lehetőség törléséhez.</p>
  </section>

  <!--TODO: <section id="modifying-snippets">
    <title>Modifying Existing Snippets</title>

  </section>-->
</page>
