<?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="gedit-ca">
  <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>jcampbell@gnome.org</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>Utilitzeu fragments per a inserir ràpidament trossos de text que utilitzeu sovint.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Jaume Jorba</mal:name>
      <mal:email>jaume.jorba@gmail.com</mal:email>
      <mal:years>2019</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Jordi Mas</mal:name>
      <mal:email>jmas@softcatala.org</mal:email>
      <mal:years>2019-2020</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Miquel-Àngel Burgos i Fradeja</mal:name>
      <mal:email>miquel.angel.burgos@gmail.com</mal:email>
      <mal:years>2020</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Òscar Pérez</mal:name>
      <mal:email>oscarpc@gmail.com</mal:email>
      <mal:years>2021</mal:years>
    </mal:credit>
  </info>

  <title>Fragments</title>

  <p>El connector <app>Fragments</app> proporciona una manera pràctica d'inserir parts repetitives de codi als vostres fitxers. Per exemple, un fragment d'HTML per a l'etiqueta <code>&lt;img&gt;</code> inserirà les seves porcions d'obertura i tancament, així com llocs fixos on poder introduir els atributs de la imatge. D'aquesta manera l'escriptura de codi és més fàcil i ràpida.</p>

  <section id="enable-snippets">
    <title>Activar el connector Fragments</title>

    <p>Per a activar el connector <gui>Fragments</gui>:</p>

    <steps>
      <item>
        <p>Seleccioneu <guiseq><gui style="menu">gedit</gui> <gui style="menuitem">Preferències</gui> <gui style="tab">Connectors</gui></guiseq>.</p>
      </item>
      <item>
        <p>Seleccioneu <gui style="menuitem">Fragments</gui> per a activar el connector.</p>
      </item>
    </steps>
  </section>

  <section id="browse-snippets">
    <title>Navegar pels fragments</title>

    <p>Per a navegar pels fragments disponibles:</p>
    <steps>
      <item>
        <p>Seleccioneu <guiseq><gui style="menu">Eines</gui> <gui style="menuitem">Gestiona els fragments</gui></guiseq>.</p>
        <note style="important">
          <p>Assegureu-vos que la sintaxi està establerta adequadament. La barra d'estat a la part inferior de la finestra del <app>gedit</app> mostrarà la configuració actual d'idioma. Aquesta configuració és la que permet que el gedit insereixi els fragments adequats. El <app>gedit</app> normalment detecta l'idioma o la sintaxi del fitxer utilitzat, però de vegades l'haureu de configurar.</p>
          <figure>
            <desc>En aquest exemple, el llenguatge està establert a HTML.</desc>
            <media type="image" mime="image/png" src="figures/gedit-html-snippet.png"/>
        </figure>
        </note>
      </item>
      <item>
        <p>Navegueu pels fragments disponibles pel vostre llenguatge o sintaxi.</p>
      </item>
    </steps>
  </section>

  <section id="using-snippets">
    <title>Utilitzar fragments</title>

    <p>Per a inserir un fragment al vostre document actual:</p>

    <steps>
      <item>
        <p>Escriviu el nom del fragment desitjat a qualsevol lloc del vostre document actual.</p>
      </item>
      <item>
        <p>Premeu <key>Tabulador</key> per a inserir el fragment associat al terme d'entrada.</p>
      </item>
    </steps>
  </section>

    <section id="example-insert-snippet">
    <title>Exemple d'ús d'un fragment</title>

    <p>Per exemple, si heu establert la sintaxi a <em>HTML</em>, escriviu <code>head </code>, i premeu la tecla <key>Tab</key>. El text es completarà automàticament en el fragment:</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>Afegir fragments</title>

    <p>Podeu afegir fragments que funcionin globalment (és a dir, que siguin agnòstics de llenguatge) o només en una sintaxi particular.</p>

    <steps>
      <item>
        <p>Seleccioneu <guiseq style="menu"><gui style="menuitem">Eines</gui> <gui style="menuitem">Gestiona els fragments</gui></guiseq>.</p>
      </item>
      <item>
        <p>Des de la barra lateral <gui>Gestiona els fragments</gui> seleccioneu la sintaxi desitjada i feu clic al botó «+» per a mostrar els fragments existents per aquesta sintaxi.</p>
        <note style="tip">
          <p>Per a afegir un fragment que funcioni a nivell global (és a dir, quan no s'hagi establert cap sintaxi o llenguatge concret per al document), seleccioneu <gui>Global</gui> des de la barra lateral <gui>Gestiona els fragments</gui>.</p>
        </note>
      </item>
      <item>
        <p>Per a afegir un nou fragment, feu clic a la icona «més» a la barra lateral <gui>Gestiona els fragments</gui>.</p>
      </item>
      <item>
        <p>Introduïu un nom per al nou fragment. El nom del fragment pot diferir del fragment que vulgueu afegir.</p>
      </item>
      <item>
        <p>A la secció <gui style="group">Activació</gui>, heu d'introduir un terme a l'àrea de text <gui style="input">Activador:</gui>. Haureu d'utilitzar aquest terme per a inserir el vostre fragment.</p>
        <note style="tip">
          <p>Si voleu inserir un fragment amb una drecera de teclat, feu clic al punter del ratolí a la caixa de text <gui style="input">Drecera:</gui> i premeu la combinació de tecles desitjada. Un cop hàgiu premut i alliberat les tecles, s'establirà la drecera de teclat.</p>
        </note>
      </item>
      <item>
        <p>A l'àrea de text <gui style="input">Edició:</gui>, introduïu el text del fragment. Podeu utilitzar <code>${n}</code> per a indicar variables, on <em>n</em> se substitueix per un nombre que representa l'ordre numèric de les variables incloses.</p>
      </item>
    </steps>

  </section>

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

    <p>Considereu que heu creat un fragment amb el contingut <var>greetings</var> al <gui style="input">Disparador de tabuladors:</gui>. L'àrea de text <gui style="input">Edita:</gui> conté:</p>

    <code>
      &lt;greetings&gt;Hello ${1:wonderful}${2:amazing} world!
      &lt;/greetings&gt;
    </code>

    <p>Podeu inserir aquest fragment escrivint <var>greetings</var> al document i prement la tecla <key>Tabulador</key>. S'inserirà el fragment següent:</p>

    <code>
      &lt;greetings&gt;Hello wonderfulamazing world!&lt;/greetings&gt;
    </code>

    <p>Les paraules «wonderful» i «amazing» es poden conservar o suprimir depenent de la vostra elecció d'ús. Per a fer-ho, premeu <key>Tabulador</key> per a triar entre «wonderful» i «amazing», i premeu <key>Suprimir</key> per a eliminar l'opció menys preferida.</p>
  </section>

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

  </section>-->
</page>
