Перейти до вмісту
Oleaflyv0.4.12

Інструменти редагування

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

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

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

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

Розділ «Відкрийте редактор»

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

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

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

Діаграма TikZ, написана кодом, а потім відредагована фігурами на полотні.
Діаграма TikZ, написана кодом, а потім відредагована фігурами на полотні. Відкрити повний знімок екрана

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

Розділ «Малюйте на полотні»

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

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

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

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

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

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

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

  • 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 і переглянута.
Блок-схема Mermaid, написана для зошита Markdown і переглянута. Відкрити повний знімок екрана

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

Розділ «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 також створюють проєкт з одним рисунком, записаним як вихідний код. Такі проєкти показуються в перегляді як сам рисунок, і їхнє меню експорту пропонує Експортувати як PDF (векторне зображення) та Експортувати як PNG. Використовуйте їх для рисунків, які повторно використовуєте в різних статтях.

Перегляд зображення

Не вдалося завантажити відповіді ШІ

Спробуйте ще раз або скористайтеся пошуком у документації.