<chapter id="plugins">

<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"
><firstname
>Юрій</firstname
><surname
>Чорноіван</surname
><affiliation
><address
><email
>yurchor@ukr.net</email
></address
></affiliation
><contrib
>Переклад українською</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>

<title
>Робота з додатками</title>

<para
>У Kate використовуються дві різні форми додатків, а саме додатки до програми &kate; і додатки до компонента редактора &kate;. Останніми можна користуватися у будь-якій програма, яка використовує компонент редактора, зокрема KDevelop, Quanta, Kile, Kwrite та багато інших програмах, тоді як додатками до програми можна скористатися лише у самій програмі &kate;.</para>

<para
>Увімкнути додатки обох типів можна за допомогою <link linkend="configuring-kate-configdialog"
>діалогового вікна налаштування</link
>, за допомогою цього вікна можна також отримати доступ до додаткових параметрів налаштування тих додатків, які потребують налаштування.</para>

<para
>Передбачено додатки, призначені для виконання різних функцій, крім того, додатки можна знайти у мережі інтернет. Декілька додатків постачаються з компонентом редактора, це зокрема додаток автоматичного додавання парних дужок, вставлення файлів, інструменти даних та додаток експортування тексту до &HTML;.</para>

<sect1 id="kate-editor-plugins">
<title
>Додатки компонента редактора</title>

<para
>На вкладці <guilabel
>Додатки</guilabel
> на сторінці <guilabel
>Розширення</guilabel
> буде показано список всіх доступних додатків, ви зможете обрати ті з них, які ви бажаєте використовувати. Натисніть кнопку <guibutton
>Інформація</guibutton
>, щоб відкрити діалогове вікно з інформацією щодо відповідного додатка.</para>
<para
>Після того, як ви позначите пункт додатка, налаштування якого є можливим, буде увімкнено кнопку <guibutton
>Налаштувати</guibutton
> і ви зможете натиснути її, щоб налаштувати позначений додаток.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>AutoBrace</guilabel
></term>
<listitem
><para
>Додаток автоматичного додавання дужок заміняє собою вбудовану можливість &kate; <quote
>Автоматичні дужки</quote
>. Додаток автоматично вставляє завершальну дужку <keycap
>}</keycap
> на початку наступного за рядком з початковою дужкою <keycap
>{</keycap
> рядка після його завершення і натискання клавіші &Enter;.</para
></listitem>
</varlistentry>
<!--http://jakob.petsovits.at/topic/kate-->
<!--Right, it's the automatic insertion of a closing brace ("}") after you ended a line with an opening one ("{"). Kate's standard insertion of parentheses, brackets and braces is simply too obtrusive for me, so even if I tried it several times I always had to disable it again because I can't stand it. So here's how AutoBrace works.
You, the developer, are writing a line of code, and want to open a new block delimited by braces. Looks like this:
If you press Enter and AutoBrace is enabled, it will insert your favorite new brace where it belongs. Looks like this:
-->
<varlistentry>
<term
><guilabel
>Засоби роботи з даними</guilabel
></term>
<listitem
><para
>Вмикає інструменти роботи з даними, зокрема тезаурус та перевірку правопису (якщо ці інструменти встановлено). Доступ до інструментів роботи з даними можна буде отримати лише після позначення фрагмента тексту або клацання правою кнопкою миші на певному слові. Якщо програма не пропонує жодних інструментів для роботи з даними, навіть якщо позначено фрагмент тексту, вам доведеться встановити ці інструменти. Деякі з інструментів роботи з даними є частиною пакунка &koffice;. Якщо буде увімкнено цей додаток і встановлено інструменти роботи з даними, наприкінці контекстного меню буде додано відповідні пункти інструментів.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><link linkend="kate-editor-plugin-exporter"
><guilabel
>Інструмент експортування</guilabel
></link
></term>
<listitem
><para
>За допомогою цього пункту можна експортувати поточний документ з усією позначеною інформацією до документа у форматі HTML. Щоб виконати цю дію, скористайтеся пунктом меню <menuchoice
><guimenu
>Файл</guimenu
><guimenuitem
>Експортувати як HTML</guimenuitem
></menuchoice
>. Крім того, ви можете скористатися пунктом меню <menuchoice
><guimenu
>Зміни</guimenu
> <guimenuitem
>Копіювати як HTML</guimenuitem
></menuchoice
>, щоб скопіювати поточний позначений фрагмент тексту у форматі HTML до буфера обміну даними системи.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Вставка піктограм</guilabel
></term>
<listitem
><para
>Додаток вставлення піктограм знадобиться лише розробникам &kde;. Цей додаток має окремий пункт <guimenuitem
>Вставити код KIcon</guimenuitem
> у контекстному меню редактора. Якщо ви скористаєтеся цим пунктом, буде відкрито вікно вибору піктограм &kde; (у ньому буде показано піктограми програм, дій тощо). Якщо ви натиснете пункт піктограми, до файла у редакторі буде вставлено назву файла піктограми без суфікса. Ця можливість буде корисною для встановлення піктограм за допомогою оболонки &kde; шляхом використання класу KIcon(). </para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Божевільне (не дзен) HTML-програмування (спрощена версія)</guilabel
></term>
<listitem
><para
>Додаток дзен-програмування подібний до заповнення варіантів вибору. Докладніше про дзен-програмування можна дізнатися зі <ulink url="http://en.wikipedia.org/wiki/Zen_Coding"
>сторінки Вікіпедії</ulink
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Вставити файл</guilabel
></term>
<listitem
><para
>За допомогою цього додатка ви можете вставити будь-який придатний до читання файл у позицію курсора. Якщо додаток буде увімкнено, у меню <guimenu
>Інструменти</guimenu
> з’явиться додатковий пункт — <guimenuitem
>Вставити файл</guimenuitem
>.</para
></listitem>
</varlistentry>
<!-- not build any longer in kde 4.5
<varlistentry>
<term
>Python Encoding check</term>
<listitem
><para
>This plugin is always enabled.  
If you are trying to save a python file as non ASCII, without specifying a 
correct source encoding line like &eg; <quote
># -*- coding: utf-8 -*-</quote
>, 
a warning dialog pops up and allows you to add a proper source encoding line for the
current encoding to the file.
</para
></listitem>
</varlistentry>
-->
</variablelist>
<!--
kdelibs/kate/plugins/ has additional plugins
autobookmark not build, its broken!
timedate not build? plugin is for howto-write-a-plugin purposes!
-->

<!-- Scripts tab ??? empty: Not implemented yet, hidden in 4.4 + 4.7  branch, removed in master bye bye-->
</sect1>

<sect1 id="kate-application-plugins">
<title
>Додатки програми &kate;</title>

<!-- from doc/kate-addons/index.docbook -->
<para
>Додатки &kate; призначено для виконання додаткових функцій у редакторі &kate;. За їх допомогою можна додавати нові меню і скорочення, а також розширювати список можливостей &kate;. Ви можете встановити будь-яку бажану кількість додатків за допомогою самої програми &kate;. Для цього скористайтеся діалоговим вікном налаштування &kate;, яке можна відкрити за допомогою пункту меню <menuchoice
><guimenu
>Параметри</guimenu
> <guimenuitem
>Налаштувати &kate;...</guimenuitem
></menuchoice
>. Щоб обрати потрібні додатки, перейдіть на сторінку <menuchoice
><guimenu
>Програма</guimenu
> <guimenuitem
>Додатки</guimenuitem
></menuchoice
>. </para>

<para
>Серед можливих додатків до програми: </para>
<itemizedlist>
<listitem>
<para
><link linkend="kate-application-plugin-findinfiles"
>Панель інструменту пошуку у файлах</link
> — панель засобу, який дає змогу шукати дані у відкритих файлах або у файлах файлової системи.</para>
</listitem>
<listitem>
<para
>GDB — проста графічна оболонка до GDB</para>
<!-- GDB Plugin http://kate-editor.org/2011/06/23/kate-plugin-updates-part-2/-->
</listitem>
<listitem>
<para
>Переглядач зворотного трасування допоможе вам переглянути дані зворотного трасування</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-quickswitcher"
>Швидке перемикання документів</link
> надає вам змогу швидко перемкнутися на вже відкритий документ.</para>
</listitem>
<listitem>
<para
>Додаток SQL — виконання запитів до баз даних SQL</para>
</listitem>
<listitem>
<para
>Додаток пошуку — Пошук у файлах за шаблоном</para>
</listitem>
<listitem>
<para
>Панель вкладок — додає смужку вкладок до головного вікна &kate;.</para>
<!--http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/-->
</listitem>
<!--listitem>
<para
>Text Snippets - Configurable Text Snippets</para>
</listitem-->
<listitem>
<para
>Фільтр тексту — просте фільтрування тексту.</para>
</listitem>
<listitem>
<para
>Переглядач символів призначено для добування і показу символів з джерельного коду.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-fsbrowser"
>Переглядач файлової системи</link
> — панель засобу навігації файловою системою</para>
</listitem>
<listitem>
<para
>Панель інструменту термінала — вбудування віджета термінала у вікно програми.</para>
</listitem>
<!--listitem>
<para
>Kate Python Browser Plugin - A Python browser plugin for Kate</para>
</listitem-->
<listitem>
<para
>Додаток CTags виконує пошук визначень або оголошень за допомогою CTags.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-filetemplate"
>Шаблони файлів</link
> призначено для створення нових файлів з шаблонів.</para>
</listitem>
<listitem>
<para
>Відкрити заголовок — відкриває відповідний файл .h/[.cpp|.c].</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-exttools"
>Зовнішні інструменти</link
></para>
</listitem>
<listitem>
<para
>Додаток збирання — компілює або збирає і обробляє повідомлення про помилки.</para>
<!-- http://kate-editor.org/2011/06/21/kate-plugin-updates-part-1/ -->
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-mail"
>Надіслати файли</link
> — надсилає файли електронною поштою.</para>
</listitem>
<listitem>
<para
>Додаток багаторядкової панелі вкладок додає панель вкладок з декількома рядками до головного вікна &kate;</para>
</listitem>
<listitem>
<para
>Фрагменти Kate — додаток для роботи з фрагментами з підтримкою завершення коду</para>
</listitem>
<listitem>
<para
>Додаток Jovie виголошення текстів додає пункт меню, призначений для виголошення тексту.</para>
</listitem>
<listitem>
<para
>Додаток <link linkend="kate-application-plugin-xmlcheck"
>Перевірка &XML;</link
> перевіряє коректність файлів &XML; за допомогою xmllint.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>Доповнення &XML;</link
> — показує список елементів, атрибутів, значень атрибутів та об’єктів &XML;, передбачених у DTD.</para>
</listitem>
<listitem>
<para
>Панель вкладок — додає смужку вкладок до головного вікна &kate;.</para>
<!--http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/-->
</listitem>
</itemizedlist>
</sect1>

<!-- from doc/kate-addons/filetemplates.docbook -->
<sect1 id="kate-application-plugin-filetemplate">
<sect1info>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
</authorgroup>
</sect1info>
<title
>Шаблони файлів</title>

  <para
>За допомогою додатка «Шаблони файлів» ви зможете створювати файли на основі інших файлів.</para>
  <para
>Після встановлення Kate вам слід увімкнути додаток:</para>
  <orderedlist>
        <listitem>
          <para
>Скористайтеся пунктом меню <menuchoice
><guimenu
>Параметри</guimenu
><guimenuitem
>Налаштувати Kate</guimenuitem
></menuchoice
> </para>
        </listitem>
        <listitem>
          <para
>У ієрархічному списку, розташованому у лівій частині екрана, натисніть пункт <guilabel
>Додатки</guilabel
>. </para>
        </listitem>
        <listitem>
          <para
>На панелі <guilabel
>Керування додатками</guilabel
>, розташованій праворуч, позначте пункт <guilabel
>Шаблони файлів</guilabel
> і натисніть кнопку <guibutton
>Гаразд</guibutton
>. </para>
        </listitem>
   </orderedlist>
  <para
>Тепер ви можете скористатися будь-яким файлом як шаблоном (буде створено копію цього файла з порожньою адресою &URL;). У особливих файлах шаблонів можуть міститися макроси для заповнення відомостей щодо вашого імені, адреси електронної пошти, поточної дати та зручного розташування курсора у новому файлі.</para>
  <para
>Ви можете легко створити новий шаблон на основі відкритого документа.</para>
  <para
>Шаблони, які ви зберегли до теки шаблонів, буде показано у списку підменю <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Створити з шаблона</guimenuitem
></menuchoice
>.</para>
  <para
>Тека шаблонів є частиною файлової системи &kde;, вона складається принаймні з</para>
    <itemizedlist>
      <listitem>
	<para>
	 <filename role="directory"
>$<envar
>KDEDIR</envar
>/share/applications/kate/plugins/katefiletemplates/templates</filename>
	</para>
      </listitem>
      <listitem>
       <para>
        <filename role="directory"
>$<envar
>KDEHOME</envar
>/share/applications/kate/plugins/katefiletemplates/templates.</filename>
	</para>
      </listitem>
    </itemizedlist>
    <para
>Якщо ваша змінна середовища <envar
>KDEDIRS</envar
> містить додаткові каталоги, ці каталоги буде перевірено на наявність подібних назв підтек. Якщо буде знайдено шаблони з однаковими назвами, буде обрано лише шаблон у вашій локальній (KDEHOME) теці.</para>
  <sect2 id="katefiletemplates-menu">
    <title
>Структура меню</title>

    <variablelist>
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Файл</guimenu
> <guisubmenu
>Створити з шаблона</guisubmenu
> <guimenuitem
>Будь-який файл...</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Відкриває діалогове вікно «Відкрити файл», за допомогою якого ви зможете використати будь-який файл як шаблон. Якщо назва обраного файла матиме суфікс <filename
>katetemplate</filename
>, відбудеться пошук у цьому файлі відомостей про шаблон і макросів.</para
></listitem>
      </varlistentry>
      <!-- not in 4.4
      <varlistentry>
        <term>
          <menuchoice>
            <guimenu
>File</guimenu>
            <guisubmenu
>New From Template</guisubmenu>
            <guimenuitem
>Use Recent</guimenuitem>
          </menuchoice>
        </term>
        <listitem
><para
>Presents a list of files recently used as
            templates, represented by their &URL;.</para
></listitem>
      </varlistentry>
      -->
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Створити з шаблона</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Інші пункти підменю міститимуть посилання на шаблони. Оберіть пункт меню, щоб створити файл у спосіб, описаний у тексті пункту меню.</para
></listitem>
      </varlistentry>

      <!-- Settings menu -->

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Параметри</guimenu
> <guimenuitem
>Керування шаблонами...</guimenuitem
></menuchoice
></term>
        <listitem
><para
>Вибір цього пункту призведе до відкриття діалогового вікна зі списком всіх шаблонів, знайдених у каталогах шаблонів, а також пунктами для додавання, зміни і вилучення шаблонів.</para
></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

  <sect2 id="katefiletemplates-use">
    <title
>Користування шаблоном &kate;</title>
    <para
>Під час створення файла з шаблона, у якому містяться макроси шаблона, деякі макроси буде показано у тексті як придатні для редагування змінні. Такі змінні виглядатимуть у тексті як підкреслені слова.</para>
    <para
>Першу зі змінних буде обрано, отже вам просто слід почати вводити інформацію, щоб змінити її значення. Якщо текст документа містить інші включення цієї з змінної, всі ці включення буде замінено на введений вами текст. Щоб перейти до наступної придатної для редагування змінної, натисніть клавішу Tab. Після визначення останньої зі змінних, список буде закрито, а клавіша Tab вашої клавіатури запрацює у звичному режимі.</para>
  </sect2>

  <sect2 id="katefiletemplates-create">
    <title
>Створення ваших власних шаблонів</title>
    <para
>Щоб створити новий шаблон, скористайтесь пунктом меню <menuchoice
><guimenu
>Параметри</guimenu
> <guimenuitem
>Керування шаблонами</guimenuitem
></menuchoice
>, за допомогою якого можна відкрити діалогове вікно керування шаблонами. У цьому вікні натисніть кнопку <guibutton
>Створити...</guibutton
>, щоб запустити Майстер створення нового шаблона. Програма запитає вас про назву необов’язкового файла, який слід перетворити на шаблон, а також про параметри відомостей про шаблон, а потім створить для вас файл шаблона.</para
> <para
>Крім того, ви можете створити шаблон вручну, додаванням відомостей про шаблон у верхню частину будь-якого файла, додаванням тексту і макросів, а потім збереженням файла з назвою, яка завершуватиметься суфіксом <filename
>katetemplate</filename
>.</para>
    <para
>Якщо ви збережете ваш шаблон у каталозі шаблонів, меню шаблонів буде відповідним чином автоматично оновлено.</para>
  </sect2>

  <sect2 id="katefiletemplates-edit">
    <title
>Редагування шаблонів</title>
    <para
>Щоб змінити шаблон, скористайтеся пунктом меню <menuchoice
><guimenu
>Параметри</guimenu
> <guimenuitem
>Керування шаблонами...</guimenuitem
></menuchoice
>. Оберіть шаблон, з яким ви бажаєте попрацювати і натисніть кнопку <guibutton
>Редагувати...</guibutton
>, — програма відкриє відповідний файл шаблона. Закрийте це діалогове вікно, змініть файл шаблона бажаним чином, збережіть його і закрийте. Зміни, виконані у шаблоні, негайно набудуть чинності, — ви можете задіяти шаблон і перевірити результат ваших змін одразу після збереження шаблона.</para>
  </sect2>

  <sect2 id="katefiletemplates-format">
    <title
>Формат шаблона &kate;</title>
    <para
>Якщо ви використовуватимете файли, назви яких мають суфікс <filename
>katetemplate</filename
>, програма знайде записані у них відомості про шаблон, макроси і дані про розташування курсора.</para>

    <sect3 id="katefiletemplates-template-info">
      <title
>Відомості про шаблон</title>
      <para
>Під час читання такого файла, інструмент обробки виявлятиме рядки, які починаються виразами <constant
>katetemplate:</constant
> і шукатиме у них відомості про шаблон у вигляді НАЗВА_ЗМІННОЇ=ЗНАЧЕННЯ. Перший же рядок, який починатиметься не з <constant
>katetemplate:</constant
> вважатиметься початком вмісту шаблона. ЗНАЧЕННЯ може складатися з будь-яких символів, окрім знака рівності (=). Можливими назвами змінних є: <variablelist>
          <varlistentry>
            <term
><varname
>Шаблон</varname
></term>
            <listitem
><para
>Це назва шаблона, яку буде показано у меню <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Створити з шаблона</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Group</varname
></term>
            <listitem
><para
>Група, у якій буде розміщено шаблон у підменю <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Створити з шаблона</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><varname
>Name</varname
></term>
            <listitem
><para
>Це назва, яку буде встановлено для документа і показано у списку файлів і смужці заголовка. Якщо назва міститиме шаблон заміни <userinput
>%N</userinput
>, цей шаблон буде замінено на число, яке збільшуватиметься зі збільшенням кількості документів з однаковою назвою.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Highlight</varname
></term>
            <listitem
><para
>Додаток намагатиметься встановити підсвічування у новому документі відповідно до значення цієї змінної. Значенням має бути назва, одна з тих, які можна знайти у меню <menuchoice
><guimenu
>Інструменти</guimenu
> <guimenuitem
>Підсвічування</guimenuitem
> </menuchoice
>. Назву слід вказувати англійською мовою.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Description</varname
></term>
            <listitem
><para
>Короткі описові відомості про шаблон. У поточній версії цей пункт використовується для показу підказки «Що це?» для пункту меню, але цю інформацію у майбутніх версіях може бути використано і з іншою метою.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>Author</term>
            <listitem
><para
>Рядок, що визначає автора, наприклад у формі <userinput
>Ім’я &lt;адреса електронної пошти&gt;</userinput
>. У поточній версії цей пункт використовується для показу підказки «Що це?» для пункту меню, але цю інформацію у майбутніх версіях може бути використано і з іншою метою.</para
></listitem>
          </varlistentry>
        </variablelist>
      </para>

    </sect3>

    <sect3 id="katetemplates-macros">
      <title
>Макроси шаблона</title>

      <para
>Під час обробки вмісту шаблона, буде розгорнуто макроси у формі <userinput
>%{НАЗВА}</userinput
> або <userinput
>${НАЗВА}</userinput
>. Якщо ви скористаєтеся префіксом <userinput
>$</userinput
>, розгорнутий макрос буде вважатися придатною для зміни змінною під час створення документа з шаблона, а якщо ви скористаєтеся префіксом <userinput
>%</userinput
>, така змінна не вважатиметься придатною для зміни, і спроба розгортання завершиться невдало.</para>
      <para
>Розгортаються такі макроси: <variablelist>
          <varlistentry
><term
><literal
>time</literal
></term>
            <listitem
><para
>Розгортається до поточного часу у форматі вашої локалі.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>date</literal
></term>
            <listitem
><para
>Розгортається до поточної дати у форматі вашої локалі.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>datetime</literal
></term>
            <listitem
><para
>Розгортається до поточної дати і часу, зібраних у вигляді рядка, відповідно до вашої локалі.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>year</literal
></term>
            <listitem
><para
>Поточний рік у вигляді числа з чотирьох цифр.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>month</literal
></term>
            <listitem
><para
>Повна назва поточного місяці, відповідно до вашої локалі.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>day</literal
></term>
            <listitem
><para
>Розгортається до поточного дня місяця.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>hostname</literal
></term>
            <listitem
><para
>Розгортається до назви вузла вашого комп’ютера у мережі.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>index</literal
></term>
            <listitem
><para
>Розгортається до «i».</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>fullname</literal
></term>
            <listitem
><para
>Розгортається до повної форми вашого імені у тому вигляді, у якому її вказано у адресі власника вашої стандартної адресної книги &kde;.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>firstname</literal
></term>
            <listitem
><para
>Розгортається до вашого імені у тому вигляді, у якому його вказано у адресі власника вашої стандартної адресної книги &kde;.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>lastname</literal
></term>
            <listitem
><para
>Розгортається до вашого прізвища у тому вигляді, у якому його вказано у адресі власника вашої стандартної адресної книги &kde;.</para>
            </listitem>
          </varlistentry>
          <!-- <varlistentry>
            <term
>username</term>
            <listitem
><para
>Expands to your username.</para
></listitem>
          </varlistentry
> -->
          <varlistentry>
            <term
>email</term>
            <listitem
><para
>Розгортається до вашої адреси електронної пошти у тому вигляді, у якому її вказано у адресі власника вашої стандартної адресної книги &kde;.</para
></listitem>
          </varlistentry>
          <!--<varlistentry>
            <term
>organisation</term>
            <listitem
><para
>This is your organisation, as defined by
                the owner address in your standard KDE
                addressbook.</para
></listitem>
          </varlistentry
>-->
        </variablelist>
      </para>
      <para
>Всі макроси, які не належать до наведеного вище списку, вважатимуться змінними придатними для перевизначення, незалежно від префікса. Якщо у шаблоні використано декілька включень однієї змінної, після створення документа з шаблона заміна цих включень текстом відбуватиметься одночасно у всіх місцях документа.</para>
    </sect3>

    <sect3 id="katefiletemplates-cursor">
      <title
>Встановлення розташування курсора</title>
      <para
>Особливий макрос <userinput
>${cursor}</userinput
> буде замінено на вертикальну риску і додано у кінець списку придатних для редагування змінних, незалежно від його розташування у тексті.</para>
    </sect3>

  </sect2>
  <sect2>
    <title
>Подяки</title>
    <para
>Авторські права на додаток до &kate; <quote
>Шаблони файлів</quote
> належать  &Anders.Lund; &Anders.Lund.mail;, ©2004. </para>
    <para
>Авторські права на документацію до додатка належать &Anders.Lund;, ©2004</para>
  </sect2>
</sect1>

<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1 id="kate-application-plugin-xmlcheck">
<sect1info>
<authorgroup
><author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
><address
>&Daniel.Naber.mail;</address
></affiliation>
</author
></authorgroup>
</sect1info>

<title
>Перевірка &XML;</title>

<para
>За допомогою цього додатка можна перевірити належний формат і коректність файлів &XML;.</para>
<para
>За допомогою цього додатка можна перевірити коректність поточного файла. Список попереджень і помилок буде показано у нижній частині головного вікна &kate;. Ви можете натиснути повідомлення про помилку, щоб перевести фокус програми на відповідне місце у тексті документа. Якщо у тексті документа є теґ <quote
>DOCTYPE</quote
> для перевірки документа на коректність буде використано саме вказаний цим теґом DTD. Пошук файла DTD буде проводитися відносно розташування файла поточного документа, тобто, якщо тим документа вказано як <quote
>DTD/xhtml1-transitional.dtd</quote
>, а файл документа знаходиться за адресою <filename
>/home/peter/test.xml</filename
>, програма очікуватиме, що файл DTD знаходиться за адресою <filename
>/home/peter/DTD/xhtml1-transitional.dtd</filename
>. Додатком підтримується і зовнішні DTD, вказані за допомогою http-адреси.</para>

<para
>Якщо у файлі не встановлено параметр doctype, файл буде перевірено на належне форматування.</para>

<para
>Щоб дізнатися більше про перевірку &XML;, відвідайте <ulink url="http://www.w3.org/XML/"
>офіційні сторінки W3C, присвячені &XML;</ulink
>.</para>

<para
>Для виконання своїх завдань цей додаток викликає зовнішню програму <command
>xmllint</command
>, яка є частиною libxml2. Якщо цю програму у вашій системі не було встановлено належним чином, цей додаток не працюватиме.</para>

<note
><para
>Під час роботи додаток створює тимчасовий файл у тій самій теці, що і файл, який слід перевірити на коректність, отже ваш користувач системи повинен мати доступ на запис до цієї теки.</para
></note>

<para
>Щоб завантажити цей додаток, відкрийте діалогове вікно налаштування &kate; за допомогою пункту меню <menuchoice
><guimenu
>Параметри</guimenu
> <guimenuitem
>Налаштувати &kate;...</guimenuitem
></menuchoice
>. Після цього позначте пункт <guilabel
>Перевірка XML</guilabel
> на сторінці <guilabel
>Програма</guilabel
>/<guilabel
>Додатки</guilabel
> і закрийте діалогове вікно. </para>

<sect2 id="xmlcheck-menu">
<title
>Структура меню</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Перевірити XML</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>За допомогою цього пункту меню можна запустити перевірку, яку було описано раніше.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmlcheck-thanks-and-acknowledgements">
<title
>Подяки</title>
<para
>Авторські права на додаток до &kate; <quote
>Перевірка XML</quote
> належать &Daniel.Naber; &Daniel.Naber.mail;, ©2002 </para>
<para
>Авторські права на документацію до додатка належать &Daniel.Naber;, ©2002</para>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-xmltools">
<sect1info>
<authorgroup
><author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
><address
>&Daniel.Naber.mail;</address
></affiliation>
</author
></authorgroup>
</sect1info>
<title
>Доповнення &XML;</title>

<para
>Цей додаток надаватиме вам підказки щодо того, які з елементів є дозволеними на певній позиції у файлі &XML;, відповідно до обмежень DTD цього файла. Програма покаже вам список можливих елементі, атрибутів, значень атрибутів або об’єктів, залежно від позиції курсора (наприклад, якщо символом, що знаходиться ліворуч від курсора, є <quote
>&amp;</quote
>, буде показано список всіх об’єктів). Додаток також може завершувати найближчий незакритий теґ, розташований ліворуч.</para>

<para
>Для роботи додатка потрібен файл <acronym
>DTD</acronym
> у форматі &XML;, створений програмою на Perl <command
>dtdparse</command
>. DTD у такому форматі називається <quote
>мета-DTD</quote
>. Деякі з мета-DTD встановлюються разом з програмою. Їх можна знайти у каталозі <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, який також є типовим під час використання функції додатка <guimenuitem
>Призначити мета-DTD...</guimenuitem
>. Щоб мати змогу створювати ваші власні мета-DTD, вам слід звантажити програму <command
>dtdparse</command
> за адресою <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect2 id="xmltools-how-to-use">
<title
>Як користуватися</title>

<para
>Щоб завантажити цей додаток, відкрийте діалогове вікно налаштування &kate; за допомогою пункту меню <menuchoice
><guimenu
>Параметри</guimenu
> <guimenuitem
>Налаштувати &kate;...</guimenuitem
></menuchoice
>. Після цього позначте пункт <guilabel
>Перевірка XML</guilabel
> на сторінці <guilabel
>Програма</guilabel
>/<guilabel
>Додатки</guilabel
> і закрийте діалогове вікно.</para>

<para
>Тепер ви зможете скористатися додатком, після набору таких символів у тексті:</para>

<variablelist>

<varlistentry>
<term
><keycap
>&lt;</keycap
> (клавіша знак «менше»)</term>
<listitem
><para
>Натискання цієї клавіші відкриє список можливих елементів, якщо курсор ще не знаходиться усередині теґу. Зауважте, що у поточній версії ви ще не можете скористатися цією можливістю для вставки елемента найвищого рівня (наприклад <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&lt;</keycap
><keycap
>/</keycap
> (клавіша знак «менше» + клавіша похилої риски)</term>
<listitem
><para
>Введення цих символів призведе до виводу панелі з пропозицією завершення поточного елемента (найближчого елемента ліворуч від курсора). Натисніть &Enter;, щоб прийняти пропозицію. На відміну від пункту меню <guimenuitem
>Завершити елемент</guimenuitem
>, комбінація символів працюватиме лише у разі призначення DTD.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>"</keycap
> (клавіша лапок)</term>
<listitem
><para
>Після введення лапок буде відкрито список можливих значень атрибута (якщо такий існує), якщо курсор знаходиться всередині теґу.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&nbsp;</keycap
> (клавіша пробілу)</term>
<listitem
><para
>Після введення цього символу додаток відкриє список можливих атрибутів для поточного елемента, якщо курсор знаходиться всередині теґу.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&amp;</keycap
> (клавіша амперсанда)</term>
<listitem
><para
>За допомогою цієї клавіші можна викликати список іменованих об’єктів.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-features-and-limitations">
<title
>Можливості і обмеження</title>

<para
>Ви можете перевірити всі функціональні можливості і обмеження завантаженням файла <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> до &kate; з наступним виконанням настанов з цього файла.</para>

</sect2>


<sect2 id="xmltools-menu">
<title
>Структура меню</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Return</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Вставити елемент...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Відкриє діалогове вікно, за допомогою якого ви зможете вставити елемент &XML;. Символи &lt; та &gt;, а також завершальний теґ буде вставлено автоматично. Якщо ви під час вибору цього пункту меню було позначено фрагмент тексту, позначений текст буде вставлено між початковим та завершальним теґами. За допомогою цього діалогового вікна також можна буде завершувати запис всіх елементів, які вставляються у поточній позиції курсора, якщо ви призначили загальний DTD за допомогою пункту меню <guimenuitem
>Призначити мета-DTD...</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>XML</guimenu
> <guimenuitem
>Завершити елемент</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Якщо ви скористаєтеся цим пунктом меню, програма виконає у вашому документі пошук теґу, який ще не було завершено, і вставить до тексту відповідний завершальний теґ. Пошук буде розпочато з позиції курсора і продовжено у напрямку ліворуч. Якщо програмі не вдасться знайти жодного незакритого теґу, ніяких дій зі зміни тексту виконано не буде.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>Призначити мета-DTD...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>За допомогою цього пункту меню ви зможете повідомити додатку, який з файлів мета-DTD слід використовувати для поточного документа. Зауважте, що додаток не зберігатиме даних вашого вибору. Вам доведеться повторити процедуру визначення після наступного запуску &kate;.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-thanks-and-acknowledgements">
<title
>Подяки</title>
<para
>Авторські права на додаток до &kate; <quote
>Доповнення &XML;</quote
> належать &Daniel.Naber; &Daniel.Naber.mail;, 2001, 2002. </para>
<para
>Версія для KDE SC 4, © Tomáš Trnka, 2010</para>
<para
>Авторські права на документацію до додатка належать &Daniel.Naber;, 2001, 2002.</para>
</sect2>

</sect1>

<sect1 id="kate-application-plugin-quickswitcher">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Швидке перемикання між документами</title>

<sect2 id="quickswitcher-menu">
<title
>Структура меню</title>

<variablelist>
<varlistentry
> 
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>1</keycap
> </keycombo
></shortcut
><guimenu
>Перехід</guimenu
><guimenuitem
>Швидке перемикання</guimenuitem
></menuchoice
></term>
<listitem
><para
>Відкриває вікно <guilabel
>Швидке перемикання документів</guilabel
> з полем пошуку та списком відкритих файлів. Введення тексту до поля пошуку призведе до фільтрування списку за назвами та адресами документів. Для навігації списком документів можна використовувати клавіші зі стрілкою <keysym
>↑</keysym
> і <keysym
>↓</keysym
>. Після натискання кнопки <guilabel
>Гаразд</guilabel
> додаток перемкне перегляд на документ, який було позначено у списку. Це спрощує перемикання між документами, якщо у редакторів відкрито дуже багато документів. </para
></listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1>

<sect1 id="kate-editor-plugin-exporter">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Інструмент експортування</title>

<sect2 id="exporter-menu">
<title
>Структура меню</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Експортувати як HTML...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Експортувати ваш файл у форматі &HTML;, так щоб ваш документ можна було переглянути як вебсторінку. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Зміни</guimenu
> <guimenuitem
>Копіювати як HTML...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Копіює виділений текст, разом з підсвічуванням синтаксису, як текст HTML.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-findinfiles">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Пошук у файлах</title>

<sect2 id="findinfiles-menu">
<title
>Структура меню</title>
<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>Зміни</guimenu
> <guimenuitem
>Знайти у файлах...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Відкриває діалогове вікно <guilabel
>Знайти у файлах</guilabel
>, за допомогою якого ви зможете виконати пошук тексту у файлах або теці.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Перегляд</guimenu
><guisubmenu
>Вікна інструментів</guisubmenu
> <guimenuitem
>Показати Пошук у файлах</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Вмикає або вимикає показ інструменту <guilabel
>Пошук у файлах</guilabel
> &kate;. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-searchinfiles">
<sect1info>
<authorgroup
><author
><firstname
>T.C.</firstname
> <surname
>Hollingsworth</surname
> <affiliation
><address
><email
>tchollingsworth@gmail.com</email
></address
></affiliation>
</author
></authorgroup>
</sect1info>
<title
>Пошук у файлах</title>

<sect2 id="searchinfiles-intro">
<title
>Вступ</title>
<para
>За допомогою додатка пошуку у файлах &kappname; ви зможете шукати фрагмент тексту або текст за <link linkend="regular-expressions"
>формальним виразом</link
> у декількох файлах одночасно. Пошук може виконуватися у всіх відкритих файлах або всіх файлах у одному каталозі і, якщо потрібно, у всіх його підкаталогах. Шукати можна з фільтруванням за назвою файлів, наприклад шукати лише файли з певним суфіксом назви.</para>

<para
>Типово, додаток пошуку у файлах не увімкнено, оскільки він є новим у &kappname; 3.7. Увімкнути його можна за допомогою сторінки <link linkend="config-dialog-plugins"
>Додатки</link
> діалогового вікна налаштування &kappname;. Він замінить попередню версію <link linkend="kate-application-plugin-findinfiles"
>додатка пошуку у файлах</link
> у наступній версії &kappname;.</para>

</sect2>

<sect2 id="searchinfiles-ui">
<title
>Інтерфейс</title>

<sect3 id="searchinfiles-ui-query">
<title
>Запит з пошуку</title>

<para
>У верхній частині панелі інструмента пошуку у файлах завжди буде показано такі пункти:</para>

<variablelist>

<varlistentry>
<term
><guiicon
>Створити вкладку</guiicon
></term>
<listitem
><para
>Ви можете відкрити довільну кількість панелей пошуку одночасно. Просто натисніть кнопку <guibutton
>Створити вкладку</guibutton
> у верхній лівій частині панелі інструмента пошуку, і програма відкриє нову вкладку, за допомогою якої можна буде виконати пошук за новими критеріями. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>Запит</term>
<listitem
><para
>Довге поле для введення тексту у верхній частині панелі призначено для введення критерію пошуку. Ви можете ввести звичайний фрагмент тексту або формальний вираз, якщо увімкнено пошук за формальними виразами. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Шукати</guibutton
></term>
<listitem
><para
>Після того, як параметри пошуку буде налаштовано, достатньо натиснути кнопку <guibutton
>Шукати</guibutton
>, щоб пошук було розпочато. Ви також можете просто натиснути клавішу &Enter; після введення тексту запиту. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Розташування</guimenu
></term>
<listitem
><para
>Тут ви можете вибрати один з двох варіантів. Позначте пункт <guilabel
>у відкритих файлах</guilabel
>, щоб пошук було виконано у файлах, які відкрито у &kappname;. За допомогою позначення пункту <guilabel
>у теці</guilabel
> можна наказати програмі виконати пошук у теці і, якщо потрібно, її підтеках. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenu
>Параметри</guimenu
></term>
<listitem
><para
>Передбачено два варіанти. Якщо позначено пункт <guilabel
>З врахуванням регістру</guilabel
>, виконуватиметься пошук лише точних відповідників комбінації великих та малих літер, вказаної у полі запиту пошуку. За допомогою позначення пункту <guilabel
>Формальні вирази</guilabel
> ви можете скористатися для пошуку за запитом <link linkend="regular-expressions"
>формальними виразами</link
> замість простих текстових фрагментів. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Вмикання/Вимикання показу результатів</guiicon
></term>
<listitem
><para
>За допомогою кнопки зі стрілочкою, спрямованою вниз, розташованої у правому верхньому куті панелі пошуку у файлах, ви можете перемикати нижню половину панелі між режимом показу додаткових параметрів пошуку у теці та режимом показу результатів пошуку. </para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-folder">
<title
>Параметри пошуку у теці</title>

<para
>Ці параметри буде показано під раніше згаданими параметрами пошуку. Якщо замість них буде показано результати пошуку, натисніть кнопку <guiicon
>Вмикання/Вимикання показу результатів</guiicon
>, щоб програма їх показала. Параметри буде враховано, лише якщо увімкнено режим пошуку у теці. Якщо вказано режим пошуку у відкритих файлах, відповідні пункти налаштувань буде вимкнено.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Тека</guilabel
></term>
<listitem
><para
>Ви можете вказати адресу теки, у якій слід виконати пошук. Наприклад, ви можете ввести <userinput
>~/development/kde/kate/</userinput
>, якщо пошук слід виконати у початковому коді &kate;. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Діалогове вікно відкриття файлів</guiicon
></term>
<listitem
><para
>Натисніть цю кнопку, щоб вказати теку за допомогою діалогового вікна перегляду ієрархії тек. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Вгору</guiicon
></term>
<listitem
><para
>Натисніть цю кнопку, щоб змінити значення у полі <guilabel
>Тека</guilabel
> на батьківську теку поточної позначеної теки. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Відновити поточну теку</guiicon
></term>
<listitem
><para
>За допомогою цієї кнопки можна змінити значення у полі <guilabel
>Тека</guilabel
> на адресу теки, у якій зберігається поточний відкритий документ. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Фільтр</guilabel
></term>
<listitem
><para
>За допомогою цього поля можна наказати програмі виконувати пошук лише у тих файлах, назви яких відповідають певному шаблону. Наприклад, якщо потрібно виконати пошук лише у файлах початкових кодів мовою C++, вкажіть <userinput
>*.cpp</userinput
>. Щоб пошук було виконано лише у файлах, назви яких починаються на <literal
>kate</literal
>, вкажіть <userinput
>kate*</userinput
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Рекурсивний</guilabel
></term>
<listitem
><para
>Якщо буде позначено цей пункт, &kappname; виконуватиме пошук у всіх підтеках вказаної вами теки. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Шукати у прихованих</guilabel
></term>
<listitem
><para
>Якщо буде позначено цей пункт, &kappname; виконуватиме пошук у файлах та теках, які позначено як приховані у вашій операційній системі. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Переходити за символічними посиланнями</guilabel
></term>
<listitem
><para
>Типово, інструмент пошуку у файлах не здійснює переходів за <ulink url="http://en.wikipedia.org/wiki/Symbolic_link"
>символічними посиланнями</ulink
>. Якщо буде позначено цей пункт, під час пошуку здійснюватиметься перехід за символічними посиланнями та пошук у файлах, на які вони посилаються. </para>
<warning
><para
>Символічні посилання можуть бути посиланнями на теку, яка є батьківською щодо тієї, у якій виконується пошук, або на теку, у якій міститься символічне посилання на її батьківську теку. Якщо у теці для пошуку є таке посилання, &kappname; виконуватиме перехід за кожним з посилань і пошук у відповідній теці, отже пошук не буде завершено у автоматичному режимі.</para
></warning>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-results">
<title
>Результати пошуку</title>

<para
>Результати пошуку буде показано під параметрами пошуку. Якщо замість них показано параметри пошуку у теці, просто натисніть кнопку <guiicon
>Вмикання/Вимикання показу результатів</guiicon
>, щоб програма їх показала. Їх також буде автоматично показано після завершення пошуку.</para>

<para
>Результати пошуку буде показано у форматі таблиці з трьома стовпчиками, які міститимуть дані щодо кожного з результатів пошуку. У стовпчику <guilabel
>Файл</guilabel
> буде показано назву файла. У стовпчику <guilabel
>Рядок</guilabel
> — номер рядка у якому було виявлено відповідник запиту щодо пошуку. У стовпчику <guilabel
>Текст</guilabel
> буде показано рядок повністю.</para>

<para
>Щоб відкрити файл, у якому було виявлено рядок, просто двічі клацніть лівою кнопкою миші на його пункті. &kappname; відкриє файл, якщо його ще не відкрито, і розташує курсор на початку фрагмента тексту, який відповідає запиту.</para>

</sect3>
</sect2>

<sect2 id="searchinfiles-menu">
<title
>Структура меню</title>
<variablelist>

<!--<varlistentry>
<term>
<menuchoice>
<guimenu
>Edit</guimenu>
<guimenuitem
>Find in Files...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para
>Launch the <guilabel
>Find in Files</guilabel
> dialog to allow you to
search for text in the files of a folder.</para>
</listitem>
</varlistentry
>-->

<varlistentry>
<term>
<menuchoice
><guimenu
>Перегляд</guimenu
><guisubmenu
>Вікна інструментів</guisubmenu
> <guimenuitem
>Показати Пошук у файлах</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Вмикає або вимикає показ інструменту <guilabel
>Пошук у файлах</guilabel
> &kappname;. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-mail">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Надсилання файлів поштою</title>

<sect2 id="mail-menu">
<title
>Структура меню</title>
<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Надіслати лист...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Відкрити ваш клієнт електронної пошти і долучити файл до повідомлення, створеного у ньому. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-fsbrowser">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Навігатор файловою системою</title>

<para
>Навігатор файлової системи — це переглядач тек, за допомогою якого ви зможете відкривати файли з показаної у навігаторі теки у поточному фреймі.</para>

<sect2 id="fsbrowser-menu">
<title
>Структура меню</title>
<variablelist>

<varlistentry>
<term>
<anchor id="view-toolviews-show-fileselector"/>
<menuchoice
><guimenu
>Перегляд</guimenu
><guisubmenu
>Вікна інструментів</guisubmenu
> <guimenuitem
>Показати Навігатор файлової системи</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Вмикає або вимикає показ переглядача файлової системи &kate;</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="fsbrowser-interface">
<title
>Інтерфейс</title>

<para
>Перелічимо всі елементи навігатора файлової системи, починаючи згори:</para>

<variablelist>
<varlistentry>
<term
>Панель інструментів</term>
<listitem>
<para
>На цій панелі містяться стандартні кнопки інструментів навігації:</para>
<variablelist>
<varlistentry>
<term
><guibutton
>Назад</guibutton
></term>
<listitem
><para
>За допомогою цієї кнопки можна повернути переглядач тек до перегляду попередньої теки з журналу перегляду. Якщо попередніх тек у журналі немає, цю кнопку буде вимкнено.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Вперед</guibutton
></term>
<listitem
><para
>За допомогою цієї кнопки можна повернути переглядач тек до перегляду наступної теки з журналу перегляду. Якщо наступних тек у журналі немає, цю кнопку буде вимкнено.</para
></listitem>
</varlistentry>
<!--varlistentry>
<term
><guibutton
>Parent Folder</guibutton
></term>
<listitem
><para
>This will cause the folder view to <command
>cd</command
> to the immediate parent of the currently displayed
folder if possible.</para
></listitem>
</varlistentry-->
<varlistentry>
<term
><guibutton
>Закладки</guibutton
></term>
<listitem
><para
>Ця кнопка відкриває підменю, за допомогою якого ви змінити або додати закладку, а також створити нову теку закладок.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Поточна тека документа</guibutton
></term>
<listitem
><para
>За допомогою цієї кнопки можна перевести фокус переглядача тек на теку, де зберігається файл поточного документа, якщо це можливо. Якщо поточний документ є новим, ще не збереженим, або теку, де зберігається файл документа не може бути визначено, цю кнопку буде вимкнено.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Параметри</guibutton
></term>
<listitem>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Стислий вигляд</guimenuitem
></term>
<listitem
><para
>За натискання цієї кнопки у переглядачі буде показано лише назви файлів.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Детальний вигляд</guimenuitem
></term>
<listitem
><para
>За натискання цієї кнопки у переглядачі буде показано дані про <guilabel
>Назву</guilabel
>, <guilabel
>Дату створення</guilabel
>, <guilabel
>Розмір</guilabel
> і <guilabel
>Тип</guilabel
> файлів.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Ієрархічний вигляд</guimenuitem
></term>
<listitem
><para
>Подібний до скороченого вигляду, але теки можна розгортати для перегляду їхнього вмісту.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Детальний ієрархічний вигляд</guimenuitem
></term>
<listitem
><para
>У цьому режимі також можна розгортати теки, але буде показано додаткові стовпчики даних з детального вигляду.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Показувати приховані файли</guimenuitem
></term>
<listitem
><para
>Показує файли, які зазвичай приховуються вашою операційною системою.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Автоматично синхронізувати з поточним документом</guimenuitem
></term>
<listitem
><para
>Якщо позначено цей пункт, інструмент перегляду файлової системи автоматично переходитиме до теки поточного відкритого документа у разі зміни цього документа.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Запис розташування</term>
<listitem>
<para
>Показує панель послідовної навігації до поточної відкритої теки, подібно до &dolphin;. Для переходу до будь-якої з тек просто клацніть на її назві. Ви також можете натиснути кнопку зі стрілочкою поряд з назвою теки, щоб відкрити список підтек цієї теки. Натискання першого з пунктів навігації з зображенням піктограми певного місця у вашій системі відкриє список панелі «Місця».</para>

<para
>Ви можете клацнути лівою кнопкою миші праворуч від поля послідовної навігації і ввести шлях до теки, вміст якої слід показати у переглядачі тек. У рядку &URL;-адреси передбачено підказку у вигляді списку раніше введених адрес. Ви можете обрати одну з цих адрес за допомогою натискання кнопки зі стрілочкою, розташованої праворуч від рядка адреси.</para>
<tip
><para
>У рядку &URL;-адреси передбачено автоматичне доповнення назв тек. Спосіб доповнення можна обрати за допомогою контекстного меню поля адреси (викликати це меню можна за допомогою клацання правою кнопкою миші).</para
></tip>
</listitem>
</varlistentry>

<varlistentry>
<term
>Перегляд тек</term>
<listitem
><para
>Це стандартне вікно перегляду тек &kde;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Поле фільтрування</term>
<listitem>
<para
>За допомогою поля фільтрування ви зможете ввести шаблон для файлів, які буде показано у переглядачі тек. У шаблоні можна використовувати стандартні замінники; декілька шаблонів слід відокремлювати один від одного пробілами. Приклад: <userinput
>*.cpp *.h *.moc</userinput
></para>
<para
>Щоб було показано всі файли, просто введіть у поле фільтрування символ зірочки, <userinput
>*</userinput
>.</para>
<para
>У полі фільтрування передбачено запам’ятовування останніх 10 шаблонів, щоб скористатися одним з них, натисніть кнопку зі стрілочкою, розташовану праворуч від поля, і виберіть потрібний рядок шаблону зі списку. Ви можете вимкнути фільтр натисканням кнопки <guibutton
>Вилучити текст</guibutton
>, розташованої ліворуч від кнопки автоматичного доповнення.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>


<sect2 id="fsbrowser-config">
<title
>Налаштування</title>

<para
>Налаштувати цей додаток можна на сторінці <guilabel
>Навігатор файлової системи</guilabel
> діалогового вікна <link linkend="configuring-kate-configdialog"
>налаштування &kate;</link
>.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Панель інструментів</guilabel
></term>
<listitem
><para
>Тут можна налаштувати перелік кнопок на панелі навігатора файлової системи: пересуньте потрібні кнопки, які ви бажаєте додати на панель, до списку <guilabel
>Вибраних дій</guilabel
>, впорядкувати кнопки можна за допомогою кнопок зі стрілочками, розташованих збоку від списку.</para>
 </listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<!--some material from mdi.docbook needs to be migrated here too-->
<sect1 id="kate-application-plugin-exttools">
<!--<sect1info>
<authorgroup
><author>
<firstname
>T.C.</firstname>
<surname
>Hollingsworth</surname>
<affiliation
><address
>tchollingsworth@gmail.com</address
></affiliation>
</author
></authorgroup>
</sect1info
>-->
<title
>Зовнішні інструменти</title>

<para
>У меню <guimenu
>Інструменти</guimenu
> ви можете знайти підменю з назвою <guisubmenu
>Зовнішні інструменти</guisubmenu
>, якщо ви увімкнули якісь з цих інструментів у налаштуваннях &kate;. За допомогою відповідних пунктів меню можна відкрити вікна зовнішніх програм з даними, що стосуються поточного документа, наприклад його URL, каталогом, текстом або виділеним фрагментом документа.</para>

<para
>Перелік зовнішніх інструментів визначається користувачем, ви можете додавати, змінювати або вилучати інструменти за допомогою панелі налаштування <link linkend="exttools-config"
>зовнішніх інструментів</link
>. </para>

<sect2 id="exttools-menu">
<title
>Структура меню</title>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Інструменти</guimenu
><guisubmenu
>Зовнішні інструменти</guisubmenu
></menuchoice
></term>
<listitem
><para
>У цьому підменю ви знайдете записи всіх зовнішніх інструментів, які ви налаштували.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="exttools-config">
<title
>Налаштування</title>

<para
>Зовнішні інструменти можна налаштувати за допомогою сторінки <guilabel
>Зовнішні інструменти</guilabel
> діалогового вікна <link linkend="configuring-kate-configdialog"
>налаштування &kate;</link
>. Інструментами використовуються зовнішні програми, яким буде передано дані, пов’язані з поточним документом, зокрема його адресу, каталог зберігання, текст або позначений фрагмент тексту. За допомогою цієї сторінки ви можете керувати меню, редагувати, вилучати або додавати пункти нових інструментів.</para>

<para
>Кожен з зовнішніх інструментів визначається командою оболонки разом з макросом, що відповідає даним документа. Після активування пункту інструменту цей макрос буде замінено даними з активного документа.</para>

<variablelist>
<title
>Наявні команди</title>

<varlistentry>
<term
><guibutton
>Створити</guibutton
></term>
<listitem
><para
>Додати новий зовнішній інструмент до списку. Відкриває список властивостей, описаний нижче, для налаштування зовнішнього інструмента.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Змінити</guibutton
></term>
<listitem
><para
>Змінити поточний позначений зовнішній інструмент за допомогою списку властивостей, описаного нижче.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Вставити роздільник</guibutton
></term>
<listitem
><para
>Додає лінію-роздільник, яку буде показано у меню після поточного позначеного пункту.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Стрілка вгору</guibutton
></term>
<listitem
><para
>Пересуває поточний позначений пункт у позицію над попереднім.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Стрілка вниз</guibutton
></term>
<listitem
><para
>Пересуває поточний позначений пункт у позицію під наступним пунктом.</para
></listitem>
</varlistentry>

</variablelist>

<variablelist>
<title
>Властивості зовнішніх інструментів</title>
<varlistentry>
<term
><guilabel
>Мітка</guilabel
></term>
<listitem
><para
>Зрозумілий підпис який буде показано у меню <guisubmenu
>Зовнішні інструменти</guisubmenu
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Піктограма</guibutton
></term>
<listitem
><para
>Надає вам змогу вибрати піктограму, яку буде показано поруч з написом у меню <guisubmenu
>Зовнішні інструменти</guisubmenu
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Скрипт</guilabel
></term>
<listitem
><para
>Скрипт, який слід виконати, коли буде активовано інструмент. Перед передаванням скрипту оболонці буде виконано таку заміну макросів: <variablelist>
<varlistentry>
<term
><userinput
>%URL</userinput
></term>
<listitem
><para
>Повна адреса URL поточного документа або порожній рядок, якщо документ ще не було збережено.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%URLs</userinput
></term>
<listitem
><para
>Список адрес URL всіх відкритих документів, відокремлений комами (окрім ще не збережених документів).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%directory</userinput
></term>
<listitem
><para
>Назва каталогу з адрес URL поточних документів або порожній рядок, якщо поточний документ ще не було збережено.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%filename</userinput
></term>
<listitem
><para
>Назва файла поточного документа без шляху до нього або порожній рядок, якщо поточний документ ще не було збережено.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%line</userinput
></term>
<listitem
><para
>Номер рядка, де знаходиться курсор вставки у поточному документі.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%column</userinput
></term>
<listitem
><para
>Номер позиції, у якому розташовано курсор вставки у поточному документі.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%selection</userinput
></term>
<listitem
><para
>Позначений текст у поточному документі або порожній рядок, якщо не позначено тексту.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%text</userinput
></term>
<listitem
><para
>Весь текст у поточному документі. Пам’ятайте, що використання цього макросу може призвести до перевищення системного обмеження на максимальну довжину командного рядка. Користуйтеся подібним макросом з осторогою.</para
></listitem>
</varlistentry>

</variablelist>

</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Виконуваний файл</guilabel
></term>
<listitem
><para
>Основний виконуваний файл скрипту. Цей пункт є обов’язковим, він використовується для перевірки можливості запуску скрипту. Якщо цей файл не знаходиться у одному з каталогів, описаних у змінній <envar
>PATH</envar
>, вам слід буде вказати шлях до нього повністю.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Типи MIME</guilabel
></term>
<listitem
><para
>Список типів MIME, відокремлених комами, для яких слід увімкнути цю команду.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Зберегти</guilabel
></term>
<listitem
><para
>За бажання, ви можете вказати, чи слід зберігати поточний документ або всі документи перед виконанням скрипту. Це може знадобитися, якщо ваш скрипт читає дані з диска.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Назва командного рядка</guilabel
></term>
<listitem
><para
>Якщо ви заповните це поле, доступ до цієї команди можна буде отримати за допомогою <link linkend="advanced-editing-tools-commandline"
>командного рядка редактора</link
> як <command
>exttool-<replaceable
>Назва командного рядка</replaceable
></command
> (рядок, який ви тут введете буде додано до <quote
>exttool-</quote
>).</para
></listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<!--
Missing (according to config docs)
Additional pages for enabled plugins: 
Kate Snippets
Backtrace Browser
Symbol Viewer
-->
</chapter>
