# Рисунки та діаграми

Редактор діаграм: малюйте на полотні або пишіть код — TikZ для LaTeX, fletcher для Typst або Mermaid для Markdown — із живим переглядом і редагованим вихідним кодом.

Намалюйте діаграму на полотні та отримайте чистий вихідний код мовою вашого документа: TikZ для LaTeX, діаграму fletcher для Typst або блок-схему Mermaid для Markdown. Малюнок і код лишаються узгодженими, тож ви можете перемикатися між ними будь-коли.

Редактор працює на вашому пристрої й не потребує облікового запису. (Про рисунки, які створює асистент, див. [Створення рисунків за допомогою ШІ](/docs/ai-figures/).)

## Відкрийте редактор

Із головного екрана виберіть **Редактор діаграм** у доку. Можна також запустити **Відкрити редактор діаграм** із палітри команд ⌘K (Ctrl+K) або ввести `/diagram` у пошуковому омнібарі. Діалог **Виберіть редактор діаграм** питає, для чого діаграма: **Діаграма TikZ** для документів LaTeX, **Діаграма Typst** для документів Typst або **Діаграма Mermaid** для документів Markdown.

З відкритого документа натомість виберіть **Намалювати діаграму** на панелі інструментів редактора. Редактор пропускає це питання й використовує мову документа: TikZ у файлі `.tex`, Typst у файлі `.typ` і Mermaid у файлі Markdown. **Назад до проєкту** повертає вас до документа.

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

![Діаграма TikZ, написана кодом, а потім відредагована фігурами на полотні.](https://cdn.oleafly.com/images/gifs/desktop/tikz-composer.gif?v=2)

## Малюйте на полотні

Режим **Малювання** — це полотно. Він працює однаково в усіх трьох мовах.

Виберіть фігуру з палітри (прямокутник, прямокутник із заокругленнями, коло, еліпс, ромб, паралелограм або текст), потім натисніть і потягніть, щоб розмістити її та задати розмір. **Формула** та **Код** — це текстові блоки, що починаються з формули або зі зразка коду мовою діаграми.

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

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

![Схема робочого процесу, намальована пакетом fletcher і скомпільована.](https://cdn.oleafly.com/images/gifs/desktop/typst-composer.gif?v=2)

## Редагуйте код

Режим **Код** показує ту саму діаграму як вихідний код, із меню **Фрагменти** для типових частин: вузол-прямокутник, круглий вузол, ребро зі стрілкою та ребро лінією. Відредагуйте будь-яку зі сторін, і інша послідує: пересуньте блок — зміниться код; перейменуйте мітку в коді — зміниться полотно.

Код — це звичайний вихідний код для кожної мови:

- TikZ: `tikzpicture` з вузлами та ребрами.
- Typst: повний фрагмент fletcher, із рядком `#import "@preview/fletcher:…"` і викликом `#diagram(…)`, що містить елементи `node(…)` і `edge(…)`. Версія fletcher відповідає версії Typst відкритого проєкту Typst: 0.5.8 для Typst 0.13 і новіших, 0.5.5 для 0.12 і 0.5.1 для старіших випусків.
- Mermaid: блок-схема з формами вузлів, позначеними зв’язками, рядками `style` для кольорів і підграфами для групових блоків. Mermaid компонує діаграму сам, тож позиції, які ви задали на полотні, не є частиною коду.

### Код, який полотно не вміє малювати

У Typst і Mermaid код, який полотно не може показати, лишається точно таким, як ви його написали. Для Typst це імпорти, рядки `#let`, обгортки як `#figure(…)`, додаткові налаштування діаграми та цикли. Для Mermaid це рядки `click`, директиви, коментарі та метадані. Вузол або ребро, якого ви не торкаєтеся на полотні, зберігає свій текст, а те, якого торкаєтеся, зберігає параметри, про які полотно не знає.

Коли полотно показує не все, у заголовку з’являється кнопка приміток із кількістю, як-от **2 примітки**. Вона перелічує, що лишається лише в коді, і що полотно показує приблизно: вузли без заданого розміру, форматовані мітки або форму Mermaid, якої полотно не має.

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

## Перегляньте результат

**Скомпілювати** відтворює діаграму окремо, поза вашим документом, у панелі перегляду поруч із полотном. Виберіть масштаб PNG 1x, 2x або 3x і колір тла або прозоре тло.

- TikZ компілюється через Tectonic в окремій збірці, тож напівготовлена діаграма ніколи не торкнеться вашого документа.
- Typst показує перегляд версією Typst і кешем пакунків відкритого проєкту Typst, або вбудованим Typst, коли жодного проєкту Typst не відкрито. Перший перегляд Typst завантажує fletcher із Typst Universe. В офлайн-режимі або без з’єднання перегляд повідомляє, що пакунка бракує, замість показу загальної помилки.
- Mermaid показує перегляд власним рендерером Mermaid із застосунку.

Помилки з’являються в панелі перегляду. Для Typst і Mermaid кожна помилка називає свій рядок у коді, а клацання на ній переходить туди.

Якщо компіляція не вдається, **Виправити за допомогою ШІ** надсилає код і його помилки до вашого підключеного постачальника ШІ та просить виправлений код тією самою мовою.

## Вставте, збережіть і завантажте

Скомпілюйте спершу, потім відкрийте меню **Зберегти** поруч із **Скомпілювати**:

- **Вставити як TikZ**, **Вставити як Typst** або **Вставити як Mermaid** ставить діаграму в позицію курсора у відкритому документі `.tex`, `.typ` або Markdown, мовою цього документа. Якщо редактор налаштований на іншу мову, малюнок спершу перетворюється через полотно, тож код, який полотно не може показати, не переноситься.
- **Зберегти в проєкт** записує `figures/<name>.png` і вихідний код — `figures/<name>.tikz`, `.typ` або `.mmd` — у проєкт, який ви виберете зі списку. Збереження в проєкт іншою мовою перетворює малюнок на мову того проєкту. Oleafly питає перед заміною файлів, які вже існують. Збережену діаграму Typst додайте до документа через `#include`, а діаграму Mermaid — усередину блоку коду `mermaid`.
- **Зберегти в проєкт → Новий проєкт** створює проєкт діаграми мовою редактора.
- **Зберегти рисунок** тримає PNG і його вихідний код у кеші рисунків Oleafly, поза будь-яким проєктом.

Меню **Завантажити** зберігає PNG, SVG для діаграм Typst і Mermaid або вихідний код як **TikZ (.tikz)**, **Typst (.typ)** або **Mermaid (.mmd)**. Завантаження іншою мовою перетворює малюнок через полотно.

![Блок-схема Mermaid, написана для зошита Markdown і переглянута.](https://cdn.oleafly.com/images/gifs/desktop/mermaid-composer.gif?v=2)

## Mermaid у документах Markdown

Вставляння в документ Markdown додає обгороджений блок коду `mermaid`, і перегляд Markdown малює його. PDF потребує зображення, тож редактор також зберігає відрендерений PNG у `figures/mermaid-<hash>.png`, а компіляція Markdown ставить це зображення на місце блоку. Тому діаграма з’являється і в скомпільованому PDF. Якщо ви пізніше відредагуєте блок вручну, PDF показуватиме код, доки ви знову не вставите або не збережете діаграму з редактора.

## Повторно відкрийте та імпортуйте діаграми

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

**Імпортувати файл діаграми** в заголовку відкриває файл `.tikz`, `.tex`, `.typ`, `.mmd` або `.md` і замінює поточну чернетку. Файл іншою мовою перемикає редактор на ту мову. Код, який полотно вміє читати, малюється; решта відкривається лише як код.

## Проєкти діаграм

Проєкт діаграм тримає один рисунок. Створіть його в будь-якій із трьох мов через **Зберегти в проєкт → Новий проєкт**. Проєкт діаграми Typst має окремий `main.typ`, чия сторінка підігнана під малюнок, тож його компіляція дає PDF діаграми.

Відкрийте головний файл проєкту й перемкніть панель інструментів редактора з **Код** на **Полотно** (TikZ) або **Візуально** (Typst і Markdown), щоб редагувати його на тому самому полотні.

Шаблон **Діаграма / рисунок** (TikZ) і шаблон **Рисунок Typst** також створюють проєкт з одним рисунком, записаним як вихідний код. Такі проєкти показуються в перегляді як сам рисунок, і їхнє [меню експорту](/docs/export/) пропонує **Експортувати як PDF (векторне зображення)** та **Експортувати як PNG**. Використовуйте їх для рисунків, які повторно використовуєте в різних статтях.
