<chapter id="filetemplates">
  <chapterinfo>

    <title
>Шаблони файлів</title>

    <authorgroup>
      <author
><firstname
>Anders</firstname
> <surname
>Lund</surname
> <affiliation
> <address
>&Anders.Lund.mail;</address>
        </affiliation>
      </author>
<othercredit role="translator"
><firstname
>Юрій</firstname
><surname
>Чорноіван</surname
><affiliation
><address
><email
>yurchor@ukr.net</email
></address
></affiliation
><contrib
>Переклад українською</contrib
></othercredit
> 
    </authorgroup>
<date
>10 січня 2006 року</date
> <releaseinfo
>0.1</releaseinfo
> <keywordset>
      <keyword
>KDE</keyword>
      <keyword
>kate</keyword>
      <keyword
>kdeaddons</keyword>
      <keyword
>шаблон</keyword>
      <keyword
>макрос</keyword>
    </keywordset>
  </chapterinfo>

  <title
>Вступ</title>

  <para
>За допомогою додатка шаблонів файлів ви зможете створювати файли на основі інших файлів. Ви можете скористатися будь-яким файлом як шаблоном, у такому разі буде створено копію цього файла з порожньою адресою &URL;, або скористатися особливим шаблоном, у якому можуть міститися макроси для визначення відомостей про вас, на зразок вашого імені та адреси електронної пошти, поточної дати тощо, так, щоб курсор у новоствореному файлі було розташовано у зручній для вас позиції.</para>
  <para
>Крім того, шаблони, розташовані у теці шаблонів, буде представлено у підменю <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Створити з шаблона</guimenuitem
></menuchoice
>.</para
> <para
>За допомогою додатка ви також зможете легко створити новий шаблон на основі відкритого документа.</para>
  <para
>Тека шаблонів є частиною файлової системи &kde;, вона складається принаймні з KDEDIR/share/applications/kate/plugins/katefiletemplates/templates і KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Якщо ваша змінна середовища KDEDIRS містить додаткові каталоги, ці каталоги буде перевірено на наявність подібних назв підтек. Якщо буде знайдено шаблони з однаковими назвами, буде обрано лише шаблон у вашій локальній (KDEHOME) теці.</para>
  <sect1 id="katefiletemplates-menu">
    <title
>Структура меню</title>

    <variablelist>
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Файл</guimenu
> <guimenu
>Створити з шаблона</guimenu
> <guimenuitem
>Будь-який файл...</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Відкриває діалогове вікно «Відкрити файл», за допомогою якого ви зможете використати будь-який файл як шаблон. Якщо назва обраного файла матиме суфікс <filename
>katetemplate</filename
>, відбудеться пошук у цьому файлі відомостей про шаблон і макросів.</para
></listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Файл</guimenu
> <guimenu
>Створити з шаблона</guimenu
> <guimenuitem
>Використовувати недавній</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Показує список файлів, які нещодавно було використано як шаблони, у вигляді адрес  &URL; цих файлів.</para
></listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Файл</guimenu
> <guimenuitem
>Створити з шаблона</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Інші пункти підменю міститимуть посилання на шаблони. Оберіть пункт меню, щоб створити файл у спосіб, описаний у тексті пункту меню.</para
></listitem>
      </varlistentry>

      <!-- Settings menu -->

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

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

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

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

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

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

    </sect2>

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

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

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

  </sect1>

  <sect1 id="katefiletemplates-thanks-and-acknowledgements">
    <title
>Подяки</title>

    <para
>Авторські права на втулок &kate; <quote
>Шаблони файлів</quote
> належать ©2004 &Anders.Lund; &Anders.Lund.mail;. </para>

    <para
>Авторські права на документацію до втулка належать ©2004 &Anders.Lund; </para>

    <para
>Переклад українською: Юрій Чорноіван<email
>yurchor@ukr.net</email
></para
> 
&underGPL; </sect1>
</chapter>

<!-- kate: word-wrap on; space-indent on; indent-width 2; -->