<?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="pl">
  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-default-plugins"/>
    <desc>Używanie wstawek, aby szybko wstawiać często używane części tekstu.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Piotr Drąg</mal:name>
      <mal:email>piotrdrag@gmail.com</mal:email>
      <mal:years>2017-2020</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Aviary.pl</mal:name>
      <mal:email>community-poland@mozilla.org</mal:email>
      <mal:years>2017-2020</mal:years>
    </mal:credit>
  </info>

  <title>Wstawki</title>

  <p><app>Wstawki</app> dostarczają wygodny sposób na wstawianie często używanych części kodu do plików. Na przykład, wstawka HTML dla znacznika <code>&lt;img&gt;</code> wstawi otwierającą i zamykającą część znacznika, a także miejsca na wpisanie atrybutów obrazu. Ułatwia i przyspiesza to pisanie kodu.</p>

  <section id="enable-snippets">
    <title>Włączanie wtyczki wstawek</title>

    <p>Aby włączyć wtyczkę <gui>Wstawki</gui>:</p>

    <steps>
      <item>
        <p>Wybierz <guiseq><gui style="menu">gedit</gui> <gui style="menuitem">Preferencje</gui> <gui style="tab">Wtyczki</gui></guiseq>.</p>
      </item>
      <item>
        <p>Zaznacz <gui style="menuitem">Wstawki</gui>, aby włączyć wtyczkę.</p>
      </item>
    </steps>
  </section>

  <section id="browse-snippets">
    <title>Przeglądanie wstawek</title>

    <p>Aby przeglądać dostępne wstawki:</p>
    <steps>
      <item>
        <p>Wybierz <guiseq><gui style="menu">Narzędzia</gui> <gui style="menuitem">Zarządzaj wstawkami</gui></guiseq>.</p>
        <note style="important">
          <p>Upewnij się, że ustawiona jest odpowiednia składnia. Pasek stanu na dole okna programu <app>gedit</app> wyświetla obecnie ustawioną składnię. To ustawienie umożliwia programowi gedit wstawianie właściwych wstawek. <app>gedit</app> powinien wykryć język lub składnię używanego pliku, ale czasami trzeba je ustawić ręcznie.</p>
          <figure>
            <desc>W tym przykładzie język jest ustawiony na HTML.</desc>
            <media type="image" mime="image/png" src="figures/gedit-html-snippet.png"/>
        </figure>
        </note>
      </item>
      <item>
        <p>Przeglądanie wstawek dostępnych dla danego języka i składni.</p>
      </item>
    </steps>
  </section>

  <section id="using-snippets">
    <title>Używanie wstawek</title>

    <p>Aby wstawić wstawkę do bieżącego dokumentu:</p>

    <steps>
      <item>
        <p>Wpisz nazwę wybranej wstawki w dowolnym miejscu bieżącego dokumentu.</p>
      </item>
      <item>
        <p>Naciśnij klawisz <key>Tab</key>, aby wstawić wstawkę powiązaną z wpisanym terminem.</p>
      </item>
    </steps>
  </section>

    <section id="example-insert-snippet">
    <title>Przykładowa wstawka</title>

    <p>Na przykład, jeśli ustawiono składnię <em>HTML</em>, wpisz <code>head </code> i naciśnij klawisz <key>Tab</key>. Tekst zostanie automatycznie uzupełniony jako wstawka:</p>

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

  </section>

  <section id="adding-snippets">
    <title>Dodawanie wstawek</title>

    <p>Można dodać nowe wstawki działające globalnie (czyli niezależnie od języka) lub tylko w konkretnej składni.</p>

    <steps>
      <item>
        <p>Wybierz <guiseq style="menu"><gui style="menuitem">Narzędzia</gui> <gui style="menuitem">Zarządzaj wstawkami</gui></guiseq>.</p>
      </item>
      <item>
        <p>Z panelu bocznego <gui>Zarządzanie wstawkami</gui> wybierz składnię i kliknij przycisk „+”, aby wyświetlić istniejące wstawki dla tej składni.</p>
        <note style="tip">
          <p>Aby dodać wstawkę działającą globalnie (czyli wtedy, kiedy nie ustawiono żadnej składni ani języka dla dokumentu), zaznacz opcję <gui>Globalna</gui> w panelu bocznym <gui>Zarządzanie wstawkami</gui>.</p>
        </note>
      </item>
      <item>
        <p>Aby dodać nową wstawkę, kliknij ikonę z plusem w panelu bocznym <gui>Zarządzanie wstawkami</gui>.</p>
      </item>
      <item>
        <p>Wpisz nazwę nowej wstawki. Nazwa może być inna niż sama wstawka.</p>
      </item>
      <item>
        <p>W sekcji <gui style="group">Aktywacja</gui> należy wpisać termin w polu tekstowym <gui style="input">Wyzwalacz Tab:</gui>. Ten termin będzie używany do wstawiania wstawki.</p>
        <note style="tip">
          <p>Aby wstawić wstawkę za pomocą skrótu klawiszowego, to kliknij pole tekstowe <gui style="input">Klawisz skrótu:</gui> i naciśnij wybraną kombinację klawiszy. Po ich wciśnięciu i zwolnieniu zostanie ustawiony skrót klawiszowy.</p>
        </note>
      </item>
      <item>
        <p>W polu tekstowym <gui style="input">Edycja:</gui> wpisz wybrany tekst wstawki. Można użyć <code>${n}</code>, aby wskazywać zmienne, gdzie <em>n</em> jest zastępowane liczbą reprezentującą numeryczną kolejność dołączonych zmiennych.</p>
      </item>
    </steps>

  </section>

  <section id="example-add-snippet">
    <title>Przykład nowej wstawki</title>

    <p>Załóżmy, że utworzono wstawkę z terminem <var>powitanie</var> w polu <gui style="input">Wyzwalacz Tab:</gui>. Pole tekstowe <gui style="input">Edycja:</gui> zawiera:</p>

    <code>
      &lt;powitanie&gt;Witaj, ${1:wspaniały}${2:piękny} świecie!
      &lt;/powitanie&gt;
    </code>

    <p>Można wstawić tę wstawkę wpisując <var>powitanie</var> w dokumencie i naciskając klawisz <key>Tab</key>. Zostanie wstawiony ten tekst:</p>

    <code>
      &lt;powitanie&gt;Witaj, wspaniałypiękny świecie!&lt;/powitanie&gt;
    </code>

    <p>Słowa „wspaniały” i „piękny” mogą zostać zachowane lub usunięte w zależności od potrzeb. Naciśnij klawisz <key>Tab</key>, aby wybrać między „wspaniały” a „piękny”, a następnie naciśnij klawisz <key>Del</key>, aby usunąć niepotrzebne słowo.</p>
  </section>

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

  </section>-->
</page>
