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

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

BibTEX
Якщо для роботи з бібліографічними записами ви користуєтеся BibTEX, вам, зазвичай, доведеться компілювати документ за особливою схемою. Це означає, що спочатку слід викликати LATEX, потім BibTEX, а потім ще двічі LATEX. На щастя, Kile достатньо кмітливий, щоб виявити потребу у виклику додаткових інструментів, зокрема BibTEX, makeidx і Asymptote. Подібну поведінку програми типово увімкнено, змінити цю поведінку можна на вкладці Загальне налаштування інструментів LATEX і PDFLATEX на сторінці Параметри Налаштувати Kile... Інструменти Збирання.

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

PDFLATEX
Існує і інший спосіб компіляції вашого документа, якщо вам потрібен файл PDF: ви можете запустити PDFLATEX, який збере ваш вихідний код безпосередньо у файл PDF за допомогою натискання комбінації клавіш 6. Переглянути зібраний файл можна натисканням комбінації клавіш 7.
Іншим шляхом є перетворення файла PS на файл PDF за допомогою натискання комбінації клавіш 8, або пряме перетворення файла DVI на файл PDF за допомогою натискання комбінації клавіш 9.
Причиною використання PDFLATEX замість LATEX може бути простота або звичка, але у певних випадках поведінка цих двох програм може відрізнятися.

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

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

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

Режим вибору
Користувач має обрати частину документа. За допомогою пункту меню Збирання Швидкий перегляд Вибране або клавіатурного скорочення P,S можна буде запустити вказану програму. Kile візьме преамбулу з початкового тексту, отже буде включено всі потрібні пакунки і визначені користувачем команди. Користувач може обрати один з восьми наперед визначених наборів налаштувань:
LaTeX+DVI (вбудований переглядач)
LaTeX+DVI ()
LaTeX+PS (вбудований переглядач)
LaTeX+PS ()
PDFLaTeX+PDF (вбудований переглядач)
PDFLaTeX+PDF ()
XeLaTeX+PS (вбудований переглядач)
XeLaTeX+PDF ()
Цього здебільшого має бути достатньо у випадках, коли вам знадобиться швидкий перегляд.

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

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

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

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

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

LATEX і PDFLATEX
PDFLATEX, за використання пакунка graphics або graphicx, може коректно збирати файли DVI або PDF з графікою у форматах PNG і JPG, але не може працювати з файлами EPS. І навпаки, якщо ви вирішите зібрати за допомогою програми LATEX файл DVI, а потім перетворити його на файл PS і зрештою на файл PDF, ви зможете скористатися графікою у форматі EPS, але не зможете додавати графіку у форматах PNG і JPG.
Значна кількість користувачів бажають створювати документи PDF, але також бажають скористатися чудовим пакунком Pstricks для створення графіки , або бажають скористатися даними виведеними у форматі математичними або науковими програмами, зокрема Mathematica, Maple або MuPAD. Цим користувачам LATEX слід спочатку зібрати файл , навіть, якщо вони бажають зрештою створити документи PDF, оскільки ці програми створюють код , яким не може скористатися PDFLATEX. Але це не настільки складно, як може здатися, оскільки вам допоможе Kile.

Перетворення графічної інформації
Щоб розірвати це коло, у випадку, якщо ви бажаєте включити одразу і код і файли PNG або JPG, ви можете скористатися одним з обхідних маневрів:
Якщо вам потрібен файл у форматі PS, а у вас є лише файли у форматах JPG або PNG, ви можете просто спочатку обробити код PDFLATEX з виводом до DVI, а потім виконати dvips, щоб отримати файл PS. Як бачите, PDFLATEX є чудовим вибором, якщо у ваших початкових файлах зовсім немає коду .
Ви можете перетворити файли 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 ), а не файли 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, для створення вашого документа . Якщо вашою метою є створення документа PDF, вам слід виконувати команду dvips з параметром -Ppdf, а потім викликати команду ps2pdf. Подібну схему обробки ви знайдете у більшості документів з цього питання.

Робота з у Kile
Kile допоможе вам отримати дані щодо обмежуваної рамки. Якщо ви встановили пакунок ImageMagick, Kile зможе видобути ці відомості з файла EPS і вставити потрібні параметри. Подібне видобування відбувається автоматично після вибору графічних файлів. У подібній процедурі існує дві переваги:
Отримані дані буде показано у діалоговому вікні, LATEX не потрібно буде пізніше видобувати ці дані.
Важливішим є те, що ширину і висоту зображення може бути обчислено, якщо відома його роздільна здатність. Ці дані буде показано у верхній частині діалогового вікна і може слугувати підказкою, якщо ви забажаєте змінити масштаб рисунка.
Kile також підтримує файли EPS, стиснуті zip або gzip, які мають набагато менший розмір, ніж нестиснуті файли EPS. Але цією функціональною можливістю можна буде скористатися за спеціального налаштування системи і зміни ваших локальних налаштувань графіки, на зразок тих, які описано у розділі Растрова графіка.

Робота з і растрова графіка
Якщо у вашій системі уможливлено 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 намагається знайти у створеному журналі повідомлення про помилки. Якщо подібні повідомлення про помилки або попередження буде знайдено, програма покаже ці повідомлення у вікні Журнал і повідомлення. Ви можете проаналізувати ці повідомлення за допомогою пункту меню Збирання Переглянути файл журналу або клавіатурного скорочення 0. Після використання однієї з цих дій створений файл журналу буде показано у вікні Журнал і повідомлення, рядки з помилками та рядки, про які система збирання вас попередила, буде підсвічено.
Перегляд журналу
Перегляд журналу
Перегляд журналу
Перейти від одного повідомлення у файлі журналу до іншого дуже просто: скористайтеся пунктами менюЗбирання Наступна/Попередня помилка/попередження LaTeX або відповідними кнопками панелі інструментів.
Щоб перейти до рядка текстових кодів LATEX, у якому сталася помилка або було створено попередження, натисніть відповідний рядок у вікні Журнал і повідомлення. Kile автоматично виконає гортання коду до потрібного рядка.

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