<appendix id="highlight">
<appendixinfo>
<authorgroup>
<author
><personname
><firstname
></firstname
></personname
></author>
<othercredit role="translator"
><firstname
>Юрій</firstname
><surname
>Чорноіван</surname
><affiliation
><address
><email
>yurchor@ukr.net</email
></address
></affiliation
><contrib
>Переклад українською</contrib
></othercredit
> 
</authorgroup>
</appendixinfo>
<title
>Як працювати з підсвічуванням синтаксису</title>

<sect1 id="highlight-overview">

<title
>Огляд</title>

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

<mediaobject>
<imageobject
><imagedata format="PNG" fileref="highlighted.png"/></imageobject>
<textobject
><phrase
>Функція, написана мовою Perl, показана з підсвічуванням синтаксису.</phrase
></textobject>
<caption
><para
>Функція, написана мовою Perl, показана з підсвічуванням синтаксису.</para>
</caption>
</mediaobject>

<mediaobject>
<imageobject
><imagedata format="PNG" fileref="unhighlighted.png"/></imageobject>
<textobject
><phrase
>Та сама функція, написана мовою Perl, без підсвічування.</phrase
></textobject>
<caption
><para
>Та сама функція, написана мовою Perl, без підсвічування.</para
></caption>
</mediaobject>

<para
>Ну що, який з двох прикладів зручніше читати?</para>

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

<para
>&kate; автоматично визначатиме належні правила підсвічування синтаксису під час відкриття файла. Дія з визначення відбуватиметься на основі типу &MIME; файла, який визначатиметься за суфіксом назви файла або, якщо у назві немає суфіксу, за вмістом файла. Якщо, на вашу думку, програма зробила неправильний вибір, ви можете вручну вказати правила підсвічування за допомогою пункту меню <menuchoice
><guimenu
>Інструменти</guimenu
> <guisubmenu
>Підсвічування</guisubmenu
></menuchoice
>.</para>

<para
>Гарнітури шрифту та кольори, які буде використано визначенням підсвічування синтаксису, можна налаштувати на вкладці <link linkend="prefcolors-highlighting-text-styles"
>Стилі підсвічування тексту</link
> <link linkend="config-dialog"
>діалогового вікна налаштування</link
>, типами ж &MIME;, для яких буде використано таке підсвічування керує вкладка <link linkend="pref-open-save-modes-filetypes"
>Режими та типи файлів</link
> tab.</para>

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

<tip>
<para
>Ви можете звантажити оновлені або додаткові правила визначення підсвічування синтаксису з веб-сайта &kate;. Для цього вам слід натиснути кнопку <guibutton
>Звантажити файли підсвічування...</guibutton
> на вкладці <link linkend="pref-open-save-modes-filetypes"
>Режими та типи файлів</link
> <link linkend="config-dialog"
>діалогового вікна налаштування</link
>.</para>
</tip>

</sect1>

<sect1 id="katehighlight-system">

<title
>Система підсвічування синтаксису &kate;</title>

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

<sect2 id="katehighlight-howitworks">

<title
>Як це працює</title>

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

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

<para
>Визначення синтаксичних правил, які використовуються у системі підсвічування синтаксису &kate;, є файлами &XML;, у яких містяться <itemizedlist>
<listitem
><para
>Правила для визначення ролі тексту, впорядковані у контекстні блоки</para
></listitem>
<listitem
><para
>Списки ключових слів</para
></listitem>
<listitem
><para
>Визначення елементів стилю</para
></listitem>
</itemizedlist>
</para>

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

</sect2>

<sect2 id="highlight-system-rules">
<title
>Правила</title>

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

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

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

</sect2>

<sect2 id="highlight-context-styles-keywords">
<title
>Контекстні стилі і ключові слова</title>

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

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

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

</sect2>

<sect2 id="kate-highlight-system-default-styles">
<title
>Типові стилі</title>

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

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

<tip>
<para
>Під час створення всіх стилів визначення синтаксису використовують один з типових стилів. У деякій частині визначень синтаксису використовуються додаткові стилі, яких немає серед типових, отже, якщо ви часто працюєте з файлами у таких форматах, доцільно відкрити діалогове вікно налаштування, щоб подивитися, чи не використовуються для певних елементів однакові стилі. Наприклад, існує лише один типовий стиль для рядків, але, оскільки у мові програмування Perl існує два типи рядків, ви можете налаштувати підсвічування для кожного з цих типів трохи по-різному. Огляд всіх <link linkend="kate-highlight-default-styles"
>можливих типових стилів</link
> буде наведено далі.</para>
</tip>

</sect2>

</sect1>

<sect1 id="katehighlight-xml-format">
<title
>Формат &XML; визначення підсвічування</title>

<sect2>
<title
>Огляд</title>

<para
>Цей розділ присвячено огляду формату &XML; визначення підсвічування. За допомогою невеличкого прикладу у розділі описано основні компоненти, їх призначення і використання. Далі ми докладно розглянемо правила визначення підсвічування синтаксису.</para>

<para
>Формальне визначення або <acronym
>DTD</acronym
> зберігається у файлі з назвою <filename
>language.dtd</filename
>, який у вашій системі має бути встановлено до теки <filename
>$<envar
>KDEDIR</envar
>/share/apps/katepart/syntax</filename
>. </para>

<variablelist>
<title
>Головні розділи файлів визначення підсвічування &kate;</title>

<varlistentry>
<term
>Файл підсвічування містить заголовок, у якому встановлюється версія і тип документа XML:</term>
<listitem>
<programlisting
>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;!DOCTYPE language SYSTEM &quot;language.dtd&quot;&gt;
</programlisting>
</listitem>
</varlistentry>

<varlistentry>
<term
>Кореневим елементом файла визначення є елемент <userinput
>language</userinput
>. Серед можливих атрибутів:</term>

<listitem>
<para
>Обов’язкові атрибути:</para>
<para
><userinput
>name</userinput
> визначає назву мови. Цю назву буде згодом показано у пунктах меню та діалогових вікнах програми.</para>
<para
><userinput
>section</userinput
> визначає категорію.</para>
<para
><userinput
>extensions</userinput
> визначає суфікси назв файлів, на зразок &quot;*.cpp;*.h&quot;</para>

<para
>Необов’язкові атрибути:</para>
<para
><userinput
>mimetype</userinput
> прив’язує файли на основі типу &MIME;.</para>
<para
><userinput
>version</userinput
> визначає поточну версію файла визначень.</para>
<para
><userinput
>kateversion</userinput
> визначає найостаннішу з підтримуваних версій &kate;.</para>
<para
><userinput
>casesensitive</userinput
> визначає, чи розрізнятимуться ключові слова за регістром символів, чи ні.</para>
<para
><userinput
>priority</userinput
> потрібно вказати, якщо у іншому файлі визначення підсвічування використовуються ті самі суфікси файлів. Для підсвічування буде використано правила з вищим пріоритетом.</para>
<para
><userinput
>author</userinput
> повинен містити ім’я і адресу електронної пошти автора.</para>
<para
><userinput
>license</userinput
> повинен містити назву ліцензії файла підсвічування, зазвичай, LGPL, Artistic, GPL тощо.</para>
<para
><userinput
>hidden</userinput
> визначає, чи має бути показано назву підсвічування у меню &kate;.</para>
<para
>Отже, наступний рядок має виглядати десь так:</para>
<programlisting
>&lt;language name=&quot;C++&quot; version=&quot;1.00&quot; kateversion=&quot;2.4&quot; section=&quot;Sources&quot; extensions=&quot;*.cpp;*.h&quot; /&gt;
</programlisting>
</listitem>
</varlistentry>


<varlistentry>
<term
>Наступним елементом є <userinput
>highlighting</userinput
>, у цьому елементі міститься необов’язковий елемент <userinput
>list</userinput
> і обов’язкові елементи <userinput
>contexts</userinput
> і <userinput
>itemDatas</userinput
>.</term>
<listitem>
<para
>Елементи <userinput
>list</userinput
> містять список ключових слів. У цьому випадку ключовими словами будуть <emphasis
>class</emphasis
> і <emphasis
>const</emphasis
>. У разі потреби ви можете додати довільну кількість списків.</para>
<para
>У елементі <userinput
>contexts</userinput
> містяться всі контексти. Типово, першим контекстом є початок діапазону підсвічування. У контексті <emphasis
>Normal Text</emphasis
> існує два правила: перше визначає список ключових слів з назвою <emphasis
>somename</emphasis
> і правило для визначення лапок і перемикання контексту на контекст <emphasis
>string</emphasis
>. Докладніше правила буде розглянуто у наступній главі.</para>
<para
>Третя частина складається з елемента <userinput
>itemDatas</userinput
>. У цьому елементі містяться всі кольори і гарнітури шрифтів, потрібні для контекстів і правил. У нашому випадку було використано <userinput
>itemData</userinput
> <emphasis
>Normal Text</emphasis
>, <emphasis
>String</emphasis
> і <emphasis
>Keyword</emphasis
>. </para>
<programlisting
>&lt;highlighting&gt;
    &lt;list name=&quot;somename&quot;&gt;
      &lt;item&gt; class &lt;/item&gt;
      &lt;item&gt; const &lt;/item&gt;
    &lt;/list&gt;
    &lt;contexts&gt;
      &lt;context attribute=&quot;Normal Text&quot; lineEndContext=&quot;#pop&quot; name=&quot;Normal Text&quot; &gt;
        &lt;keyword attribute=&quot;Keyword&quot; context=&quot;#stay&quot; String=&quot;somename&quot; /&gt;
        &lt;DetectChar attribute=&quot;String&quot; context=&quot;string&quot; char=&quot;&amp;quot;&quot; /&gt;
      &lt;/context&gt;
      &lt;context attribute=&quot;String&quot; lineEndContext=&quot;#stay&quot; name=&quot;string&quot; &gt;
        &lt;DetectChar attribute=&quot;String&quot; context=&quot;#pop&quot; char=&quot;&amp;quot;&quot; /&gt;
      &lt;/context&gt;
    &lt;/contexts&gt;
    &lt;itemDatas&gt;
      &lt;itemData name=&quot;Normal Text&quot; defStyleNum=&quot;dsNormal&quot; /&gt;
      &lt;itemData name=&quot;Keyword&quot; defStyleNum=&quot;dsKeyword&quot; /&gt;
      &lt;itemData name=&quot;String&quot; defStyleNum=&quot;dsString&quot; /&gt;
    &lt;/itemDatas&gt;
  &lt;/highlighting&gt;
</programlisting>
</listitem>
</varlistentry>

<varlistentry>
<term
>Останньою частиною визначення підсвічування є необов’язковий розділ <userinput
>general</userinput
>. У ньому можуть міститися відомості щодо ключових слів, згортання коду, коментарів і відступів.</term>

<listitem>
<para
>У розділі <userinput
>comment</userinput
> визначається послідовність символів, за допомогою якої можна додати однорядковий коментар. Крім того, ви можете визначати багаторядкові коментарі за допомогою елемента <emphasis
>multiLine</emphasis
> з додатковим атрибутом <emphasis
>end</emphasis
>. Ці визначення буде використано за виконання користувачем дій <emphasis
>закоментувати/розкоментувати</emphasis
>.</para>
<para
>У розділі <userinput
>keywords</userinput
> визначається те, чи слід враховувати регістр символів у списку ключових слів, чи ні. Інші атрибути буде описано далі за текстом.</para>
<programlisting
>&lt;general&gt;
    &lt;comments&gt;
      &lt;comment name="singleLine" start="#"/&gt;
    &lt;/comments&gt;
    &lt;keywords casesensitive="1"/&gt;
  &lt;/general&gt;
&lt;/language&gt;
</programlisting>
</listitem>
</varlistentry>

</variablelist>


</sect2>

<sect2 id="kate-highlight-sections">
<title
>Докладно про розділи</title>
<para
>У цій частині описано всі доступні атрибути для контекстів, itemDatas, ключових слів, коментарів, згортання коду і відступів.</para>

<variablelist>
<varlistentry>
<term
>Елемент <userinput
>context</userinput
> належить до групи <userinput
>contexts</userinput
>. Цей елемент визначає специфічні для контексту правила, на зразок того, що має трапитися, якщо система підсвічування досягне кінця рядка. Серед можливих атрибутів:</term>


<listitem>
<para
><userinput
>name</userinput
> — назва контексту. За допомогою цієї назви правила визначатимуть контекст, на який слід перемкнутися у випадку виявлення відповідника правила.</para>
<para
><userinput
>lineEndContext</userinput
> визначає контекст, на який має перемкнутися система підсвічування у разі досягнення кінця рядка. Значенням може бути назва іншого контексту, <userinput
>#stay</userinput
> означатиме, що контекст не слід перемикати (тобто нічого не робити) or <userinput
>#pop</userinput
> означатиме, що слід вийти з контексту. Наприклад, можна скористатися значенням <userinput
>#pop#pop#pop</userinput
> для того, щоб система після виходу піднялася на два контексти вище.</para>
<para
><userinput
>lineBeginContext</userinput
> визначає контекст, якщо буде знайдено початок рядка. Типове значення: #stay.</para>
<para
><userinput
>fallthrough</userinput
> вказує, чи слід системі підсвічування перемикатися на контекст вказаний параметром fallthroughContext, якщо текст не відповідає жодному з правил. Типове значення: <emphasis
>false</emphasis
>.</para>
<para
><userinput
>fallthroughContext</userinput
> визначає наступний контекст, якщо не буде знайдено відповідника до правил.</para>
<para
><userinput
>dynamic</userinput
>: якщо має значення <emphasis
>true</emphasis
>, контекст запам’ятовуватиме рядки або заповнювачі, збережені за допомогою динамічних правил. Це потрібно, наприклад, для документів HERE. Типове значення: <emphasis
>false</emphasis
>.</para>
</listitem>
</varlistentry>


<varlistentry>
<term
>Елемент <userinput
>itemData</userinput
> знаходиться у групі <userinput
>itemDatas</userinput
>. За його допомогою визначаються тип шрифту і кольори. Таким чином можна визначати власні типи шрифтів і кольори, але ми рекомендуємо, за можливості, використовувати лише типові стилі так, щоб користувач завжди бачив однакові кольори у файлах різних форматів. Все ж іноді іншого способу не існує, і вам доведеться змінити колір і атрибути шрифту. Обов’язковими атрибутами є name і defStyleNum, інші атрибути є необов’язковими. Серед можливих атрибутів:</term>

<listitem>
<para
><userinput
>name</userinput
> визначає назву itemData. Цю назву буде використано у контекстах і правилах для посилання на itemData у атрибуті <emphasis
>attribute</emphasis
>.</para>
<para
><userinput
>defStyleNum</userinput
> визначає, який тип слід використовувати типово. Докладний перелік можливих типових стилів ви знайдете нижче.</para>
<para
><userinput
>color</userinput
> визначає колір. Можливі формати: '#rrggbb' і '#rgb'.</para>
<para
><userinput
>selColor</userinput
> визначає колір виділеного тексту.</para>
<para
><userinput
>italic</userinput
>, якщо має значення <emphasis
>true</emphasis
>, шрифт буде курсивним.</para>
<para
><userinput
>bold</userinput
>, якщо має значення <emphasis
>true</emphasis
>, шрифт тексту буде напівжирним.</para>
<para
><userinput
>underline</userinput
>: якщо цей атрибут має значення <emphasis
>true</emphasis
>, текст буде підкреслено.</para>
<para
><userinput
>strikeout</userinput
>, якщо цей параметр має значення <emphasis
>true</emphasis
>, текст буде перекреслено.</para>
</listitem>
</varlistentry>


<varlistentry>
<term
>Елемент <userinput
>keywords</userinput
> у групі <userinput
>general</userinput
> визначає властивості ключових слів. Серед можливих атрибутів:</term>

<listitem>
<para
><userinput
>casesensitive</userinput
>, може приймати значення <emphasis
>true</emphasis
> або <emphasis
>false</emphasis
>. Якщо має значення <emphasis
>true</emphasis
>, пошук ключових слів відбуватиметься з врахуванням регістру символів.</para>
<para
><userinput
>weakDeliminator</userinput
> — це список символів, які не є символами відокремлення слів. Наприклад, крапка <userinput
>«.»</userinput
> є символом відокремлення слів. Припустімо тепер, що ключове слово у <userinput
>list</userinput
> містить крапку, тоді це слово буде задіяно, лише якщо ви вкажете крапку серед значень цього аргументу.</para>
<para
><userinput
>additionalDeliminator</userinput
> визначає додаткові символи розмітки.</para>
<para
><userinput
>wordWrapDeliminator</userinput
> визначає символи, після яких можна розривати рядок.</para>
<para
>Типовими символами розмітки і символами відокремлення слів є символи <userinput
>.():!+,-&lt;=&gt;%&amp;*/;?[]^{|}~\</userinput
>, пробіл (<userinput
>' '</userinput
>) і символ табуляції (<userinput
>'\t'</userinput
>).</para>
</listitem>
</varlistentry>


<varlistentry>
<term
>Елемент <userinput
>comment</userinput
> у групі <userinput
>comments</userinput
> визначає властивості коментаря, які буде використано для дій за пунктами меню <menuchoice
><guimenu
>Інструменти</guimenu
> <guimenuitem
>Закоментувати</guimenuitem
></menuchoice
> і <menuchoice
><guimenu
>Інструменти</guimenu
> <guimenuitem
>Розкоментувати</guimenuitem
></menuchoice
>. Серед доступних атрибутів:</term>

<listitem>
<para
><userinput
>name</userinput
>: може мати значення <emphasis
>singleLine</emphasis
> або <emphasis
>multiLine</emphasis
>. Якщо буде обрано варіант <emphasis
>multiLine</emphasis
>, слід буде також вказати атрибути <emphasis
>end</emphasis
> і <emphasis
>region</emphasis
>.</para>
<para
><userinput
>start</userinput
> визначає рядок, який використовується для позначення початку коментаря. У C++ цим рядком є &quot;/*&quot;.</para>
<para
><userinput
>end</userinput
> визначає рядок, яким завершуватиметься коментар. У C++ цим рядком буде &quot;*/&quot;.</para>
<para
>Атрибут <userinput
>region</userinput
> повинен мати значення назви придатного для згортання багаторядкового коментаря. Припустімо, що у правилах вказано <emphasis
>beginRegion="Comment"</emphasis
> ... <emphasis
>endRegion="Comment"</emphasis
>, тоді вам слід взяти значення <emphasis
>region="Comment"</emphasis
>. За допомогою цього атрибута можна користуватися дією з розкоментування, навіть якщо було виділено не весь текст багаторядкового коментаря. Потрібно лише, щоб курсор знаходився всередині цього багаторядкового коментаря.</para>
</listitem>
</varlistentry>


<varlistentry>
<term
>Елемент <userinput
>folding</userinput
> у групі <userinput
>general</userinput
> призначено для визначення властивостей згортання коду. Серед можливих атрибутів:</term>

<listitem>
<para
><userinput
>indentationsensitive</userinput
>: якщо має значення <emphasis
>true</emphasis
>, позначки згортання коду буде додано на основі відступів, так, як це робиться у скриптовій мові Python. Зазвичай, вам не потрібно буде встановлювати цей атрибут, оскільки його типовим значенням є <emphasis
>false</emphasis
>.</para>
</listitem>
</varlistentry>


<varlistentry>
<term
>Елемент <userinput
>indentation</userinput
> у групі <userinput
>general</userinput
> призначено для зазначення інструменту визначення відступів. Ми наполегливо рекомендуємо вам уникати використання цього елемента, оскільки інструмент визначення відступів, зазвичай, визначається або за типом файла або за рядком режиму, доданим до текстового файла. Якщо ви все ж визначите цей інструмент програма примусово буде використовувати саме його, що може бути дуже небажаним для користувача програми. Серед можливих атрибутів:</term>

<listitem>
<para
><userinput
>mode</userinput
>: назва інструменту визначення відступів. У поточній версії можливими значеннями є: <emphasis
>normal, cstyle, csands, xml, python</emphasis
> і <emphasis
>varindent</emphasis
>.</para>
</listitem>
</varlistentry>


</variablelist>


</sect2>

<sect2 id="kate-highlight-default-styles">
<title
>Можливі типові стилі</title>
<para
>Ви <link linkend="kate-highlight-system-default-styles"
>вже обговорювали</link
> типові стилі у короткому резюме: типовими стилями є наперед визначені набори з гарнітур шрифтів та кольорів.</para>
<variablelist>
<varlistentry>
<term
>Отже, ось список доступних типових стилів:</term>
<listitem>
<para
><userinput
>dsNormal</userinput
>, використовується для звичайного тексту.</para>
<para
><userinput
>dsKeyword</userinput
>, використовується для ключових слів.</para>
<para
><userinput
>dsDataType</userinput
>, використовується для типів даних.</para>
<para
><userinput
>dsDecVal</userinput
>, використовується для десяткових значень.</para>
<para
><userinput
>dsBaseN</userinput
>, використовується для величин у численні з основою, відмінною від 10.</para>
<para
><userinput
>dsFloat</userinput
>, використовується для значень з плаваючою комою.</para>
<para
><userinput
>dsChar</userinput
>, використовується для символів.</para>
<para
><userinput
>dsString</userinput
>, використовується для рядків.</para>
<para
><userinput
>dsComment</userinput
>, використовується для коментарів.</para>
<para
><userinput
>dsOthers</userinput
>, використовується для «інших» значень.</para>
<para
><userinput
>dsAlert</userinput
>, використовується для попереджувальних повідомлень.</para>
<para
><userinput
>dsFunction</userinput
>, використовується для викликів функцій.</para>
<para
><userinput
>dsRegionMarker</userinput
>, використовується для позначок ділянок.</para>
<para
><userinput
>dsError</userinput
>, використовується для підсвічування помилок та синтаксичних неточностей.</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>

<sect1 id="kate-highlight-rules-detailled">
<title
>Правила визначення способу підсвічування</title>

<para
>Цей розділ присвячено опису правил визначення синтаксису.</para>

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

<para
>Правило виглядає так:</para>

<programlisting
>&lt;НазваПравила attribute=&quot;(ідентифікатор)&quot; context=&quot;(ідентифікатор)&quot; [специфічні для правила атрибути] /&gt;</programlisting>

<para
>Значення <emphasis
>attribute</emphasis
> визначає назву стилю, який буде використано для відповідних символів, а значення <emphasis
>context</emphasis
> визначає контекст, який слід використовувати, починаючи з цього місця.</para>

<para
><emphasis
>context</emphasis
> може бути визначено за допомогою:</para>

<itemizedlist>
<listitem>
<para
><emphasis
>Ідентифікатора</emphasis
>, який є назвою іншого контексту.</para>
</listitem>
<listitem>
<para
>Значення <emphasis
>порядку</emphasis
>, яке повідомляє рушієві, чи слід залишатися у поточному контексті (<userinput
>#stay</userinput
>), чи слід повернутися до попереднього контексту, використаного у рядку (<userinput
>#pop</userinput
>).</para>
<para
>Щоб повернутися на декілька рівнів контексту назад, ключове слово #pop можна повторити декілька разів: <userinput
>#pop#pop#pop</userinput
></para>
</listitem>
</itemizedlist>

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

<programlisting
>&lt;НазваПравила (атрибути)&gt;
  &lt;НазваДочірньогоПравила (атрибути) /&gt;
  ...
&lt;/НазваПравила&gt;
</programlisting>


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


<itemizedlist>
<title
>Загальні атрибути</title>
<para
>Всі правила мають перелічені нижче атрибути, їх можна вказувати всюди, де ви побачите напис <userinput
>(загальні атрибути)</userinput
> у списку. Атрибути <emphasis
>attribute</emphasis
> і <emphasis
>context</emphasis
> є обов’язковими атрибутами, всі інші атрибути є необов’язковими. </para>

<listitem>
<para
><emphasis
>attribute</emphasis
>: атрибут, що вказує на визначені <emphasis
>itemData</emphasis
>.</para>
</listitem>
<listitem>
<para
><emphasis
>context</emphasis
>: визначає контекст, на який слід перемкнути систему підсвічування у разі виявлення відповідника правила.</para>
</listitem>
<listitem>
<para
><emphasis
>beginRegion</emphasis
>: почати блок згортання коду. Типове значення: unset.</para>
</listitem>
<listitem>
<para
><emphasis
>endRegion</emphasis
>: закрити блок згортання коду. Типове значення: unset.</para>
</listitem>
<listitem>
<para
><emphasis
>lookAhead</emphasis
>: якщо має значення <emphasis
>true</emphasis
>, система підсвічування не оброблятиме довжину відповідника. Типове значення: <emphasis
>false</emphasis
>.</para>
</listitem>
<listitem>
<para
><emphasis
>firstNonSpace</emphasis
>: відповідність встановлюватиметься, лише якщо рядок є першою відмінною від пробілів послідовністю символів у рядку тексту. Типове значення: <emphasis
>false</emphasis
>.</para>
</listitem>
<listitem>
<para
><emphasis
>column</emphasis
>: збіг буде зареєстровано, якщо збігатиметься рядок. Типове значення: unset.</para>
</listitem>
</itemizedlist>

<itemizedlist>
<title
>Динамічні правила</title>
<para
>Деякі з правил надають змогу встановлювати додатковий атрибут, <userinput
>dynamic</userinput
>, булівського типу з типовим значенням <emphasis
>false</emphasis
>. Якщо атрибут dynamic має значення <emphasis
>true</emphasis
>, у правилі можна використовувати заповнювачі, які позначають текст, знайдений за допомогою правила <emphasis
>формального виразу</emphasis
>, текст буде перемкнуто у поточний контекст у його атрибутах <userinput
>string</userinput
> або <userinput
>char</userinput
>. У атрибуті <userinput
>string</userinput
> заповнювач <replaceable
>%N</replaceable
> (де N — ціле число) буде замінено на відповідний елемент <replaceable
>N</replaceable
> з виклику формального виразу. У атрибуті <userinput
>char</userinput
> заповнювач повинен бути числом <replaceable
>N</replaceable
>, його буде замінено на перший символ відповідного елемента <replaceable
>N</replaceable
> з виклику формального виразу. Всі правила, які дозволяють використання цього атрибута, буде позначено написом <emphasis
>(dynamic)</emphasis
>.</para>

<listitem>
<para
><emphasis
>dynamic</emphasis
>: може мати значення <emphasis
>(true|false)</emphasis
>.</para>
</listitem>
</itemizedlist>

<sect2 id="highlighting-rules-in-detail">
<title
>Докладно про правила</title>

<variablelist>
<varlistentry>
<term
>DetectChar</term>
<listitem>
<para
>Перевірка на рівність одному певному символу. Зазвичай, використовується для пошуку кінця рядків, взятих у лапки.</para>
<programlisting
>&lt;DetectChar char=&quot;(символ)&quot; (загальні атрибути) (dynamic) /&gt;</programlisting>
<para
>Атрибут <userinput
>char</userinput
> визначає символ, з яким відбуватиметься порівняння.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Detect2Chars</term>
<listitem>
<para
>Перевірка на рівність двом певним символам у вказаному порядку.</para>
<programlisting
>&lt;Detect2Chars char=&quot;(символ)&quot; char1=&quot;(символ)&quot; (загальні атрибути) (dynamic) /&gt;</programlisting>
<para
>Атрибут <userinput
>char</userinput
> визначає перший символ для порівняння, <userinput
>char1</userinput
> — другий.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>AnyChar</term>
<listitem>
<para
>Перевірка на рівність одному з символів вказаного набору.</para>
<programlisting
>&lt;AnyChar String=&quot;(рядок)&quot; (загальні атрибути) /&gt;</programlisting>
<para
>Атрибут <userinput
>String</userinput
> визначає набір символів.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>StringDetect</term>
<listitem>
<para
>Перевірка на рівність вказаному рядку.</para>
<programlisting
>&lt;StringDetect String=&quot;(рядок)&quot; [insensitive=&quot;true|false&quot;] (загальні атрибути) (dynamic) /&gt;</programlisting>
<para
>Атрибут <userinput
>String</userinput
> визначає рядок для порівняння. Типовим значенням атрибута <userinput
>insensitive</userinput
> є <emphasis
>false</emphasis
>, цей атрибут передається функції порівняння рядків. Якщо значенням атрибута буде <emphasis
>true</emphasis
>, порівняння відбуватиметься без врахування регістру.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>RegExpr</term>
<listitem>
<para
>Перевірка на збіг з формальним виразом.</para>
<programlisting
>&lt;RegExpr String=&quot;(рядок)&quot; [insensitive=&quot;true|false&quot;] [minimal=&quot;true|false&quot;] (загальні атрибути) (dynamic) /&gt;</programlisting>
<para
>Атрибут <userinput
>String</userinput
> визначає формальний вираз.</para>
<para
>Типовим значенням атрибута <userinput
>insensitive</userinput
> є <emphasis
>false</emphasis
>, цей атрибут передається рушію пошуку за формальним виразом.</para>
<para
>Типовим значенням атрибута <userinput
>minimal</userinput
> є <emphasis
>false</emphasis
>, цей атрибут буде передано рушієві пошуку за формальним виразом.</para>
<para
>Оскільки пошук відповідників для застосування правила завжди відбувається на початку поточного рядка, формальний вираз, що починається з символу каретки (<literal
>^</literal
>) вказує на те, що пошук відповідника правила слід виконувати лише на початку рядка.</para>
<para
>Щоб дізнатися більше, ознайомтеся з розділом <link linkend="regular-expressions"
>Формальні вирази</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>keyword</term>
<listitem>
<para
>Перевірка на рівність ключовому слову з вказаного списку.</para>
<programlisting
>&lt;keyword String=&quot;(назва списку)&quot; (загальні атрибути) /&gt;</programlisting>
<para
>Атрибут <userinput
>String</userinput
> визначає назву списку ключових слів. Список з вказаною назвою має існувати.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Int</term>
<listitem>
<para
>Перевірка на рівність цілому числу.</para>
<para
><programlisting
>&lt;Int (загальні атрибути) (dynamic) /&gt;</programlisting
></para>
<para
>У цього правила немає специфічних атрибутів. Зазвичай, для виявлення символів, що стоять після числа і позначають тип цілого числа у коді програми, <userinput
>L</userinput
> і <userinput
>U</userinput
>, використовуються дочірні правила. Насправді, можна використовувати будь-які правила як дочірні, але у <acronym
>DTD</acronym
> передбачено використання лише правила <userinput
>StringDetect</userinput
>.</para>
<para
>Приклад пошуку цілих чисел, які слідують за символом «L». <programlisting
>&lt;Int attribute="Decimal" context="#stay" &gt;
  &lt;StringDetect attribute="Decimal" context="#stay" String="L" insensitive="true"/&gt;
&lt;/Int&gt;
</programlisting
></para>

</listitem>
</varlistentry>

<varlistentry>
<term
>Float</term>
<listitem>
<para
>Перевірка на рівність числу з плаваючою крапкою.</para>
<para
><programlisting
>&lt;Float (загальні атрибути) /&gt;</programlisting
></para>
<para
>У цього правила немає специфічних атрибутів. Можна використовувати правило <userinput
>AnyChar</userinput
> як дочірнє, це правило типово використовується для виявлення комбінацій, порівняйте з правилом <userinput
>Int</userinput
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>HlCOct</term>
<listitem>
<para
>Перевірка на відповідність рядка запису вісімкового числа (починається з «0»).</para>
<para
><programlisting
>&lt;HlCOct (загальні атрибути) /&gt;</programlisting
></para>
<para
>У цього правила немає особливих атрибутів.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>HlCHex</term>
<listitem>
<para
>Перевірка на відповідність рядка запису шістнадцяткового числа (починається з «0x»).</para>
<para
><programlisting
>&lt;HlCHex (загальні атрибути) /&gt;</programlisting
></para>
<para
>У цього правила немає особливих атрибутів.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>HlCStringChar</term>
<listitem>
<para
>Перевірка на відповідність символу керівної послідовності.</para>
<para
><programlisting
>&lt;HlCStringChar (загальні атрибути) /&gt;</programlisting
></para>
<para
>У цього правила немає особливих атрибутів.</para>

<para
>Перевірка на відповідність символам, які часто використовуються у коді програм, наприклад, <userinput
>\n</userinput
> (перехід на новий рядок) або <userinput
>\t</userinput
> (табуляція).</para>

<para
>Пошук буде виконуватися за переліченими далі символами, якщо ці символи стоять одразу за зворотною навскісною рискою (<literal
>\</literal
>): <userinput
>abefnrtv&quot;'?\</userinput
>. Крім того, відповідними вважатимуться шістнадцяткові числа, наприклад, <userinput
>\xff</userinput
> і екрановані вісімкові числа, наприклад, <userinput
>\033</userinput
>.</para>

</listitem>
</varlistentry>

<varlistentry>
<term
>HlCChar</term>
<listitem>
<para
>Перевірка на відповідність символу C.</para>
<para
><programlisting
>&lt;HlCChar (загальні атрибути) /&gt;</programlisting
></para>
<para
>У цього правила немає особливих атрибутів.</para>

<para
>Перевірка на відповідність символам C, взятим у одинарні лапки (Приклад: <userinput
>'c'</userinput
>). Отже, у таких лапках може бути простий символ або екранований символ. Щоб дізнатися про пошук екранованих послідовностей символів, перегляньте пункт для HlCStringChar.</para>

</listitem>
</varlistentry>

<varlistentry>
<term
>RangeDetect</term>
<listitem>
<para
>Перевірка на відповідність рядку з вказаними початковим і кінцевим символами.</para>
<programlisting
>&lt;RangeDetect char=&quot;(символ)&quot;  char1=&quot;(символ)&quot; (загальні атрибути) /&gt;</programlisting>
<para
><userinput
>char</userinput
> визначає символ, який повинен починати діапазон символів, <userinput
>char1</userinput
> — символ, який має завершувати діапазон.</para>
<para
>Корисно для виявлення, наприклад, невеличких рядків у лапках, але зауважте, що, оскільки рушій підсвічування обробляє за раз лише один рядок, у такий спосіб неможливо знайти рядки у лапках, які розбито між декількома рядками документа.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>LineContinue</term>
<listitem>
<para
>Перевірка на відповідність символу кінця рядка.</para>
<programlisting
>&lt;LineContinue (загальні атрибути) /&gt;</programlisting>
<para
>У цього правила немає особливих атрибутів.</para>
<para
>Це правило корисне для перемикання контексту наприкінці рядка, якщо останнім символом є зворотна навскісна риска (<userinput
>'\'</userinput
>). Така риска потрібна зокрема у коді мовами C/C++ для продовження макросів або рядків.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>IncludeRules</term>
<listitem>
<para
>Включити правила з іншого контексту або мови/файла.</para>
<programlisting
>&lt;IncludeRules context=&quot;посилання на контекст&quot; [includeAttrib=&quot;true|false&quot;] /&gt;</programlisting>

<para
>Атрибут <userinput
>context</userinput
> визначає контекст, який слід включити.</para>
<para
>Якщо значенням є простий рядок, у поточний контекст буде включено всі визначені правила, наприклад: <programlisting
>&lt;IncludeRules context=&quot;anotherContext&quot; /&gt;</programlisting
></para>

<para
>Якщо рядок починатиметься з <userinput
>##</userinput
>, система підсвічування шукатиме інше визначення для мови з вказаною назвою. Приклад: <programlisting
>&lt;IncludeRules context=&quot;##C++&quot; /&gt;</programlisting
></para>
<para
>Якщо атрибут <userinput
>includeAttrib</userinput
> матиме значення <emphasis
>true</emphasis
>, атрибут призначення буде змінено на атрибут джерела. Це потрібно для того, щоб, наприклад, виконати коментування, якщо текст, що відповідає знайденому контексту, має інше підсвічування, ніж текст у основному контексті. </para>
</listitem>
</varlistentry>


<varlistentry>
<term
>DetectSpaces</term>
<listitem>
<para
>Пошук пробілів.</para>
<programlisting
>&lt;DetectSpaces (загальні атрибути) /&gt;</programlisting>

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


<varlistentry>
<term
>DetectIdentifier</term>
<listitem>
<para
>Пошук рядків ідентифікаторів (зокрема формальних виразів: [a-zA-Z_][a-zA-Z0-9_]*).</para>
<programlisting
>&lt;DetectIdentifier (загальні атрибути) /&gt;</programlisting>

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

</variablelist>
</sect2>

<sect2>
<title
>Підказки та поради</title>

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

<listitem>
<para
>Якщо вам потрібно перевірити відповідність лише двом символам, скористайтеся правилом <userinput
>Detect2Chars</userinput
>, замість правила <userinput
>StringDetect</userinput
>. Те саме стосується правила <userinput
>DetectChar</userinput
>.</para>
</listitem>
<listitem>
<para
>Формальними виразами просто користуватися, але часто існує інший, набагато швидший спосіб досягти результату. Припустімо вам потрібно перевірити, чи є символ <userinput
>'#'</userinput
> першим символом рядка. Вирішення на основі формального виразу має виглядати десь так: <programlisting
>&lt;RegExpr attribute=&quot;Macro&quot; context=&quot;macro&quot; String=&quot;^\s*#&quot; /&gt;</programlisting
> Того самого результату можна досягти набагато швидше за допомогою такого правила: <programlisting
>&lt;DetectChar attribute=&quot;Macro&quot; context=&quot;macro&quot; char=&quot;#&quot; firstNonSpace=&quot;true&quot; /&gt;</programlisting
> Якщо вам потрібно знайти формальний вираз <userinput
>'^#'</userinput
> ви знову ж таки можете скористатися правилом <userinput
>DetectChar</userinput
> з атрибутом <userinput
>column=&quot;0&quot;</userinput
>. Відлік значення атрибута <userinput
>column</userinput
> засновано на кількості символів, отже табуляція вважатиметься лише одним символом. </para>
</listitem>
<listitem>
<para
>Ви можете перемикати контексти без обробки символів тексту. Припустімо, що вам потрібно перемкнути контекст у разі виявлення рядка <userinput
>*/</userinput
>, але також слід обробити цей рядок у наступному контексті. Ви можете скористатися наведеним нижче правилом, у якому атрибут <userinput
>lookAhead</userinput
> призведе до того, що інструмент визначення підсвічування збереже знайдений рядок для обробки у наступному контексті. <programlisting
>&lt;Detect2Chars attribute=&quot;Comment&quot; context=&quot;#pop&quot; char=&quot;*&quot; char1=&quot;/&quot; lookAhead=&quot;true&quot; /&gt;</programlisting>
</para>
</listitem>
<listitem>
<para
>Скористайтеся <userinput
>DetectSpaces</userinput
>, якщо вам відома точна кількість пробілів.</para>
</listitem>
<listitem>
<para
>Скористайтеся <userinput
>DetectIdentifier</userinput
> замість формального виразу <userinput
>'[a-zA-Z_]\w*'</userinput
>.</para>
</listitem>
<listitem>
<para
>За можливості, використовуйте типові стилі. Таким чином, ви полегшите користувачеві призвичаювання до середовища.</para>
</listitem>
<listitem>
<para
>Зазирайте до інших файлів XML, щоб дізнатися як інші люди реалізують складні правила.</para>
</listitem>
<listitem>
<para
>Ви можете перевірити файл XML на коректність за допомогою команди <command
>xmllint --dtdvalid language.dtd мійСинтаксичнийФайл.xml</command
>.</para>
</listitem>
<listitem>
<para
>Якщо у вашому файлі часто вживаються складні формальні вирази, ви можете скористатися визначенням <emphasis
>ENTITIES</emphasis
>. Приклад:</para>
<programlisting
>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;!DOCTYPE language SYSTEM "language.dtd"
[
        &lt;!ENTITY myref    "[A-Za-z_:][\w.:_-]*"&gt;
]&gt;
</programlisting>
<para
>Після такого визначення ви зможете використовувати <emphasis
>&amp;myref;</emphasis
> замість формального виразу.</para>
</listitem>
</itemizedlist>
</sect2>

</sect1>

</appendix>