<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; передбачено декілька типів додатків. Додатки поділяються ще на два типи: деякі з них написано мовою C++, інші ж написано мовою програмування Python. Між цими додатками є невеличкі відмінності, які буде обговорено нижче.</para>

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

<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-backtracebrowser"
>Переглядач зворотного трасування</link
> допоможе вам переглянути дані зворотного трасування</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-build"
>Додаток збирання</link
> — компілює або збирає програми і обробляє повідомлення про помилки.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-closeexceptlike"
>Додаток закриття за критерієм</link
> — закрити групу документів на основі даних щодо спільного для них розташування у файловій системі або суфікса назви файла.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-ctags"
>Додаток CTags</link
> виконує пошук визначень або оголошень за допомогою CTags.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-documentswitcher"
>Перемикач між документами</link
> — налаштовування швидкого перемикання документів за допомогою натискання комбінації клавіш <keycombo action="simul"
>&Alt;&Tab;</keycombo
>.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-fsbrowser"
>Переглядач файлової системи</link
> — панель засобу навігації файловою системою</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-documents"
>Додаток документів</link
> показує структуру відкритих файлів.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-gdb"
>&gdb;</link
> — надає доступ до простої графічної оболонки до &gdb;</para>
</listitem>
<!--from workspace/plasma-sdk, why picked up here?
<listitem>
<para
>Icon picker - Invokes Cuttlefish icon picker</para>
</listitem>
-->
<listitem>
<para
><link linkend="kate-application-plugin-lumen"
>Lumen</link
> — додаток автоматичного доповнення коду мовою D, якому використано сервер доповнення DCD.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-openheader"
>Відкрити заголовок</link
> — відкриває відповідний файл .h/[.cpp|.c].</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-projects"
>Додаток проектів</link
> — додаток проектів для Kate.</para>
</listitem>
<listitem>
<para
>Replicode</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-rust"
>Доповнення коду Rust</link
> — доповнення коду для інструкцій мовою Rust.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-searchinfiles"
>Панель інструмента «Пошук з заміною»</link
> — панель засобу, який дає змогу шукати дані у відкритих файлах або у файлах файлової системи.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-snippets"
>Панель фрагментів</link
> — вбудована панель для керування фрагментами.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-sql"
>Додаток SQL</link
> — виконання запитів до баз даних SQL.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-symbolviewer"
>Переглядач символів</link
> призначено для добування і показу символів з початкового коду.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-konsole"
>Панель інструмента термінала</link
> — вбудування віджета термінала у вікно програми.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-textfilter"
>Фільтр тексту</link
> — просте фільтрування тексту.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>Доповнення &XML;</link
> — показує список елементів, атрибутів, значень атрибутів та об’єктів &XML;, передбачених у DTD.</para>
</listitem>
<listitem>
<para
>Додаток <link linkend="kate-application-plugin-xmlcheck"
>Перевірка &XML;</link
> перевіряє коректність файлів &XML; за допомогою xmllint.</para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="kate-application-plugin-backtracebrowser">
<!--https://kate-editor.org/2008/08/12/kate-fast-backtrace-navigation/-->
<title
>Додаток перегляду зворотного трасування</title>

<sect2 id="backtracebrowser-using">
<title
>Користування додатком перегляду зворотного трасування</title>

<para
>Цей додаток призначено в основному для розробників, а не для звичайних користувачів. За його допомогою можна переглянути дані зворотного трасування, які створено за допомогою gdb, у форматі списку у вікні інструмента &kate;. Наведенням вказівника миші на пункт у цьому списку із наступним клацанням лівою кнопкою миші можна відкрити відповідний файл і перейти у ньому до відповідного рядка коду. Такий спосіб навігації працює із даними зворотного трасування, які створено не лише на вашому комп’ютері: ви можете скористатися даними інших користувачів, якщо файли коду розташовано у однакових місцях. Для роботи інструментів додатка слід проіндексувати каталоги, у яких зберігаються файли із початковим кодом програми. </para>

<para
>Іноді може існувати декілька файлів із однаковою назвою. Приклад:</para>

<simplelist>
<member
><filename
>kdegraphics/okular/generators/dvi/config.h</filename
></member>
<member
><filename
>kdepim-runtime/resources/gmail/saslplugin/config.h</filename
></member>
</simplelist>

<para
>Для того, щоб зробити правильний вибір, у додатку використовуються останні дві частини адреси, у нашому прикладі такі:</para>

<simplelist>
<member
><filename
>dvi/config.h</filename
></member>
<member
><filename
>saslplugin/config.h</filename
></member>
</simplelist>

<para
>Зазвичай, додаток визначає належний файл автоматично.</para>

<para
>Одночасне індексування основної і бічних гілок розробки, звичайно ж, призведе до конфлікту.</para>

</sect2>

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

<para
>На сторінці налаштовування можна додати каталоги, у яких міститься початковий код програми.</para>

<screenshot id="screenshot-backtrace-settings">
<screeninfo
>Переглядач зворотного трасування</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="backtrace-settings.png" format="PNG"/></imageobject>
<caption
>Налаштовування шляхів у вікні інструмента перегляду зворотного трасування</caption>
</mediaobject>
</screenshot>

<para
>Натисканням кнопки <guibutton
>Гаразд</guibutton
> можна дозволити програмі розпочати індексування. Після завершення індексування можна відкрити вікно інструмента <guilabel
>Перегляд зворотного трасування</guilabel
>.</para>
<para
>Після цього можна завантажити дані зворотного трасування з буфера обміну даними (наприклад, після натискання кнопки <guibutton
>Копіювати до буфера</guibutton
> у DrKonqi) або з файла.</para>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-build">
<!--http://kate-editor.org/2011/06/21/kate-plugin-updates-part-1/ -->
<sect1info>
<authorgroup>
<author
><firstname
>Salma</firstname
> <surname
>Sultana</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Додаток для збирання</title>

<sect2 id="build-intro">
<title
>Вступ</title>

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

</sect2>

<sect2 id="build-using">
<title
>Користування додатком збирання</title>

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

<screenshot id="screenshot-build-output">
<screeninfo
>Вивід збирання</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="build-output.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>На панелі <guilabel
>Вивід збирання</guilabel
> передбачено дві вкладки:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Параметри цілі</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Вивід</guilabel
></para
></listitem>
</itemizedlist>

<sect3 id="build-using-target-settings">
<title
>Вкладка «Параметри цілі»</title>

<para
>Вкладкою «Параметри цілі» можна скористатися для налаштовування різноманітних цілей збирання та визначення наборів збирання.</para>

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

<para
>Для нового набору цілей передбачено декілька параметрів налаштовування:</para>

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

<varlistentry>
<term
><guilabel
>Зібрати</guilabel
></term>
<listitem
><para
>За допомогою цього пункту можна визначити команду збирання. Типовою командою збирання є <command
>make</command
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Спорожнити</guilabel
></term>
<listitem
><para
>За допомогою цього пункту можна визначити команду очищення. Типовою командою очищення є <command
>make clean</command
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Налаштування</guilabel
></term>
<listitem
><para
>За допомогою цього пункту можна визначити команду налаштовування збирання. Типовою командою є <command
>cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../</command
>.</para
></listitem>
</varlistentry>
</variablelist>

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

<simplelist>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="dialog-ok-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — зібрати позначену ціль</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="list-add-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — додати нову ціль збирання</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-new-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — створити набір цілей збирання</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="edit-copy-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — копіювати команду або набір цілей</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="edit-delete-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — вилучити поточну команду або набір цілей</member>
</simplelist>

</sect3>

<sect3 id="build-using-output">
<title
>Вкладка «Вивід»</title>

<para
>На вкладці <guilabel
>Вивід</guilabel
> буде показано повідомлення, виведені під час виконання останньої команди.</para>

<para
>Скористайтеся повзунком у верхній частині вікна, щоб наказати програмі показувати або приховувати категорії повідомлень:</para>

<para
><guilabel
>Виведені дані повністю</guilabel
>, <guilabel
>Оброблені виведені дані</guilabel
>, <guilabel
>Помилки і попередження</guilabel
> або <guilabel
>Лише помилки</guilabel
> </para>

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

<!--FIXME: These shortcuts now seem to be used by the Project plugin as well.
            https://bugs.kde.org/show_bug.cgi?id=328170 -->
<para
>Щоб перейти до місця попередньої помилки, натисніть комбінацію клавіш <keycombo action="simul"
>&Ctrl;&Alt;<keysym
>←</keysym
></keycombo
>. Щоб перейти до наступної помилки, натисніть комбінацію клавіш <keycombo action="simul"
>&Ctrl;&Alt;<keysym
>→</keysym
></keycombo
>.</para>

</sect3>
</sect2>

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

<variablelist id="build-build">
<varlistentry>
<term
><menuchoice id="build-targets"
><guimenu
>Збирання</guimenu
><guisubmenu
>Вибрати ціль</guisubmenu
> </menuchoice
></term>
<listitem
><para
>Надає змогу вибрати одну з цілей, налаштованих користувачем.</para
></listitem>
</varlistentry>

<varlistentry id="build-default">
<term
><menuchoice
><guimenu
>Збирання</guimenu
><guimenuitem
>Зібрати типову ціль</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Збирає ціль, визначену як типову у активному наборі цілей.</para
></listitem>
</varlistentry>

<varlistentry id="build-previous">
<term
><menuchoice
><guimenu
>Збирання</guimenu
><guimenuitem
>Зібрати попередню ціль</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Перейти до попередньої цілі, налаштованої користувачем.</para
></listitem>
</varlistentry>

<varlistentry id="build-stop">
<term
><menuchoice
><guimenu
>Збирання</guimenu
> <guimenuitem
>Зупинити</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Припинити збирання цілі.</para
></listitem>
</varlistentry>

<varlistentry id="build-previous-error">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>←</keysym
></keycombo
></shortcut
> <guimenu
>Збирання</guimenu
><guimenuitem
>Попередня помилка</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Пересуває курсор до місця попередньої помилки у документі.</para
></listitem>
</varlistentry>

<varlistentry id="build-next-error">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>→</keysym
></keycombo
></shortcut
> <guimenu
>Збирання</guimenu
><guimenuitem
>Наступна помилка</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Пересуває курсор до місця наступної помилки у документі.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="build-ack">
<title
>Подяки</title>
<para
>Додаток збирання &kate; створено Kåre Särs.</para>
<para
>Особлива подяка учасниці Google Code-In 2011 Salma Sultana за написання більшої частини цього розділу.</para>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-closeexceptlike">

<title
>Додаток закриття за критерієм</title>

<sect2 id="closeexceptlike-intro">
<title
>Вступ</title>

<para
>За допомогою цього додатка можна закрити групу документів на основі вказаних даних щодо суфікса назви і шляху.</para>

</sect2>

<sect2 id="closeexceptlike-using">
<title
>Користування додатком закриття за критерієм</title>

<para
>Нехай у &kate; відкрито такі документи:</para>

<simplelist>
<member
>/tmp/subfolder/test.h</member>
<member
>/tmp/test.cpp</member>
<member
>/tmp/test.txt</member>
</simplelist>

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

<screenshot id="screenshot-closeexceptlike">
<screeninfo
>Закрити, окрім</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="close-except-like.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

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

</sect2>

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

<variablelist>
<varlistentry id="file-close-except">
<term
><menuchoice
><guimenu
>Файл</guimenu
> <guisubmenu
>Закрити, окрім</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Закрити</action
> усі відкриті документи, <emphasis
>окрім</emphasis
> тих, які за шляхом або суфіксом назви збігаються із варіантом, вибраним за допомогою підменю.</para>
</listitem>
</varlistentry>

<varlistentry id="file-close-like">
<term
><menuchoice
><guimenu
>Файл</guimenu
> <guisubmenu
>Закрити подібні</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Закрити</action
> усі відкриті документи, які за шляхом або суфіксом назви збігаються із варіантом, вибраним за допомогою підменю.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>


<sect1 id="kate-application-plugin-ctags">
<!--https://kate-editor.org/2012/11/02/using-the-projects-plugin-in-kate/-->
<title
>Додаток CTags</title>

<sect2 id="ctags-intro">
<title
>Вступ</title>

<para
><ulink url="https://en.wikipedia.org/wiki/Ctags"
>CTags</ulink
> створює файл покажчика (або файл міток) об’єктів мови, які буде знайдено у файлах початкового коду. Після створення такого файла об’єкти можна буде швидко і просто знайти за допомогою цього додатка до &kate;. </para>
<para
>Мітка позначає об’єкт мови програмування, для якого існує запис у покажчику (або, інакше кажучи, запис покажчика для цього об’єкта).</para>

<para
>Створення міток можливе для <ulink url="http://ctags.sourceforge.net/languages.html"
>цих мов програмування</ulink
>. </para>
</sect2>

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

<para
>Додаток CTags використовує два різних файли баз даних для зберігання даних покажчика.</para>

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

<sect3 id="ctags-config-common">
<title
>Загальний покажчик</title>

<screenshot id="screenshot-ctags-global-settings">
<screeninfo
>Параметри CTags</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="ctags-global-setting.png" format="PNG"/></imageobject>
<caption
>Налаштовування загальної бази даних CTags</caption>
</mediaobject>
</screenshot>

<para
>За допомогою нижньої частини сторінки налаштовування ви можете вказати <guilabel
>Команду CTags</guilabel
>. </para>

<para
>Щоб дізнатися більше про усі доступні параметри, будь ласка, ознайомтеся із сторінкою підручника (man) CTags. Прочитати цю сторінку можна у «Центрі довідки» (&khelpcenter;). Крім того, можна просто ввести адресу <emphasis
>man/:ctags</emphasis
> безпосередньо у поле для адреси вікна &konqueror; </para>

<para
>Натискання кнопки <guibutton
>Оновити</guibutton
> накаже програмі розпочати індексування. Коли індексування буде завершено, закрийте діалогове вікно.</para>
</sect3>

<sect3 id="ctags-config-session">
<title
>Покажчик сеансу</title>

<para
>Щоб налаштувати покажчик сеансу, відкрийте панель <guilabel
>CTags</guilabel
>.</para>

<variablelist>
<varlistentry>
<term
><menuchoice>
<guimenu
>Цілі індексування</guimenu>
</menuchoice
></term>
<listitem>
<para
>За допомогою цієї вкладки ви можете додавати або вилучати записи каталогів, які містять початковий код програми, і вручну запускати процедуру повторного створення специфічної для сеансу бази даних CTags.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice>
<guimenu
>База даних</guimenu>
</menuchoice
></term>
<listitem>
<screenshot id="screenshot-ctags-session-settings">
<screeninfo
>Параметри бази даних</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="ctags-session-setting.png" format="PNG"/></imageobject>
<caption
>Налаштовування бази даних сеансів CTags</caption>
</mediaobject>
</screenshot>
<para
>Вибір іншого файла бази даних CTags, налаштовування команди CTags або повернення до типової команди.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="ctags-using">
<title
>Користування додатком CTags</title>

<para
>Вам достатньо навести вказівник миші на об’єкт мови, зокрема функцію, символ тощо, який вам потрібен, а потім вибрати один із пунктів меню <guimenu
>CTags</guimenu
>, щоб перейти до рядка і файла, де цей об’єкт визначено чи оголошено.</para>
<para
>Типово, із пунктами меню <guimenu
>CTags</guimenu
> не пов’язано жодних клавіатурних скорочень. Якщо вам хочеться визначити такі скорочення, скористайтеся <ulink url="help:/fundamentals/shortcuts.html"
>редактором клавіатурних скорочень</ulink
>.</para>

<para
>Крім того, можна скористатися полем для пошуку на вкладці <guilabel
>Пошук</guilabel
> панелі CTags.</para>
<para
>Після введення перших символів назви об’єкта у поле для пошуку програма спробує знайти відповідні об’єкти мови за назвою. Буде показано відповідні функції, класи, символи тощо разом із даними щодо їхнього типу та назви відповідного файла.</para>
<para
>Позначте пункт у списку, щоб перейти до відповідного рядка у файлі із початковим кодом.</para>
<!--FIXME why Tag Type here but Name Kind in Project plugin, is there really any difference?-->

<!--FIXME completion as in Project plugin? -->

</sect2>

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

<variablelist>

<varlistentry id="ctags-jumpback">
<term
><menuchoice
><guimenu
>CTags</guimenu
> <guisubmenu
>Повернутися на один крок</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Перейти назад за записом журналу щодо останньої відвіданої мітки.</para>
</listitem>
</varlistentry>

<varlistentry id="ctags-lookup">
<term
><menuchoice
><guimenu
>CTags</guimenu
> <guisubmenu
>Шукати поточний текст</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Відкриває вкладку <guilabel
>Пошук</guilabel
> панелі CTags і показує список усіх об’єктів мови, що відповідають поточному позначеному фрагменту тексту.</para>
</listitem>
</varlistentry>

<varlistentry id="ctags-gotodeclaration">
<term
><menuchoice
><guimenu
>CTags</guimenu
> <guisubmenu
>Перейти до оголошення</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Якщо курсор перебуває у межах визначення об’єкта, буде відкритого документ, що містить відповідне оголошення об’єкта, активовано цей документ, а курсор буде пересунуто на початок оголошення.</para>
</listitem>
</varlistentry>

<varlistentry id="ctags-gotodefinition">
<term
><menuchoice
><guimenu
>CTags</guimenu
> <guisubmenu
>Перейти до визначення</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Якщо курсор перебуває у межах оголошення об’єкта, буде відкритого документ, що містить відповідне визначення об’єкта, активовано цей документ, а курсор буде пересунуто на початок визначення.</para>
</listitem>
</varlistentry>

</variablelist>

<!--context menu with Lookup Current Text, Goto Declaration, Goto Definition -->

</sect2>

</sect1>

<sect1 id="kate-application-plugin-documentswitcher">

<title
>Додаток перемикання документів</title>

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

<variablelist>

<varlistentry id="view-documentswitcher">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Tab;</keycombo
> </shortcut
> <guimenu
>Перегляд</guimenu
> <guisubmenu
>Попередні перегляди</guisubmenu
> </menuchoice
></term>
<listitem>

<para
><action
>Відкриває</action
> список останніх переглянутих документів:</para>

<screenshot id="screenshot-documentswitcher">
<screeninfo
>Останні переглянуті документи</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="documentswitcher.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Якщо утримувати натиснутою комбінацію клавіш <keycombo action="simul"
>&Ctrl;&Tab;</keycombo
>, можна скористатися клавішами <keysym
>↑</keysym
>, <keysym
>↓</keysym
>, <keycap
>Home</keycap
> та <keycap
>End</keycap
> для навігації списком. Натисканням клавіші з літерою можна циклічно переходити між усіма пунктами у списку із відповідною першою літерою. Після відпускання натиснутих клавіш програма негайно перемкнеться на поточний позначений документ зі списку. </para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>


<sect1 id="kate-application-plugin-fsbrowser">

<title
>Навігатор файловою системою</title>

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

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

<varlistentry id="view-toolviews-show-filebrowser">
<term
><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
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-previous-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Назад</guiicon
></term>
<listitem
><para
>За допомогою цієї кнопки можна повернути переглядач тек до перегляду попередньої теки з журналу перегляду. Якщо попередніх тек у журналі немає, цю кнопку буде вимкнено.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-next-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Вперед</guiicon
></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
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="bookmarks-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Закладки</guiicon
></term>
<listitem
><para
>Ця кнопка відкриває підменю, за допомогою якого ви змінити або додати закладку, а також створити нову теку закладок.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="system-switch-user-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Поточна тека документа</guiicon
></term>
<listitem
><para
>За допомогою цієї кнопки можна перевести фокус переглядача тек на теку, де зберігається файл поточного документа, якщо це можливо. Якщо поточний документ є новим, ще не збереженим, або теку, де зберігається файл документа не може бути визначено, цю кнопку буде вимкнено.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="games-config-options-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Параметри</guiicon
></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
> файлів.</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>

<sect1 id="kate-application-plugin-documents">
<title
>Список документів</title>
<!-- https://kate-editor.org/2010/09/12/kate-tree-view-plugin-update/-->
<sect2 id="documents-intro">
<title
>Вступ</title>

<para
><indexterm
><primary
>Список документів</primary
></indexterm
> На панелі списку документів ви побачите список всіх документів, які зараз відкрито у &kate;. Поруч з позначками файлів з незбереженими змінами буде показано невеличку піктограму <guiicon
>дискети</guiicon
>, яка позначатиме їх стан.</para>

<para
>Над списком документів розташовано панель інструментів із такими кнопками:</para>

<simplelist>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-new-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — створити документ</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-open-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> відкрити наявний документ</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-up-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — попередній документ</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-down-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — наступний документ</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-save-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — зберегти поточний документ</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-save-as-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> — зберегти поточний документ із новою назвою</member>
</simplelist>

<para
>Типово список документів буде показано у <guimenuitem
>Ієрархічному режимі</guimenuitem
>, у якому програма показує структуру тек навколо поточних відкритих документів. Ним також можна скористатися у <guimenuitem
>Режимі списку</guimenuitem
>, у якому програма показує простий список всіх відкритих документів. Перемкнутися між режимами перегляду можна клацанням правою кнопкою на списку з наступним вибором режиму зі списку <guisubmenu
>Режим перегляду</guisubmenu
>.</para>

<para
>Якщо буде відкрито декілька файлів з однаковою назвою (розташованих у різних теках) у <guimenuitem
>Режимі списку</guimenuitem
>, перед назвою другого з цих файлів ви побачите цифру «(2)», інші файли з тією ж назвою нумеруватимуться послідовно. У контекстній підказці файла буде показано назву файла повністю, разом зі шляхом до теки, де він знаходиться, отже вам буде просто обрати потрібний вам файл зі списку.</para
> <para
>Щоб програма показала документ у поточному активному фреймі, натисніть позначку документа у списку.</para>

<para
>У контекстному меню буде показано деякі з пунктів дій меню <guimenu
>Файл</guimenu
>.</para>

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

<para
>Ви можете впорядковувати список у декілька різних способів за допомогою пункту <guisubmenu
>Впорядкувати за</guisubmenu
> контекстного меню, яке відкривається після клацання правою кнопкою миші, коли вказівник миші знаходитиметься у списку. Серед можливих варіантів впорядкування: <variablelist>

<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>

</para>

<para
>Типово, у списку документів буде показано порядок роботи з документами за допомогою підсвічування у списку документів, з якими ви працювали нещодавно, кольором. Якщо документ було змінено, до кольору буде додано відповідний відтінок. Документи з якими ви працювали останніми буде показано яскравішим кольором, отже вам буде простіше знайти документи, над якими ви працюєте. Цю можливість можна вимкнути за допомогою <link linkend="config-dialog-documents"
>сторінки документів</link
> діалогового вікна налаштування програми.</para>
<para
>Типово, список документів у вікні &kate; розташовано у лівій частині області редагування.</para>

</sect2>

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

<variablelist>

<varlistentry id="view-document-previous">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Alt;<keysym
>↑</keysym
></keycombo
></shortcut
> <guimenu
>Перегляд</guimenu
> <guimenuitem
>Попередній документ</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Відкриває документ, показаний у списку документів перед поточним відкритим документом.</para>
</listitem>
</varlistentry>

<varlistentry id="view-document-next">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Alt;<keysym
>↓</keysym
></keycombo
></shortcut
> <guimenu
>Перегляд</guimenu
> <guimenuitem
>Наступний документ</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Відкриває документ, показаний у списку документів після поточного відкритого документа.</para>
</listitem>
</varlistentry>

<varlistentry id="view-active">
<term
><menuchoice
><guimenu
>Перегляд</guimenu
> <guimenuitem
>Показати активні</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Показує поточний відкритий документ у списку документів.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

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

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

<varlistentry>
<term
><guilabel
>Впорядкувати за</guilabel
></term>
<listitem
><para
>Тут ви можете встановити спосіб впорядкування списку документів. Ви також можете встановити порядок за допомогою контекстного меню списку документів.</para
></listitem>
</varlistentry>

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

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

</variablelist>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-gdb">
<!--http://kate-editor.org/2011/06/23/kate-plugin-updates-part-2/-->
<sect1info>
<authorgroup>
<author
><firstname
>Martin</firstname
> <surname
>Gergov</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Додаток &gdb;</title>

<sect2 id="gdb-intro">
<title
>Вступ</title>

<para
>Додаток &gdb; до &kate; є простою графічною оболонкою до популярного інструмента діагностики виконання програм &GNU;, &gdb;.</para>

<important>
<para
>Користувачам додатка варто спочатку добре ознайомитися з самим &gdb;. Щоб дізнатися більше про те, як користуватися &gdb;, зверніться до <ulink url="http://www.gnu.org/s/gdb/"
>сайта &gdb;</ulink
>.</para>
</important>

<para
>Увімкнути додаток &gdb; можна за допомогою <link linkend="config-dialog-plugins"
>розділу «Додатки» діалогового вікна налаштувань &kate;</link
>.</para>

<para
>Щоб додаток працював належним чином, вам знадобиться файл з кодом (будь-якого підтримуваного у &gdb; типу) та виконуваний файл.</para>

<tip>
<para
>Якщо виконуваний файл збирається за допомогою &gcc;/<command
>g++</command
>, варто скористатися під час збирання параметром командного рядка <command
><parameter
>-ggdb</parameter
></command
>. </para>
</tip>

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

</sect2>

<sect2 id="gdb-menus">
<title
>Структура меню і панелі інструментів</title>

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

<variablelist>

<varlistentry id="gdb-menus-show-debug-view">
<term
><menuchoice
><guimenu
>Перегляд</guimenu
><guisubmenu
>Вікна інструментів</guisubmenu
> <guimenuitem
>Панель налагоджування</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Показує панель з даними, виведеними &gdb;, дані щодо використаного командного рядка &gdb; та інших параметрів.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-show-locals-and-stack">
<term
><menuchoice
><guimenu
>Перегляд</guimenu
><guisubmenu
>Вікна інструментів</guisubmenu
> <guimenuitem
>Показати Локальні і стек викликів</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Показує список всіх завантажених змінних та їхніх значень, а також зворотне трасування &gdb;. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-targets">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
><guisubmenu
>Призначення</guisubmenu
> </menuchoice
></term>
<listitem
><para
>Підменю зі списком призначень (виконуваних файлів). </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-start">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
> <guimenuitem
>Почати налагоджування</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Запускає &gdb; для обробки певного виконуваного файла.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-kill">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
><guimenuitem
>Перервати або припинити налагоджування</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Зупиняє роботу &gdb;.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-restart">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
><guimenuitem
>Перезапустити налагоджування</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Перезапускає &gdb;.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-break">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
><guimenuitem
>Встановити/Зняти точку зупинки</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Встановити або зняти точку зупинки у поточному розташуванні курсора. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-in">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
><guimenuitem
>Увійти</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Виконати поточну інструкцію (буде виконано діагностику виклику функції). </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-over">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
><guimenuitem
>Переступити</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Виконати поточну інструкцію (діагностику виклику функції не буде виконано).</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-out">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
> <guimenuitem
>Вийти</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Поновлює виконання, аж до моменту переривання програми, яка виконується.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-move-pc">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
><guimenuitem
>Пересунути PC</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Пересунути лічильник програми (наступне виконання).</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-run-to-cursor">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
> <guimenuitem
>Виконати до курсора</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Запускає виконання програми до інструкції, у якій зараз перебуває курсор. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-continue">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
><guimenuitem
>Продовжити</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ігнорує всі точки зупинки і виконує програму аж до її переривання (у режимі успішного виконання або у режимі аварійної зупинки).</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-print-value">
<term
><menuchoice
><guimenu
>Налагоджування</guimenu
> <guimenuitem
>Вивести значення</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Виводить значення змінної, на якій перебуває курсор у тексті програми.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-toolbar">
<term
><menuchoice
><guimenu
>Параметри</guimenu
> <guisubmenu
>Показані панелі</guisubmenu
> <guimenuitem
>Додаток &gdb;</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Показати панель налагоджування.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="gdb-debug-view">
<title
>Панель налагоджування</title>

<para
>На панелі <guilabel
>Панель налагоджування</guilabel
> буде показано декілька вкладок: </para>

<variablelist>

<varlistentry>
<term
><guilabel
>Вивід &gdb;</guilabel
></term>
<listitem>
<para
>Містить дані, отримані від &gdb;, та командний рядок &gdb;.</para>

<screenshot id="screenshot-gdb-output">
<screeninfo
>Вкладка «Вивід»</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-output.png" format="PNG"/></imageobject>
<textobject
><phrase
>Вкладка «Вивід».</phrase
></textobject>
<caption
><para
>На вкладці <guilabel
>Вивід</guilabel
> буде показано повідомлення, виведені під час виконання сеансу налагоджування.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Параметри</guilabel
></term>
<listitem>
<variablelist>

<varlistentry>
<term
><guilabel
>Виконуваний файл</guilabel
></term>
<listitem
><para
>Шлях до призначення (виконуваного файла) для виконання діагностики.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Робочий каталог</guilabel
></term>
<listitem
><para
>Поточний робочий каталог, вказаний виконуваному файлу (призначенню). </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Аргументи</guilabel
></term>
<listitem
><para
>Аргументи, передані програмі.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Зберігати фокусування</guilabel
></term>
<listitem
><para
>Зберігає фокусування на командному рядку &gdb;.</para
></listitem>
</varlistentry>

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

</variablelist>

<screenshot id="screenshot-gdb-settings">
<screeninfo
>Діалогове вікно параметрів</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-settings.png" format="PNG"/></imageobject>
<textobject
><phrase
>Діалогове вікно параметрів</phrase
></textobject>
<caption
><para
>У діалоговому вікні <guilabel
>Параметри</guilabel
> буде показано налаштування сеансу налагоджування (діагностики).</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ввід-вивід</guilabel
></term>
<listitem>
<para
>Містить область з даними, виведеними запущеною програмою, та запрошенням командного рядка, за допомогою якого ви можете вводити дані, потрібні програмі.</para>

<screenshot id="screenshot-gdb-io">
<screeninfo
>Вкладка «Ввід-вивід»</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-io.png" format="PNG"/></imageobject>
<textobject
><phrase
>Вкладка «Ввід-вивід».</phrase
></textobject>
<caption
><para
>На вкладці <guilabel
>Ввід-вивід</guilabel
> показано повідомлення, виведені простою тестовою програмою.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="gdb-other">
<title
>Стек викликів і локальні змінні</title>

<para
>На панелі <guilabel
>Стек викликів</guilabel
> буде показано форматовані дані зворотного трасування, отримані від &gdb;.</para>

<screenshot id="screenshot-gdb-call-stack">
<screeninfo
>Панель інструмента стеку викликів &gdb;</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-call-stack.png" format="PNG"/></imageobject>
<textobject
><phrase
>Панель інструмента стеку викликів.</phrase
></textobject>
<caption
><para
>Панель інструмента <guilabel
>Стек викликів</guilabel
> додатка &gdb;. </para
></caption>
</mediaobject>
</screenshot>

<para
>На панелі інструмента <guilabel
>Локальні змінні</guilabel
> буде показано список всіх завантажених зараз змінних програми та їхніх значень.</para>

<screenshot id="screenshot-gdb-locals">
<screeninfo
>Панель інструмента «Локальні змінні» &gdb;</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-locals.png" format="PNG"/></imageobject>
<textobject
><phrase
>Панель інструмента локальних змінних.</phrase
></textobject>
<caption
><para
>Панель інструмента <guilabel
>Локальні змінні</guilabel
> додатка &gdb;. </para
></caption>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="gdb-ack">
<title
>Подяки</title>

<para
>Особлива подяка учаснику Google Code-In 2011 Martin Gergov за написання більшої частини цього розділу.</para>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-lumen">
<!-- https://kate-editor.org/2014/02/20/lumen-a-code-completion-plugin-for-the-d-programming-language/ -->
<title
>Додаток Lumen</title>

<para
>Lumen — додаток, який реалізує автоматично доповнення коду для <ulink url="https://uk.wikipedia.org/wiki/D_(мова_програмування)"
>мови програмування D</ulink
>. Додаток є лише проміжною ланкою між редактором і фоновою службою автоматичного доповнення коду мовою D (сервером, який надає усі дані), яка має назву DCD. У поточній версії додатка передбачено підтримку усіх основних можливостей сервера автоматичного доповнення: передавання серверу імпортованих файлів, показ документації та декілька типів автоматичного доповнення: </para>

<para
>Імпорт:</para>
<screenshot id="screenshot-lumen-import">
<screeninfo
>Імпорт</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="lumen-import.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Базове доповнення:</para>
<screenshot id="screenshot-lumen-completion">
<screeninfo
>Базове доповнення</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="lumen-completition.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Доповнення (перевантажена функція):</para>
<screenshot id="screenshot-lumen-completitionoverload">
<screeninfo
>Доповнення (перевантажена функція)</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="lumen-completition-overload.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Підказки щодо викликів:</para>
<screenshot id="screenshot-lumen-calltips">
<screeninfo
>Підказки щодо викликів</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="lumen-calltips.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Щоб зробити Lumen працездатним, вам слід встановити DCD, для цього скористайтеся даними, які надає <ulink url="https://dlang.org/"
>спільнота D</ulink
>. </para>

<para
>Після встановлення DCD відкрийте для редагування файл <filename
>~/.config/dcd/dcd.conf</filename
> (створіть такий файл, якщо його ще не існує) і додайте шлях до файлів імпортування або включення D у вашій системі, наприклад <filename class="directory"
>/usr/include/dlang/dmd</filename
> або <filename class="directory"
>/usr/include/d</filename
>. </para>

<para
>Крім того, додаток Lumen намагатиметься прочитати дані з файла <filename
>.lumenconfig</filename
> у кожному з батьківських каталогів поточного відкритого файла з кодом D і передати серверу DCD усі рядки з цього файла як шляхи для включення. Вам слід дописати у цей файл усі залежності вашого поточного проекту мовою D. </para>

<para
>Після цього слід запустити сервер автоматичного доповнення за допомогою команди <command
>dcd-server</command
>, увімкнути додаток Lumen у налаштуваннях &kate;, і ви зможете скористатися автоматичним доповненням коду мовою програмування D у &kate; </para>

</sect1>


<sect1 id="kate-application-plugin-openheader">

<title
>Додаток відкриття заголовків</title>

<sect2 id="openheader-using">
<title
>Користування додатком відкриття файлів заголовків</title>

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

<para
>Наприклад, якщо ви редагуєте <filename
>myclass.cpp</filename
>, вибір цього пункту призведе до переходу до редагування <filename
>myclass.h</filename
>, якщо такий файл буде виявлено у тому самому каталозі.</para>

<para
>Додаток здатен пов’язувати між собою файли із такими парами суфіксів назв:</para>

<simplelist>
<member
>Файли заголовків: h, H, hh, hpp</member>
<member
>Файли з кодом: c, cpp, cc, cp, cxx</member>
</simplelist>

</sect2>

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

<variablelist>

<varlistentry id="file-openheader">
<term
><menuchoice
><shortcut
> <keycap
>F12</keycap
> </shortcut
> <guimenu
>Файл</guimenu
> <guisubmenu
>Відкрити .h/.cpp/.c</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Відкрити</action
> відповідні файли заголовків або коду для активного документа.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>


<sect1 id="kate-application-plugin-projects">
<!--https://kate-editor.org/2012/11/02/using-the-projects-plugin-in-kate -->

<title
>Додаток проектів</title>

<sect2 id="project-intro">
<title
>Вступ</title>

<para
>Основне призначення додатка роботи з проектами — створення структурованого списку файлів, які належать до проекту. Реалізовано такі можливості:</para>

<orderedlist>
<listitem
><para
>Надання структурованого перегляду файлів проекту</para
></listitem>
<listitem
><para
>Спрощення і пришвидшення відкриття проектів і перемикання між проектами</para
></listitem>
<listitem
><para
>Підтримка пошуку із заміною у межах проекту</para
></listitem>
<listitem
><para
>Підтримка простого механізму автоматичного доповнення коду</para
></listitem>
<listitem
><para
>Спрощення швидкого відкриття файлів у проекті</para
></listitem>
<listitem
><para
>Підтримка збирання проекту</para
></listitem>
</orderedlist>
</sect2>

<sect2 id="project-view">
<title
>Структурований перегляд файлів</title>

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

<screenshot id="screenshot-project-view">
<screeninfo
>Панель проекту</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-view.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Як можна бачити у нашому прикладі, поточним активним проектом є <quote
>Kate</quote
>, а його вміст показано у форматі ієрархічного списку. Якщо натиснути пункт файла у такому списку, програма відкриє його для редагування. Крім того, передбачено контекстне меню, за допомогою якого можна відкривати файли у інших програмах, зокрема можна відкривати файли <filename class="extension"
>.ui</filename
> за допомогою Qt Designer.</para>
<para
>Фільтрувати список можна ввівши частину назви файла, який ви шукаєте у поле для пошуку, розташоване під списком.</para>
</sect2>

<sect2 id="project-switch">
<title
>Перемикання проектів</title>

<para
>Ідея роботи додатка полягає у тому, що вам ніколи не доведеться відкривати проект вручну (таку можливість, зрештою, взагалі не передбачено). Якщо ви відкриєте якийсь файл, додаток роботи з проектами швидко виконає сканування теки, де він зберігається, і усіх її батьківських тек, і спробує знайти файл <filename
>.kateproject</filename
>. Якщо такий файл буде знайдено, програма автоматично завантажить відповідний проект.</para>

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

</sect2>

<sect2 id="project-search-replace">
<title
>Пошук і заміна у проектах</title>

<para
>У &kate; передбачено додаток пошуку із заміною, сторінку якого буде показано на нижній панелі. Якщо відкрито проект, ви можете розгорнути панель пошуку із заміною і перемкнути додаток на режим пошуку із заміною у поточному проекті:</para>

<screenshot id="screenshot-projects-search">
<screeninfo
>Пошук у проектах</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-search.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="project-autocompletition">
<title
>Просте автоматичне доповнення</title>

<para
>Маючи дані щодо усіх файлів, які належать до проекту, додаток роботи з проектами надає можливості з автоматичного доповнення коду, реалізовані на основі CTags. Під час першого відкриття проекту CTags виконує обробку усіх файлів проекту у фоновому режимі і зберігає усі дані CTags до каталогу <filename class="directory"
>/tmp</filename
>. Отримані дані потім використовуються для заповнення списку контекстної панелі автоматичного доповнення у &kate;.</para>

<para
>Якщо ж відповідні можливості автоматичного доповнення виявляться недоступними, &kate; зможе показувати у списку автоматичного доповнення лише пункти, отримані на основі даних слів з поточного файла. Таким чином, можливості автоматичного доповнення, реалізовані у додатку роботи з проектами є набагато потужнішими за стандартні.</para>

<screenshot id="screenshot-completion-search">
<screeninfo
>Доповнення коду у проектах</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-completition.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Якщо у системі не буде виявлено програм CTags, &kate; повідомить вам про це панеллю нагадування. Крім того, варто зауважити, що файл CTags у <filename class="directory"
>/tmp</filename
> спорожнюється кожного разу, коли ви завершуєте роботу &kate;. Отже, додаток не засмічуватиме теку зайвими застарілими файлами.</para>

</sect2>

<sect2 id="project-quickopen">
<title
>Швидке відкриття файлів</title>

<para
>Оскільки клацання на пунктах файлів у ієрархічному списку не є найшвидшим способом відкрити файл, у &kate; передбачено вбудований механізм швидкого відкриття файлів, активувати який можна за допомогою натискання комбінації клавіш <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>O</keycap
></keycombo
>. У відповідь буде показано список, подібний до цього:</para>

<screenshot id="screenshot-project-quickopen">
<screeninfo
>Швидке відкриття</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-quickopen.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Фільтрувати список можна введенням частини назви файла, який ви шукаєте. Навігацію списком можна здійснювати за допомогою натискання клавіш зі стрілками та клавіш <keycap
>Page Up/Down</keycap
>. Натисканням клавіші &Enter; можна активувати позначений файл. Натискання клавіші &Esc; приховує панель відкриття.</para>

<para
>Крім того, засіб швидкого відкриття запам’ятовує попередні файли. Отже, одразу після розгортання панелі швидкого відкриття буде позначено попередній відкритий файл, — вам достатньо буде натиснути клавішу &Enter;, щоб його відкрити. Іноді, це дуже зручно.</para>

</sect2>

<sect2 id="project-build">
<title
>Підтримка збирання проекту</title>

<para
>Ще однією можливістю є підтримка автоматичного налаштовування <link linkend="projects-build-support"
>додатка збирання</link
>.</para>

</sect2>

<sect2 id="project-create">
<title
>Створення проектів</title>

<sect3 id="project-autoload">
<!--https://kate-editor.org/2014/10/12/autoloading-projects-plugin-kate-5/-->
<title
>Автоматичне завантаження проектів</title>

<para
>У додатку роботи з проектами передбачено можливість автоматичного завантаження. Список файлів формується на основі даних системи керування версіями. Для того, щоб скористатися цією можливістю, вам слід увімкнути відповідну систему керування версіями у параметрах програми (типово увімкнено): </para>

<screenshot id="screenshot-project-configure">
<screeninfo
>Налаштовування додатка роботи з проектами</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-configure.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect3>

<sect3 id="project-manual">
<title
>Створення проектів вручну</title>
<para
>Вам достатньо створити файл <filename
>.kateproject</filename
> у кореневій теці проекту. Наприклад, для <quote
>Kate</quote
> файл <filename
>.kateproject</filename
> містить такі дані: </para>

<screen
>{
  "name": "Kate"
, "files": [ { "git": 1 } ]
}
</screen>

<para
>Вміст файла записується із використанням синтаксису JSON. Проект називається <quote
>Kate</quote
>, а список файлів, які у ньому містяться, отримується з даних git. </para>

<para
>Окрім підтримки <literal
>git</literal
>, передбачено підтримку subversion (<literal
>svn</literal
>) та mercurial (<literal
>hg</literal
>). Якщо ви не хочете, щоб додаток читав дані із системи керування версіями, ви можете наказати йому рекурсивно завантажити файли з каталогів так: </para>

<screen
>{
  "name": "Kate"
, "files": [ { "directory": "kate", "filters": ["*.cpp", "*.h", "*.ui", "CMakeLists.txt", "Find*.cmake"], "recursive": 1 } ]
}
</screen>

<para
>Тут підкаталоги та фільтри визначають те, що є частиною проекту. За допомогою фільтрів також можна поєднувати дані з системи керування версіями і вказані вручну файли. </para>

<para id="projects-build-support"
>Якщо вам потрібно додати підтримку додатка збирання, ви можете вписати до файла <filename
>.kateproject</filename
> такі рядки:</para>

<screen
>{
  "name": "Kate"
, "files": [ { "git": 1 } ]
, "build": {
    "directory": "build"
  , "build": "make all"
  , "clean": "make clean"
  , "install": "make install"
  }
}
</screen>

</sect3>

</sect2>

<sect2 id="project-current">
<title
>Поточний проект</title>

<para
>За допомогою пункту меню <menuchoice
><shortcut
><keycombo action="simul"
>&Alt;<keycap
>1</keycap
></keycombo
></shortcut
> <guimenu
>Проекти</guimenu
><guimenuitem
>Перейти</guimenuitem
></menuchoice
> ви можете відкрити панель <guilabel
>Поточний проект</guilabel
> у нижній частині вікна редактора із такими чотирма вкладками:</para>

<screenshot id="screenshot-project-current">
<screeninfo
>Поточний проект</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-current-analysis.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<variablelist>

<varlistentry>
<term>
<guimenu
>Термінал</guimenu>
</term>
<listitem>
<para
>Запуск <link linkend="kate-application-plugin-konsole"
>емулятора термінала</link
> у кореневій теці проекту.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term>
<guimenu
>Аналіз коду</guimenu>
</term>
<listitem>
<para
>Натисніть пункт <guilabel
>Розпочати аналіз</guilabel
>, щоб запустити статичний аналіз коду мовами програмування C та C++ за допомогою <command
>cppcheck</command
> і отримати звіт із показаними назвами файлів, номерами рядків та рівнем критичності помилки (стильова, попередження тощо) та даними щодо знайденої вади.</para>
<para
>Позначте пункт у списку, щоб перейти до відповідного рядка у файлі із початковим кодом.</para>
</listitem>
</varlistentry>
<!--FIXME options for cppcheck? configurable?-->
<varlistentry>
<term>
<guimenu
>Нотатки</guimenu>
</term>
<listitem>
<para
>Текст, введений на цій вкладці буде збережено у файлі <filename
><replaceable
>назва проекту</replaceable
>.kateproject.notes</filename
>.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="projects-menu">
<title
>Меню «Проекти»</title>

<para
>За допомогою меню <guimenu
>Проекти</guimenu
> ви зможете перемикатися між поточними відкритими проектами. Відповідальним за цей пункт меню є додаток «Проекти».</para>

<variablelist>

<!--FIXME: these shortcuts conflict with the preexisting Build plugin
            https://bugs.kde.org/show_bug.cgi?id=328170 -->

<varlistentry id="projects-back">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>←</keysym
></keycombo
></shortcut
> <guimenu
>Проекти</guimenu
> <guimenuitem
>Назад</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Перемкнутися на попередній проект.</para>
</listitem>
</varlistentry>

<varlistentry id="projects-forward">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>→</keysym
></keycombo
></shortcut
> <guimenu
>Проекти</guimenu
> <guimenuitem
>Вперед</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Перемкнутися на наступний проект.</para>
</listitem>
</varlistentry>

<varlistentry id="projects-goto">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Alt;<keycap
>1</keycap
></keycombo
> </shortcut
> <guimenu
>Проекти</guimenu
><guimenuitem
>Перейти до</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Відкрити панель <guilabel
>Поточний проект</guilabel
> у нижній частині вікна редактора.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>
<!--
context menu Project->Lookup:xxx
-->

</sect1>

<!--FIXME Replicode
Projects Replicode run / stop-->

<sect1 id="kate-application-plugin-rust">
<!--https://blogs.kde.org/2015/05/18/basic-code-completion-rust-kdes-kate-and-later-kdevelop
https://blogs.kde.org/2015/05/22/updates-kates-rust-plugin-syntax-highlighting-and-rust-source-mime-type-->
<title
>Додаток доповнення коду мовою Rust</title>

<para
>За допомогою цього додатка можна користуватися автоматичним доповненням коду мовою програмування <ulink url="https://www.rust-lang.org/"
>Rust</ulink
>.</para>

<para
>Після позначення пункту додатка автоматичного доповнення коду мовою Rust на сторінці додатків, у діалоговому вікні налаштовування &kate; з’явиться нова сторінка. </para>

<screenshot id="screenshot-rust-configuration">
<screeninfo
>Налаштовування додатка Rust</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="rust-configuration.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Можна змінити команду запуску <ulink url="https://github.com/phildawes/racer"
>Racer</ulink
>, програми, призначеної для реалізації можливості автоматичного доповнення коду мовою Rust у редакторах.</para>

<para
>Вам також потрібен код мовою Rust, щоб вказати шлях до ієрархії файлів із кодом. </para>

<para
>Під час введення коду додаток відкриватиме контекстну панель із списком варіантів автоматичного доповнення: </para>

<screenshot id="screenshot-rust-completion">
<screeninfo
>Доповнення коду Rust</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="rust-completion.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

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

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

</sect1>

<sect1 id="kate-application-plugin-searchinfiles">
<sect1info>
<authorgroup
><author
>&TC.Hollingsworth; &TC.Hollingsworth.mail; </author
></authorgroup>
</sect1info>
<title
>Пошук з заміною</title>

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

</sect2>

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

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

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

<variablelist>

<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="tab-new-22.png" format="PNG"/>
</imageobject
></inlinemediaobject
></guiicon
></term>
<listitem
><para
>Ви можете відкрити довільну кількість панелей пошуку одночасно. Просто натисніть кнопку створення вкладки у верхній лівій частині панелі інструмента пошуку, і програма відкриє нову вкладку, за допомогою якої можна буде виконати пошук за новими критеріями. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="games-config-options-22.png" format="PNG"/>
</imageobject
></inlinemediaobject
></guiicon
></term>
<listitem
><para
>За допомогою кнопки, розташованої у правому верхньому куті панелі пошуку у файлах, ви можете перемикати нижню половину панелі між режимом показу додаткових параметрів пошуку у теці та режимом показу результатів пошуку. </para
></listitem>
</varlistentry>

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

<varlistentry>
<term
><guilabel
>Замінити</guilabel
> (поле для введення тексту)</term>
<listitem
><para
>Текст рядка заміни буде додано замість тексту у полі <guilabel
>Знайти</guilabel
>. </para
></listitem>
</varlistentry>

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

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

<varlistentry>
<term
><guibutton
>Далі</guibutton
></term>
<listitem
><para
>Перейти до наступного відповідника вашого критерію пошуку, якщо потрібно, у іншому файлі. </para
></listitem>
</varlistentry>

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

</variablelist>
</sect3>

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

<para
>Ці пункти буде показано під раніше згаданими пунктами параметрів пошуку. Якщо замість них буде показано результати пошуку, натисніть кнопку <guiicon
><inlinemediaobject
><imageobject
> <imagedata fileref="games-config-options-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
>, щоб програма їх показала.</para>

<variablelist>

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

<varlistentry>
<term
><guilabel
>Враховувати регістр</guilabel
></term>
<listitem
><para
>Виконувати пошук лише точних відповідників комбінації великих та малих літер, вказаної у полі запиту пошуку. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Формальні вирази</guilabel
></term>
<listitem
><para
>Надає вам змогу використовувати <ulink url="help:/katepart/regular-expressions.html"
>формальні вирази</ulink
> замість звичайного тексту у запитах. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Розгорнути результати</guilabel
></term>
<listitem
><para
>Показати усі пункти знайдених фрагментів у кожному з файлів, а не просто список файлів, у яких міститься шуканий фрагмент. </para
></listitem>
</varlistentry>

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

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

<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-up-22.png" format="PNG"/>
</imageobject
></inlinemediaobject
></guiicon
></term>
<listitem
><para
>Натисніть цю кнопку, щоб змінити значення у полі <guilabel
>Тека</guilabel
> на батьківську теку поточної позначеної теки. Цим пунктом можна буде скористатися лише у режимі <guilabel
>теки</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="view-refresh-22.png" format="PNG"/>
</imageobject
></inlinemediaobject
></guiicon
></term>
<listitem
><para
>За допомогою цієї кнопки можна змінити значення у полі <guilabel
>Тека</guilabel
> на адресу теки, у якій зберігається поточний відкритий документ. Цим пунктом можна буде скористатися лише у режимі <guilabel
>теки</guilabel
>. </para
></listitem>
</varlistentry>

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

<varlistentry>
<term
><guilabel
>Виключити</guilabel
></term>
<listitem
><para
>Варіант, який є протилежним до <guilabel
>Фільтр</guilabel
>. Забороняє &kate; шукати у файлах, назви яких відповідають певному зразку. Так само, як і у полі <guilabel
>Фільтр</guilabel
>, ви можете вказати декілька зразків, відокремлених комою (<userinput
>,</userinput
>). Цим пунктом можна буде скористатися, якщо пошук виконується у режимі <guilabel
>у відкритих файлах</guilabel
>. </para
></listitem>
</varlistentry>

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

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

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

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

</variablelist>
</sect3>

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

<para
>Результати пошуку буде показано під параметрами пошуку. Якщо замість них показано параметри пошуку у теці, просто натисніть кнопку <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="games-config-options-22.png" format="PNG"/> </imageobject
></inlinemediaobject
></guiicon
>, щоб програма їх показала. Їх також буде автоматично показано після завершення пошуку.</para>

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

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

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

</sect3>
</sect2>

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

<variablelist>

<varlistentry id="edit-searchinfiles">
<term
><menuchoice
><guimenu
>Зміни</guimenu
> <guimenuitem
>Пошук у файлах</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Відкриває панель засобу «Пошук з заміною».</para>
</listitem>
</varlistentry>

<varlistentry id="edit-next-match">
<term
><menuchoice
><guimenu
>Зміни</guimenu
> <guimenuitem
>Перейти до наступного відповідника</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Перейти до наступного відповідника під час пошуку за допомогою додатку «Пошук з заміною».</para>
</listitem>
</varlistentry>

<varlistentry id="edit-previous-match">
<term
><menuchoice
><guimenu
>Зміни</guimenu
> <guimenuitem
>Перейти до попереднього відповідника</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Перейти до попереднього відповідника під час пошуку за допомогою додатку «Пошук з заміною».</para>
</listitem>
</varlistentry>

<varlistentry id="view-toolviews-searchandreplace">
<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-snippets">
<sect1info>
<authorgroup>
<author
><firstname
>Martin</firstname
> <surname
>Gergov</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Фрагменти тексту Kate</title>

<sect2 id="snippets-intro">
<title
>Вступ</title>
<para
>Інструмент «Фрагменти тексту Kate» — додаток, призначений для раціонального використання ваших зусиль за допомогою так званих «фрагментів» (характерних частин коду мовою програмування, комп’ютерних команд або тексту). У додатку передбачено підтримку автоматичного доповнення коду та JavaScript.</para>
</sect2>

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

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

<varlistentry id="tools-create-snippet">
<term
><menuchoice
><guimenu
>Інструменти</guimenu
> <guimenuitem
>Створити фрагмент</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Створити фрагмент, тобто придатний до повторного використання фрагмент тексту, який можна буде потім вставити у довільну частину будь-якого документа.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="snippets-panel">
<title
>Панель фрагментів</title>

<screenshot id="screenshot-snippets-panel">
<screeninfo
>Панель фрагментів тексту Kate</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-panel.png" format="PNG"/></imageobject>
<textobject
><phrase
>Панель фрагментів тексту &kate;.</phrase
></textobject>
<caption
><para
>Панель для фрагментів тексту &kate;.</para
></caption>
</mediaobject>
</screenshot>

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

<sect3 id="snippets-repo-internet">
<title
>Завантаження файлів сховища фрагментів</title>
<para
>Ви можете отримати сховища фрагментів з інтернету. Просто натисніть кнопку <guibutton
>Отримати нові фрагменти</guibutton
> і програма покаже вікно зі списком сховищ фрагментів. Після отримання потрібного вам сховища не забудьте позначити його пункт, щоб згодом скористатися вмістом сховища.</para>
<!--FIXME no way to load a local file ?
<para
>You can also load snippet repositories from a local file using the file
browser at the bottom of the panel.  Click <guibutton
>Copy to repository</guibutton>
when finished.</para
>-->
</sect3>

<sect3 id="snippets-repo-editor">
<title
>Створення і редагування сховищ фрагментів</title>

<para
>Щоб створити нове сховище фрагментів, натисніть кнопку <guibutton
>Додати сховище</guibutton
>. У відповідь має бути відкрито діалогове вікно, у якому програма попросить вас вказати назву файла фрагментів, умови ліцензування цього файла та його автора. Після визначення бажаних параметрів натисніть кнопку <guibutton
>Гаразд</guibutton
>, щоб відкрити вікно редактора фрагментів.</para>

<screenshot id="screenshot-snippets-repository">
<screeninfo
>Редактор фрагментів</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-repository.png" format="PNG"/></imageobject>
<textobject
><phrase
>Редактор даних сховища.</phrase
></textobject>
<caption
><para
>Інтерфейс редактора сховища.</para
></caption>
</mediaobject>
</screenshot>

<para
>У редакторі даних сховища фрагментів можна визначити такі поля:</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Name</guilabel
></term>
<listitem
><para
>Буде показано у списку фрагментів панелі інструментів, а також використовуватиметься під час пошуку варіантів для автодоповнення.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Простір назв</guilabel
></term>
<listitem
><para
>Префікс, що використовується під час доповнення коду.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ліцензія</guilabel
></term>
<listitem
><para
>Виберіть умови ліцензування даних вашого сховища фрагментів.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Автори</guilabel
></term>
<listitem
><para
>Вкажіть імена авторів файла фрагментів.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Типи файлів</guilabel
></term>
<listitem
><para
>Виберіть типи файлів, до яких будуть застосовуватися дані зі сховища. Типово встановлено значення <quote
>*</quote
>, тобто сховище застосовуватиметься до всіх файлів. Ви можете змінити тип, наприклад визначити <userinput
>C++</userinput
>, або вибрати значення зі списку, який відкривається натисканням кнопки пунктів. Ви можете вказати декілька типів файлів, якщо натиснете клавішу &Shift; під час їхнього додавання.</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="snippets-editor">
<title
>Створення і редагування фрагментів</title>

<screenshot id="screenshot-snippets-form">
<screeninfo
>Редактор фрагментів</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-form.png" format="PNG"/></imageobject>
<textobject
><phrase
>Редактор фрагментів.</phrase
></textobject>
<caption
><para
>Інтерфейс редактора фрагментів.</para
></caption>
</mediaobject>
</screenshot>

<variablelist>

<varlistentry>
<term
><guilabel
>Name</guilabel
></term>
<listitem
><para
>Цю назву буде показано у списку автозавершення.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Скорочення</term>
<listitem
><para
>Натискання цієї комбінації клавіш призведе до вставлення фрагмента до документа.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Фрагменти</guilabel
></term>
<listitem
><para
>Текст, який ваш фрагмент вставлятиме до документа.</para>
<para
>Фрагмент може містити придатні до редагування поля. Циклічний перехід цими полями можна здійснювати натисканням клавіші &Tab;. У тексті шаблона можна використовувати такі вирази для створення полів:</para>
<para
><userinput
>${<replaceable
>назва_поля</replaceable
>}</userinput
> створює просте придатне до редагування поле. Під час редагування усі наступні вставки тієї самої <replaceable
>назви_поля</replaceable
> будуть дзеркальними копіями вмісту першого поля.</para>
<para
><userinput
>${<replaceable
>назва_поля=типове значення</replaceable
>}</userinput
> може бути використане для визначення типового значення поля. Вмістом фрагмента <replaceable
>типове значення</replaceable
> може бути будь-який вираз JavaScript.</para>
<para
><userinput
>${<replaceable
>назва_поля</replaceable
>=<replaceable
>текст</replaceable
>}</userinput
> — вказати фіксований рядок як типове значення.</para>
<para
><userinput
>${функція(<replaceable
>інше_поле</replaceable
>, <replaceable
>інше_поле</replaceable
>, ...)}</userinput
> — цим можна скористатися для створення поля, яке міститиме результат виконання функції JavaScript під час кожного редагування. Докладнішу інформацію можна знайти на вкладці <guilabel
>Скрипти</guilabel
>.</para>
<para
><userinput
>${курсор}</userinput
> — цим можна скористатися для того, щоб вказати кінцеву позицію курсора після заповнення усіх інших даних.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Скрипти</guilabel
></term>
<listitem
><para
>Допоміжні функції JavaScript, якими можна скористатися у ваших фрагментах.</para>
<para
>Усі використані функції JavaScript мають повертати рядкові дані, якими ви хочете замінити поле шаблона.</para>
<para
>Функції викликаються у області, яка містить вміст усіх редагованих полів як локальні змінні. Наприклад, у фрагменті, що містить <userinput
>${<replaceable
>поле</replaceable
>}</userinput
>, міститься змінна із назвою <userinput
>поле</userinput
>, яка матиме значення поточного вмісту поля шаблона. Такими змінними у функції можна скористатися або статично, або передати вміст змінних як аргумент функції, використовуючи у рядку фрагмента такий синтаксис: <userinput
>${функція(поле)}</userinput
> або <userinput
>${<replaceable
>поле2=функція(поле)</replaceable
>}</userinput
>.</para>
<para
>Ви можете скористатися програмним інтерфейсом роботи зі скриптами &kate; для отримання позначеного фрагмента тексту, усього тексту документа, назви файла та інших даних за допомогою відповідних методів об’єктів <userinput
>document</userinput
> та <userinput
>view</userinput
>. Щоб дізнатися більше, зверніться до документації із програмного інтерфейсу для роботи зі скриптами.</para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>

<sect2 id="snippets-using">
<title
>Користування фрагментами</title>

<screenshot id="screenshot-snippets-usage">
<screeninfo
>Робота з фрагментами у Kate</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-usage.png" format="PNG"/></imageobject>
<textobject
><phrase
>Доступ до фрагментів &kate; з панелі інструментів або спадного меню.</phrase
></textobject>
<caption
><para
>Вибір зі списку фрагментів.</para
></caption>
</mediaobject>
</screenshot>

<para
>Викликати фрагменти можна у два способи:</para>

<itemizedlist>
<listitem
><para
>Вибором пункту фрагментів на панелі інструментів.</para
></listitem>
<listitem
><para
>Під час написання тексту чи коду ви можете натиснути комбінацію клавіш <keycombo action="simul"
>&Ctrl; <keysym
>Пробіл</keysym
></keycombo
> і програма покаже зручне вікно зі списком всіх фрагментів, за допомогою якого ви зможете вибрати потрібний вам фрагмент. Натискання цієї комбінації клавіш надає доступ до функціональних можливостей, подібних до автоматичного доповнення коду.</para
></listitem>
</itemizedlist>

<para
>Якщо у фрагменті містяться змінні (окрім змінної <literal
>${cursor}</literal
>) курсор буде автоматично пересунуто до першого екземпляра таких змінних, після чого програма перейде у стан очікування на введення тексту. Після введення відповідного значення натисніть клавішу &Tab;, щоб перейти до наступної змінної.</para>

</sect2>

<sect2 id="snippets-ack">
<title
>Подяки</title>
<para
>Розділ щодо роботи з фрагментами у &kate; було написано Джозефом Веніґером (Joseph Wenninger).</para>
<para
>Особлива подяка учаснику Google Code-In 2011 Martin Gergov за написання більшої частини цього розділу.</para>
</sect2>

</sect1>


<sect1 id="kate-application-plugin-sql">
<sect1info>
<authorgroup>
<author
><firstname
>Ömer</firstname
> <othername
>Faruk</othername
> <surname
>ORUÇ</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Додаток SQL</title>

<sect2 id="sql-intro">
<title
>Вступ</title>

<para
>Структурована мова запитів (SQL) — спеціалізована мова, призначена для оновлення, вилучення та отримання даних з баз даних.</para>

<para
>За допомогою додатка SQL &kate; ви зможете виконувати такі дії:</para>

<itemizedlist>
<listitem
><para
>створювати бази даних;</para
></listitem>
<listitem
><para
>встановлювати з’єднання з уже створеною базою даних;</para
></listitem>
<listitem
><para
>вставляти дані у базу даних і вилучати дані з бази даних;</para
></listitem>
<listitem
><para
>надсилати запити до бази даних;</para
></listitem>
<listitem
><para
>переглядати результати у форматі таблиці.</para
></listitem>
</itemizedlist>

</sect2>

<sect2 id="sql-connecting">
<title
>Встановлення з’єднання з базою даних</title>

<para
>Виберіть пункт <guibutton
>Додати з’єднання</guibutton
> з меню <guimenu
>SQL</guimenu
> або відповідний пункт на панелі інструментів, а потім виберіть драйвер бази даних Qt, який слід використовувати (ви можете вибрати QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 або QPSQL). Якщо потрібного вам драйвера немає у списку, вам слід встановити його. Після визначення драйвера натисніть кнопку <guibutton
>Далі</guibutton
>. </para>

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

<para
>Нарешті, надайте вашому з’єднанню назву і натисніть кнопку <guibutton
>Завершити</guibutton
>.</para>

</sect2>

<sect2 id="sql-querying">
<title
>Виконання запитів</title>

<sect3 id="sql-querying-insert-delete-update">
<title
>INSERT/DELETE/UPDATE</title>

<para
>За допомогою додатка SQL ви можете вставляти, вилучати і оновлювати дані так само, як це можна робити із командного рядка чи програми-скрипту. Просто введіть запит на панелі інструментів і натисніть кнопку <guibutton
>Виконати запит</guibutton
> або скористайтеся пунктом меню <menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Виконати запит</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
>).</para>

<example>
<title
>Декілька прикладів запитів</title>
<variablelist>

<varlistentry>
<term
><command
>INSERT</command
></term>
<listitem
><para
><programlisting
>INSERT INTO <replaceable
>назва_таблиці</replaceable
> ("<replaceable
>запис1</replaceable
>", "<replaceable
>запис2</replaceable
>", "<replaceable
>запис3</replaceable
>", "<replaceable
>запис4</replaceable
>", "<replaceable
>запис5</replaceable
>")
VALUES ("<replaceable
>значення1</replaceable
>", "<replaceable
>значення2</replaceable
>", "<replaceable
>значення3</replaceable
>", "<replaceable
>значення4</replaceable
>", "<replaceable
>значення5</replaceable
>" )
</programlisting
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><command
>DELETE</command
></term>
<listitem
><para
><programlisting
>DELETE FROM <replaceable
>назва_таблиці</replaceable
> WHERE name = "<replaceable
>текст</replaceable
>"
</programlisting
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><command
>UPDATE</command
></term>
<listitem
><para
><programlisting
>UPDATE <replaceable
>назва_таблиці</replaceable
> SET "<replaceable
>запис1</replaceable
>" = "<replaceable
>текст</replaceable
>", "<replaceable
>запис2</replaceable
>" = "<replaceable
>текст</replaceable
>", "<replaceable
>запис3</replaceable
>" = "<replaceable
>текст</replaceable
>", "<replaceable
>запис4</replaceable
>" = "<replaceable
>текст</replaceable
>", "<replaceable
>запис5</replaceable
>" = "<replaceable
>текст</replaceable
>"
</programlisting
></para
></listitem>
</varlistentry>

</variablelist>
</example>

</sect3>

<sect3 id="sql-querying-select">
<title
>SELECT</title>

<para
>Після виконання запиту <command
>SELECT</command
> ви зможете переглянути результати у таблиці, яку буде показано на панелі <guilabel
>Вивід даних SQL</guilabel
> у нижній частині вікна &kate; або у текстовому форматі на панелі <guilabel
>Текстовий вивід SQL</guilabel
>. Якщо під час виконання запиту станеться помилка, ви зможете переглянути відповідне повідомлення на панелі текстового виводу.</para>

<example>
<title
>Приклад запиту <command
>SELECT</command
></title>
<para
><programlisting
>SELECT * FROM <replaceable
>назва_таблиці</replaceable
>
</programlisting
></para>
</example>

<para
>На панелі інструментів <guilabel
>Вивід даних SQL</guilabel
> розташовано декілька кнопок:</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
>Копіювати</guibutton
></term>
<listitem
><para
>Позначити весь вміст таблиці і скопіювати його до буфера обміну даними.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Експортувати</guibutton
></term>
<listitem
><para
>Експортувати весь вміст таблиці до файла, буфера обміну даними або поточного документа у форматі тексту, розділеного комами (CSV).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Спорожнити</guibutton
></term>
<listitem
><para
>Вилучає всі дані з перегляду таблиці.</para
></listitem>
</varlistentry>

<!--FIXME Use system locale -->

</variablelist>

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

</sect3>
</sect2>

<sect2 id="sql-browsing">
<title
>Навігація</title>

<para
>Навігацію вашою базою даних можна здійснювати за допомогою панелі інструментів <guilabel
>Схеми бази даних</guilabel
>, розташованої у вікні ліворуч. Перелік показаних на цій панелі даних залежатиме від використаного вами драйвера бази даних.</para>

<para
>Щоб оновити вміст списку, наведіть вказівник миші на вільне місце панелі інструментів і клацніть правою кнопкою миші, потім виберіть у контекстному меню пункт <guimenuitem
>Оновити</guimenuitem
>. Щоб створити запит щодо якогось з записів у списку, наведіть вказівник миші на цей запис, клацніть правою кнопкою миші і виберіть у контекстному меню пункт <guisubmenu
>Створити</guisubmenu
>, а потім виберіть тип запиту (<guimenuitem
>SELECT</guimenuitem
>, <guimenuitem
>UPDATE</guimenuitem
>, <guimenuitem
>INSERT</guimenuitem
> або <guimenuitem
>DELETE</guimenuitem
>) з підменю.</para>

</sect2>

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

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Додати з’єднання...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Додає нове з’єднання за допомогою одного з драйверів баз даних. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Вилучити з’єднання</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Вилучає позначене з’єднання. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Змінити параметри з’єднання...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Змінити параметри поточного з’єднання. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>З'єднання</term>
<listitem
><para
>Всі створені вами з’єднання з базами даних буде показано у списку між пунктами меню <guimenuitem
>Змінити параметри з’єднання</guimenuitem
> та <guimenuitem
>Виконати запит</guimenuitem
>. Щоб надіслати запити до відповідної бази даних або внести зміни до цієї бази даних, просто виберіть один з цих пунктів. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
></shortcut
> <guimenu
>SQL</guimenu
><guimenuitem
>Виконати запит</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Виконати ваш запит. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="sql-ack">
<title
>Подяки</title>

<para
>Додаток SQL було створено Marco Mentasti.</para>
<para
>Особлива подяка учаснику Google Code-In 2011 Ömer Faruk ORUÇ за написання більшої частини цього розділу.</para>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-symbolviewer">
<!--https://kate-editor.org/2010/10/27/php-treeview-improvements-in-kate/?-->
<title
>Додаток перегляду символів</title>

<sect2 id="symbolviewer-using">
<title
>Користування додатком закриття за критерієм</title>

<para
>Цей додаток надає змогу розробникам переглядати символи (функції, макроси і структури) під час редагування початкового коду.</para>
<para
>Клацанням на пунктах обробленої інформації ви можете без проблем здійснювати навігацію кодом.</para>
<para
>У поточній версії передбачено підтримку таких мов:</para>
<para
>C/C++, Java, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk, Fortran</para>

<para
>Список можливостей:</para>
<simplelist>
<member
>Режим списку/дерева</member>
<member
>Вмикання або вимикання упорядковування</member>
<member
>Приховування або показ параметрів функцій</member>
<member
>Розгортання або згортання ієрархічних списків</member>
<member
>Автоматичне оновлення у відповідь на зміну у документах</member>
<member
>Обробку коду засновано на засобах підсвічування синтаксичних конструкцій з &kde-frameworks;.</member>
</simplelist>

</sect2>

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

<varlistentry id="tools-symbolviewer">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>\</keycap
></keycombo
> </shortcut
> <guimenu
>Перегляд</guimenu
> <guisubmenu
>Вікна інструментів</guisubmenu
> <guimenuitem
>Показати список символів</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Увімкнути або вимкнути показ панелі списку символів &kate;. На цій панелі буде показано список функцій, макросів і структур у початковому коді активного документа.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

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

<screenshot id="screenshot-symbolviewer-settings">
<screeninfo
>Переглядач символів</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="symbolviewer-settings.png" format="PNG"/></imageobject>
<caption
><para
>Вибір параметрів типового обробника</para
></caption>
</mediaobject>
</screenshot>

</sect2>

</sect1>


<sect1 id="kate-application-plugin-konsole">
<title
>Додаток перегляду інструмента термінала</title>

<para
><indexterm
><primary
>Емулятор термінала</primary
></indexterm
> Вбудований емулятор термінала є копією термінала з програми &konsole;, його додано для зручності. Доступ до емулятора можна отримати за допомогою пункту меню <menuchoice
><guimenu
>Перегляд</guimenu
><guisubmenu
>Вікна інструментів</guisubmenu
> <guimenuitem
>Показати термінал</guimenuitem
></menuchoice
>, це вікно завжди отримуватиме фокус після увімкнення його показу. Крім того, якщо буде позначено пункт <link linkend="konsole-config"
>Автоматично синхронізувати термінал з поточним документом, за можливості</link
>, поточний каталог у терміналі буде за можливості змінено на каталог поточного документа після показу або внесення змін у поточний документ.</para>

<para
>Типовим розташуванням емулятора термінала у вікні &kate;, є нижня частина вікна, під областю редагування.</para>

<para
>Ви можете налаштувати &konsole; за допомогою контекстного меню, яке можна викликати клацанням правою кнопкою миші. Докладніші відомості можна знайти у <ulink url="help:/konsole/index.html"
>підручнику з &konsole;</ulink
>.</para>

<para
>Відповідальним за роботу емулятора термінала є додаток перегляду інструмента термінала.</para>

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

<variablelist>

<varlistentry id="view-toolviews-show-terminal">
<term
><menuchoice
><guimenu
>Перегляд</guimenu
><guisubmenu
>Вікна інструментів</guisubmenu
> <guimenuitem
>Показати Термінал</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Вмикає або вимикає показ вбудованого емулятора термінала.</para>
<para
>Після першого активування буде створено термінал.</para>
<para
>Якщо буде показано панель емулятора термінала, їй буде передано фокус, і ви зможете негайно перейти до набору команд. Якщо буде позначено пункт <link linkend="konsole-config"
>Автоматично синхронізувати термінал з поточним документом, за можливості</link
> на сторінці <guilabel
>Термінал</guilabel
> <link linkend="config-dialog"
>головного діалогового вікна налаштування</link
>, у сеансі командної оболонки каталог автоматично змінюватиметься на каталог активного документа, якщо активним документом є локальний файл.</para>
</listitem>
</varlistentry>

<varlistentry id="view-toolviews-pipe-to-terminal">
<term
><menuchoice
><guimenu
>Інструменти</guimenu
><guimenuitem
>Спрямувати через канал у консоль</guimenuitem
></menuchoice
></term>
<listitem
><para
>Передає поточний виділений текст у рядок введення вбудованого емулятора термінала. Символ нового рядка у кінець рядка додано не буде.</para
></listitem>
</varlistentry>

<varlistentry id="tools-sync-terminal-document">
<term
><menuchoice
><guimenu
>Інструменти</guimenu
> <guimenuitem
>Синхронізувати термінал з поточним документом</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Позначення цього пункту призведе до того, що вбудований термінал автоматично змінюватиме свій поточний каталог на каталог активного документа.</para>

<para
>Крім того, ви можете налаштувати &kate; так, щоб термінал було завжди синхронізовано з поточним документом. Докладніше про це у розділі <xref linkend="konsole-config"/>.</para>
</listitem>
</varlistentry>

<varlistentry id="tools-focus-terminal">
<term
><menuchoice
><guimenu
>Інструменти</guimenu
> <guimenuitem
>Фокус на термінал/Зняти фокус з термінала</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Перемикає фокус з поточного документа на термінал, і навпаки. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

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

<para
>Налаштувати додаток панелі термінала можна за допомогою сторінки <guilabel
>Термінал</guilabel
> <link linkend="configuring-kate"
>діалогового вікна налаштовування програми</link
>.</para>

<para
>Можна вибрати один з таких варіантів:</para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Автоматично синхронізувати термінал з поточним документом, за можливості</guilabel
></term>
<listitem
><para
>Якщо буде позначено цей пункт, вбудований термінал змінюватиме поточний каталог на каталог активного документа після запуску і після того, як новий документ отримуватиме фокус. Якщо пункт не буде позначено, вам слід буде виконувати всі дії з навігації у терміналі вручну. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Змінити значення змінної середовища EDITOR на «kate -b»</guilabel
></term>
<listitem
><para
>За допомогою цього пункту можна визначити змінну середовища <envar
>EDITOR</envar
> так, щоб програми, що працюють у вбудованому терміналі і автоматично відкривають файл у редакторі, відкривали його у &kate; замість типового текстового редактора командної оболонки. Ви не зможете продовжувати користування таким терміналом, аж доки редагований файл не буде закрито у &kate; з надсиланням програмі, якій потрібно було редагування, повідомлення про завершення редагування файла.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

</sect1>

<sect1 id="kate-application-plugin-textfilter">

<title
>Додаток для фільтрування тексту</title
><!--Name is completely misleading and should be changed-->

<sect2 id="textfilter-using">
<title
>Користування додатком фільтрування тексту</title>

<para
>Цим додатком можна скористатися для виконання команд оболонки. Аргументом команди буде позначений фрагмент тексту. Виведені дані буде або використано як замінник позначеного фрагмента, або скопійовано до буфера обміну. </para>

<itemizedlist>
<title
>Приклади:</title>
<listitem
><para
><command
>less /etc/fstab</command
> — вставити вміст цього файла або скопіювати вміст до буфера обміну даними </para
></listitem>
<listitem
><para
><command
>wc</command
> — порахувати кількість рядків, слів і символів у позначеному фрагменті тексту і вставити ці дані до документа або скопіювати їх до буфера обміну даними </para
></listitem>
<listitem
><para
><command
>sort</command
> — упорядкувати рядки у позначеному фрагменті тексту і вставити результат до документа або скопіювати його до буфера обміну даними </para
></listitem>
</itemizedlist>

</sect2>

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

<variablelist>

<varlistentry id="tools-textfilter">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>\</keycap
></keycombo
> </shortcut
> <guimenu
>Інструменти</guimenu
> <guisubmenu
>Фільтрувати текст</guisubmenu
> </menuchoice
></term>
<listitem>

<para
><action
>Відкриває</action
> діалогове вікно фільтрування тексту:</para>

<screenshot id="screenshot-filtertext">
<screeninfo
>Діалогове вікно фільтрування тексту</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="textfilter.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Введіть до поля спадного списку команду оболонки або виберіть раніше введену команду зі списку журналу.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Копіювати результат замість його вставлення</guilabel
></term>
<listitem>
<para
>Копіювати результат до буфера обміну даними без внесення змін до документа.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Об’єднати STDOUT і STDERR</guilabel
></term>
<listitem>
<para
>Якщо позначити цей пункт, виведення до каналів STDOUT та STDERR буде об’єднано і програма не повідомлятиме про помилки. Якщо пункт не буде позначено, програма показуватиме дані, виведені до STDERR, за допомогою панелі пасивного повідомлення.</para>
</listitem>
</varlistentry>

</variablelist>

</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-xmlcheck">
<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1info>
<authorgroup
><author
>&Daniel.Naber; &Daniel.Naber.mail; </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>

<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">
<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1info>
<authorgroup
><author
>&Daniel.Naber; &Daniel.Naber.mail; </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"
>katexmltools/</filename
> каталогу <userinput
><command
>qtpaths</command
> <option
>--paths GenericDataLocation </option
></userinput
>, який також є типовим під час використання функції додатка <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
> і закрийте діалогове вікно. Після цього скористайтеся пунктом меню <menuchoice
><guimenu
>&XML;</guimenu
><guimenuitem
>Призначити мета-DTD...</guimenuitem
></menuchoice
>. Якщо у документі не міститься означення <quote
>DOCTYPE</quote
> або тип документа є невідомим, вам доведеться вказати файл мета-DTD у файловій системі. Якщо ж усе гаразд, буде автоматично завантажено мета-DTD, який відповідає DOCTYPE поточного документа.</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
>katexmltools/testcases.xml</filename
> у каталозі <userinput
><command
>qtpaths</command
> <option
>--paths GenericDataLocation </option
></userinput
> до &kate; з наступним виконанням настанов з цього файла.</para>

</sect2>


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

<variablelist id="xml-insert-element">
<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 id="xml-close-element">
<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 id="xml-assign-metadtd">
<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>


</chapter>