<?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-ru">
  <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>Использование фрагментов для быстрой вставки часто используемых частей текста.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Станислав Соловей</mal:name>
      <mal:email>whats_up@tut.by</mal:email>
      <mal:years>2013-2019.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Юрий Мясоедов</mal:name>
      <mal:email>ymyasoedov@yandex.ru</mal:email>
      <mal:years>2014.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Alexey Rubtsov</mal:name>
      <mal:email>rushills@gmail.com</mal:email>
      <mal:years>2021</mal:years>
    </mal:credit>
  </info>

  <title>Фрагменты</title>

  <p>Модуль <app>Фрагменты</app> предоставляет удобный способ вставки повторяющихся частей кода в файлы. Например, фрагмент HTML для тега <code>&lt;img&gt;</code> вставит открывающую и закрывающую части тега, а также место, где можно ввести атрибуты изображения. Это может сделать написание кода проще и быстрее.</p>

  <section id="enable-snippets">
    <title>Включение модуля Фрагменты</title>

    <p>Чтобы включить модуль <app>Фрагменты</app>:</p>

    <steps>
      <item>
        <p>Выберите <guiseq><gui style="menu">gedit</gui> <gui style="menuitem">Параметры</gui> <gui style="tab">Модули</gui></guiseq>.</p>
      </item>
      <item>
        <p>Чтобы включить модуль, нажмите на <gui style="menuitem">Фрагменты</gui>.</p>
      </item>
    </steps>
  </section>

  <section id="browse-snippets">
    <title>Обзор фрагментов</title>

    <p>Чтобы просмотреть доступные фрагменты:</p>
    <steps>
      <item>
        <p>Выберите <guiseq><gui style="menu">Сервис</gui> <gui style="menuitem">Управление фрагментами</gui></guiseq>.</p>
        <note style="important">
          <p>Убедитесь, что указан верный синтаксис. В строке состояния в нижней части окна <app>gedit</app> показаны текущие настройки языка. Данная настройка позволяет gedit вставлять правильные фрагменты. <app>Gedit</app>, как правило, автоматически определяет язык или синтаксис используемого файла, но иногда может понадобиться установить их вручную.</p>
          <figure>
            <desc>В этом примере установлен язык HTML.</desc>
            <media type="image" mime="image/png" src="figures/gedit-html-snippet.png"/>
        </figure>
        </note>
      </item>
      <item>
        <p>Просмотрите фрагменты, доступные для текущего языка или синтаксиса.</p>
      </item>
    </steps>
  </section>

  <section id="using-snippets">
    <title>Использование фрагментов</title>

    <p>Чтобы вставить фрагмент в текущий документ:</p>

    <steps>
      <item>
        <p>Введите слово-термин нужного фрагмента в любом месте текущего документа.</p>
      </item>
      <item>
        <p>Нажмите клавишу <key>Tab</key>, чтобы вставить фрагмент, связанный с набранным словом-термином.</p>
      </item>
    </steps>
  </section>

    <section id="example-insert-snippet">
    <title>Пример использования фрагмента</title>

    <p>Например, если установить синтаксис <em>HTML</em>, ввести слово-термин <code>head </code>, и нажать клавишу <key>Tab</key>, текст будет автоматически дополнен фрагментом:</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>Добавление фрагментов</title>

    <p>Можно добавлять новые фрагменты, которые могут работать как глобально (то есть, независимо от языка), так и только при определённом синтаксисе.</p>

    <steps>
      <item>
        <p>Выберите <guiseq style="menu"><gui style="menuitem">Сервис</gui> <gui style="menuitem">Управление фрагментами</gui></guiseq>.</p>
      </item>
      <item>
        <p>В боковой панели <gui>Управление фрагментами</gui> выберите нужный синтаксис и нажмите на кнопку «+» рядом с ним, чтобы отобразить список существующих фрагментов для выбранного синтаксиса.</p>
        <note style="tip">
          <p>Чтобы добавить фрагмент, который работает глобально (то есть, когда для документа не установлен особый синтаксис или язык), выберите раздел <gui>Глобальные</gui> в боковой панели <gui>Управление фрагментами</gui>.</p>
        </note>
      </item>
      <item>
        <p>Чтобы добавить новый фрагмент, нажмите на значок «плюс» внизу боковой панели <gui>Управление фрагментами</gui>.</p>
      </item>
      <item>
        <p>Введите имя для нового фрагмента. Имя фрагмента может не совпадать с текстом добавляемого фрагмента.</p>
      </item>
      <item>
        <p>В разделе <gui style="group">Включение</gui>, необходимо ввести в текстовое поле <gui style="input">Переключатель вкладок:</gui> слово-термин, которое будет использоваться для вставки фрагмента.</p>
        <note style="tip">
          <p>Если нужно вставлять фрагмент с помощью комбинации клавиш, перенесите курсор в текстовое поле <gui style="input">Комбинация клавиш:</gui>, нажмите нужную комбинацию клавиш и отпустите. После этого комбинация клавиш будет установлена.</p>
        </note>
      </item>
      <item>
        <p>Под надписью <gui style="input">Правка:</gui>, введите нужный текст фрагмента. Можно использовать <code>${n}</code> для обозначения переменных, где <em>n</em> заменяется числом, которое представляет порядковый номер переменной.</p>
      </item>
    </steps>

  </section>

  <section id="example-add-snippet">
    <title>Пример нового фрагмента</title>

    <p>Например, вы создали фрагмент текста со словом-термином <var>greetings</var> в графе <gui style="input">Переключатель вкладок:</gui>. Текстовое поле под надписью <gui style="input">Правка:</gui> содержит следующее:</p>

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

    <p>Можно вставить этот фрагмент, набрав в документе слово <var>greetings</var> и нажав на клавиатуре кнопку <key>Tab</key>. Будет вставлен следующий фрагмент текста:</p>

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

    <p>Слова "wonderful" и "amazing" могут быть оставлены или удалены в зависимости от вашего выбора. Для этого нажмите <key>Tab</key>, чтобы выбрать между словами "wonderful" и "amazing", и нажмите <key>Del</key>, чтобы удалить неподходящий вариант.</p>
  </section>

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

  </section>-->
</page>
