<chapter id="plugins">

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

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

<para
>У &kate; передбачено декілька типів додатків. Є додатки до компонента редактора &kate;, якими можна скористатися у будь-якій програмі, яка використовує компонент редактора, зокрема у KDevelop, Quanta, Kile, &kwrite; та багатьох інших програмах. Є додатки, якими можна скористатися лише у редакторі &kate;. Ці додатки поділяються ще на два типи: деякі з них написано мовою C++, інші ж написано мовою програмування Python. Між цими додатками є невеличкі відмінності, які буде обговорено нижче.</para>

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

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

<sect1 id="editor-component-plugins">
<title
>Розширення компонента редактора</title>

<para
>Щоб дізнатися більше про доступні додатки, ознайомтеся із <ulink url="help:/katepart/editor-component-plugins.html"
>розділом щодо розширень компонента редактора у підручнику з &katepart;</ulink
>.</para>

</sect1>

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

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

<para
>Серед можливих додатків до програми: </para>
<itemizedlist>
<listitem>
<para
>Переглядач зворотного трасування допоможе вам переглянути дані зворотного трасування</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-build"
>Додаток збирання</link
> — компілює або збирає програми і обробляє повідомлення про помилки.</para>
</listitem>
<listitem>
<para
>Додаток закриття за критерієм — закрити групу документів на основі даних щодо спільного для них розташування у файловій системі або суфікса назви файла.</para>
</listitem>
<listitem>
<para
>Додаток CTags виконує пошук визначень або оголошень за допомогою CTags.</para>
</listitem>
<listitem>
<para
>Перемикач між документами — налаштовування швидкого перемикання документів за допомогою натискання комбінації клавіш <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-gdb"
>&gdb;</link
> — надає доступ до простої графічної оболонки до &gdb;</para>
</listitem>
<listitem>
<para
>Вибір піктограми — запускає засіб вибору піктограми Cuttlefish.</para>
</listitem>
<listitem>
<para
>Lumen — додаток автоматичного доповнення коду мовою D, якому використано сервер доповнення DCD.</para>
</listitem>
<listitem>
<para
>Відкрити заголовок — відкриває відповідний файл .h/[.cpp|.c].</para>
</listitem>
<listitem>
<para
>Додаток проектів — додаток проектів для Kate.</para>
</listitem>
<listitem>
<para
>Replicode</para>
</listitem>
<listitem>
<para
>Доповнення коду Rust — доповнення коду для інструкцій мовою Rust.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-searchinfiles"
>Панель інструмента «Пошук з заміною»</link
> — панель засобу, який дає змогу шукати дані у відкритих файлах або у файлах файлової системи.</para>
</listitem>
<listitem>
<para
>Панель фрагментів — вбудована панель для керування фрагментами.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-sql"
>Додаток SQL</link
> — виконання запитів до баз даних SQL.</para>
</listitem>
<listitem>
<para
>Переглядач символів призначено для добування і показу символів з початкового коду.</para>
</listitem>
<listitem>
<para
>Панель інструмента термінала — вбудування віджета термінала у вікно програми.</para>
</listitem>
<listitem>
<para
>Фільтр тексту — просте фільтрування тексту.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>Доповнення &XML;</link
> — показує список елементів, атрибутів, значень атрибутів та об’єктів &XML;, передбачених у DTD.</para>
</listitem>

<!-- not in 4.10
<listitem>
<para
>Text Snippets - Configurable Text Snippets</para>
</listitem-->
<!--listitem>
<para
>Kate Python Browser Plugin - A Python browser plugin for Kate</para>
</listitem-->
<!--<listitem>
<para
><link linkend="kate-application-plugin-exttools"
>External Tools</link
></para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-snippets"
>Kate Snippets</link
> - Snippets plugin with code completion support</para>
</listitem>
<para
>Tabify - Adds a tab bar to Kate's main window</para>
http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/
</listitem>
-->
</itemizedlist>
</sect1>

<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1 id="kate-application-plugin-xmltools">
<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"
>$KDEDIR/share/apps/katexmltools/</filename
>, який також є типовим під час використання функції додатка <guimenuitem
>Призначити мета-DTD...</guimenuitem
>. Щоб мати змогу створювати ваші власні мета-DTD, вам слід отримати програму <command
>dtdparse</command
> за адресою <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

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

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

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

<variablelist>

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

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

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

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

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

</sect2>

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

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

</sect2>


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

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

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

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

</sect2>

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

</sect1>
<!--FIXME this belongs to Extensions, it is an editor plugin-->
<sect1 id="kate-editor-plugin-exporter">
<!--<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</author
></authorgroup>
</sect1info
>-->
<title
>Інструмент експортування</title>

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

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

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

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

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

<sect2 id="searchinfiles-intro">
<title
>Вступ</title>
<para
>За допомогою додатка «Пошук з заміною» &kappname; ви зможете шукати фрагмент тексту або текст за <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
>Створити вкладку</guiicon
></term>
<listitem
><para
>Ви можете відкрити довільну кількість панелей пошуку одночасно. Просто натисніть кнопку <guibutton
>Створити вкладку</guibutton
> у верхній лівій частині панелі інструмента пошуку, і програма відкриє нову вкладку, за допомогою якої можна буде виконати пошук за новими критеріями. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Вмикання/Вимикання показу результатів</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
>Вмикання/Вимикання показу результатів</guiicon
>, щоб програма їх показала.</para>

<variablelist>

<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
>Тут ви можете вибрати один з трьох варіантів. Позначте пункт <guilabel
>у відкритих файлах</guilabel
>, щоб пошук було виконано у файлах, які відкрито у &kappname;. За допомогою позначення пункту <guilabel
>у теці</guilabel
> можна наказати програмі виконати пошук у теці і, якщо потрібно, її підтеках. Пунктом <guilabel
>у проекті</guilabel
> можна скористатися для пошуку у всіх файлах зі списку поточного відкритого проекту. </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
>Вгору</guiicon
></term>
<listitem
><para
>Натисніть цю кнопку, щоб змінити значення у полі <guilabel
>Тека</guilabel
> на батьківську теку поточної позначеної теки. Цим пунктом можна буде скористатися лише у режимі <guilabel
>у теці</guilabel
>. </para
></listitem>
</varlistentry>

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

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

<varlistentry>
<term
><guilabel
>Шукати у прихованих</guilabel
></term>
<listitem
><para
>Якщо буде позначено цей пункт, &kappname; виконуватиме пошук у файлах та теках, які позначено як приховані у вашій операційній системі. Цим пунктом можна буде скористатися лише у режимі <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
>Символічні посилання можуть бути посиланнями на теку, яка є батьківською щодо тієї, у якій виконується пошук, або на теку, у якій міститься символічне посилання на її батьківську теку. Якщо у теці для пошуку є таке посилання, &kappname; виконуватиме перехід за кожним з посилань і пошук у відповідній теці, отже пошук не буде завершено у автоматичному режимі.</para
></warning>
</listitem>
</varlistentry>

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

</variablelist>
</sect3>

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

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

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

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

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

</sect3>
</sect2>

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

<variablelist>

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

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

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

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

</variablelist>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-fsbrowser">
<!--<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</author
></authorgroup>
</sect1info
>-->
<title
>Навігатор файловою системою</title>

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

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

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

</variablelist>
</sect2>

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

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

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

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

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

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

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

</variablelist>
</sect2>


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

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

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

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

<!--some material from mdi.docbook needs to be migrated here too-->
<!--<sect1 id="kate-application-plugin-exttools">
<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</author
></authorgroup>
</sect1info>
<title
>External Tools</title>

<para
>In the <guimenu
>Tools</guimenu
> menu you will find a submenu labeled
<guisubmenu
>External Tools</guisubmenu
>, if you have enabled them in &kate; settings.
These tools invoke external applications with data related to the current document,
for example its URL, directory, text or selection.</para>

<para
>External tools are user defined, you can add, edit or remove tools using
the <link linkend="exttools-config"
>External Tools</link
> configuration panel.
</para>

<sect2 id="exttools-menu">
<title
>Menu Structure</title>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Tools</guimenu
><guisubmenu
>External
Tools</guisubmenu
></menuchoice
></term>
<listitem
><para
>This submenu contains all the external tools you have
configured.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="exttools-config">
<title
>Configuration</title>

<para
>External tools are configured on the <guilabel
>External Tools</guilabel
> page
of <link linkend="configuring-kate-configdialog"
>&kate;'s configuration</link
>. These tools invoke external
applications with data related to the current document, for example its URL,
directory, text or selection. This page allows you to manage the menu and edit,
remove or add new tools.</para>

<para
>Each external tool is a shell command which contains macros representing
the document data. When activated, the macros are substituted with data from the
active document.</para>

<variablelist>
<title
>Available Commands</title>

<varlistentry>
<term
><guibutton
>New</guibutton
></term>
<listitem
><para
>Add a new external tool to the list.  This will launch the property
sheet described below where you can configure an external tool.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Edit</guibutton
></term>
<listitem
><para
>Edit the currently selected external tool, using the property
sheet described below.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Insert Separator</guibutton
></term>
<listitem
><para
>Adds a separator line that appears in the menu below the currently
selected item.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Up Arrow</guibutton
></term>
<listitem
><para
>Moves the currently selected item above the previous
one.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Down Arrow</guibutton
></term>
<listitem
><para
>Moves the currently selected item below the subsequent
one.</para
></listitem>
</varlistentry>

</variablelist>

<variablelist>
<title
>External Tools Properties</title>
<varlistentry>
<term
><guilabel
>Label</guilabel
></term>
<listitem
><para
>A friendly label that will appear in the <guisubmenu
>External Tools</guisubmenu
> menu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Icon</guibutton
></term>
<listitem
><para
>Allows you to select an icon that appears next to the label in the
<guisubmenu
>External Tools</guisubmenu
> menu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Script</guilabel
></term>
<listitem
><para
>The script to execute when the tool is activated. Before passing
the script to the shell, the following macros are substituted:

<variablelist>
<varlistentry>
<term
><userinput
>%URL</userinput
></term>
<listitem
><para
>The full URL of the current document, or an empty string if the
document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%URLs</userinput
></term>
<listitem
><para
>A space separated list of the URLs of all open documents
(except unsaved ones).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%directory</userinput
></term>
<listitem
><para
>The directory part of the current documents URL or an empty
string if the current document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%filename</userinput
></term>
<listitem
><para
>The filename of the current document without the path, or an
empty string if the current document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%line</userinput
></term>
<listitem
><para
>The line number of the insertion cursor is in the current
document.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%column</userinput
></term>
<listitem
><para
>The column number of the insertion cursor in the current
document.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%selection</userinput
></term>
<listitem
><para
>The selected text in the current document, or an empty string
if no text is selected</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%text</userinput
></term>
<listitem
><para
>The full text of the current document. Beware that this may
potentially exceed the maximum command length allowed on your system.
Use with care.</para
></listitem>
</varlistentry>

</variablelist>

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

<varlistentry>
<term
><guilabel
>Executable</guilabel
></term>
<listitem
><para
>The main executable in the script. This is mandatory, and is used
to test if the command can be run at all. A fully qualified path is allowed
in case the executable is not in your <envar
>PATH</envar
> variable.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Mime types</guilabel
></term>
<listitem
><para
>A semicolon separated list of mimetypes for which this command
should be enabled.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Save</guilabel
></term>
<listitem
><para
>You can optionally select to have the current or all documents
saved prior to executing the script. This is handy if your script reads the file
from disk.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Command line name</guilabel
></term>
<listitem
><para
>If you fill this, the tool will be available in the
<link linkend="advanced-editing-tools-commandline"
>editors command line</link
> as
<command
>exttool-<replaceable
>Command Line Name</replaceable
></command>
(the string you enter here prepended <quote
>exttool-</quote
>).</para
></listitem>
</varlistentry>

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

 <!--
 FIXME: replaced by built-in functionality in 4.12
        lots of this is wrong, other parts need to be moved somewhere else
<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 Snippets</title>

<sect2 id="snippets-intro">
<title
>Introduction</title
>       
<para
>Kate Snippets is a plugin used to save you some time by adding support for
so-called <quote
>snippets</quote
> (re-usable source code, machine code or text). The plugin
also supports code completion and QtScript.</para>
</sect2>

<sect2 id="snippets-menu">
<title
>Menu Structure</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>View</guimenu
><guisubmenu
>Tool Views</guisubmenu>
<guimenuitem
>Show Snippets</guimenuitem
></menuchoice
></term>
<listitem
><para
>Shows snippets panel containing all snippets in your repository
that are for the currently opened file type.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="snippets-panel">
<title
>Snippets panel</title>

<screenshot id="screenshot-snippets-panel">
<screeninfo
>Kate Snippets Panel</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-panel.png" format="PNG"/></imageobject>
<textobject
><phrase
>The &kate; snippets panel.</phrase
></textobject>
<caption
><para
>The panel for &kate; Snippets.</para
></caption>
</mediaobject>
</screenshot>

<para
>In the panel you should see a list of snippet repositories,
along with options to create your own, get them from the Internet or load
them from a local file.  Each repository has a checkbox that can be used to
activate or deactivate it.  There are also buttons to edit and delete existing
repositories.</para>

<sect3 id="snippets-repo-internet">
<title
>Loading Snippet Repository Files</title>
<para
>You can download snippet repositories from the Internet.  Just click 
<guibutton
>Get New Snippets</guibutton
> and a window with a list of snippet 
repositories will open.  After downloading the desired snippet, make sure that
you have activated it.</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
>Creating and Editing Snippets</title>

<screenshot id="screenshot-snippets-form">
<screeninfo
>Snippet Editor</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-form.png" format="PNG"/></imageobject>
<textobject
><phrase
>The snippet editor.</phrase
></textobject>
<caption
><para
>The snippet editor interface.</para
></caption>
</mediaobject>
</screenshot>

<para
>To create a new snippet repository, click <guibutton
>New Snippet File</guibutton
>.
You should now see a dialog that asks for the name of the snippet file, license and
author.  After choosing the desired options, click <guibutton
>Create</guibutton
>,
and the snippet editor will open.</para>

<para
>The snippet editor contains the following options:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>File Type</guilabel
></term>
<listitem
><para
>Select the file type(s) you want the snippet repository to apply
to.  It is set to <quote
>*</quote
> by default, so the repository applies to all files.  You 
can change it to something like <userinput
>C++</userinput
> for instance, or select
from a list by hitting the <guibutton
>Edit</guibutton
>.  You can specify more
than one file type by separating them with <userinput
>;</userinput
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Authors</guilabel
></term>
<listitem
><para
>Enter the name(s) of the author(s) of the snippet file.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Snippets List</term>
<listitem
><para
>Contains all snippets defined in the snippet file.  You can
simply click on a snippet listed there to edit it.</para
></listitem>
</varlistentry>
    
<varlistentry>
<term
>Add (<guibutton
>+</guibutton
>)</term>
<listitem
><para
>Used to add a new snippet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Delete (<guibutton
>-</guibutton
>)</term>
<listitem
><para
>Used to delete a snippet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Match/Name</guilabel
></term>
<listitem
><para
>Appears in the list of snippets in the tool view and is also
searched when using the code completion feature.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Display Prefix</guilabel
>, <guilabel
>Display Postfix</guilabel
>,
and <guilabel
>Display Arguments</guilabel
></term>
<listitem
><para
>Used to display helpful information while using code completion.
The prefix and postfix are displayed before and after the name, while the arguments
are displayed in parenthesis immediately after the name.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Snippet Content</guilabel
></term>
<listitem
><para
>Reusable text or code.  This is what appears in your document
when the snippet is used.</para
></listitem>
</varlistentry>

</variablelist>

<para
>In <guilabel
>Snippet Content</guilabel
> you can specify variables with 
<userinput
>${<replaceable
>name</replaceable
>}</userinput
> or
<userinput
>%{<replaceable
>name</replaceable
>}</userinput
>.  These can be filled
by QtScript or when the snippet is used.  There is a special variable - 
${cursor} or %{cursor} - which automatically sets the cursor to its first 
occurrence.</para>

</sect3>
</sect2>

<sect2 id="snippets-using">
<title
>Using Snippets</title>

<screenshot id="screenshot-snippets-usage">
<screeninfo
>Kate Snippets in Action</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-usage.png" format="PNG"/></imageobject>
<textobject
><phrase
>Accessing &kate; Snippets from a tool view and a drop down menu.</phrase
></textobject>
<caption
><para
>Selecting from a list of snippets.</para
></caption>
</mediaobject>
</screenshot>

<para
>You can call snippets in two ways:</para>

<itemizedlist>
<listitem
><para
>By choosing the snippet from the tool view.</para
></listitem>
<listitem
><para
>While writing, you can press <keycombo action="simul"
>&Ctrl;
<keysym
>Space</keysym
></keycombo
>, which will display all the snippets in a
convenient window from which you can choose.  You may enter the beginning
of the snippets name before or after pressing this key combination, which provides
functionality similar to code completion.</para
></listitem>
</itemizedlist>

<para
>If the snippet contains variables (besides <literal
>${cursor}</literal
>)
the cursor will automatically go to the first occurrence of a variable and will
wait for you to write something. When you are done, you can press &Tab; to move
to the next variable, and so on.</para>

</sect2>

<sect2 id="snippets-ack">
<title
>Thanks and Acknowledgments</title>
<para
>&kate; Snippets was written by Joseph Wenninger.</para>
<para
>Special thanks to Google Code-In 2011 participant Martin Gergov for
writing much of this section.</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>

<!--When you first install Kate, you need to enable the plugin:

Click `Settings → Configure Kate`

In the tree on the left of the screen, click `Plugins`.

In the `Plugin Manager` panel on the right, select `Build plugin`, and then click `OK`.-->

</sect2>

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

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


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

<itemizedlist>
<listitem
><para
><guilabel
>Параметри цілі</guilabel
></para
></listitem>
<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>

<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
>gcc -Wall -g %f</command
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Створити нову ціль можна за допомогою натискання кнопки <guibutton
>Створити</guibutton
>. Натисканням кнопки <guibutton
>Копіювати</guibutton
> можна створити копію поточної цілі. Щоб вилучити ціль, натисніть кнопку <guibutton
>Вилучити</guibutton
>.</para>

</sect3>

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

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

</sect3>

<sect3 id="buiid-using-errors">
<title
>Помилки і попередження</title>

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

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

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

<!--FIXME: These shortcuts now seem to be used by the Project plugin in 4.11.
            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>
<varlistentry>
<term
><menuchoice
><guimenu
>Збирання</guimenu
> <guimenuitem
>Зібрати</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Виконує команду <guilabel
>Зібрати</guilabel
> для поточної позначеної цілі.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Збирання</guimenu
><guimenuitem
>Очистити</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Виконує команду <guilabel
>Очистити</guilabel
> (вилучає файли, створені під час компіляції та збирання) для поточної позначеної цілі.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Збирання</guimenu
> <guimenuitem
>Швидка компіляція</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Виконує команду <guilabel
>Швидка компіляція</guilabel
> для поточної позначеної цілі.</para
></listitem>
</varlistentry>

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

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

<varlistentry>
<term
><menuchoice
><guimenu
>Збирання</guimenu
><guisubmenu
>Цілі</guisubmenu
> </menuchoice
></term>
<listitem
><para
>Надає змогу вибрати одну з цілей, налаштованих користувачем.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><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-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>

<!--If Kate is installed on your computer, at first open Kate.
If Kate isn't installed on your computer, download and install it.

Using SQL Plugin
After opening the Kate;
Click Settings→ Configure Kate
and then;
Click Application → Select Plugins in the tree widget

In the Plugin Manager panel on the right, check SQL Plugin and click OK.
-->

</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
>.</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
> у нижній частині вікна &kappname; або у текстовому форматі на панелі <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>

</variablelist>

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

</sect3>
</sect2>

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

<para
>Навігацію вашою базою даних можна здійснювати за допомогою панелі інструментів <guilabel
>Перегляд схеми SQL</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-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; до &kappname; є простою графічною оболонкою до популярного інструмента діагностики виконання програм &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"
>розділу «Додатки» діалогового вікна налаштувань &kappname;</link
>.</para>

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

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

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

</sect2>

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

<para
>Доступ до всіх пунктів дій можна отримати за допомогою меню &kappname;. Крім того, скористатися значною частиною цих пунктів можна за допомогою панелі інструментів налагоджування.</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">
<term
><menuchoice
><guimenu
>Перегляд</guimenu
><guisubmenu
>Вікна інструментів</guisubmenu
> <guimenuitem
>Показати Локальні змінні</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Показує список всіх завантажених змінних та їхніх значень. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-show-call-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-arg-lists">
<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-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.htm"
>підручнику з &konsole;</ulink
>.</para>

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

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

<variablelist>

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

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

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

<varlistentry>
<term
><anchor id="tools-focus-terminal"/><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>

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