# Підручник з &kile;

## Передмова

### Вимоги

Щоб можна було користуватися &kile;, вам слід встановити наступні компоненти у вашу систему:

- K Desktop environment (&kde;): &kde; — це популярне стільничне середовище з відкритим кодом.

- &Qt;: &Qt; — це написана на C++ бібліотека для створення графічного інтерфейсу і програм для роботи у мережі, потрібна для збирання &kile;.

- &latex;: високоякісна програма для верстання документів. Швидше за все, вам потрібен пакунок &texlive; (або &tetex; на застарілих системах), якщо ви працюєте у Unix-подібній системі.

Більшість з цих елементів уже наявні у вашому дистрибутиві Linux; будь ласка, зверніться до документації вашого дистрибутива, або пошукайте на вашому компакт-диску або DVD для встановлення пакунки для встановлення цих програм на вашому комп’ютері.

Можливо, &kile; вже зібрано у бінарний пакунок для вашого дистрибутива &Linux;. Будь ласка, скористайтеся програмою керування пакунками у вашому дистрибутиві для пошуку відповідного пакунка.

### Коло призначення

Цей підручник написано для всіх, незалежно від їх досвіду у &latex;, &kde;, &kile; або Linux.

Досвідчені користувачі навряд чи читатимуть цей підручник, але буде розглянуто всі пропозиції щодо покращення документації. Якщо ви бажаєте зробити внесок до проекту або цієї документації, будь ласка, зверніть по настанови до вебсторінки &kile;.

Потрібні відповіді щодо &kile;? Маєте труднощі зі збиранням програми? Вам потрібна додаткова функція у програмі? Найкращим шляхом для того, щоб задати технічне питання або розпочати обговорення, є використання нашого списку листування: kile-devel@lists.sourceforge.net.

## Вступ

### Основні факти

#### Про &kile;

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

#### &kile; і компонент редактора &kate;

&kile; засновано на компоненті редактора &kate;, отже значна частина можливостей з редагування запозичена з &kate;, &kile; розширює можливості редагування цієї програми на документи &latex;. Щоб дізнатися більше про програму &kate; і її можливості, зверніться до сторінки &kate; у інтернеті.

#### Що таке &latex;?

&latex; — це система обробки текстів, створена на основі &tex;, програми, першу версію якої було розроблено Дональдом Кнутом (Donald Knuth) у 1977 році для професійного компонування робіт. Ця програма виконувала завдання, подібні до завдань набірника, тобто робітника, який компонує документ відповідно до специфікацій типу документа. &latex; було створено Леслі Лемпортом (Leslie Lamport) як інструмент, який надав авторам текстів можливість автоматичного набору, особливо, якщо йдеться про вартісний і важкий набір математичних формул і виразів, які у &latex; завжди мають перебувати між знаками долара. Сьогодні програми-процесори текстів надають змогу будь-якому користувачеві бути набірником. Але, насправді, часто єдиною вашою метою є створення документа, який би було приємно читати, а не витрачання годин праці на те, щоб зробити його вигляд чудовим. &latex; бере на себе завдання з покращення вигляду тексту і надає вам змогу зосередитися на вмісті, а не на компонуванні. А результат має виглядати чудово!

#### Як вимовляється це слово? Чому його пишуть у такий дивний спосіб?

Існує весела традиція: назви пакунків, пов’язаних з &tex;, мають дивну вимову або написання. Автор склав назву з міркувань того, що &tex; — це грецьке τεχ, записане латинськими літерами tech. Існує багато пояснень цього факту, але найімовірнішою причиною такої назви є те, що від початку &tex; було призначено для технічної літератури, його найголовнішим призначенням було створення середовища для правильного і простого друку математичних формул, яке тоді було дорогою, тривалою і непростою справою.

Вимовляти цю назву слід так: Т, відповідно до звуку, який позначає ця літера, Е, як у слові мед і Х, подібно до звуку німецької, який на письмі позначається літерами ch (пом’якшений варіант українського «х»). IPA-символом, що відповідає цьому звуку є /ç/. Відомо, що багато хто вимовляє цей звук як ach (IPA-символ /x/), але автор особисто запитував у людей, для яких грецька мова є рідною, і вони підтвердили перший варіант вимови. Майте на увазі, що багато хто вимовляє назву неправильно: /teks/ (текс) або /tek/ (тек).

Нарешті, у слові &latex; комбінація літер LA вимовляється як лей: ідея, яка лежить в основі цієї назви, полягала у тому, що, якщо звичайний &tex; є досить важким, макросами &latex; може користуватися навіть layman (дилетант). Простішою, але реалістичнішою виглядає версія про те, що відповідні літери просто взято з прізвища Леслі Лемпорта (Leslie Lamport), автора &latex;. Отже, тепер ви все знаєте про назви!

### &latex; 101

Система набору тексту у &latex; подібна до інших мов розмітки, зокрема XML, які використовуються у багатьох типах документів (зокрема у тому документі, який ви зараз читаєте), або мови HTML, яка використовується для створення вебсторінок. Загальною ідеєю є використання спеціально оформлених ключових слів, які називаються теґами, які повідомляють програмі (текстовому процесору, переглядачеві сторінок інтернету або компілятору &latex;) про спосіб представлення тексту. У &kile; передбачено додавання значної кількості цих теґів за допомогою меню LaTeX.

Хоча ми і надамо вам загальні відомості щодо &latex;, звичайно ж, цей підручник не є вичерпним довідником з &latex;. Якщо ви бажаєте досконало оволодіти &latex;, вам варто взяти підручник з відповідного питання у вашій бібліотеці. Ви можете скористатися російськомовним підручником С.М. Львовського «Набор и вёрстка в системе &latex;», який є досить повним описом потрібних відомостей.

Як і у інших мовах розмітки, документ &latex; містить преамбулу, у якій встановлюються загальні команди, зокрема розмір паперу, спосіб нумерування сторінок, виміри блоку тексту на сторінці, та тіла документа, де міститься текст документа. У преамбулі має міститися принаймні команда `\documentclass`, преамбула має передувати тілу, яке починається командою `\begin{document}` і завершується, очевидно, наступною командою `\end{document}`.

### Основні можливості &kile;

#### Майстер швидкого запуску

Вбудований до &kile; майстер швидкого запуску корисний, якщо вам потрібно швидко створити документ за допомогою &kile;. Якщо ви скористаєтеся пунктом майстра у меню програми, ви зможете вибрати один з багатьох варіантів створення вашого документа. Крім того, ви зможете вказати декілька параметрів, пов’язаних з типом документа, який ви оберете.

Параметри класу:

- Клас документа: тут ви можете вибрати тип документа, який ви бажаєте створити: article, book, letter, report, scrartcl, scrreprt, scrbook, prosper, beamer або інший вказаний вами тип.

- Розмір шрифту: повідомте &kile;, шрифт якого розміру (у пт) ви бажаєте використовувати у документі.

- Розмір паперу: виберіть розмір або формат аркушів.

- Кодування: загалом, найкраще використати стандартне кодування вашої системи. У сучасних системах як стандартне все ширше використовується кодування UTF-8. Якщо можете, використовуйте utf8 або utf8x (саме так це кодування позначається у документах &latex;).

- Інші параметри: тут ви можете вказати інші параметри, що стосуються друку, чернеток тощо.

Пакунки

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

Властивості документа

- Автор: тут введіть своє ім’я.

- Заголовок: сюди введіть заголовок документа.

- Дата: вкажіть дату.

#### Наперед визначені шаблони

Попередньо визначеними шаблонами у &kile; є:

- Порожній документ: справжні джедаї починають з порожнього листа!

- Article: встановлює формат статті, для документів, які достатньо короткі, щоб їх можна було не розбивати на глави.

- Report: встановлює формат звіту, для документів середнього розміру, з нумерацією сторінок, наприклад, з зовнішньої сторони сторінки.

- Book: формат книги, повноцінної монографії, достатньо потужний для написання багатьох університетських підручників.

- Letter: встановлює формат листа.

- Beamer, HA-Prosper: призначений для створення чудових презентацій у PDF, ці презентації виглядають просто чудово: у них сконцентровано всю потужність &latex;.

- Powerdot: Powerdot — це спадкоємець пакунків `seminar` і `HA-Prosper`. у ньому передбачено менше параметрів налаштування, ніж у Beamer, але ним просто користуватися, він створює чудові презентації у форматі PDF.

- Scrartcl, Scrbook, Scrreprt, Scrlttr2: класи документів KOMA-Script, спеціально адаптовані до німецьких типографських стандартів. Скористайтеся ними, якщо ви готуєте тексти німецькою.

- Xelatex: змінений шаблон `Article` для використання з `XeLaTeX`.

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

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

#### Підсвічування синтаксису

&kile; подібний до програм, які працюють з вихідними кодами і редагуванням: програма здатна автоматично підсвічувати команди, параметри і елементи, які було використано (та тих, які було використано неправильно). У &kile; можна легко візуально визначити проблемні фрагменти тексту: наприклад, якщо фрагмент тексту показано зеленим кольором, ви забули закрити середовище математичної формули. Про проблеми можна дізнатися і за неправильним виглядом остаточного файла, але підсвічування збереже вам час і дозволить уникнути важких пошуків причин помилки.

#### Автозавершення середовищ

Автоматичне завершення середовищ означає, що якщо ви починаєте створення середовища командою `\begin{середовище}`, &kile; автоматично вставить відповідну команду `\end{середовище}` разом з порожнім рядком між цими командами, у якому ви можете розпочати введення тексту середовища. Звичайно ж, ви можете вимкнути цю функціональну можливість за допомогою сторінки Параметри Налаштувати Kile... LaTeX Середовища.

#### Перехід до структури елемента

Всі документи, зазвичай, мають структурну ієрархію певного типу. У &latex; ви можете розбити документ на такі структурні одиниці (частина (part) є найвищою одиницею ієрархії, а підпараграф (subparagraph) — найнижчою):

- \part

- \chapter

- \section

- \subsection

- \subsubsection

- \paragraph

- \subparagraph

Під час перегляду структури документа у області перегляду Структура ви можете відкривати різні елементи структури у редакторі натисканням пункту елемента, вміст якого ви бажаєте переглянути.

#### Зворотний пошук

Якщо ви створюєте власні файли &latex;, зворотній пошук буде дуже корисним. Після створення файла DVI (DeVice Independent File або файла, незалежного від пристрою) або файла PDF, ви можете навести вказівник миші на цікаве місце у програмі-переглядачі, натиснути клавішу &Shift; і клацнути лівою кнопкою миші, і &kile; відкриє у вікні редактора фрагмент з відповідним рядком вихідних кодів &latex;.

У файлах типу DVI міститься опис форматованого документа, а також інші дані, зокрема дані шрифту символів. Файли цього типу, разом з PDF, звичайним результатом обробки компіляторами &tex; або &latex;. Існує багато програм, призначених для перегляду, перетворення і друку файлів DVI у різноманітних системах і на різноманітних пристроях.

#### Прямий пошук

Кожному елементу у файлі DVI або PDF відповідають певні рядки у редакторі вихідних кодів, отже, якщо ви скористаєтеся зворотнім пошуком і натиснете у певному місці області показу файла DVI або PDF, у редакторі коду &latex; буде показано відповідний фрагмент коду. Прямий пошук є функціональною можливістю, протилежною до цієї можливості. За використання прямого пошуку ви можете клацнути кнопкою миші у певному місці вихідних кодів &latex;, а програма має відкрити відповідне місце у вікні програми перегляду.

### Панель інструментів

- Створити: започатковує редагування нового документа.

- Відкрити: відкрити новий документ.

- Закрити: закрити ваш документ.

- Зробити поточний документ головним: цим пунктом можна скористатися під час роботи з документами, що складаються з декількох файлів. Позначення головного документа спростить вам роботу з іншими файлами `.tex`, включеними до вашого документа. Якщо ви користуєтеся для керування документами проектами, ви можете встановити головний документ проекту за допомогою пункту менюПроект->Параметри проекту.

- Quickbuild: призначено для компіляції ваших вихідних кодів &latex; і автоматичного показу результатів, якщо збирання кодів завершилося без помилок.

- Режим нагляду за файлами: у цьому режимі програма «наглядатиме» за змінами у файлах DVI і не запускатиме новий сеанс &okular; після виконання команди Quickbuild.

- Перегляд файла журналу: відкриває перегляд файла `.log`, за допомогою якого ви зможете виявити помилки.

- Попередня помилка: перейти до попереднього запису у файлі `.log` і позначити помилку у файлі джерела.

- Наступна помилка: перейти до наступного запису у файлі `.log` і позначити помилку у файлі джерела.

- Зупинити: зупиняє поточний інструмент.

- LaTeX: запускає &latex; для активного документа.

- ViewDVI: запускає інструмент перегляду файла DVI.

- DVItoPS: перетворює файл DVI на файл &PostScript; (PS).

- ViewPS: запускає інструмент перегляду файла &PostScript; (PS).

- PDFLaTeX: запускає компілятор &pdflatex; для поточного документа.

- ViewPDF: запускає інструмент перегляду файла PDF.

- DVItoPDF: перетворює файл DVI на файл PDF.

- PStoPDF: перетворює PS на PDF.

- ViewHTML: відкриває переглядач створеного HTML.

- ForwardDVI: відкриває сторінку файла &DVI;, яка відповідає поточному рядку у коді, показаному у вікні редактора.

- ForwardPDF: відкриває сторінку файла PDF, яка відповідає поточному рядку у коді, показаному у вікні редактора.

Якщо ви поглянете на панель інструментів Зміни ви побачите три великих спадних списки. Ці спадні меню було створено для спрощення додавання певних типових елементів до вашого документа. Першим зі спадних списків можна скористатися для швидкого розбиття вашого документа на частини, глави, розділи тощо. Серед можливих структурних частин вашого вихідного коду &latex;:

- part: найбільше структурна частина документа.

- chapter: починає нову главу.

- section: починає новий розділ.

- subsection: починає новий підрозділ.

- subsubsection: підрозділ другого рівня, розташованого між підрозділом і параграфом.

- paragraph: починає новий параграф.

- subparagraph: починає новий підпараграф.

Спадним списком з назвою Інше можна скористатися для вставки елементів на зразок елементів покажчика, зносок і посилань до вашого документа. Серед можливих команд у цьому списку:

- label: команда, яка створює мітку для глави, рисунка або іншого елемента.

- index: створює новий запис у покажчику.

- footnote: створює підрядкову примітку у вашому документі.

- ref: використовується для посилання на раніше створену командою label мітку, цю мітку ви можете вибрати зі спадного списку.

- pageref: подібна до ref, але посилання здійснюється на сторінку, а не на сам елемент структури документа.

- cite: створює посилання на дані з бібліографії.

Спадне меню Інше Спадне меню Інше

Спадне меню Інше

Вибір мітки для посилання Вибір мітки для посилання

Вибір мітки для посилання

За використання команди cite програма має показати вам спадний список всіх елементів бібліографії, але, якщо ви користуєтеся &bibtex;, ця можливість працюватиме, лише якщо файл належить до проекту. Для редагування файлів &bibtex; ми рекомендуємо вам скористатися спеціалізованим редактором. Автор цього підручника вважає найкращими редакторами &kbibtex; і &kbib;. Звичайно ж, ви можете створити файли &bibtex; і вручну за допомогою &kile;.

Останній зі спадних списків з міткою Розмір використовується для визначення розміру шрифту тексту. Ви можете вказати розмір основного тексту, тексту зносок тощо. Серед можливих варіантів:

- крихітний: найменший.

- розмір індексу: дуже малий.

- розмір виноски: менший.

- малий: малий.

- звичайний розмір: звичайний.

- великий: великий.

- Великий: більший.

- ВЕЛИКИЙ: ще більший.

- величезний: навіть більше.

- Величезний: найбільший.

## Швидкий запуск

### Створення документа &latex; за допомогою &kile; для початківців

Користувачі &kile; можуть скористатися одним з двох способів створення документа: скористатися Майстром створення документів, вибрати тип документа, який слід створити, та визначити його параметри, зокрема розмір шрифту, розмір паперу тощо; або просто вписати відповідний код вручну.

    \documentclass[12pt]{article}
    \usepackage[T2A]{fontenc}\usepackage[utf8]{inputenc}
    \begin {document}
            Якийсь текст з кодами \LaTeX.
    \end{document}

Всі документи у &latex; починаються з команди `\documentclass[додаткові параметри]{клас}`, де «клас» визначає тип документа.

Введення прикладу коду, наведеного вище, у поле для введення тексту дасть вам такий результат:

Скомпільований у DVI текст Скомпільований у DVI текст

Скомпільований у DVI текст

У квадратних дужках після команди `\documentclass` містяться параметри команди. Параметр `[12pt]` встановлює розмір шрифту вашої статті; якщо на початку документа розмір шрифту не буде вказано, ви зможете встановити цей розмір у тексті документа.

Після того, як ви завершите введення коду прикладу з блоку, наведеного вище, вам потрібно буде скомпілювати ваші вихідні коди &latex;. Найпростішим способом компіляції &latex; є використання меню Збирання або натискання кнопки Quickbuild.

&Alt;2 — це клавіатурне скорочення для компіляції вашого початкового коду.

Вам слід зберегти файл з текстом перед його компіляцією; &kile; виконає це завдання за вас у автоматичному режимі.

Якщо програмі не вдається зібрати ваш документ, погляньте на журнал помилок. Якщо для збирання ви натискали кнопку Quickbuild, програма автоматично запустить переглядач &okular;, якщо цього не сталося, знову ж таки, погляньте на те, що написано у журналі.

### Середовища

Середовище — це фрагмент тексту, який має власні параметри, відмінні від решти тексту документа. Нехай ви створили звіт з розміром шрифту 12 пунктів, але бажаєте змінити цей розмір для декількох речень. Послідовність команд `\begin{середовище}`, `\huge` і `\end{середовище}` надасть вам змогу змінити розмір шрифту тексту між командами середовища на величезний (huge).

Зміни параметрів тексту стосуватиметься лише фрагменту між командами `\begin{середовище}` і `\end{середовище}`. Кількість змін, яку ви можете вносити до параметрів тексту середовища, є необмеженою.

Існує багато елементів оформлення, які можуть зробити ваш документ приємнішим для читання та зрозумілішим. Ви можете використовувати особливу гарнітуру шрифту, напівжирний шрифт, підкреслювання тощо. Дія відповідних команд завершуватиметься після команди `\end` або після завершення вашого середовища.

- `\begin{emph}`: за допомогою цієї команди можна позначити фрагмент тексту курсивом, зміна вигляду шрифту діятиме до команди `\end{emph}` або початку нового середовища. Щоб написати курсивом одне слово речення, скористайтеся конструкцією на зразок: це `\emph{моє}` речення.

- `\textbf{Текст всередині фігурних дужок буде напівжирним}`: за допомогою цієї команди можна зробити фрагмент тексту напівжирним.

- `\quote`: призначено для додавання поля цитування у ваш документ, цитату слід почати з оголошення `\begin{quote}` і завершити оголошенням `\end{quote}`.

- `\center`: вирівнює текст по центру.

- `\verse`: створює середовище для текстів віршів.

- `\itemize`: створює ненумерований список.

### Користування &kile;

Тепер, коли ви вже маєте певне уявлення щодо того, як писати код з використанням мови розмітки &latex;, ми наведемо для вас покрокову процедуру створення документа за допомогою &kile;.

1. Запуск &kile;.

2. Скористайтеся пунктом меню Майстер Швидкий запуск, потім оберіть формат і вкажіть потрібні вам параметри за допомогою майстра.

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

4. Збережіть ваш файл, надавши йому назву, скажімо, `intro.tex`.

5. Зберіть ваш документ за допомогою натискання комбінації клавіш &Alt;2 або натискання кнопки з міткою LaTeX.

6. Натисніть кнопку ViewDVI.

7. Перегляньте створений текст.

8. Коли ви надивитеся на ваш документ, натисніть кнопку Вікно редактора або комбінацію клавіш &Ctrl;E, щоб повернутися до вікна редактора, якщо ви користувалися вбудованим переглядачем, або закрийте вікно програми перегляду, якщо ви користувалися окремим вікно перегляду.

Ось і все! Ви тільки-но створили ваш перший документ &latex;!

Після створення вашого DVI файла ви зможете надрукувати ваш документ або перетворити його на файл &PostScript; або PDF. Спробуйте, це цікаво!

### Файли DVI

DVI є файлом DeVice Independent (незалежним від пристрою). Такі файли створюються за допомогою &tex; або &latex; для читання певним драйвером на вашому комп’ютері. Існує багато інших пристроїв виводу даних, на які можна надіслати файл `.dvi`, зокрема принтер, інструмент перетворення на файли &PostScript; або PDF або просто екран вашого комп’ютера.

#### Перегляд DVI

Ви вже ознайомилися з тим, як можна переглянути файл DVI за допомогою натискання кнопки ViewDVI на панелі інструментів.

#### Друк DVI

Для друку DVI ви можете скористатися процедурою, подібною до тієї, яку ви раніше виконували для створення документа (див. quick_using). На кроці 7, після натискання кнопки ViewDVI, скористайтеся пунктом меню Файл Друкувати переглядача, і, якщо ваш принтер належно налаштовано, ви зможете надрукувати ваш файл DVI.

#### Перетворення файлів DVI

За допомогою панелі інструментів ви зможете перетворити файл DVI на файл у інших форматах. Після створення файла DVI з ваших вихідних кодів &latex; його можна експортувати до вказаного вами формату за допомогою натискання кнопок панелі інструментів.

### Прямий пошук між &kile; і &okular;

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

У &kile; передбачено можливість налаштування всіх файлів програм &latex; з відповідним параметром. Відкрийте сторінку Параметри Налаштувати Kile... Інструменти Збирання і оберіть Сучасні налаштування.

Щоб виконати прямий пошук, розташуйте курсор у потрібному рядку коду документа, а потім натисніть кнопку Прямий пошук, щоб перейти до відповідного місця у вікні переглядача &DVI; або PDF.

### Зворотний пошук між &kile; і &okular;

Зворотній пошук стане у пригоді, якщо ви створюєте документ &latex; власноруч. Якщо все налаштовано належним чином, ви зможете натиснути клавішу &Shift; і клацнути у вікні &okular; лівою кнопкою миші. Після цього &kile; завантажить відповідний файл кодів &latex; і відкриє у ньому відповідний абзац тексту. Щоб мати змогу користуватися зворотнім пошуком, вам слід зібрати ваш файл &latex; з використанням Сучасних налаштувань.

Зворотній пошук не працюватиме, якщо ви не виконаєте таких умов:

- Файл початкових кодів має бути успішно зібрано.

- &okular; відомі дані щодо редактора, який ви бажаєте використовувати.

За використання цієї можливості &okular; натискання клавіші &Shift; з наступним клацанням лівою кнопкою миші у документі DVI призведе до відкриття відповідного документа &latex; у &kile; з наступною спробою перейти до відповідного рядка у коді. Не забудьте повідомити &okular; про те, що слід використовувати &kile; як текстовий редактор, це можна зробити за допомогою пункту меню &okular; Параметри Налаштувати Okular... (на сторінці Редактор).

Налаштування &okular; Налаштування &okular;

Налаштування &okular;

### Усування помилок

Якщо ви використовуєте можливість quickbuild, а програма-переглядач DVI не відкривається у відповідь на натискання кнопки, ймовірно, зібрати документ не вдалося через помилку. Якщо сталася помилка, повідомлення про неї можна буде побачити у області перегляду файла журналу і повідомлень, там же буде наведено резюме помилки.

У файлі журналу ви зможете знайти посилання на джерело помилки у вашому коді. У вікні редактора ви можете скористатися кнопками панелі інструментів з мітками Попередня помилка у LaTeX і Наступна помилка у LaTeX для переходу між рядками коду, у яких містяться помилки. У файлі журналу завжди зазначатиметься номер рядка коду, обробка якого призвела до помилки. Щоб переглянути рядок, у якому було знайдено помилку, натисніть повідомлення про помилку на панелі перегляду журналу, — програма перегорне текст у редакторі так, щоб ви побачили рядок з помилкою.

## Створення нового документа

Після натискання кнопки панелі інструментів, призначеної для створення документа, програма відкриє діалогове вікно, у якому запитає вас про тип шаблону, яким ви бажаєте скористатися для написання вашого документа. Серед типових варіантів:

- Порожній документ

- Стаття

- Beamer

- Книга

- HA-Prosper

- Powerdot

- Лист

- Звіт

- Scrartcl (з пакунка KOMA-Script)

- Scrbook (з пакунка KOMA-Script)

- Scrlttr2 (з пакунка KOMA-Script)

- Scrreprt (з пакунка KOMA-Script)

- PDF

- XeLaTeX

Якщо ви оберете варіант Порожній документ, ви зможете або розпочати введення документа з порожнього місця, або скористатися майстром, призначеним для пришвидшення створення документа (див. intro_docwizard).

### Шаблони

Ті, хто користується &latex; постійно, зазвичай, використовують однакову преамбулу майже у всіх документах, які створюють. Для полегшення роботи з подібними типовими документами у &kile; передбачено можливість створення, збереження і завантаження шаблонів документів, які роблять створення нових документів простішим.

#### Створення нового шаблону

Для того, щоб створити новий шаблон, вам спочатку слід або відкрити якийсь файл &tex; / &latex;, або створити такий файл власноруч. У &kile; передбачено можливість створення шаблону на основі існуючого документа: вам слід відкрити цей документ, а потім скористатися пунктом меню Файл Створити шаблон з документа.

#### Налаштування автоматичних замін

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

Якщо ви маєте намір розробити власний шаблон, вам буде корисно знати про те, яка комбінація символів відповідає за кожну зі змінних шаблону:

- `$$AUTHOR$$`: цей рядок буде замінено на значення змінної «автор».

- `$$DOCUMENTCLASSOPTIONS$$`: цей рядок буде замінено змінною параметрів класу документа. Типове використання:: `\documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}`.

- `$$INPUTENCODING$$`: якщо змінну вхідного кодування (inputencoding) встановлено, скажімо, у значення `utf8` цей рядок буде замінено на `\input[utf8]{inputenc}`.

#### Створення шаблону за допомогою Майстра

Найпростішим способом створення шаблону є запуск майстра з наступним додаванням команд у редакторі. Після налаштування вашого документа у бажаний спосіб виконайте такі дії:

1. Збережіть ваш файл;

2. Відкрийте меню Файл;

3. Скористайтеся пунктом меню Створити шаблон з документа;

4. Внесіть потрібні зміни до шаблону.

5. Введіть назву вашого нового шаблону;

6. Натисніть кнопку Гаразд, щоб додати ваш шаблон до меню.

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

#### Створення шаблону на основі довільного файла

Ви можете створити шаблон на основі будь-якого файла &latex;. Якщо ви бажаєте спростити процедуру створення шаблону, ви можете просто скопіювати приклад з мережі Інтернет, а потім виконати кроки описані у розділі templ_wiz.

Наприклад, ви вирішили створити повноцінний плакат A0. Такі плакати, зазвичай використовуються на наукових конференціях. &latex; допоможе вам у створенні красивого і зрозумілого плаката. Шаблон для плакатів A0 можна звантажити з домашньої сторінки Джонатана Марчіні, там же можна знайти і багато інших шаблонів. Не забудьте, що вам знадобиться пакунок `a0poster`, який може бути не включено до стандартного дистрибутива tex, яким ви користуєтеся. Звантажте цей пакунок за відповідною адресою і розпакуйте його до теки, де зберігатиметься ваш файл кодів &latex;.

#### Як вилучити шаблон

Для того, щоб вилучити шаблон з &kile;, виконайте такі дії:

1. Скористайтеся пунктом меню Файл Вилучити шаблон...;

2. Програма відкриє діалогове вікно зі списком всіх шаблонів: оберіть шаблон;

3. Натисніть кнопку Гаразд, — позначений вами шаблон буде вилучено.

Шаблони, позначені зірочкою (*), не можна вилучати без отримання належних прав доступу.

## Як редагувати документи &latex;

Вбудованим редактором, який використовує &kile;, є &kate;. Kate — це текстовий редактор, створений для програмістів, у ньому передбачено можливість читання і підсвічування файлів у різноманітних текстових форматах, серед яких &latex; і &bibtex;. Ви можете отримати доступ до багатьох параметрів &kate; безпосередньо з меню Інструменти &kile;.

Щоб дізнатися більше про програму &kate; і її можливості, прочитайте підручник з Kate. Користувачі &kile; можуть розпочати читання з глави Робота у редакторі Kate.

### Довідник з &latex;

У &kile; передбачено дуже корисний довідник з теґів &latex;, ви можете відкрити його за допомогою пункту меню Довідка Довідка LaTeX. У цій довідці міститься загальний опис майже всіх команд, якими ви можете скористатися у &latex; та синтаксису цих команд.

### Пересування курсора

Ви можете позначити фрагмент тексту у один з таких способів:

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

- Наведіть вказівник миші на певне слово і клацніть лівою кнопкою миші, щоб пересунути курсор на нове місце.

- Наведіть вказівник миші на певне слово і двічі клацніть лівою кнопкою миші, щоб позначити це слово.

- Наведіть вказівник миші на слово, двічі клацніть лівою кнопкою миші і натисніть клавішу &Ctrl;, щоб вибрати ціле слово TeX. Таким чином, якщо клацання було виконано на слові `\par` з групи `\par\bigskip`, буде позначено лише слово \par.

- Клацніть лівою кнопкою миші три рази поспіль, щоб позначити ціле речення.

Утримування натиснутою лівої кнопки миші з перетягуванням вказівника миші над фрагментом тексту, який ви бажаєте вибрати, призведе до автоматичного копіювання тексту до буфера обміну даними.

Утримування натиснутою клавіші &Shift; з наступним натисканням клавіш зі стрілочками надасть вам змогу обирати ділянки коду у вікні редактора.

### Дужки

Інструмент автоматичного закриття дужок використовується редактором для позначення відповідності між лівими і правими дужками у тексті. Якщо ви відкриєте будь-який файл `.tex`, а потім наведете курсор на будь-яку дужку, зокрема на одну з дужок пар круглих дужок (), квадратних дужок [] або фігурних дужок {}, редактор автоматично підсвітить дужку і парну до неї дужку жовтим кольором (цей типовий колір можна змінити). Отже, наприклад, якщо ви наведете курсор на фігурні дужки у виразі `\section{Вступ}`, ви у `\section{Вступ}` дужки підсвічені жовтим кольором, отже зможете визначити розташування початкової і кінцевої дужки.

### Підсвічування

У &kile; передбачено можливість пошуку і підсвічування елементів коду різного типу. Наприклад, команди &latex; відрізнятимуться від звичайного тексту, математичні формули також підсвічуватимуться певним кольором.

### Позначки

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

Позначки Позначки

&Ctrl;&Alt;Стрілка праворуч Наступний маркер

- Перейти до наступної позначки у тексті, якщо така є.

&Ctrl;&Alt;Стрілка ліворуч Попередня позначка

- Перейти до попередньої позначки у тексті, якщо така є.

### Вибрати

Редагування, звичайно ж, одним з основних елементів роботи програм, подібних до &kile;. Хоча програма &kate; вже є досить потужною, у &kile; до її потужностей долучаються додаткові можливості, особливо цінні під час створення текстів &latex;. У &latex; ви завжди матимете справу з багатьма середовищами і групами, отже у &kile; передбачено підтримку окремих команд для вибору цих елементів тексту. У підменю Зміни Вибрати ви знайдете такі команди, призначені для вибору тексту:

Зміни->пункти підменю «Вибрати» Зміни->пункти підменю «Вибрати»

&Ctrl;&Alt;S ,E Середовище (всередині)

- Позначити вміст середовища без обмежувальних теґів. Якщо ви скористаєтеся цим пунктом меню, коли вже буде позначено вміст середовища, &kile; розширить область позначення до середовища, що містить позначене середовище.

&Ctrl;&Alt;S ,F Середовище (ззовні)

- Позначити середовище разом з обмежувальними теґами. Подібне позначення також можна розширити повторним використанням пункту меню.

&Ctrl;&Alt;S ,T Група TeX (всередині)

- Вибрати групу TeX між зовнішніми фігурними дужками.

&Ctrl;&Alt;S ,U Група TeX (ззовні)

- Вибрати групу TeX разом з зовнішніми фігурними дужками.

&Ctrl;&Alt;S ,M Математична група

- Вибрати поточну математичну групу разом з математичними командами.

&Ctrl;&Alt;S ,P Абзац

- Вибрати весь абзац, тобто групу рядків тексту, відокремлених з обох боків порожніми рядками. Абзацом у даному випадку вважається не лише неперервна послідовність рядків тексту, подібна до абзаців інших текстових редакторів. У &kile; до абзацу, окрім тексту, додаються команди &latex; і інші рядки коду. Єдиним обмеженням на рядки, які може бути включено до єдиного абзацу, є те, що у &kile; абзац має починатися і завершуватися порожніми рядками.

&Ctrl;&Alt;S ,L Рядок

- Вибрати рядок тексту, у якому зараз перебуває курсор.

&Ctrl;&Alt;S ,W Слово TeX

- Вибрати слово, у якому зараз перебуває курсор. Цей варіант вибору має і розширене значення, оскільки за його допомогою можна обирати команди &latex;, які починаються з символу зворотної риски і можуть завершуватися символом зірочки.

#### Позначення команд &latex;

У &kile; передбачено додаткові можливості позначення команд &latex;. Якщо ви, наприклад, введете

    текст \bfseries\itshape ще якийсь текст

потім наведете вказівник миші на одну з команд &latex; і двічі клацнете лівою кнопкою миші, буде позначено обидві команди. Якщо ж ви бажаєте позначити лише одну з двох або декількох команд, натисніть під час клацання клавішу &Ctrl;. У разі натискання клавіші &Ctrl; після подвійного клацання буде позначено лише одну бажану вами команду.

### Вилучити

Щоб вилучити певний фрагмент документа, ви можете, звичайно ж, позначити його, а потім натиснути клавішу Delete. Крім того, у Kate передбачено комбінацію клавіш &Ctrl;K, за допомогою якої можна вилучити цілий рядок. Але у &kile; передбачено і власні команди вилучення. У меню Зміни Вилучити ви знайдете такі команди, призначені для вилучення фрагментів тексту:

Зміни->пункти підменю «Вилучити» Зміни->пункти підменю «Вилучити»

&Ctrl;&Alt;T ,E Середовище (всередині)

- Вилучити середовище без зовнішніх міток.

&Ctrl;&Alt;T ,F Середовище (ззовні)

- Вилучити середовище разом з зовнішніми мітками.

&Ctrl;&Alt;T ,T Група TeX (всередині)

- Вилучити групу TeX між зовнішніми фігурними дужками.

&Ctrl;&Alt;T ,U Група TeX (ззовні)

- Вилучити групу TeX разом з зовнішніми фігурними дужками.

&Ctrl;&Alt;T ,M Математична група

- Вилучити поточну математичну групу разом з математичними командами.

&Ctrl;&Alt;T ,P Абзац

- Вилучити цілий абзац. Щоб дізнатися про те, яким чином визначається абзац у &kile;, зверніться до пояснення, викладеного для пункту меню Вибрати Абзац.

&Ctrl;&Alt;T ,I До кінця рядка

- Вилучити фрагмент тексту від поточної позиції курсора до кінця рядка.

&Ctrl;&Alt;T W, Слово TeX

- Вилучити слово або команду &latex;, де зараз перебуває курсор.

### Середовище

Як ми вже згадували, середовища є базовими елементами &latex;. Тому у &kile; передбачено п’ять додаткових команд, які гранично спрощують роботу з &latex;. Цим командам відповідають пункти меню Зміни Середовище.

Зміни->пункти підменю «Середовище» Зміни->пункти підменю «Середовище»

&Ctrl;&Alt;E ,B Перейти до початку

- За допомогою цієї команди можна перевести курсор на початок поточного середовища, яким би не було поточне розташування курсора. Курсор буде розташовано безпосередньо перед початковим теґом середовища.

&Ctrl;&Alt;E ,E Перейти в кінець

- За допомогою цієї команди можна перевести курсор у кінець поточного середовища, яким би не було поточне розташування курсора. Курсор буде розташовано безпосередньо за завершальним теґом середовища.

&Ctrl;&Alt;E ,M Перейти до відповідника

- Якщо курсор розташовано перед або над теґом `\begin{середовище}`, його буде пересунуто у кінець цього середовища, і навпаки.

&Ctrl;&Alt;E ,C Закрити

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

&Ctrl;&Alt;E ,A Закрити всі

- За допомогою цього пункту можна здійснити спробу завершити всі середовища, не лише останнє з відкритих.

### Група &tex;

Крім того, у &kile; передбачено певні особливі команди для груп &latex;, тобто фрагментів тексту між фігурними дужками, `{...}`. У підменю Зміни Група TeX ви знайдете декілька важливих команд, які схожі на пункти підменю Зміни Середовище.

Зміни->Група TeX Зміни->Група TeX

&Ctrl;&Alt;G ,B Перейти до початку

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

&Ctrl;&Alt;G ,E Перейти в кінець

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

&Ctrl;&Alt;G ,M Перейти до відповідника

- Якщо курсор розташовано перед або за початковою фігурною дужкою групи &tex;, його буде пересунуто у кінець цієї групи, і навпаки.

&Ctrl;&Alt;G ,C Закрити

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

### Подвійні лапки

Для позначення подвійних лапок у &latex; використовують дві одинарні лапки. Щоб полегшити вам введення лапок у &kile; передбачено можливість заміни символу ", набраного з клавіатури, на дві початкові одинарні лапки. Крім того, якщо ви бажаєте закрити лапки, ви теж можете натиснути клавішу ". &kile; достатньо кмітливий, щоб розібратися у ситуації і вставити у текст дві завершальні одинарні лапки, які передбачено стандартом &latex;.

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

Ви можете увімкнути або вимкнути автоматичне додавання початкових і кінцевих подвійних лапок у розділі Параметри Налаштувати Kile...LaTeX.

Подвійні лапки Подвійні лапки

Крім того, ви можете включити параметри, характерні для певної мови, зокрема `ngerman` або `french`, ви можете скористатися і подвійним лапками, які використовуються у типографській справі у Німеччині або Франції. У програмі передбачено варіанти для багатьох мов.

### Кмітливий новий рядок

Якщо ви натиснете комбінацію клавіш &Ctrl;Enter, &kile; вставить до тексту кмітливий новий рядок. Якщо курсор розташовано всередині середовища списку, зокрема `enumerate` або `itemize`, &kile; не лише вставить символ розриву рядка, але і автоматично додасть команду `\item`.

Якщо ви вводите текст у табличному середовищі, &kile; завершуватиме поточний рядок символами `\\` і додаватиме після них символ розриву рядка.

Якщо ви вводите текст у закоментованому рядку, після введення символу розриву рядка &kile; розпочне новий рядок з символу `%`.

І навіть більше, &kile; достатньо кмітливий для того, щоб підтримувати попередньо визначені середовища &latex; та визначені користувачем середовища, які можна додати у розділі Параметри Налаштувати Kile... LaTeX.

### Кмітлива табуляція

Декому з користувачів подобається впорядковувати стовпчики у середовищах таблиць так, щоб всі символи амперсандів, &, знаходилися у однакових позиціях рядків таблиці. У &kile; передбачено підтримку такого форматування. Якщо ви натиснете комбінацію клавіш &Alt;&Shift;&, &kile; спробує знайти наступну табуляцію у попередньому рядку таблиці. Хоча ця табуляція може і не відповідати розташуванню елемента таблиці, &kile; додасть декілька пробілів, щоб у коді візуально вміст стовпчиків знаходився на однакових позиціях у рядках.

## Автозавершення коду

Хоча у &kate; вже передбачено досить непоганий режим автоматичного доповнення, у &kile; цей режим доповнено підтримкою деяких спеціальних методів, характерних для &latex;. Програма використовує п’ять різних режимів доповнення. Три з цих режимів може викликати сам користувач, інші ж два є режимами автоматичного доповнення. Параметри кожного з режимів можна налаштувати окремо за допомогою пункту меню Параметри Налаштувати Kile....

### Автоматичне завершення середовищ

Коли ви починаєте створення нового середовища і вводите щось на зразок `\begin{середовище}`, &kile; автоматично додасть команду `\end{середовище}`, а також рядок для введення вмісту середовища.

Автоматичне доповнення можна вимкнути у розділі «&latex;» на сторінці Параметри Налаштувати Kile... LaTeX Середовища.

Завершення середовища рівняння (equation) Завершення середовища рівняння (equation)

Завершення середовища рівняння (equation)

### Команди &latex;

Під час введення тексту ви можете задіяти цей режим доповнення для команд &latex; і звичайних слів за допомогою пункту меню Зміни Завершити Завершення команди (La)TeX або клавіатурного скорочення &Ctrl;&Shift;Пробіл. &kile; почне читати літери ліворуч від поточної позиці курсора і зупиниться на першому ж небуквенному символі або символі зворотної рики. Якщо отриманий таким чином рядок починатиметься зі зворотної риски, &kile; увійде у режим завершення команди &tex; або &latex;. Якщо ж зворотної риски не буде знайдено, програма увійде у звичайний словниковий режим, у якому команди &latex; зовсім не братимуться до уваги. Залежно від вказаного режиму, буде відкрито відповідну панель доповнення. У списку цієї панелі ви побачите всі команди або слова, початок яких збігається з введеними вами літерами. Ви можете пересувати позначку у цьому списку за допомогою клавіш зі стрілочками, а потім вставити бажаний варіант за допомогою натискання клавіші &Enter; або наведення вказівника миші на запис цього варіанта з наступним подвійним клацанням лівою кнопкою миші.

Доповнення команди LaTeX Доповнення команди LaTeX

Якщо ви натиснете клавішу &Backspace;, останню літеру з вашого шаблону буде вилучено, отже список варіантів доповнення може зрости. З іншого боку, якщо ви введете наступну літеру, шаблон розшириться, а отже список видимих варіантів може зменшитися.

Якщо жоден з варіантів не буде для вас прийнятним, ви можете закрити це діалогове вікно натисканням клавіші &Esc;.

Всі команди буде показано з коротким описом параметрів. Ці описи, звичайно ж, буде вилучено після вставки команди. За бажання, ви можете надати &kile; змогу вставити на місце параметрів позначки, призначені для полегшення пересування між позиціями параметрів за допомогою пункту меню Зміни Позначки Наступна позначка: так вам простіше буде вставити бажане значення параметра.

Доповнення команди LaTeX Доповнення команди LaTeX

Відкрийте сторінку налаштувань Параметри Налаштувати Kile... Kile Завершення, там ви зможете налаштувати один або декілька з цих списків. Ви зможете вибрати окремі списки слів для команд &tex; і &latex; та списком режиму словника звичайних слів.

Якщо ви позначите пункту Показати команди Latex, &kile; покаже вміст списків команд &latex; всіх вказаних файлів cwl у окремому списку бічної панелі &kile;. Отже у вас перед очима буде список всіх команд та параметрів, які можна їм передати. Ви можете просто навести вказівник миші на один з пунктів списку і клацнути лівою кнопкою миші, щоб вставити відповідну команду до документа. Всі назви параметрів та значення буде при цьому вилучено.

Команди LaTeX на бічній панелі Команди LaTeX на бічній панелі

Оскільки кожен з вказаних списків слів буде показано окремо, списків може виявитися забагато для показу у вікні &kile;. Оскільки велика кількість списків захаращує вікно, у &kile; цю кількість обмежено максимальним значенням 10. Якщо це значення буде завеликим для розмірів екрана вашого комп’ютера, ви можете його зменшити.

### Середовища

Режим команд непридатний для завершення середовищ. Після введення вами декількох літер команди `\begin` і виклику режиму завершення ви отримаєте величезний список теґів середовищ. Оскільки середовища використовуються досить часто, у &kile; передбачено особливий режим для завершення середовищ. Не вводьте початкового теґу — спробуйте ввести, наприклад, `eq`.

Після виклику режиму доповнення за допомогою пункту меню Зміни Завершити Середовище або клавіатурного скорочення &Alt;&Shift;Пробіл програмою буде автоматично додано відповідний теґ, отже ви побачите у тексті рядок `\begin{eq}`. Після подібної заміни список доповнення значно скоротиться.

Доповнення команди LaTeX Доповнення команди LaTeX

Тепер оберіть бажане середовище, а програма подбає про його автоматичне завершення. Навіть більше, якщо &kile; визначить, що введено середовище списку, програма додасть у середовище перший теґ `\item`.

Доповнення команди LaTeX Доповнення команди LaTeX

Перейдіть на сторінку, що відкривається послідовністю переходів Параметри Налаштувати Kile... Kile Завершення, щоб налаштувати один або декілька з цих списків. У цьому режимі буде використано ті самі списки, що і у режимі завершення команд &tex; і &latex;.

### Абревіатури

У &kile; передбачено можливість створення користувачем списків абревіатур, які буде за вимогою замінено на довші текстові рядки. На сторінці налаштувань Параметри Налаштувати Kile... Kile Завершення ви зможете налаштувати один або декілька списків абревіатур. У наведеному у цьому підручнику прикладі, слід вибрати список абревіатур `example.cwl`. У цьому файлі, наприклад, ви знайдете запис `L=\LaTeX`.

Для прикладу, введіть одну літеру `L`. Після цього увімкніть режим завершення слів за абревіатурами за допомогою пункту меню Зміни Завершити Абревіатура або скористайтеся клавіатурним скороченням &Ctrl;&Alt;Пробіл, — програма автоматично замінить літеру `L` на рядок `\LaTeX`.

Крім того, у доповнення скорочень передбачено підтримку символу розриву рядка, `%n` і позначення позиції розташування курсора, `%C`. Отже, якщо у вашому файлі автоматичного доповнення є запис

    en1=\begin{enumerate}%n\item %C%n\end{enumerate}%n

після використання доповнення скорочення текст набуде вигляду, наведеного нижче, де символом `x` позначено остаточну позицію курсора.

    \begin{enumerate}
            \item x
    \end{enumerate}

#### Абревіатури

Якщо ви позначите пункт Показати скорочення, програма покаже всі можливі скорочення у особливому списку на бічній панелі. Отже у вас перед очима буде список всіх можливих скорочень.

### Режими автозавершення

#### Команди &latex;

Крім того, ви можете увімкнути режим автоматичного завершення команд &latex;. Після введення порогової кількості літер команди (типово, трьох літер) програма відкриє контекстну панель зі списком всіх подібних команд &latex;. Ви зможете вибрати одну з команд у списку або продовжити введення команди. Пункти у списку змінюватимуться відповідно до введених вами перших літер команди.

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

Завершення середовища рівняння (equation) Завершення середовища рівняння (equation)

#### Слова документа

Великі словники непридатні для використання у режимі автоматичного доповнення. Але, очевидно, значна кількість слів у документах вживаються декілька разів. Отже, у &kile; передбачено доповнення всіх слів з документа, які вже було введено користувачем раніше. Увімкнути автоматичне доповнення вручну можна за допомогою натискання комбінації клавіш &Ctrl;Пробіл. Зауважте, що цей режим відрізняється від режиму автоматичного доповнення команд &latex;.

Якщо ви бажаєте увімкнути або вимкнути цей режим, скористайтеся сторінкою налаштувань Параметри Налаштувати Kile... Редактор Редагування Автозавершення. За допомогою цієї сторінки налаштування ви можете вказати програмі, чи слід використовувати режим автоматичного завершення слів. Крім того, передбачено додатковий режим автоматичного завершення, за використання якого програма відкриватиме панель автоматичного завершення за умови введення певної порогової кількості літер.

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

Специфікацію формату файла завершення можна знайти у файлі специфікації формату CWL.

Файли завершення можна встановити у домашньому каталозі користувача у підкаталозі `~/.kde/share/apps/kile/complete/<режим>/`, де `<режим>` може приймати одне зі значень: `abbreviation`, `dictionary` або `tex`.

## Майстри і діалогові вікна

### Майстер швидкого запуску

Цей майстер вже було описано у розділі intro_docwizard.

### Включення графіки

Діалогове вікно Середовище рисунка гранично спрощує додавання графічних об’єктів у текст. Відкрити це діалогове вікно можна за допомогою пункту LaTeX Додавання картинки меню програми. Будь ласка, прочитайте розділи build_graphics і build_epsgraphics, щоб ознайомитися з основними фактами, що стосуються форматів графічних даних.

Додавання графічного елемента Додавання графічного елемента

1. Оберіть файл з графічними даними. Ви можете скористатися файлом у форматі JPEG, PNG, PDF, EPS або навіть у форматі даних EPS стиснутих за допомогою zip або gzip. Якщо вами було встановлено програму &imagemagick;, а також налаштовано &kile; на використання цієї програми (це можна зробити за допомогою пункту меню Параметри Налаштувати Kile... LaTeX Графіка), програма автоматично визначить ширину і висоту зображення. Якщо програмі &imagemagick; вдасться визначити роздільну здатність зображення, його розміри буде показано також і у сантиметрах.

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

3. Визначтеся з тим, чи слід використовувати позначення `\graphicspath` для вашого файла графіки.

   Типово, графічні файли мають зберігатися у тій самій теці, що і файл головного документа. Але для того, щоб зробити структуру зберігання даних стрункішою, ви можете зберігати ці файли у окремій теці. Якщо ви не використовуватимете команди `\graphicspath`, &kile; обиратиме для пошуку рисунків саме теку поточного головного документа. Але, якщо ви скористаєтеся командою `\graphicspath` у преамбулі документа ось так:

       \graphicspath{{/шлях/до/моїх/рисунків}{інший/шлях/до/інших/рисунків}}

   і позначите відповідний пункт, &kile; використовуватиме лише базову назву графічного файла.

   Ще один приклад: якщо ви використали таку команду `\graphicspath`:

       \graphicspath{{./}{camera/}{images/}}

   &latex; виконає пошук графічних файлів спочатку у поточній теці, потім у теці `camera`, і нарешті у теці `images`.

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

5. Ви можете вказати кут, на який слід повернути рисунок за годинниковою стрілкою.

6. Дані щодо обмежувальної рамки автоматично визначатимуться після вибору вами графічного файла. Ці дані знадобляться, лише якщо ви працюєте з традиційною графікою &latex; та растровою графікою. Докладніше про це можна дізнатися з розділу щодо графіки у форматі EPS.

   Якщо для додавання зображення &latex; потрібна обмежувальна рамка, а ви не бажаєте створювати окремий файл bb, ви можете скористатися &kile;. За допомогою відповідного пункту можна увімкнути або вимкнути використання обмежувальної рамки. Якщо ви позначите пункт для додавання зображення у форматі png або jpg &pdflatex; покаже попередження.

7. За допомогою параметра коефіцієнта масштабування ви можете вказати бажаний масштаб, наприклад 0,5 для зменшення розмірів зображення удвічі або 2 для подвоєння цих розмірів. Якщо ви скористаєтеся цим параметром, вам не потрібно буде вказувати ширину або висоту зображення.

8. За допомогою вкладки Обрізати зображення ви можете вказати параметри обрізання зображення у всіх чотирьох напрямках.

9. Нарешті, ви можете вказати, чи слід вбудовувати зображення до середовища figure. Якщо текст має обтікати рисунок, вам слід скористатися середовищем wrapfigure.

   Якщо вами було вибрано середовище wrapfigure, вам слід додати до преамбули документа команду використання пакунка wrapfig.

   Яким би варіантом ви не скористалися, ви зможете вказати підпис і мітку рисунка. Варто додавати окремі префікси для міток різних об’єктів. Типовим для зображень є використання префікса `рис.`.

10. Якщо ви виберете середовище figure, ви зможете вказати бажане розташування рисунка під час збирання документа &latex;.

11. У середовищі wrapfigre ви можете

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

    2. Визначити кількість рядків тексту, які буде використано для обтікання. Якщо ви не вкажете ніякого значення, &latex; спробує визначити потрібну кількість рядків автоматично.

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

    4. Вибрати ширину рисунка. Це значення має бути трошки більшим за справжню ширину рисунка, щоб між рисунком і текстом залишився певний інтервал.

### Масиви і таблиці

Одним з найнудніших завдань, які доводиться виконувати у &latex; є введення матриці або середовища таблиці. Вам доводиться стежити за всіма елементами таблиці, правильністю форматування середовища та правильністю розташування всіх елементів, які формують таблицю. Правильне використання відступів може допомогти, але існує і простіший спосіб: використання пунктів меню Майстер Масив або Майстер Таблиця. Після вибору відповідного пункту у меню програма відкриє вікно з формою у вигляді матриці, яку ви легко зможете заповнити потрібними вам записами. У діалоговому вікні ви зможете також вибрати певні параметри, пов’язані з верстанням вмісту таблиці.

Додавання середовища таблиці Додавання середовища таблиці

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

За допомогою нижньої частини діалогового вікна ви зможете вибрати кількість рядків і стовпчиків та змінити інші параметри вашого масиву або таблиці:

- За допомогою пункту Назва ви зможете вибрати середовище, яке має бути використано для вашого масиву або таблиці.

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

- Якщо у вибраному вами середовищі можна скористатися такою можливістю, ви можете позначити пункт Використовувати версію з зірочкою. Якщо вами буде позначено цей пункт, вам також доведеться вказати Ширину таблиці.

- Іноді покращити вигляд таблиць можна за допомогою позначення пункту Використовувати пакунок booktabs.

- Звичайно ж, ви також можете наказати розташувати По центру весь ваш масив.

- Пункт Додавати позначки пунктів допоможе вам у заповненні відповідних пунктів таблиці чи масиву у редакторі. Якщо цей пункт буде позначено, &kile; додасть позначки кружечком для кожного з елементів вашого масиву.

За використання пункту меню Майстер Розміщення у таблиці програма відкриє простіше діалогове вікно для налаштування середовища tabbing. Для таких середовищ ви зможете вибрати кількість рядків і стовпчиків, а також інші специфічні параметри.

### Додавання плаваючих об’єктів

&kile; може допомогти вам у додаванні до документа плаваючих об’єктів (таблиць чи рисунків). За допомогою пункту меню Майстер Плаваючі об’єкти вам буде зовсім нескладно додати до документу нове середовище рисунка чи таблиці.

Додавання плаваючого об’єкта Додавання плаваючого об’єкта

Щоб додати новий плаваючий об’єкт, виконайте такі дії:

1. Виберіть різновид об’єкта, який ви бажаєте додати: рисунок чи таблицю.

2. Вкажіть бажані правила розташування.

3. Вкажіть підпис до плаваючого об’єкта.

4. Вкажіть мітку нового плаваючого об’єкта. &kile; автоматично запропонує відповідний префікс: "fig:" для рисунків і "tab:" для таблиць.

### Додавання математичних середовищ

Запам’ятати всі середовища, які використовуються для створення математичних формул, доволі складно. Звичайно ж, &kile; допоможе вам згадати потрібні команди за допомогою пункту меню Майстер Математика.

Додавання математичного елемента Додавання математичного елемента

Параметри:

- Назва: виберіть тип математичного об’єкта, який слід створити.

- За допомогою пункту Без нумерації можна вимкнути нумерацію для об’єктів формул.

- Команда для розділення груп: у середовищах, яких передбачено підтримку декількох груп, зокрема alignat, ви можете визначити роздільник. У полі цього пункту можна вказати будь-яку команду додавання інтервалу, якою можна скористатися у математичному режимі, наприклад \quad.

- Стандартний табулятор: тут ви можете вказати табулятор, який буде використано у формулі. &kile; може визначити належний табулятор автоматично.

- Режим формули: для середовищ матриць та масивів ви можете вибрати математичне середовище для формули.

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

### Засоби &PostScript;

Файли PS не набули такої популярності, як файли PDF, але ці файли є чудовою основою для обробки і перевпорядкування сторінок документів. Якщо вам потрібно вивести дані у форматі PDF, ви можете перевпорядкувати сторінки за допомогою однієї з програм, що працюють з форматом &PostScript;, а потім перетворити файл на файл PDF за допомогою команди `ps2pdf`.

У Майстрі &PostScript; (пункт меню Майстер Інструменти Postscript) ви побачите найпоширеніші варіанти перевпорядкування, але зможете вказати і ваші власні параметри. Основну роботу з обробки файлів виконують програми `pstops` і `psselect`, які у більшості дистрибутивів можна знайти у пакунку `psutils`. Якщо однієї з цих програм немає у вашому дистрибутиві, відповідні пункти не буде показано.

Діалогове вікно PSTools Діалогове вікно PSTools

Спочатку вам слід вибрати вхідний файл. Якщо &kile; знайде файл PS, який відповідає вашому поточному головному документу, відповідне поле вже буде заповнено, але ви можете вибрати і будь-який інший файл. Після цього оберіть файл для виводу даних та завдання, яке слід виконати. Нарешті, визначіться: бажаєте ви, щоб програма виконала лише перетворення, чи слід також запустити &okular; для перегляду результатів.

1 A5 Сторінка + Порожня сторінка → DIN A4

- Розташувати одну сторінку A5 разом з однією порожньою сторінкою на одній сторінці A4. Під час розташування сторінки A5 буде повернуто на 90 градусів і розміщено на сторінці A4 у альбомному режимі.

  A5 + Порожня сторінка A5 + Порожня сторінка

1 сторінка A5 + дублікат → A4

- Розташування одної сторінки A5 разом з її дублікатом на одній сторінці A4.

  дублювання сторінок A5 Дублювання сторінки A5

2 сторінки A5 → A4

- Розташування двох послідовних сторінок A5 на одній сторінці A4.

  Поєднання двох сторінок A5 Поєднання двох сторінок A5

2 сторінки A5L → A4

- Розташування двох послідовних сторінок A5 у альбомному режимі разом на сторінці A4.

4 сторінки A5 → A4

- Зібрати чотири послідовних сторінки A5 на одній сторінці A4. Для того, щоб сторінки A5 вмістилися, їх розміри потрібно зменшити з коефіцієнтом 0,7.

  4 сторінки A5 → A4 4 сторінки A5 → A4

1 сторінка A4 + порожня сторінка → A4

- Розташувати одну сторінку A4 разом з однією порожньою сторінкою на одній сторінці A4. Під час розташування розмір сторінок A4 буде зменшено з коефіцієнтом 0,7 (приблизно рівним кореню з 2 поділеному навпіл) і розміщено на сторінці A4 у альбомному режимі.

  1 сторінка A4 + порожня сторінка → A4 1 сторінка A4 + порожня сторінка → A4

1 сторінка A4 + дублікат → A4

- Розташування одної сторінки A4 разом з її дублікатом на одній сторінці A4.

  1 сторінка A4 + дублікат → A4 1 сторінка A4 + дублікат → A4

2 сторінки A4 → A4

- Розташування двох послідовних сторінок A4 на одній сторінці A4.

  Поєднання двох сторінок A4 Поєднання двох сторінок A4

2 сторінки A4L → A4

- Розташування двох послідовних сторінок A4 у альбомному режимі разом на сторінці A4.

вибрати парні сторінки

- Вибрати всі парні сторінки у документі.

Вибрати непарні сторінки

- Вибрати всі непарні сторінки у документі.

Вибрати парні сторінки (у зворотньому порядку)

- Вибрати всі парні сторінки у документі у зворотному порядку.

Вибрати непарні сторінки (у зворотньому порядку)

- Вибрати всі парні сторінки у документі у зворотному порядку.

Всі сторінки у зворотному порядку

- Всі сторінки поточного документа у зворотному порядку.

Копіювати всі сторінки (сортованими)

- Копіювати всі сторінки документа. Ви можете вибрати кількість впорядкованих копій.

  Копіювати всі сторінки (сортованими) Копіювати всі сторінки (сортованими)

Копіювати всі сторінки (несортованими)

- Копіювати всі сторінки документа. Ви можете вибрати кількість невпорядкованих копій.

  Копіювати всі сторінки (несортованими) Копіювати всі сторінки (несортованими)

pstops: Виберіть параметр

- У програмах &PostScript; `pstops` і `psselect` передбачено використання величезної кількості параметрів. Якщо вам потрібні якісь спеціальні параметри, ви можете запустити `pstops` з вказаним вами параметром. Перелік можливих параметрів можна знайти на сторінці довідки (man) відповідної програми.

psselect: Виберіть параметр

- Ви можете наказати виконати `psselect` з вказаними вами параметрами. Будь ласка, прочитайте довідник з програми, щоб дізнатися про всі можливі параметри.

### Статистика документа

За допомогою діалогового вікна, яке відкривається пунктом меню Файл Статистика ви можете ознайомитися зі статистичними даними щодо позначеного фрагмента тексту, документа або всього проекту. Тут зокрема буде наведено дані щодо кількості слів, команд або середовищ &latex;, а також кількість символів для кожного з типів даних.

Отримані статистичні дані можна скопіювати у текстовому форматі або у форматі таблиці &latex; до буфера обміну даними.

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

Слід зробити зауваження щодо точності наведених даних. Ось приклад обчислень, які буде виконано програмою: у рядку «K\"uhler» буде знайдено одне слово (шість літер) і одну команду (дві літери). Існують і інші комбінації, у яких частини команд буде пораховано як слова і навпаки. Крім того, алгоритм було створено і перевірено для мов на зразок англійської або німецької. Отже вважати показані цифри абсолютно точними не можна. Якщо вам потрібні точні дані щодо кількості слів і символів, вам слід виконати декілька перевірок, щоб оцінити точність даних &kile; для вашої мови.

## Особливі теґи у &latex;

### Користування бібліотекою теґів &latex;

У &latex; передбачено тисячі теґів для літер і спеціальних символів. Найпростішим способом вставки цих теґів є використання меню бічної панелі, панелі, яку розташовано ліворуч від вікна редактора.

Меню бічної панелі Меню бічної панелі

Меню бічної панелі

Ви можете скористатися одним з таких типів:

- Ті, що найчастіше використовуються

- Відношення

- Оператори

- Стрілки

- Інші математичні символи

- Різноманітний текст

- Розділювачі

- Грецька

- Спеціальні символи

- Символи кирилиці

- Визначений користувачем

На панельках підказок до піктограм буде показано відповідні команди &latex; і назви пакунків, які слід включити для коректної роботи цих команд.

Якщо натиснути клавішу &Shift;, навести вказівник миші на символ і клацнути лівою кнопкою миші, до тексту буде вставлено рядок `$\команда_символу$`. Якщо натиснути клавішу &Ctrl;, команду буде додано у фігурних дужках.

Якщо ви вставляєте команду, для роботи якої потрібно включити пакунок, який не було включено до вашого документа &latex;, ви побачите повідомлення з попередженням у вікні перегляду журналу.

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

У списку Визначених користувачем символів міститимуться ваші власні символи. Для створення власного символу вам знадобиться програма gesymb і файл definitions.tex з пакунка вихідних кодів &kile;. Крім того вам потрібен буде компілятор &latex; (сюрприз!) і програма &dvipng; (версії 1.7 або новішої). Процедура створення символу полягає у тому, що ви створюєте файл &latex; з `\input{визначення}`, що робить можливим використання наведених нижче команд, і надаєте змогу команді `gesymb mysymbols.tex user` (яка викликає &latex; і &dvipng;) створити піктограми. Після копіювання піктограм до теки `$HOME/.kde/share/apps/kile/mathsymbols/user/` і перезапуску &kile; ви зможете скористатися вашими власними символами.

У файлі definitions.tex визначено такі команди:

- `\command[\optarg]{\symbol}`: включити символ `\symbol` до списку символів, додатковий параметр `\optarg` визначає команду, яку &kile; має вставити до тексту. Якщо додаткового параметра не буде вказано, використовуватиметься команда з обов’язкового параметра.

- `\mathcommand[\optarg]{\symbol}`: те саме, що і попередня команда, але команду у обов’язковому параметрів буде вставлено у математичному режимі.

- `\pkgs[arg]{pkg}`: оголосити, що команда, вказана у цьому рядку, потребує використання пакунка &latex; з назвою `pkg` та необов’язковим параметром `arg`. Цю команду слід вказувати до команди `\command`, вона перевизначає всі специфікації пакунків, задані середовищем neededpkgs.

- `\begin{neededpkgs}[pkgs-args]{pkgs} ... \end{neededpkgs}`: виконує ту саму роль, що і попередня команда, але для всіх включених у середовище команд.

Нижче, для повноти, наведено приклад:

    \documentclass[a4paper,10pt]{article}
    \usepackage{amssymb}
    \input{definitions}
    %
    \begin{document}
    \pagestyle{empty}
    %
    \begin{neededpkgs}{amssymb}
    \mathcommand{\surd}
    \pkgs{amsmath}\mathcommand[\ddddot{}]{\ddddot{a}}
    \mathcommand{\angle}
    \end{neededpkgs}
    \command{\"A}
    \mathcommand{\exists}
    \mathcommand[\stackrel{}{}]{\stackrel{abc}{=}}

    %\begin{neededpkgs}[ukrainian,utf8,T2A,]{babel,inputenc,fontenc,mathtext}
    %
    %   \end{neededpkgs}
    % this would need to include the packages
    % \usepackage{mathtext}
    % \usepackage[T2A]{fontenc}
    % \usepackage[ukrainian]{babel}
    % \usepackage[utf8]{inputenc}
    %  just to explain the format
    \end{document}

### Використання елементів бібліографії (bibitems)

`\bibitem` — це команда, що використовується для вставки використаного джерела у середовищі `thebibliography` вашого документа. Синтаксична конструкція `\bibitem` є такою: `\bibitem[мітка]{ключ}`.

Необов’язковий параметр `[мітка]` призначено для того, щоб ви могли додати власну систему міток для запису бібліографії. Якщо цей параметр не буде встановлено, посилання на записи бібліографії виглядатиме як [1], [2], [3] тощо.

Параметр `{ключ}` використовується для пов’язування команд пункту бібліографії і посилання на цей пункт, `\bibitem` і `\cite`. Команда `\cite` має містити мітку, пов’язану з відповідним пунктом з бібліографічними даними `\bibitem`, розташованим у середовищі `thebibliography`. Обидві команди, `\bibitem` і `\cite`, повинні мати спільний параметр `{ключ}`. Найпростішим способом визначення ключів є використання прізвищ авторів. У других фігурних дужках визначення середовища `thebibliography` слід вказати найбільшу довжину мітки бібліографії у вашому документі. Отже, якщо ви, наприклад, вказали `{`foo`}`, всі мітки мають бути коротшими або рівними за довжиною до мітки ``foo``. Якщо цей параметр буде вказано неправильно, вам не вдасться створити красиві відступи у бібліографії вашого документа.

Бібліографія — це розділ вашого документа, відмінний від основного тексту. Приклад коду бібліографії може виглядати так:

    \begin{thebibliography}{50}
            \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm...donuts}. Evergreen Terrace Printing Co.,
                              Springfield, SomewhereUSA, 1998
    \end{thebibliography}

Після зазначення подібного пункту, ви можете додати посилання на відповідний пункт `\bibitem` за допомогою команди `\cite`. Код посилання може виглядати так:

    Моя доповідь щодо філософії Сімпсонів\copyright ґрунтується на моїй улюбленій книзі \cite{Simpson}.

Оскільки часто важко запам’ятати точний ключ цитування, якщо посилань доволі багато, у &kile; передбачено простий спосіб додавання посилань. За допомогою пункту меню LaTeX Посилання Cite ви можете відкрити список з усіма ключами цитування. Виберіть потрібний вам ключ, і програма додасть відповідне посилання у ваш документ. Щоб оновити список ключів, збережіть файл, скористайтеся пунктом меню Зміни Оновити структуру або просто натисніть клавішу F12. Якщо буде увімкнено автоматичне доповнення коду, &kile; показуватиме список всіх міток `bibitem` одразу після введення команди `\cite`.

Остаточний вигляд пункту у бібліографії вашого документа буде таким:

`[1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998.`

Крім того, &kile; може працювати з редакторами &bibtex;, зокрема &kbibtex; з метою полегшення додавання посилань на літературу. Якщо до проекту буде додано файл &bibtex;, &kile; увімкне можливість з автоматичного доповнення команд посилань, яку описано вище.

### Теґи, що визначаються користувачем

У &kile; передбачено можливість створення ваших власних теґів. Теґ подібний до скорочення, за допомогою якого виконується певна команда або записується текст, який часто використовується. Наприклад, Петро П’яточкін часто використовує речення `\LaTeX\ кращий за \TeX\` і `Що б я робив без Linux?`. Для створення теґів, визначених користувачем, що міститимуть ці речення йому слід скористатися пунктом меню LaTeX Теґи користувача Редагувати теґи користувача.... У відповідь програма відкриє діалогове вікно, за допомогою якого він зможе створити власні теґи.

Діалогове вікно редагування теґів користувача Діалогове вікно редагування теґів користувача

Діалогове вікно редагування теґів користувача

Як викликати теґ, який ви раніше визначили Виклик раніше визначеного теґу користувача

Виклик раніше визначеного теґу користувача

Ймовірно, йому слід надати кожному теґові назву, щоб точно ідентифікувати його. Назву, яку він надасть своєму теґові слід ввести у поле з позначкою Пункт меню, а текст команди, яку він часто використовує слід ввести у розділ з міткою Значення. Після введення команд, користувач зможе скористатися для пришвидшення доступу до них клавіатурними скороченнями: &Ctrl;&Shift;1 для першого з теґів, `\LaTeX\ кращий за \TeX\`, і &Ctrl;&Shift; 2 для того, щоб ввести `Щоб я робив без Linux?`.

#### Заповнювачі у теґах, визначених користувачем

Існує декілька заповнювачів, якими ви можете скористатися у визначених користувачем теґах: `%B`, `%C`, `%M` і `%S`.

- `%B`: буде замінено позначкою-кружечком.

- `%C`: це позиція, куди буде пересунуто курсор після вставки визначеного користувачем теґу.

- `%M`: це замінник позначеного тексту; на його місце буде вставлено виділений текст під час вставки теґу.

- `%S`: буде замінено на назву файла вихідних кодів без суфікса.

Розглянемо приклад, наведений на знімках вікон. Спочатку ми позначили число у нашому тексті, наприклад `2`. Далі натиснули комбінацію клавіш &Ctrl;&Shift;1 або скористалися пунктом меню LaTeX Теґи користувача Frac. Маємо отримати запис `\frac{2}{}`, курсор буде розташовано у другій парі дужок.

## Інструменти для збирання

### Компіляція, перетворення і перегляд

Щоб переглянути результати вашої роботи, вам потрібно скомпілювати вихідні коди. Всі пункти інструментів збирання згруповано у меню Збирання Компілювати, Збирання Перетворити і Збирання Переглянути.

Щоб скомпілювати ваш код для перегляду у &okular; або подальшого перетворення, ви можете скористатися клавіатурним скороченням &Alt;2. Після цього ви можете переглянути отриманий файл DVI за допомогою типового переглядача за допомогою натискання комбінації клавіш &Alt;3, перетворити файл DVI на файл PS за допомогою натискання комбінації клавіш &Alt;4 і переглянути файл PS за допомогою натискання комбінації клавіш &Alt;5.

#### &bibtex;

Якщо для роботи з бібліографічними записами ви користуєтеся &bibtex;, вам, зазвичай, доведеться компілювати документ за особливою схемою. Це означає, що спочатку слід викликати &latex;, потім &bibtex;, а потім ще двічі &latex;. На щастя, &kile; достатньо кмітливий, щоб виявити потребу у виклику додаткових інструментів, зокрема &bibtex;, &makeidx; і &asymptote;. Подібну поведінку програми типово увімкнено, змінити цю поведінку можна на вкладці Загальне налаштування інструментів &latex; і &pdflatex; на сторінці Параметри Налаштувати Kile...Інструменти Збирання.

#### MetaPost і &asymptote;

Якщо ви бажаєте зібрати ваш документ за допомогою програма малювання зображень MetaPost або &asymptote;, ви можете зробити це за допомогою пунктів меню Збирання Компілювати Metapost або Збирання Компілювати Asymptote.

#### &pdflatex;

Існує і інший спосіб компіляції вашого документа, якщо вам потрібен файл PDF: ви можете запустити &pdflatex;, який збере ваш вихідний код безпосередньо у файл PDF за допомогою натискання комбінації клавіш &Alt;6. Переглянути зібраний файл можна натисканням комбінації клавіш &Alt;7.

Іншим шляхом є перетворення файла PS на файл PDF за допомогою натискання комбінації клавіш &Alt;8, або пряме перетворення файла DVI на файл PDF за допомогою натискання комбінації клавіш &Alt;9.

Причиною використання &pdflatex; замість &latex; може бути простота або звичка, але у певних випадках поведінка цих двох програм може відрізнятися.

#### Перетворення &latex; на вебсторінку

Нарешті, у вас може виникнути потреба у публікації вашої роботи у інтернеті, а не просто на папері. Ви можете просто скористатися програмою latex2html, яку можна викликати за допомогою пункту меню &kile; Збирання Перетворити LaTeX to Web. Результат буде збережено у підтеку у підтеці робочої теки, ви зможете переглянути результат перетворення за допомогою пункту меню Збирання Переглянути ViewHTML.

#### Як передати параметри командного рядка

Якщо ви бажаєте передати певні особливі параметри командного рядка для збирання документа, перетворення або перегляду, ви можете вказати ці параметри на сторінці Параметри Налаштувати Kile... Інструменти Збирання.

### Швидкий попередній перегляд

Під час роботи з &latex; вам завжди буде потрібен певний час для перегляду результату. Спочатку &latex; має скомпілювати вихідний код документа, а потім запустити інструмент перегляду. Це може внести певні незручності, якщо ви просто змінили декілька літер у складному рівнянні. У &kile; передбачено режим Швидкого перегляду, у якому ви можете скомпілювати лише частину документа і зекономити час. У цьому режимі існує чотири різних підрежими, які можна скомбінувати у сім варіантів збирання.

Швидкий попередній перегляд Швидкий попередній перегляд

Всі налаштування слід виконувати за допомогою сторінки Параметри Налаштувати Kile... Інструменти Переглянути.

Налаштування швидкого перегляду Налаштування швидкого перегляду

#### Режим вибору

Користувач має обрати частину документа. За допомогою пункту меню Збирання Швидкий перегляд Вибране або клавіатурного скорочення &Ctrl;&Alt;P,S можна буде запустити вказану програму. &kile; візьме преамбулу з початкового тексту, отже буде включено всі потрібні пакунки і визначені користувачем команди. Користувач може обрати один з восьми наперед визначених наборів налаштувань:

- LaTeX+DVI (вбудований переглядач)

- LaTeX+DVI (&okular;)

- LaTeX+PS (вбудований переглядач)

- LaTeX+PS (&okular;)

- PDFLaTeX+PDF (вбудований переглядач)

- PDFLaTeX+PDF (&okular;)

- XeLaTeX+PS (вбудований переглядач)

- XeLaTeX+PDF (&okular;)

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

#### Режим середовища

Дуже часто у вас виникатиме потреба у перегляді поточного середовища, особливо математичних середовищ, які іноді досить важко записати належним чином. У &kile; передбачено дуже швидкий спосіб досягти потрібного результату. Вибирати нічого не потрібно, достатньо лише скористатися пунктом меню Збирання Швидкий перегляд Середовище або клавіатурним скороченням &Ctrl;&Alt;P,E, — програма виконає збирання, а потім і покаже вам результат.

#### Режим піддокумента

Якщо ви створили великий проект, що складається з багатьох документів, не варто компілювати одразу весь проект, якщо зміни було внесено лише у окремий документ. Програма &kile; здатна скомпілювати і показати попередній перегляд поточного піддокумента. Преамбулу буде взято з головного документа, зібрано буде лише поточну частину: достатньо лише скористатися пунктом меню Збирання Швидкий перегляд Піддокумент або клавіатурним скороченням &Ctrl;&Alt;P,D.

#### Режим математичної групи

За допомогою попереднього перегляду математичної групи ви зможете побачити результат збирання математичної групи, яку ви зараз редагуєте. &kile; візьме преамбулу з головного документа і збере лише математичну групу, у якій зараз перебуває курсор, — достатньо лише скористатися пунктом меню Збирання Швидкий перегляд Математична група або клавіатурним скороченням &Ctrl;&Alt;P,M.

#### Швидкий перегляд на нижній панелі

Ви можете налаштувати &kile; так, щоб програма використовувала для показу попереднього перегляду не нове вікно, а нижню панель вікна програми. Ви можете задіяти цю можливість за допомогою панелі налаштування швидкого перегляду.

### Формати графічних файлів

#### &latex; і &pdflatex;

&pdflatex;, за використання пакунка `graphics` або `graphicx`, може коректно збирати файли DVI або PDF з графікою у форматах PNG і JPG, але не може працювати з файлами EPS. І навпаки, якщо ви вирішите зібрати за допомогою програми &latex; файл DVI, а потім перетворити його на файл PS і зрештою на файл PDF, ви зможете скористатися графікою у форматі EPS, але не зможете додавати графіку у форматах PNG і JPG.

Значна кількість користувачів бажають створювати документи PDF, але також бажають скористатися чудовим пакунком Pstricks для створення графіки &PostScript;, або бажають скористатися даними виведеними у форматі &PostScript; математичними або науковими програмами, зокрема Mathematica, Maple або MuPAD. Цим користувачам &latex; слід спочатку зібрати файл &PostScript;, навіть, якщо вони бажають зрештою створити документи PDF, оскільки ці програми створюють код &PostScript;, яким не може скористатися &pdflatex;. Але це не настільки складно, як може здатися, оскільки вам допоможе &kile;.

#### Перетворення графічної інформації

Щоб розірвати це коло, у випадку, якщо ви бажаєте включити одразу і код &PostScript; і файли PNG або JPG, ви можете скористатися одним з обхідних маневрів:

- Якщо вам потрібен файл у форматі PS, а у вас є лише файли у форматах JPG або PNG, ви можете просто спочатку обробити код &pdflatex; з виводом до DVI, а потім виконати dvips, щоб отримати файл PS. Як бачите, &pdflatex; є чудовим вибором, якщо у ваших початкових файлах зовсім немає коду &PostScript;.

- Ви можете перетворити файли EPS у файли PNG або файли у інших форматах за допомогою програми Gimp або &imagemagick;, а потім скористатися &pdflatex;.

- Найкращим шляхом перетворення графіки у форматі EPS на графіку у форматі PDF є використання програми `epstopdf`, яку включено до всіх дистрибутивів &tex;, з наступним використанням &pdflatex;. У результаті буде створено високоякісні зображення, ви ж отримаєте змогу керувати отриманим результатом за допомогою таких параметрів:

      -dAutoFilterColorImages=false
              -dAutoFilterGrayImages=false
              -sColorImageFilter=FlateEncode
              -sGrayImageFilter=FlateEncode
              -dPDFSETTINGS=/prepress
              -dUseFlateCompression=true

  Навіть більше: якщо ваша система надає змогу використовувати `shell-escape`, перетворення можна виконати на льоту. Все, що вам слід зробити, це включити пакунок epstopdf, який є частиною дистрибутивів &tex; за допомогою команди `\usepackage{epstopdf}`. Припустімо, що код включення рисунка є таким:

              \includegraphics[width=5cm]{test.eps}

  Тоді, якщо ви викликатимете &pdflatex; з параметром `--shell-escape`, рисунок `test.eps` буде автоматично перетворено на `test.pdf`.

  Подібне перетворення буде виконуватися кожного разу, коли ви викликатимете &pdflatex;. Якщо команду включення рисунка вказано неявно:

              \includegraphics[width=5cm]{test}

  epstopdf перевірятиме, чи існує файл `test.pdf`, отже крок перетворення можна пропустити.

- Перетворення можна виконати і іншим способом: скористатися &latex; і перетворенням PS-PDF. Користуватися цим способом не варто, оскільки інкапсуляція у EPS зображень JPG і PNG може призвести до створення більших файлів, що призведе до занадто великих документів. Цей розмір сильно залежить від використаної програми, оскільки у EPS можна інкапсулювати інші графічні дані, але не всі програми підтримують це перетворення належним чином. Деякі з цих програм намагаються скомбінувати ваше зображення JPG з векторною графікою і різноманітними скриптами, що може призвести до створення величезних файлів. Перетворення даних у всіх графічних форматах на дані у форматі EPS можна виконати за допомогою &imagemagick;. Іншою простою програмою, яка виконує перетворення належним чином є jpg2ps.

- Крім того, ви можете скористатися автоматичним перетворенням. Всі графічні файли на льоту буде перетворено на файли EPS, а потім вставлено до документа PS. Цей спосіб комфортніший, але потребує належного налаштування вашої системи. Цей спосіб обговорено у розділі EPS-графіка.

#### Використовуємо правильний формат для зображень

- EPS є різновидом скриптової мови, призначеної для створення векторної графіки, у ній описуються всі лінії і точки, з яких складається рисунок. Зображення, описані такою мовою, виглядають добре, навіть за значного збільшення масштабу зображення. Ця мова добре пасує до діаграм і векторних графіків, які було створено за допомогою EPS, такі графіки виглядають чітко і мають незначні розміри у байтах.

- PNG (або застарілий формат GIF) є форматом зберігання графічних даних без втрати якості, файли у цьому форматі мають незначні розміри і є достатньо якісними. Цей формат достатньо добре пасує для діаграм, сканованих графіків та інших зображень у яких важливе зберігання без втрати різкості. Ці формати не завжди варто використовувати, якщо ви маєте справу з фотографіями.

- JPG є форматом зберігання даних з втратою якості, за використання якого файли мають менший розмір за файли у форматі PNG ціною певною втрати деталізації зображення. Зазвичай, зберігання у цьому форматі фотографій не призводить до видимої втрати якості, але погіршує якість діаграм, креслень і може призвести до зникнення з зображення тонких ліній, у останніх випадках слід використовувати EPS або PNG.

Але завжди пам’ятайте: якщо на початку був мотлох, вийде мотлох! Ніяке перетворення не зробить погане зображення кращим.

### EPS-графіка

Графічні файли у форматі EPS є традиційним способом додавання графічних файлів до документів &latex;. Оскільки списки листування переповнено питаннями щодо графіки у форматі EPS, ми обговоримо деякі важливі аспекти і продемонструємо спосіб, у який &kile; підтримує ці файли.

#### &latex; і EPS-графіка

Якщо ви вирішили скористатися традиційним &latex; для створення файлів у форматі PS або PDF, ймовірно, у вас можуть виникнути проблеми з графічними файлами. Вам доведеться використовувати EPS-графіку (Encapsulated &PostScript;), а не файли JPEG або PNG. Це не повинно призвести до проблем, оскільки існує багато інструментів перетворення, зокрема програма `convert` з чудового пакунка &imagemagick;. Але подібне перетворення може тривати деякий час.

Файли EPS використовуються як &latex;, так і інструментом перетворення DVI-PS:

- &latex; шукає у файлі EPS рядок обмежувальної рамки, який повідомляє &latex; про те, скільки простору сторінки слід зарезервувати для рисунка.

- Після цього інструмент перетворення DVI-PS прочитає файл EPS і вставить рисунок до файла PS.

Ось вам декілька підказок:

- &latex; ніколи не читає файл EPS, якщо параметри обмежуючої рамки не було вказано у команді вставки рисунка.

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

- Рисунки у форматі EPS не включаються до файла DVI. Оскільки файли EPS потрібні для перетворення файла DVI у формат PS, ці файли EPS слід зберігати разом з файлами DVI.

Тепер можна викликати &latex;, а потім інструмент перетворення DVI-PS, наприклад dvips, для створення вашого документа &PostScript;. Якщо вашою метою є створення документа PDF, вам слід виконувати команду `dvips` з параметром `-Ppdf`, а потім викликати команду `ps2pdf`. Подібну схему обробки ви знайдете у більшості документів з цього питання.

#### Робота з &PostScript; у &kile;

&kile; допоможе вам отримати дані щодо обмежуваної рамки. Якщо ви встановили пакунок &imagemagick;, &kile; зможе видобути ці відомості з файла EPS і вставити потрібні параметри. Подібне видобування відбувається автоматично після вибору графічних файлів. У подібній процедурі існує дві переваги:

- Отримані дані буде показано у діалоговому вікні, &latex; не потрібно буде пізніше видобувати ці дані.

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

- &kile; також підтримує файли EPS, стиснуті zip або gzip, які мають набагато менший розмір ніж нестиснуті файли EPS. Але цією функціональною можливістю можна буде скористатися за спеціального налаштування системи і зміни ваших локальних налаштувань графіки, на зразок тих, які описано у розділі Растрова графіка.

#### Робота з &PostScript; і растрова графіка

Якщо у вашій системі уможливлено `shell-escape`, &kile; підтримуватиме простий спосіб включення растрової графіки, якщо ви належно налаштували вашу систему &tex;. Потреби у перетворенні графіки у форматах JPEG або PNG не буде, її буде виконано автоматично під час перетворення файла DVI на файл PS.

&latex; потрібні дані щодо суфіксів файлів. Пакунок `graphicx` шукає файл `graphics.cfg`, який має зберігатися за шляхом пошуку ваших документів &latex;. Знайдіть такі рядки:

    \DeclareGraphicsRule{.pz}{eps}{.bb}{}%
       \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
       \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
       \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
       \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{}%

і замінити ці рядки на рядки:

    \DeclareGraphicsRule{.pz}{eps}{.bb}{}%
       \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
       \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
       \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
       % changed or new graphic rules
       \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}%   zipped EPS
       \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}%   gzipped EPS
       \DeclareGraphicsRule{.jpg}{eps}{}{`convert #1 eps:-}%         JPEG
       \DeclareGraphicsRule{.gif}{eps}{.bb}{`convert #1 eps:-}%      GIF
       \DeclareGraphicsRule{.png}{eps}{.bb}{`convert #1 eps:-}%      PNG
       \DeclareGraphicsRule{.tif}{eps}{.bb}{`convert #1 eps:-}%      TIFF
       \DeclareGraphicsRule{.pdf}{eps}{.bb}{`convert #1 eps:-}%      PDF-graphics

У Debian ви знайдете цей файл за адресою `/etc/texmf/latex/graphics.cfg`. Найкращим способом змінити ці параметри є скопіювати цей файл до вашого локального шляху tex, а потім внести зміни. Ознайомтеся з підручником з &tex; вашого дистрибутива, щоб дізнатися як отримати список ваших тек &tex;.

За допомогою цього файла налаштувань ви зможете вставляти растрові рисунки і стиснуті zip або gzip файли EPS у &latex;. Команда для перетворення передається `dvips`. Якщо ви подивитеся на команду перетворення ви побачите, що вона не створює ніяких додаткових файлів. Результат процесу перетворення буде безпосередньо передано до файла PS. Єдиним набором даних, який потрібно знати &latex;, є розміри рисунка, тому нам потрібна обмежуюча рамка, яку створить &kile;.

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

#### &pdflatex; і EPS-графіка

Як ми вже зауважили, &pdflatex; не здатен працювати з графічними файлами у форматі EPS, але тут вам можуть допомогти інструменти перетворення, зокрема epstopdf. Найкращим вирішенням проблеми є додавання рядка включення пакунка `epstopdf` одразу після рядка включення `graphicx`.

    \usepackage[pdftex]{graphicx}
       \usepackage{epstopdf}

Тепер можна включати рисунки у форматі EPS, якщо ви запускатимете `pdflatex` з параметром `--shell-escape`, але все можна зробити ще краще, принагідно увімкнувши обробку файлів EPS, стиснутих zip або gzip. Знову ж таки доведеться змінити файл налаштування графіки `graphics.cfg` у спосіб, описаний раніше. Цього разу вам слід знайти рядки:

    % pdfTeX is running in pdf mode
       \ExecuteOptions{pdftex}%

і просто додати туди такі рядки:

    % pdfTeX is running in pdf mode
       \ExecuteOptions{pdftex}%
       \AtEndOfPackage{%
          \g@addto@macro\Gin@extensions{.eps.gz,.eps.zip}%
          \@namedef{Gin@rule@.eps.gz}#1{{pdf}{.pdf}{`gunzip -c #1 | epstopdf -f
    >\Gin@base.pdf}}%
          \@namedef{Gin@rule@.eps.zip}#1{{pdf}{.pdf}{`unzip -p #1 | epstopdf -f
    >\Gin@base.pdf}}%
       }%

Після додавання цих рядків &pdflatex; зможе працювати з файлами EPS, це, сподіваємося, розв’яже ваші проблеми з графікою.

### Головний документ

Визначення документа як головного надасть вам змогу працювати з окремими файлами: основним (або головним документ) і дочірніми документами, з яких складатиметься сама робота. Після визначення головного документа за допомогою відповідного пункту з меню Параметри всі команди з меню Інструменти стосуватимуться головного документа, навіть якщо ви працюєте з одним з дочірніх документів. Це стосується навіть випадків, коли головний документ не відкрито.

### Робота над помилками

Після виконання спроби збирання документа &kile; намагається знайти у створеному журналі повідомлення про помилки. Якщо подібні повідомлення про помилки або попередження буде знайдено, програма покаже ці повідомлення у вікні Журнал і повідомлення. Ви можете проаналізувати ці повідомлення за допомогою пункту меню Збирання Переглянути файл журналу або клавіатурного скорочення &Alt;0. Після використання однієї з цих дій створений файл журналу буде показано у вікні Журнал і повідомлення, рядки з помилками та рядки, про які система збирання вас попередила, буде підсвічено.

Перегляд журналу Перегляд журналу

Перегляд журналу

Перейти від одного повідомлення у файлі журналу до іншого дуже просто: скористайтеся пунктами менюЗбирання Наступна/Попередня помилка/попередження LaTeX або відповідними кнопками панелі інструментів.

Щоб перейти до рядка текстових кодів &latex;, у якому сталася помилка або було створено попередження, натисніть відповідний рядок у вікні Журнал і повідомлення. &kile; автоматично виконає гортання коду до потрібного рядка.

### Режим нагляду за файлами

Після запуску команди Quickbuild і збирання документа буде запущено певний інструмент перегляду. Якщо ви не користуєтеся вбудованим переглядачем, програма кожен раз відкриватиме нове вікно переглядача.

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

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

## Навігація кодом &latex;

### Користування переглядом структури

У перегляді Структура буде показано ієрархічну структуру документа, який ви створюєте за допомогою &kile;. Ви зможете швидко пересувати перегляд документом та переглядати його структурні частини. Щоб пересунути область перегляду у редакторі, вам достатньо натиснути відповідну позначку мітки, глави, розділу, підрозділу тощо, — програма пересуне область перегляду на початок відповідного фрагмента тексту.

Якщо ви включили до документа окремий файл кодів &latex; за допомогою теґів `\input` або `\include`, відповідний файл буде показано у перегляді Структури, наведення вказівника миші на позначку цього файла з наступним подвійним клацанням лівою кнопкою миші відкриє включений файл у вікні редактора &kile;.

Крім того, у ієрархічному дереві є окрема гілка для міток, які було використано у тексті.

#### Користування контекстним меню

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

Використання перегляду структури Використання перегляду структури

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

Контекстне меню для записів структури документа Контекстне меню для записів структури документа

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

Контекстне меню для записів рисунків/таблиць та графіки Контекстне меню для записів рисунків/таблиць та графіки

#### Оновлення перегляду структури

Оновити дані перегляду структури можна за допомогою пункту меню Зміни Оновити структуру або натисканням клавіші F12. Крім того, ви можете просто зберегти ваш документ, після чого &kile; оновить дані у перегляді Структура.

### Закладки

Закладки — це ваші посилання на фрагменти тексту або рядок у середовищі &kile;. Щоб встановити закладку, оберіть певний рядок у вашому документі, до якого ви бажаєте згодом повернутися, а потім натисніть комбінацію клавіш &Ctrl; B, — &kile; створить закладку на відповідному рядку. Іншим способом створення закладки є виділення рядка з наступним використанням пункту меню Закладка Встановити закладку.

Щоб вилучити всі закладки одразу, скористайтеся пунктом меню Закладки Очистити всі закладки.

## Проекти

### Робота з проектами

У &kile; ви можете створювати і працювати з проектами. Проект — це група файлів &latex;, графічних файлів, файлів &bibtex; або інших файлів, які містять дані, потрібні для збирання вашого документа. Типовим проектом є документ, що складається з декількох глав, збережених у різних файлах `.tex`. Всі ці глави можна включити до проекту, щоб полегшити керування документом. Специфікація проекту зберігається у окремому файлі, назва якого завершується суфіксом `.kilepr`.

За допомогою проектів ви отримаєте доступ до таких функціональних можливостей:

- Вам не потрібно буде вказувати головний документ, &kile; визначить його автоматично.

- Файли проекту дуже просто архівувати всі одразу за допомогою пункту меню Проект Архівувати

- У перегляді Файли і проект буде показано файли, які включено до проекту.

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

- Автоматичне доповнення кодів працюватиме у всіх файлах проекту.

- Автоматичне доповнення посилань працюватиме у всіх файлах проекту.

- Автоматичне доповнення посилань на бібліографію працюватиме у всіх файлах проекту.

- Можна буде виконувати пошук одразу у всіх файлах проекту.

- Можна буде визначити нетипову команду швидкого збирання і команду &makeidx;.

Всі пункти дій, пов’язані з проектами, зібрано у меню Проект. За допомогою цього меню ви можете відкривати, закривати проекти та виконувати дії з керування вашими проектами.

### Як створити проект

Щоб створити проект, скористайтеся пунктом меню Проект Новий проект.... Для створення проекту програмі будуть потрібні такі дані:

- Назва вашого проекту.

- Назва файла вашого проекту з суфіксом `.kilepr`.

- Назва файла

- Тип файла, який буде створено: порожній документ, стаття, книга, лист, звіт...

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

### Перегляд файла і проекту

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

Перегляд файла і проекту Перегляд файла і проекту

Перегляд файла і проекту

### Додавання і вилучення файлів

Щоб додати файл до вашого проекту, відкрийте будь-який файл &tex;, наведіть вказівник миші на позначку його назви у вікні перегляду Файли і проекти, клацніть правою кнопкою миші і скористайтеся пунктом Додати до проекту. Якщо у редакторі відкрито декілька проектів, програма відкриє діалогове вікно за допомогою якого ви зможете вказати проект, до якого слід додати файл.

Крім того, ви можете навести вказівник миші на пункт назви проекту у вікні перегляду Файли та проекти, клацнути правою кнопкою миші і обрати пункт Додати файли..., щоб відкрити діалогове вікно вибору файлів.

Додавання файла до проекту Додавання файла до проекту

Додавання файла до проекту

Щоб вилучити файл з проекту, наведіть на його позначку вказівник миші, клацніть правою кнопкою і оберіть у контекстному меню пункт Вилучити файл. Вилучення файла з проекту не призведе до вилучення відповідного файла з диска (і не закриє вікна його редагування), — ця дія лише вилучить файл зі списку файлів, назви яких зберігаються у файлі з суфіксом `.kilepr`.

#### Архівування вашого проекту

У &kile; передбачено можливість простого створення резервної копії вашого проекту шляхом архівування всіх його файлів у окремому архіві. Щоб виконати архівування вашого проекту наведіть вказівник миші на позначку його назви у вікні Файли і проект і клацніть правою кнопкою миші або скористайтеся пунктом меню Збирання Проект Архівувати.

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

Дію з архівування у поточній версії реалізовано за допомогою виконання команди `tar` у теці проекту (теці, у якій розташовано файл `.kilepr`).

### Параметри проектів

У &kile; передбачено декілька параметрів вашого проекту, які ви можете встановити. Щоб змінити ці параметри, наведіть вказівник миші на позначку назви вашого проекту, клацніть правою кнопкою миші і оберіть у контекстному меню пункт Параметри проекту. Ви отримаєте доступ до зміни таких параметрів проекту:

- Назву вашого проекту.

- Типові суфікси назв файлів.

- Головний документ.

- Команду швидкого збирання.

- Параметри &makeidx;.

### Як закрити проект

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

## Кодування документа

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

- Першим способом встановлення кодування документа є використання пункту меню Параметри Налаштувати Kile... Редактор. На відповідній сторінці ви можете вказати типове кодування символів для всіх файлів, з якими ви працюєте.

  Встановлення типового кодування символів Встановлення типового кодування символів

- Другим способом встановлення кодування є вибір бажаного кодування під час створення документа за допомогою майстра.

Сам &latex; розуміє лише ASCII, дуже обмежений набір символів, отже використовувати акцентовані та спеціальні символи напряму неможливо. Щоб ввести акцентовану літеру, слід скористатися особливою синтаксичною конструкцією: такою, як, наприклад, `\"e` для отримання літери `ë`. Існує пакунок, який допоможе вам вирішити цю проблему. Цей пакунок називається inputenc, його слід включити до преамбули за допомогою команди `\usepackage[utf8]{inputenc}`, необов’язковим параметром якої є назва кодування, яким ви бажаєте скористатися (зараз здебільшого користуються кодуванням `utf8`). Таким чином ви повідомите &latex; про те, що слід перетворити всі введені вами `ë` на `\"e` перед збиранням документа. Будь ласка, ознайомтеся з документацією пакунка inputenc, щоб дізнатися більше про inputenc. Ну і, нарешті, не забудьте переконатися, що ваш файл справді має те саме кодування, про яке ви повідомили за допомогою рядка inputenc!

Існування різних таблиць кодування створює проблеми: наприклад, ви, звичайно ж, не зможете писати одночасно українською і французькою без втрати спеціальних символів однієї з мов. Всі погоджуються з тим, що рано чи пізно відбудеться перехід на Unicode. Існує багато реалізацій Unicode: UTF-8 найширше використовується у Linux; у Windows® використовується складніший і менш гнучкий варіант UCS-2. У більшості дистрибутивів типовим кодуванням вже є UTF-8, тому бажано використовувати параметр `utf8` під час включення пакунка `inputenc`.

### Пакунок &ucs;

Якщо у вашій системі ще не встановлено пакунок &ucs;, ви можете його встановити, виконавши таку послідовність дій:

- Отримати пакунок &ucs; можна за допомогою CTAN.

- Щоб встановити потрібні файли, розпакуйте звантажений архів до каталогу, який згадується у вашій змінній середовища $`TEXINPUTS`. Вказати значення цієї змінної можна напряму з kile.

    \usepackage{ucs}
    \usepackage[utf8]{inputenc}

### XeLaTeX

Якщо ви користуєтеся `XeLaTeX`, вам достатньо завантажити пакунок `xltxtra`. За допомогою цього пакунка буде додатково завантажено всі інші потрібні пакунки.

    \usepackage{xltxtra}

### Підтримка &cjk;

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

У вашому дистрибутиві Linux, можливо, вже встановлено пакунок &cjk; (Chinese, Japanese, Korean), отже вам не доведеться нічого встановлювати вручну. Перевірте, чи встановлено цей пакунок, перш ніж виконувати будь-які з наведених нижче настанов!

Для створення коротких фрагментів ієрогліфічних текстів ви можете скористатися пакунком &ucs;, але цей варіант має серйозні обмеження, оскільки за його використання є неможливим розрив рядків. Ми розповімо як встановити повноцінний пакунок &cjk;-&latex;, який працюватиме у &latex; і &pdflatex;. Більшість порад запозичено зі сторінки Pai H. Chou, присвяченої налаштуванню &pdflatex;.

1. Звантажте пакунок &cjk;. Скопіюйте розпаковані файли до відповідної підтеки $`TEXMF`, подібно до копіювання файлів пакунка &ucs;, про яке ми розповідали раніше (див. ucs). Файли буде розпаковано до теки `CJK/X_Y.Z`, їх не обов’язково звідти виймати, зробіть все так, щоб вам зручніше було підтримувати відповідний пакунок у належному стані.

2. Тепер вам слід звантажити шрифт, у якому передбачено підтримку всіх потрібних вам символів &cjk;. Ви можете скористатися будь-яким файлом `*.ttf`, у якому є відповідні символи, але у нашому прикладі ми скористаємося шрифтом Cyberbit. Розпакуйте архів і перейменуйте файл `Cyberbit.ttf` на `cyberbit.ttf`, оскільки використання верхнього регістру може спричинити проблеми під час роботи.

   Скопіюйте `cyberbit.ttf` до певної теки разом з файлом `Unicode.sfd`, а потім створіть файли `*.tfm` і `*.enc` за допомогою команди ``$ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@``. З певних причин іноді виконання цієї команди не створює, як це має бути, сотень файлів. Якщо так сталося, ви можете звантажити відповідні файли `*.tfm` і `*.enc`.

   Скопіюйте файли `*.tfm` до відповідної теки, наприклад `$`TEXMF`/fonts/tfm/bitstream/cyberbit/`; файли `*.enc` слід встановити до теки `$`TEXMF`/pdftex/enc/cyberbit/`.

3. Тепер нам потрібен файл карти (map), щоб пов’язати файли `*.enc` з шрифтом. Звантажте файл `cyberbit.map`, а потім скопіюйте його до теки `$`TEXMF`/pdftex/config/`.

4. Звантажте ще один файл, `c70cyberbit.fd`, і скопіюйте його до відповідної теки. Ви, наприклад, можете вибрати теку `$`TEXMF`/tex/misc/`.

5. Останнім з файлів, які нам слід створити є файл шрифту Type 1 &PostScript;, потрібний для читання файлів DVI, створених за допомогою &latex;. Виконайте команду ``$ ttf2pfb cyberbit.ttf -o cyberbit.pfb`` і скопіюйте отриманий файл `cyberbit.pfb` до теки на зразок `$`TEXMF`/fonts/type1/cyberbit/`.

6. Тепер давайте розташуємо `cyberbit.ttf` серед шрифтів так, щоб &latex; міг його знайти. Ви, наприклад, можете скопіювати цей файл до теки з назвою `$`TEXMF`/fonts/truetype/`.

7. Відкрийте файл налаштування, який ви знайдете за адресою `$`TEXMF`/web2c/texmf.cnf`, і переконайтеся, що рядок зі словом `TTFONTS` не закоментовано і що у цьому рядку записано теку, куди ви скопіювали `cyberbit.ttf`.

8. Щоб уможливити використання &pdflatex; ваших шрифтів &cjk;, потрібно додати відповідний рядок до файла налаштувань `$`TEXMF`/pdftex/config/pdftex.cfg`. Допишіть у цей файл `map +cyberbit.map`, щоб завершити налаштування для &pdflatex;.

9. Щоб налаштувати &latex; так, щоб він міг створювати файли DVI з символами &cjk;, вам слід додати певний рядок до файла `ttfonts.map`. Цей файл має зберігатися у теці з назвою `$`TEXMF`/ttf2pk/`, але, якщо його там немає, ви можете пошукати деінде. Додайте рядок `cyberbit@Unicode@ cyberbit.ttf` у цей файл.

10. Тепер вам достатньо виконати команду ``texhash`` — і система готова до роботи.

Щоб перевірити чи правильно налаштовано систему, спробуйте скомпілювати цей тестовий файл.

#### Настанови з усування проблем з &cjk;

Існує багато причин, з яких встановлення підтримки &cjk; вручну може не спрацювати. Якщо щось не працює, спробуйте перевірити систему за такими критеріями за наведеним нижче списком.

- Очевидно, оскільки ви запускаєте &latex; від імені користувача, а не адміністратора (root), вам слід дозволити звичайним користувачам доступ до нових файлів. Забезпечте доступність всіх тек і файлів за допомогою команди `chmod`.

- Якщо &latex; створює DVI без проблем, але переглянути файл ви не можете, ймовірно, причиною цього є певні проблеми зі створенням файлів шрифтів `*.pk`. Ці файли має бути створено на льоту під час спроби перегляду файла DVI, але спроба створення може зазнати невдачі з декількох причин: ретельно перевірте, чи наявний доданий вами рядок у `ttfonts.map`. Але, може так статися, що вашу програму `ttf2pk`, яку, зазвичай, викликає інструмент перегляду DVI, було зібрано без підтримки бібліотек kpathsea. Якщо це так, у виводі команди ``ttf2pk` `--version`` не буде згадок про kpathsea. Оскільки підтримка відповідних бібліотек є необхідною, вам доведеться знайти новий пакунок або перезібрати FreeType 1 власноруч.

#### Як мені ввести ієрогліфи у Unicode?

Існує багато різних рушіїв вводу, вибір рушія є справою смаку. Автор цього підручника користується Skim, портом рушія Scim для &kde;. Зверніться до документації з вашого дистрибутива, щоб дізнатися більше про те, як встановити ці програми. Налаштування програм може бути також непростою справою. У випадку Skim вам доведеться визначити змінну середовища ``XMODIFIERS`="@im=SCIM"` до запуску сервера X.

## Запис сценаріїв

### Написання скриптів для &kile;

У &kile; передбачено можливість виконання кодів ECMAScript. Керувати скриптами можна за допомогою підпанелі роботи зі скриптами, розташованої на бічній панелі.

### Довідка з програмного інтерфейсу

У цьому розділі ми опишемо інтерфейс роботи зі скриптами &kile;.

Будь ласка, зауважте, що програмний інтерфейс написання скриптів ще не узгоджено остаточно. Інтерфейс, описаний нижче може змінитися у наступних версіях &kile;.

Перш за все, у середовищі виконання скриптів &kile; передбачено загальний об’єкт з назвою «kile», для якого передбачено такі методи:

(kile).`currentTextDocument()`

- Повертає об’єкт `KileTextDocument`, який відповідає поточному активному документу у вікні редактора. Повертає `null`, якщо активного документа немає.

(kile).`getInputValue(`заголовок`, `мітка`)`

- Відкриває діалогове вікно з вказаним заголовком і міткою. Повертає значення, введене користувачем.

Об’єкти типу `KileTextDocument` відповідають текстовим документам у &kile;. Ці об’єкти мають такі властивості:

(KileTextDocument).`backspace()`

- Вилучає символ, який було розташовано одразу перед поточною позицією курсора і пересуває курсор на одну позицію текстом.

(KileTextDocument).`cursorLeft()`

- Пересуває курсор на одну позицію назад текстом.

(KileTextDocument).`cursorRight()`

- Пересуває курсор на одну позицію вперед текстом.

(KileTextDocument).`insertText(`текст`)`

- Вставляє текст, що міститься у змінній `text` до документа у поточну позицію курсора.

(KileTextDocument).`insertBullet()`

- Вставляє у документ позначку на поточній позиції курсора.

(KileTextDocument).`nextBullet()`

- Виділяє першу ж позначку, розташовану у документі після поточної позиції курсора.

(KileTextDocument).`previousBullet()`

- Виділяє першу ж позначку, розташовану у документі до поточної позиції курсора.

(KileTextDocument).`up()`

- Пересуває курсор у документі на один рядок вгору.

(KileTextDocument).`down()`

- Пересуває курсор у документі на один рядок вниз.

(KileTextDocument).`cursorLine()`

- Повертає номер рядка, у якому зараз перебуває курсор.

(KileTextDocument).`cursorColumn()`

- Повертає номер позиції у рядку, у якій зараз перебуває курсор.

(KileTextDocument).`setCursorLine(`рядок`)`

- Пересуває курсор у рядок, визначений параметром `рядок`.

(KileTextDocument).`setCursorColumn(`стовпчик`)`

- Пересуває курсор у позицію рядка, визначену параметром `стовпчик`.

## Довідка

### Довідкові документи

&latex; є досить складною системою, у якій базові функції можна розширювати за допомогою величезної кількості додаткових пакунків. У &kile; передбачено цілий спектр довідкових матеріалів, призначених для підтримки користувачів.

Довідка LaTeX

- Впорядкований за абеткою список найуживаніший команд &latex;.

Документація з TeX

- &tetex;/&texlive; постачається з дуже розгорнутою документацією. Серед цієї документації документація щодо всіх пакунків і додаткові довідники з &latex;.

LaTeX

- Повний довідник з &tex; і супутніх програм. Це не лише опис всіх програм, у ньому згадуються також і деякі важливі пакунки. До нього також включено повну інструкцію з команд &latex; — ідеальне джерело для пошуку команд форматування під час створення документа. Оскільки цей документ досить великий, у &kile; його поділено на три частини, закладки яких і показано у меню програми.

Команда LaTeX

- Ще один впорядкований за абеткою список найуживаніший команд &latex;.

Тема у LaTeX

- Опис важливих тем у &latex;.

Середовище LaTeX

- Впорядкований за абеткою список найуживаніших середовищ &latex;.

### Контекстна довідка

Крім того, у &kile; передбачено контекстну довідку, яку можна викликати за допомогою комбінації клавіш &Ctrl;&Alt;H,K. На сторінці Параметри Налаштувати Kile... Kile Довідка ви можете вказати програмі: бажаєте ви використовувати довідку з &latex; &kile; чи довідкову систему &tetex;/&texlive;, яка є типовою довідковою системою.

Позначки Позначки

### Пошук за ключовими словами

Іноді, знайти потрібний документ не просто, оскільки разом з &tetex;/&texlive; постачається величезна кількість документів. У такому випадку вам може допомогти невеличка програма texdoctk, яка постачається разом з &tetex;/&texlive;. До складу цієї програми входить база даних всіх документів, яку &kile; використовує для показу списку документів.

Позначки Позначки

Всі документи зібрано у категорії, основною перевагою є можливість пошуку за назвами пакунків або ключовими словами. &kile; показуватиме лише результати пошуку.

Позначки Позначки

Подвійне клацання лівою кнопкою миші або натискання клавіші Пробіл відкриє вікно переглядача документа. Цим документом може бути довільний документ, не лише документ DVI, PS, PDF або HTML. &kile; використає параметри &kde; для визначення назви програми-переглядача, яку слід запустити.

### Довідка, визначена користувачем

Окрім статичної документації з &tetex;/&texlive;, у &kile; передбачено і підтримку інших документів довідки. У меню Довідка &kile; є спеціальний пункт Довідка користувача, за допомогою якого користувач сам зможе додавати власні довідкові документи. Цими документами можуть бути найважливіші частини документації &tetex;/&texlive; або навіть власноруч написані документи. Ви навіть можете просто вказати адреси URL сторінок у інтернеті.

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

Діалогове вікно: налаштування визначених користувачем пунктів меню довідки Діалогове вікно: налаштування визначених користувачем пунктів меню довідки

Натискання кнопки Додати відкриє діалогове вікно, у якому ви зможете вказати назву пункту меню і обрати відповідний файл або адресу &URL; у інтернеті. Якщо ви оберете адресу &URL;, програма запустить &konqueror;, звідки ви зможете скопіювати остаточну адресу &URL;.

Діалогове вікно: додавання нового пункту довідки Діалогове вікно: додавання нового пункту довідки

Після завершення налаштування пункти всіх позначених записів мають з’явитися у меню Довідка &kile; у спеціальному підменю Довідка користувача.

Меню довідки користувача Меню довідки користувача

## Подяки і ліцензія

&kile; — дружній до користувача редактор текстів &latex; / &tex; з відкритим кодом. Ним можна користуватися у всіх системах, де встановлено стільничне середовище &kde; &kde; можна використовувати на комп’ютерах з різною апаратною платформою, де встановлено Linux або іншу Unix-подібну систему.

Велика подяка всім, хто доклав зусилля для розвитку проекту &kile;, та учасникам розробки, які витрачали свій час годинами, щоб створити інструменти розробки, якими ми можемо користуватися за умов дотримання ліцензії GNU. Поточні дані щодо учасників розробки можна знайти у діалоговому вікні Про &kile;, це діалогове вікно відкривається відповідним пунктом з меню Довідка.

Велика подяка всім, хто брав участь!

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

&underFDL; &underGPL;
&documentation.index;