<?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="ro">
  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-default-plugins"/>
    <desc>Utilizează fragmente de text pentru a introduce rapid bucăți de text utilizate frecvent.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Laurențiu Cristian Ion</mal:name>
      <mal:email>ionlaurentiucristian@gmail.com</mal:email>
      <mal:years>2012</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Daniel Șerbănescu</mal:name>
      <mal:email>daniel [at] serbanescu [dot] dk</mal:email>
      <mal:years>2015, 2018-2021</mal:years>
    </mal:credit>
  </info>

  <title>Fragmente de text</title>

  <p><app>Fragmente de text</app> oferă un mod convenient de a introduce porțiuni de cod repetitive în fișerele dumneavoastră. De exemplu un fragment HTML pentru tagul <code>&lt;img&gt;</code> va introduce deschiderea și închiderea tagului, de asemenea și locurile fixe unde ați pute introduce atributele imaginii. Asta poate face scrierea codului mai rapidă.</p>

  <section id="enable-snippets">
    <title>Activarea modulului Fragmente de text</title>

    <p>Pentru a activa modulul <gui>Fragmente de text</gui>:</p>

    <steps>
      <item>
        <p>Selectați <guiseq><gui style="menu">gedit</gui> <gui style="menuitem">Preferințe</gui> <gui style="tab">Module</gui></guiseq>.</p>
      </item>
      <item>
        <p>Selectați <gui style="menuitem">Fragmente de text</gui> pentru a activa modulul.</p>
      </item>
    </steps>
  </section>

  <section id="browse-snippets">
    <title>Navigarea fragmentelor de text</title>

    <p>Pentru a naviga prin fragmentele de text disponibile:</p>
    <steps>
      <item>
        <p>Selectați <guiseq><gui style="menu">Unelte</gui> <gui style="menuitem">Administrează fragmente de text</gui></guiseq>.</p>
        <note style="important">
          <p>Asigurațivă că sintaxa este stabilită corespunzător. Bara de stare din partea inferioară a ferestrei <app>gedit</app> va arăta configurarea curentă pentru limbaj. Această configurare de limbaj este ceea ce permite gedit să insereze fragmentele potrivite. <app>Gedit</app> în mod normal va detecta limbajul sau sintaxa fișierului pe care îl folosiți, dar uneori poate fi necesar să o configurați dumneavoastră.</p>
          <figure>
            <desc>În acest exemplu, limbajul configurat este HTML.</desc>
            <media type="image" mime="image/png" src="figures/gedit-html-snippet.png"/>
        </figure>
        </note>
      </item>
      <item>
        <p>Navigați fragmentele de text care sunt disponibile pentru limbajul sau sintaxa dumneavoastră.</p>
      </item>
    </steps>
  </section>

  <section id="using-snippets">
    <title>Utilizarea fragmentelor de text</title>

    <p>Pentru a introduce un fragment de text în documentul curent:</p>

    <steps>
      <item>
        <p>Tastați numele fragmentului de text dorit oriunde în documentul curent.</p>
      </item>
      <item>
        <p>Apăsați <key>Tab</key> pentru a introduce fragmentul de text asociat cu termenul tastat.</p>
      </item>
    </steps>
  </section>

    <section id="example-insert-snippet">
    <title>Exemplu de utilizare a fragmentelor de text</title>

    <p>De exemplu, dacă stabiliți sintaxa la <em>HTML</em>, tastați <code>head</code>, și apăsați tasta <key>Tab</key>. Textul va fi autocompletat într-un fragment de text cum ar fi:</p>

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

  </section>

  <section id="adding-snippets">
    <title>Adăugarea fragmentelor de text</title>

    <p>Puteți adăuga Fragmente de text care funcționează fie global (agnostic de limbaj) sau numai în cadrul unei sintaxe particulare.</p>

    <steps>
      <item>
        <p>Selectați <guiseq style="menu"><gui style="menuitem">Unelte</gui> <gui style="menuitem">Administrează fragmentele de text</gui></guiseq>.</p>
      </item>
      <item>
        <p>Din bara laterală <gui>Administrează fragmentele de text</gui> selectați sintax dorită și apăsați pe butonul „+” pentru a lista fragmentele de text existente pentru sintaxa selectată.</p>
        <note style="tip">
          <p>Pentru a adăuga un fragment care să funcționeze global (pentru atunci când nicio sintaxă sau limbă nu a fost stabilită pentru document), selectați <gui>Global</gui> din bara laterală <gui>Administrează fragmente</gui>.</p>
        </note>
      </item>
      <item>
        <p>Pentru a adăuga un fragment, apăsați pe iconița „plus” din bara laterală <gui>Administrează fragmente</gui>.</p>
      </item>
      <item>
        <p>Introduceți un nume pentru fragment. Numele fragmentului poate fi diferit de fragmentul pe care doriți să-l adăugați.</p>
      </item>
      <item>
        <p>Sub secția <gui style="group">Activare</gui>, trebuie să introduceți un termen pentru zona de text <gui style="input">Declanșator tab:</gui>. Veți folosi acest termen pentru a introduce fragmentul dumneavoastră.</p>
        <note style="tip">
          <p>Dacă doriți să introduceți un fragment cu o scurtătură de tastatură, apoi apăsați cu mausul pe zona de text <gui style="input">Tastă scurtătură:</gui> și apăsați combinația dorită de taste. Odată ce ați apăsat și ați eliberat tastele, scurtătura de tastatură va fi stabilită.</p>
        </note>
      </item>
      <item>
        <p>Sub zona de text pentru <gui style="input">Editare:</gui>, introduceți textul dorit pentru fragment. Puteți folosi <code>${n}</code> pentru a indica variabile unde <em>n</em> este înlocuit de un număr care reprezintă ordina numerică a variablelor incluse.</p>
      </item>
    </steps>

  </section>

  <section id="example-add-snippet">
    <title>Exemplu de fragment nou</title>

    <p>Presupunem că ați creeat un fragent cu termenul <var>salutări</var> în <gui style="input">Declanșator tab:</gui>. Zona de text <gui style="input">Editare:</gui> conține:</p>

    <code>
      &lt;salutări&gt;Salut ${1:wonderful}${2:amazing} lume!
      &lt;/salutări&gt;
    </code>

    <p>Puteți introduce acest fragment tastând <var>salutări</var> în document și apăsând tasta <key>Tab</key>. Următorul fragment de text va fi introdus:</p>

    <code>
      &lt;salutări&gt;Saluări lume fantasticăextraordinară!&lt;/salutări&gt;
    </code>

    <p>Cuvintele „fantastică” și „extraordinară” pot fi reținute sau șterse în funcție de alegerea dumneavoastră. Pentru a facea asta, apăsați <key>Tab</key> pentru a alege între „fantastică” și „extraordinară” și apăsați tasta <key>Del</key> pentru a șterge opțiunea mai puțin preferată.</p>
  </section>

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

  </section>-->
</page>
