JetTeX
Матеріал з ВНТУ Вікі
Зміст
Вступ
JetTeX (вимовляється «джетте́к») - це вебредактор для роботи з LaTeX-документами, який дозволяє:
- створювати окремі LaTeX-документи;
- створювати та використовувати шаблони - готові заготовки документів, на основі яких можна почати новий;
- імпортувати готові файли або .zip-архіви з файлами документу, якщо ви вже маєте напрацьований матеріал;
- компілювати документ у PDF;
- переглядати результат компіляції одразу ж, у вигляді готового PDF-файлу власне у редакторі.
LaTeX (вимовляється «лате́к») — мова розмітки даних та пакет макросів TeX для високоякісного оформлення документів.
Списки документів та шаблонів
На головній сторінці відображаються два списки - документи та шаблони - для викладачів та один список - документи - для студентів.
Кожен документ можна:
- відкрити для редагування (натиснувши на назву);
- скопіювати;
- редагувати;
- відкрити PDF, якщо документ коректний;
- опублікувати до репозиторію (для викладачів) або до Файл-Експрес (для студентів);
- видалити.
Створення шаблону (лише для викладачів)
Для створення нового шаблону потрібно перейти до списку шаблонів, натиснути кнопку "Новий шаблон" та заповнити наступну форму:
Назва шаблону обов'язкова.
Як основу для шаблону можна використовувати .zip-архів. Для цього потрібно відмітити прапорець "Використати ZIP" та потім власне обрати .zip-архів.
Створення документу
Для створення нового документу потрібно на сторінці зі списком документів натиснути кнопку "Новий документ" та заповнити наступну форму:
Назва документу обов'язкова.
Як основу для документу можна використовувати шаблон. Для цього потрібно відмітити прапорець "Використати шаблон" та потім власне обрати його серед випадаючого списку.
Або ж можна використовувати .zip-архів. Для цього потрібно відмітити прапорець "Використати ZIP" та потім власне обрати .zip-архів.
ВАЖЛИВО - кожен документу мусить мати файл main.tex. Це основний (вхідний) файл кожного документу. При створенні документу або шаблону - такий файл буде створено автоматично. Якщо документ було створено використовуючи .zip-архів, то такий файл буде створено за умови його відсутності у архіві.
Основний інтерфейс редактора
Робочий простір проєкту складається з трьох основних частин:
Дерево файлів (ліва панель)
Тут відображається структура вашого документу — усі файли та папки: .tex-файли, зображення, бібліографії тощо. З цієї панелі можна:
- створювати нові файли й папки;
- перейменовувати та видаляти елементи;
- імпортувати окремі файли (картинки, файли PDF), групи файлів або .zip-архів у будь-яку папку.
Головний файл — main.tex — саме з нього починається компіляція документа. Він знаходиться в корені дерева файлів та не може бути перейментований або видалений.
Редактор (центральна частина)
Основне робоче вікно, де можна редагувати вміст обраного файлу, а також переглядати обраний файл (текстовий, зображення або файл PDF). Клацнувши на будь-якому файлі в дереві зліва, можна відкрити його вміст для редагування або перегляду.
При редагуванні будь-якого файлу зміни зберігаються автоматично.
Зверху над редактором розташована Панель компіляції - тут можна скомпілювати документ або відкрити його у новій вкладці.
PDF-прев'ю (права панель)
Після успішної компіляції готовий PDF-файл можна одразу переглянути на правій панелі.
Робота з деревом файлів
Кожна папка має декілька кнопок:
- створення нової папки всередині - у модальному вікні потрібно ввести лише її назву;
- створення нового файлу всередині - у модальному вікні потрібно ввести її назву файлу (не обов'язково) та розширення файлу (у форматі sample.bib або .ttf);
- імпортувати файл чи декілька файлів всередину. У кореневій папці кнопка відображається одразу, у всіх інших папках цю функцію можна знайти всередині меню (натиснувши три крапки);
- імпортувати файли із .zip-архіву. Всі файли із архіву будуть перевірені та всталені у бажану папку. У кореневій папці кнопка відображається одразу, у всіх інших папках цю функцію можна знайти всередині меню (натиснувши три крапки);
- перейменувати - доступно для всіх папок, окрім кореневої;
- видалити - доступно для всіх папок, окрім кореневої'.
ВАЖЛИВО
- Якщо при здійснені імпорту .zip-архіву у кореневу папку виявиться так, що архів містить в собі файл main.tex, то у поточному документі буде перевірено чи main.tex містить якийсь контект. Якщо так, то він буде перейменований у main_old.tex та залишиться в кореневій папці, а новий файл буде завантажено, як очікувалось. Якщо ні, то файл main.tex буде замінено на новий.
- Якщо файл із такою назвою вже існує в папці, він не перезаписується: система пропускає такий файл і показує звіт про пропущені файли з причиною.
Кожен файл має кнопку меню, натиснувши яку можна:
- перейменувати файл - доступно для всіх файлів, окрім main.tex;
- видалити - доступно для всіх файлів, окрім main.tex'.
ВАЖЛИВО - створювати чи завантажувати файли з розширеннями .php, .pl, .js заборонено — система блокує їх незалежно від способу додавання (вручну, через імпорт чи zip-архів).
"Вставити" та "Форматувати"
Над редактором розташована панель з двома випадаючими меню, які допомагають вставляти елементи та форматувати текст без ручного набору LaTeX-команд.
ПОРАДА - можна виділити текст перед форматування/вставкою, щоб застосувати до цього тексту бажаний ефект.
Випадаюче меню "Вставити" має наступні пункти:
| Пункт | Що робить | Розмітка |
|---|---|---|
| Формула → У стрічку | Вставляє математичну формулу в текст рядка | \(\) |
| Формула → Блоком | Вставляє формулу окремим блоком з нової стрічки | \[\] |
| Рисунок → З комп'ютера | Завантажує рисунок з вашого комп'ютера та вставляє його в документ. Потрібно потрібно обрати файл, папку до якої зберегти його, можливість додавати підпис та мітку, а також ширину | \begin{figure}
\centering
\includegraphics[width=0.5\linewidth]{Enter image name}
\caption{Enter Caption} |
| Рисунок → Із файлів документу | Вставляє зображення, яке вже завантажене в поточний документ. Потрібно обрати рисунок серед списку, можливість додавати підпис та мітку, а також ширину | \begin{figure}
\centering
\includegraphics[width=0.5\linewidth]{Enter image name}
\caption{Enter Caption} |
| Рисунок → Із файлів іншого документу | Вставляє зображення з іншого вашого документу. Потрібно обрати документ, потім рисунок серед списку доступних у документі, папку до якої зберегти його в поточному документі, можливість додавати підпис та мітку, а також ширину | \begin{figure}
\centering
\includegraphics[width=0.5\linewidth]{Enter image name}
\caption{Enter Caption} |
| Таблиця | Вставляє таблицю бажаного розміру. Потрібно обрати розмір таблиці виділивши бажану кількість рядків та стовбців | \begin{table}
\centering
\begin{tabular}{ccc}
& & \\
& & \\
& & \\
& & \\
\end{tabular}
\caption{Caption}
\label{tab:placeholder}
\end{table} |
| Цитата | Вставляє команду цитування | \cite{} |
| Посилання | Вставляє гіперпосилання | \href{}{} |
| Посилання з .bib | Вставляє бібліографічне посилання, обране зі списку джерел у .bib-файлі проєкту, якщо такі наявні | \cite{Enter bib link} |
| Перехресне посилання | Вставляє посилання на інший розділ/рисунок/формулу в межах документа | \ref{} |
Випадаюче меню "Форматувати" має наступні пункти:
| Пункт | Що робить | Розмітка |
|---|---|---|
| Напівжирний | Змінює текст на напівжирний | \textbf{} |
| Курсив | Змінює текст на курсив | \textit{} |
| Маркований список | Створює пустий маркований список або обгортає виділений текст у маркований список | \begin{itemize}
\item \item \end{itemize} |
| Нумерований список | Створює пустий нумерований список або обгортає виділений текст у нумерований список | \begin{enumerate}
\item \item \end{enumerate} |
| Стилі параграфів | Створює новий або перетворює виділений текст на:
|
|
Корисні посилання
Для більшого розуміння як потрібно користуватись розміткою та як створювати документи, можна скористуватись такими посиланнями:
- LaTeX Wikibook - найповніший онлайн підручник англійською: від основ до просунутих тем (власні команди, пакети, верстка)
- The Not So Short Introduction to LaTeX - PDF-посібник.