Przejdź do treści
Przewodnik po Varlig
Strona główna Varlig

Zapisane przekształcenia tekstu

Przekształcenie to mały zestaw zapisanych reguł znajdowania i zastępowania, uruchamiany świadomie: porządkuje wklejony tekst, sortuje listę, usuwa końcowe spacje lub otacza blok znacznikami kodu. Wybierasz je z menu Format, oglądasz planowane zmiany i dopiero wtedy decydujesz.

Ustawienia wyjaśniają to dokładnie: „Zapisane reguły znajdowania i zastępowania oraz kilka wbudowanych operacji tekstowych. To nie są skrypty: Varlig nie uruchamia dla nich poleceń powłoki, wtyczek ani żądań sieciowych i nigdy nie stosuje ich samodzielnie — ani przy imporcie, ani wklejaniu, ani otwieraniu notatki. Wybierasz przekształcenie z Format ▸ Transformations i oglądasz zmiany przed ich zastosowaniem”.

Gdzie znaleźć przekształcenia

Settings › Editor › Text Transformations zawiera listę, początkowo pustą. Dopóki nic nie dodasz, Format › Transformations pokazuje No Transformations i nic nie jest uruchamiane.

Add Transformation tworzy przekształcenie o nazwie Transformation z jedną regułą Find and Replace. Każde przekształcenie ma:

Pole Działanie Wartość początkowa
Name Nazwa widoczna w menu Format. Transformation
Applies to Selection lub Whole Note. Selection
Show in Format menu Określa, czy przekształcenie jest widoczne w Format › Transformations. Włączone
Reguły Add Rule dodaje regułę, a Remove Last Rule usuwa ostatnią. Jedna reguła Find and Replace

Każdy wiersz listy ma też przycisk duplikowania i usuwania.

Nieukończone przekształcenie — bez nazwy, bez reguł lub z nieprawidłowym wzorcem — jest oznaczone w ustawieniach z podanym powodem i pomijane w Format › Transformations, dopóki go nie poprawisz.

Zapisane przekształcenia tekstu synchronizują się między Makiem, iPhonem i iPadem przez iCloud. Na Macu włącz Sync notes with iCloud. Każde urządzenie zachowuje lokalną kopię w preferencjach, więc przekształcenia działają również offline; nie są częścią eksportów notatek ani kopii zapasowych biblioteki.

Reguły przekształcania

Reguły działają kolejno, każda na wyniku poprzedniej. Nie ma warunków ani rozgałęzień.

Reguła Działanie
Find and Replace Dosłowny tekst z opcjami Match Case i Whole Words (obie domyślnie wyłączone).
Regular Expression Wzorzec ICU; w tekście zastępującym $1 i ${name} odwołują się do grup przechwytujących.
UPPERCASE Zamienia tekst na wielkie litery.
lowercase Zamienia tekst na małe litery.
Title Case Rozpoczyna każde słowo wielką literą.
Sort Lines Sortuje wiersze.
Unique Lines Zachowuje pierwsze wystąpienie każdego powtarzającego się wiersza.
Trim Trailing Spaces Usuwa spacje na końcu każdego wiersza.
Join Lines Łączy wiersze separatorem podanym w Separator.
Split Lines Dzieli tekst w miejscach wskazanych przez Split at, umieszczając każdy fragment w osobnym wierszu.
Wrap in Code Fence Umieszcza tekst w bloku kodu z delimitatorami i językiem podanym w Language.

Reguła jest zestawem wartości, nigdy kodem. Wyrażenia regularne są kompilowane i sprawdzane przez ten sam silnik co Edit › Find and Replace (Advanced)…. Nieprawidłowy wzorzec zostaje oznaczony w ustawieniach jeszcze przed użyciem.

Stosowanie przekształcenia

Na Macu uruchom przekształcenie przez Format › Transformations › name. Na iPhonie i iPadzie użyj menu Transformations w edytorze. Przekształcenia nie mają skrótów klawiszowych i nigdy nie uruchamiają się automatycznie przy otwieraniu notatki, imporcie, wklejaniu ani pozostawieniu aplikacji w tle.

Przy Applies to ustawionym na Selection najpierw zaznacz tekst. Whole Note obejmuje całą notatkę.

Varlig wykonuje reguły na kopii i pokazuje podgląd z Removes 4 lines i Inserts 4 lines. Listy obejmują tylko różniące się fragmenty i najwyżej 40 wierszy po każdej stronie, z informacją, jeśli było ich więcej. Stopka mówi: „Zastosowanie to jeden krok cofnięcia. Nic się nie zmienia, dopóki nie naciśniesz Apply”. Cancel pozostawia notatkę bez zmian, a Apply wprowadza zmianę jako jedną operację, którą Edit › Undo (⌘Z) odwraca w jednym kroku.

Jeśli notatka zmieniła się od utworzenia podglądu, Apply odmawia zastosowania i prosi o ponowne uruchomienie zamiast nadpisywać nowszy tekst.

Gdy przekształcenie nie działa

Każdy błąd pozostawia notatkę dokładnie bez zmian — przekształcenie nigdy nie jest zastosowane częściowo. Komunikat wyjaśnia przyczynę:

  • „Transformations don't run on protected, read-only or trashed notes.” To samo dotyczy biblioteki tylko do odczytu.
  • „More than 10,000 matches in one rule. Narrow the transformation.”
  • „The transformation took too long. Simplify its rules or use a smaller scope.”
  • „This transformation changes nothing here.”
  • Reguła z nieprawidłowym wzorcem, brakującą grupą przechwytującą lub pustym szukanym tekstem, przekształcenie bez nazwy lub reguł albo Selection uruchomione bez zaznaczenia — komunikat wskazuje konkretną przyczynę.

Limity

Element Limit
Zapisane przekształcenia 50
Reguły w jednym przekształceniu 20
Dopasowania w jednej regule 10,000
Czas całego przekształcenia 1,5 sekundy

Nie ma próbnego uruchomienia na wielu notatkach. Aby zmieniać wiele naraz, użyj Edit › Replace in Notes…, które pokazuje zmiany osobno dla każdej notatki.

Przekształcenie zawsze tworzy zwykły Markdown. Nic w jego zapisie nie jest specyficzne dla Varlig, a inny edytor widzi dokładnie zapisaną treść.