<?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="lv">
  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-default-plugins"/>
    <revision pkgversion="3.8" date="2013-02-24" status="review"/>
    <revision pkgversion="3.8" date="2013-03-22" status="review"/>
    <credit type="author">
      <name>Jim Campbell</name>
      <email>jwcampbell@gmail.com</email>
    </credit>
    <credit type="author">
      <name>Sindhu S</name>
      <email>sindhus@live.in</email>
    </credit>
    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
    <desc>Izmantot fragmentus, lai ātri ievietotu bieži lietotus teksta gabalus</desc>
  </info>

  <title>Fragmenti</title>

  <p><app>Fragmenti</app> nodrošina iespēju ātri ievietot tekstā bieži lietotus koda fragmentus. Piemēram, HTML fragments<code>&lt;img&gt;</code> elementam ievietos atverošās un aizverošās birkas un atvieglos atribūtu ievadi pareizajās vietās. Tas var padarīt koda rakstīšanu vienkāršāku un ātrāku.</p>

  <section id="enable-snippets">
    <title>Aktivēt fragmentu spraudni</title>

    <p>Aktivēt <gui>fragmentu</gui> spraudni:</p>

    <steps>
      <item>
        <p>Izvēlieties <guiseq><gui style="menu">gedit</gui><gui style="menuitem">Iestatījumi</gui><gui>Spraudņi</gui></guiseq>.</p>
      </item>
      <item>
        <p>Izvēlieties <gui style="menuitem">Fragmenti</gui>, lai aktivētu spraudni.</p>
      </item>
    </steps>
  </section>

  <section id="browse-snippets">
    <title>Pārlūkot fragmentus</title>

    <p>Lai pārlūkotu pieejamos fragmentus:</p>
    <steps>
      <item>
        <p>Izvēlieties <guiseq><gui style="menu">Rīki</gui> <gui style="menuitem">Pārvaldīt spraudņus</gui></guiseq>.</p>
        <note style="important">
          <p>Pārliecinieties, vai ir iestatīta atbilstošā sintakse. Statusa josla <app>gedit</app> loga apakšā parādīs iestatīto valodu. Šis iestatījums atļauj gedit ievietot pareizos fragmentus. <app>Gedit</app> parasti automātiski noteiks datnes valodu vai sintaksi, bet var gadīties, ka jums vajadzēs to iestatīt.</p>
          <figure>
            <desc>Šajā piemērā valodas iestatījums ir HTML.</desc>
            <media type="image" mime="image/png" src="figures/gedit-html-snippet.png"/>
        </figure>
        </note>
      </item>
      <item>
        <p>Pārlūkot spraudņus, kas ir pieejami jūsu valodai vai sintaksei.</p>
      </item>
    </steps>
  </section>

  <section id="using-snippets">
    <title>Fragmentu lietošana</title>

    <p>Lai dokumentā ievietotu fragmentu:</p>

    <steps>
      <item>
        <p>Ierakstiet vajadzīgā fragmenta nosaukumu jebkurā vietā dokumentā.</p>
      </item>
      <item>
        <p>Spiediet <key>Tab</key>, lai ievietotu fragmentu, kas ir saistīts ar ievades termu.</p>
      </item>
    </steps>
  </section>

    <section id="example-insert-snippet">
    <title>Fragmenta piemēra izmantojums</title>

    <p>Piemēram, ja iestata <em>HTML</em> sintaksi, ierakstiet <code>head</code> un nospiediet <key>Tab</key> taustiņu. Tekstam vajadzētu automātiski pabeigties par uz šādu fragmentu:</p>

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

  </section>

  <section id="adding-snippets">
    <title>Fragmentu pievienošana</title>

    <p>Jūs varat pievienot jaunus fragmentus, kas darbosies globāli (tas ir, tie ir neatkarīgi no valodas) vai arī noteiktā sintaksē.</p>

    <steps>
      <item>
        <p>Izvēlieties <guiseq><gui style="menu">Rīki</gui> <gui style="menuitem">Pārvaldīt spraudņus</gui></guiseq>.</p>
      </item>
      <item>
        <p>From the <gui>Manage Snippets</gui> sidebar select the desired syntax
        and click on the "+" button to list existing snippets for the selected
        syntax.</p>
        <note style="tip">
          <p>To add a snippet that works globally (that is, when no particular
          syntax or language has been set for the document), select
          <gui>Global</gui> from the <gui>Manage Snippets</gui> sidebar.</p>
        </note>
      </item>
      <item>
        <p>To add a new snippet, click on the "plus" icon in the
        <gui>Manage Snippets</gui> sidebar.</p>
      </item>
      <item>
        <p>Input a name for the new snippet. The name of the snippet can be
        different from the snippet you want to add.</p>
      </item>
      <item>
        <p>Under the <gui style="group">Activation</gui> section, you must
        input a term for the <gui style="input">Tab trigger:</gui> textarea.
        You will be using this term to insert your snippet.</p>
        <note style="tip">
          <p>If you wish to insert a snippet with a keyboard shortcut, then
          click your mouse pointer on <gui style="input">Shortcut key:</gui>
          textarea and press the desired combination of keys. Once you have
          pressed and released the keys, the keyboard shortcut will be set.</p>
        </note>
      </item>
      <item>
        <p>Under the textarea for <gui style="input">Edit:</gui>, input the
        desired text for the snippet. You may use <code>${n}</code> to indicate
        variables, where <em>n</em> is replaced with a number that
        represents the numerical order of variables included.</p>
      </item>
    </steps>

  </section>

  <section id="example-add-snippet">
    <title>Jauna fragmenta piemērs</title>

    <p>Consider you have created a snippet with the term <var>greetings</var>
    in <gui style="input">Tab trigger:</gui>. The
    <gui style="input">Edit:</gui> textarea contains:</p>

    <code>
      &lt;sveiciens&gt;Sveika ${1:lieliskā}${2:apbrīnojamā} pasaule!
      &lt;/sveiciens&gt;
    </code>

    <p>You can insert this snippet by typing <var>greetings</var> in the
    document and pressing the <key>Tab</key> key. The following text snippet
    will be inserted:</p>

    <code>
      &lt;sveiciens&gt;Sveika lieliskāapbrīnojamā pasaule!&lt;/sveiciens&gt;
    </code>

    <p>The words "wonderful" and "amazing" can be retained or deleted depending
    on your choice of usage. To do so, press <key>Tab</key> to choose between
    "wonderful" and "amazing" and press <key>Del</key> to delete the least
    preferred option.</p>
  </section>

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

  </section>-->
</page>
