# Шаблони файлів

Anders
Lund

    &Anders.Lund.mail;

Юрій
Чорноіван

    yurchor@ukr.net

Переклад українською
10 січня 2006 року
0.1
KDE
kate
kdeaddons
шаблон
макрос

# Вступ

За допомогою додатка шаблонів файлів ви зможете створювати файли на основі інших файлів. Ви можете скористатися будь-яким файлом як шаблоном, у такому разі буде створено копію цього файла з порожньою адресою &URL;, або скористатися особливим шаблоном, у якому можуть міститися макроси для визначення відомостей про вас, на зразок вашого імені та адреси електронної пошти, поточної дати тощо, так, щоб курсор у новоствореному файлі було розташовано у зручній для вас позиції.

Крім того, шаблони, розташовані у теці шаблонів, буде представлено у підменю Файл Створити з шаблона.

За допомогою додатка ви також зможете легко створити новий шаблон на основі відкритого документа.

Тека шаблонів є частиною файлової системи &kde;, вона складається принаймні з KDEDIR/share/applications/kate/plugins/katefiletemplates/templates і KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Якщо ваша змінна середовища KDEDIRS містить додаткові каталоги, ці каталоги буде перевірено на наявність подібних назв підтек. Якщо буде знайдено шаблони з однаковими назвами, буде обрано лише шаблон у вашій локальній (KDEHOME) теці.

## Структура меню

Файл Створити з шаблона Будь-який файл...

  Відкриває діалогове вікно «Відкрити файл», за допомогою якого ви зможете використати будь-який файл як шаблон. Якщо назва обраного файла матиме суфікс `katetemplate`, відбудеться пошук у цьому файлі відомостей про шаблон і макросів.

Файл Створити з шаблона Використовувати недавній

  Показує список файлів, які нещодавно було використано як шаблони, у вигляді адрес &URL; цих файлів.

Файл Створити з шаблона

  Інші пункти підменю міститимуть посилання на шаблони. Оберіть пункт меню, щоб створити файл у спосіб, описаний у тексті пункту меню.

Параметри Керування шаблонами...

  Вибір цього пункту призведе до відкриття діалогового вікна зі списком всіх шаблонів, знайдених у каталогах шаблонів, а також пунктами для додавання, зміни і вилучення шаблонів.

## Користування шаблоном &kate;

Під час створення файла з шаблона, у якому містяться макроси шаблона, деякі макроси буде показано у тексті як придатні для редагування змінні. Такі змінні виглядатимуть у тексті як підкреслені слова.

Першу зі змінних буде обрано, отже вам просто слід почати вводити інформацію, щоб змінити її значення. Якщо текст документа містить інші включення цієї з змінної, всі ці включення буде замінено на введений вами текст. Щоб перейти до наступної придатної для редагування змінної, натисніть клавішу Tab. Після визначення останньої зі змінних, список буде закрито, а клавіша Tab вашої клавіатури запрацює у звичному режимі.

## Створення ваших власних шаблонів

Щоб створити новий шаблон, скористайтесь пунктом меню Параметри Керування шаблонами, за допомогою якого можна відкрити діалогове вікно керування шаблонами. У цьому вікні натисніть кнопку Створити..., щоб запустити Майстер створення нового шаблона. Програма запитає вас про назву необов’язкового файла, який слід перетворити на шаблон, а також про параметри відомостей про шаблон, а потім створить для вас файл шаблона.

Крім того, ви можете створити шаблон вручну, додаванням відомостей про шаблон у верхню частину будь-якого файла, додаванням тексту і макросів, а потім збереженням файла з назвою, яка завершуватиметься суфіксом `katetemplate`.

Якщо ви збережете ваш шаблон у каталозі шаблонів, меню шаблонів буде відповідним чином автоматично оновлено.

## Редагування шаблонів

Щоб змінити шаблон, скористайтеся пунктом меню Параметри Керування шаблонами.... Оберіть шаблон, з яким ви бажаєте попрацювати і натисніть кнопку Редагувати..., — програма відкриє відповідний файл шаблона. Закрийте це діалогове вікно, змініть файл шаблона бажаним чином, збережіть його і закрийте. Зміни, виконані у шаблоні, негайно набудуть чинності, — ви можете задіяти шаблон і перевірити результат ваших змін одразу після збереження шаблона.

## Формат шаблона &kate;

Якщо ви використовуватимете файли, назви яких мають суфікс `katetemplate`, програма знайде записані у них відомості про шаблон, макроси і дані про розташування курсора.

### Відомості про шаблон

Під час читання такого файла, інструмент обробки виявлятиме рядки, які починаються виразами `katetemplate:` і шукатиме у них відомості про шаблон у вигляді НАЗВА_ЗМІННОЇ=ЗНАЧЕННЯ. Перший же рядок, який починатиметься не з `katetemplate:` вважатиметься початком вмісту шаблона. ЗНАЧЕННЯ може складатися з будь-яких символів, окрім знака рівності (=). Можливими назвами змінних є:

`Template`

  Це назва шаблона, яку буде показано у меню Файл Створити з шаблона.

`Group`

  Група, у якій буде розміщено шаблон у підменю Файл Створити з шаблона.

`Name`

  Це назва, яку буде встановлено для документа і показано у списку файлів і смужці заголовка. Якщо назва міститиме шаблон заміни `%N`, цей шаблон буде замінено на число, яке збільшуватиметься зі збільшенням кількості документів з однаковою назвою.

`Highlight`

  Додаток намагатиметься встановити підсвічування у новому документі відповідно до значення цієї змінної. Значенням має бути назва, одна з тих, які можна знайти у меню Інструменти Підсвічування . Назву слід вказувати англійською мовою.

`Description`

  Короткі описові відомості про шаблон. У поточній версії цей пункт використовується для показу підказки «Що це?» для пункту меню, але цю інформацію у майбутніх версіях може бути використано і з іншою метою.

Author

  Рядок, що визначає автора, наприклад, у формі `Ім’я <адреса електронної пошти>`. У поточній версії цей пункт використовується для показу підказки «Що це?» для пункту меню, але цю інформацію у майбутніх версіях може бути використано і з іншою метою.

### Макроси шаблона

Під час обробки вмісту шаблона, буде розгорнуто макроси у формі `%{НАЗВА}` або `${НАЗВА}`. Якщо ви скористаєтеся префіксом `$`, розгорнутий макрос буде вважатися придатною для зміни змінною під час створення документа з шаблона, а якщо ви скористаєтеся префіксом `%`, така змінна не вважатиметься придатною для зміни, і спроба розгортання завершиться невдало.

Розгортаються такі макроси:

time

  Розгортається до поточного часу у форматі вашої локалі.

date

  Розгортається до поточної дати у форматі вашої локалі.

datetime

  Розгортається до поточної дати і часу, зібраних у вигляді рядка, відповідно до вашої локалі.

year

  Поточний рік у вигляді числа з чотирьох цифр.

month

  Повна назва поточного місяці, відповідно до вашої локалі.

day

  Розгортається до поточного дня місяця.

hostname

  Розгортається до назви вузла вашого комп’ютера у мережі.

index

  Розгортається до «i».

fullname

  Розгортається до повної форми вашого імені у тому вигляді, у якому її вказано у адресі власника вашої стандартної адресної книги &kde;.

firstname

  Розгортається до вашого імені у тому вигляді, у якому його вказано у адресі власника вашої стандартної адресної книги &kde;.

lastname

  Розгортається до вашого прізвища у тому вигляді, у якому його вказано у адресі власника вашої стандартної адресної книги &kde;.

email

  Розгортається до вашої адреси електронної пошти у тому вигляді, у якому її вказано у адресі власника вашої стандартної адресної книги &kde;.

Всі макроси, які не належать до наведеного вище списку, вважатимуться змінними придатними для перевизначення, незалежно від префікса. Якщо у шаблоні використано декілька включень однієї змінної, після створення документа з шаблона заміна цих включень текстом відбуватиметься одночасно у всіх місцях документа.

### Встановлення розташування курсора

Особливий макрос `${cursor}` буде замінено на вертикальну риску і додано у кінець списку придатних для редагування змінних, незалежно від його розташування у тексті.

## Подяки

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

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

Переклад українською: Юрій Чорноіванyurchor@ukr.net

&underGPL;