Перейти до вмісту
Посібник Varlig
Головна сторінка Varlig

Збережені перетворення тексту

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

Налаштування пояснюють: «Збережені правила пошуку й заміни та кілька вбудованих текстових операцій. Це не скрипти: Varlig не запускає для них команди оболонки, плагіни чи мережеві запити й не застосовує самостійно при імпорті, вставленні або відкритті. Ви вибираєте Format ▸ Transformations і бачите зміни до застосування».

Де вони зберігаються

Список у Settings › Editor › Text Transformations спочатку порожній. Доки ви нічого не додасте, Format › Transformations показує No Transformations, і жодні перетворення не виконуються.

Add Transformation створює Transformation з одним правилом Find and Replace. Кожне перетворення має:

Поле Призначення Початкове значення
Name Назва в меню Format. Transformation
Applies to Selection або Whole Note. Selection
Show in Format menu Чи показується в Format › Transformations. Увімкнено
Правила Add Rule додає правило; Remove Last Rule прибирає останнє. Одне Find and Replace

Кожен рядок списку також має кнопки дублювання й видалення.

Незавершене перетворення — без назви, правил або з некоректним шаблоном — позначається в налаштуваннях із причиною й не з’являється у Format › Transformations до виправлення.

Збережені перетворення тексту синхронізуються між Mac, iPhone та iPad через iCloud. На Mac увімкніть Sync notes with iCloud. Кожен пристрій зберігає локальну копію в налаштуваннях, тож перетворення працюють і без мережі; вони не входять до експорту нотаток чи резервних копій бібліотеки.

Перелік правил

Правила виконуються послідовно, кожне — над результатом попереднього. Умов і розгалужень немає.

Правило Призначення
Find and Replace Буквальний текст із параметрами Match Case і Whole Words (обидва спочатку вимкнені).
Regular Expression Шаблон ICU з $1 і ${name} у заміні для захоплених груп.
UPPERCASE Перетворює текст на великі літери.
lowercase Перетворює текст на малі літери.
Title Case Починає кожне слово з великої літери.
Sort Lines Сортує рядки.
Unique Lines Залишає перший примірник кожного повторюваного рядка.
Trim Trailing Spaces Прибирає пробіли в кінці кожного рядка.
Join Lines Об'єднує рядки з указаним Separator.
Split Lines Розділяє за текстом із Split at, по одному фрагменту на рядок.
Wrap in Code Fence Поміщає текст у блок коду з роздільниками й указаною Language.

Правило — список значень, не код. Регулярні вирази компілює й перевіряє той самий движок, що й Edit › Find and Replace (Advanced)…. Некоректний шаблон позначається в налаштуваннях до застосування.

Застосування перетворення

На Mac запустіть перетворення через Format › Transformations › name. На iPhone та iPad використовуйте меню Transformations у редакторі. Перетворення не мають сполучень клавіш і ніколи не запускаються автоматично під час відкриття нотатки, імпорту, вставлення чи переходу програми у фоновий режим.

Якщо Applies to має Selection, спочатку виділіть текст. Whole Note охоплює всю нотатку.

Varlig застосовує правила до копії й показує перегляд із Removes 4 lines, Inserts 4 lines. Списки містять лише змінену частину, до 40 рядків з кожного боку, із повідомленням про решту. Унизу пояснено, що застосування — одна дія Undo і до Apply нічого не змінюється. Cancel залишає нотатку як є; Apply виконує зміну, яку Edit › Undo (⌘Z) скасовує за один крок.

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

Коли перетворення не виконується

Якщо виникає помилка, нотатка залишається без змін: перетворення ніколи не застосовується частково. Натомість повідомлення пояснює причину:

  • «Перетворення не виконуються для захищених нотаток, нотаток лише для читання або нотаток у кошику». Це стосується й бібліотеки лише для читання.
  • «Понад 10 000 збігів в одному правилі. Звузьте область перетворення».
  • «Перетворення тривало надто довго. Спростіть правила або зменште область застосування».
  • «Це перетворення тут нічого не змінює».
  • Повідомлення також пояснює, якщо в правилі хибний шаблон, відсутня група захоплення або текст для пошуку; якщо перетворення не має назви чи правил; або якщо перетворення Selection запущено без виділеного тексту.

Обмеження

Що обмежується Межа
Збережені перетворення 50
Правила в одному перетворенні 20
Збіги в одному правилі 10,000
Час усього перетворення 1,5 секунди

Попередньої перевірки для кількох нотаток немає. Щоб змінити багато нотаток одразу, скористайтеся Edit › Replace in Notes…: ця команда показує зміни окремо для кожної нотатки.

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