Spring naar inhoud
Varlig-handleiding
Varlig-startpagina

Opgeslagen tekstbewerkingen

Een transformatie is een kleine reeks zoek-en-vervangregels die je eenmaal bewaart en bewust toepast: geplakte tekst opschonen, een lijst sorteren, spaties aan regeleinden verwijderen of tekst tussen codeblokmarkeringen zetten. Je kiest haar in het menu Format, bekijkt de voorgestelde wijzigingen en beslist dan.

Settings beschrijft precies wat het zijn: “Opgeslagen zoek-en-vervangregels en enkele ingebouwde tekstbewerkingen. Het zijn geen scripts: Varlig voert hiervoor nooit shellopdrachten, plug-ins of netwerkverzoeken uit en past ze nooit zelfstandig toe — ook niet bij importeren, plakken of openen van een notitie. Je kiest er een via Format ▸ Transformations en ziet de wijzigingen voordat er iets wordt toegepast.”

Waar ze worden opgeslagen

Settings › Editor › Text Transformations bevat de lijst, die aanvankelijk leeg is. Totdat je er een toevoegt, toont Format › Transformations de tekst No Transformations en wordt nergens iets uitgevoerd.

Add Transformation maakt er een met de naam Transformation en één regel Find and Replace. Elke transformatie heeft:

Veld Wat deze doet Beginwaarde
Name De naam in het menu Format. Transformation
Applies to Selection of Whole Note. Selection
Show in Format menu Of de transformatie in Format › Transformations verschijnt. Aan
Regels Add Rule voegt een regel toe; Remove Last Rule verwijdert de laatste. Eén Find and Replace

Elke rij in de lijst heeft ook knoppen om haar te dupliceren en te verwijderen.

Een onvolledige transformatie — zonder naam, zonder regels of met een ongeldig patroon — krijgt in Settings een melding met de reden. Ze verschijnt pas in Format › Transformations nadat je het probleem hebt opgelost.

Bewaarde teksttransformaties volgen iCloud tussen je Mac, iPhone en iPad. Zet op de Mac Sync notes with iCloud aan. Elk apparaat bewaart een lokale kopie in zijn voorkeuren, zodat transformaties ook offline werken. Ze zijn niet opgenomen in notitie-exports of bibliotheekreservekopieën.

De regels

Regels worden in volgorde uitgevoerd, steeds op het resultaat van de vorige. Er zijn geen voorwaarden of vertakkingen.

Regel Wat deze doet
Find and Replace Letterlijke tekst, met Match Case en Whole Words (beide aanvankelijk uitgeschakeld).
Regular Expression Een ICU-patroon, met $1 en ${name} in de vervanging voor vastgelegde groepen.
UPPERCASE Zet de tekst om in hoofdletters.
lowercase Zet de tekst om in kleine letters.
Title Case Geeft elk woord een hoofdletter.
Sort Lines Sorteert de regels.
Unique Lines Behoudt van elke herhaalde regel alleen de eerste.
Trim Trailing Spaces Verwijdert de spaties aan het einde van elke regel.
Join Lines Voegt de regels samen met de opgegeven Separator.
Split Lines Splitst bij de tekst in Split at, met elk deel op een eigen regel.
Wrap in Code Fence Zet de tekst in een afgebakend codeblok met de opgegeven Language.

Een regel is een lijst waarden, nooit code. Reguliere expressies worden gecompileerd en gecontroleerd door dezelfde engine als Edit › Find and Replace (Advanced)…. Een patroon dat niet compileert, wordt al in Settings gemeld voordat je het toepast.

Een transformatie toepassen

Op de Mac voer je een transformatie uit via Format › Transformations › name. Op iPhone en iPad gebruik je het menu Transformations in de editor. Transformaties hebben geen sneltoets en worden nooit automatisch uitgevoerd wanneer je een notitie opent, importeert, plakt of de app op de achtergrond laat draaien.

Staat Applies to op Selection, selecteer dan eerst de tekst. Met Whole Note geldt de transformatie voor de hele notitie.

Varlig voert de regels op een kopie uit en toont een voorbeeldvenster met Removes 4 lines en Inserts 4 lines. De lijsten beperken zich tot wat echt verschilt, met maximaal 40 regels per kant en een melding als het er meer waren. Onderaan staat dat toepassen één ongedaan te maken stap is en niets verandert totdat je op Apply drukt. Cancel laat de notitie intact; Apply past alles als één wijziging toe, die Edit › Undo (⌘Z) in één stap terugdraait.

Is de notitie sinds het maken van het voorbeeld gewijzigd, dan weigert Apply en vraagt om een nieuwe uitvoering in plaats van nieuwere tekst te overschrijven.

Als een transformatie niet wordt uitgevoerd

Bij elke fout blijft de notitie exact zoals ze was; een transformatie wordt nooit half toegepast. Elke melding vertelt wat er gebeurde, zonder iets te wijzigen:

  • “Transformaties werken niet op beveiligde, alleen-lezen of verwijderde notities.” Hetzelfde geldt voor een alleen-lezen bibliotheek.
  • “Meer dan 10.000 overeenkomsten in één regel. Beperk de transformatie.”
  • “De transformatie duurde te lang. Vereenvoudig de regels of verklein het bereik.”
  • “Deze transformatie verandert hier niets.”
  • Een regel met een ongeldig patroon, een ontbrekende vastleggroep of geen zoektekst; een transformatie zonder naam of regels; of een Selection-transformatie zonder selectie: de melding benoemt elk van deze gevallen.

Limieten

Onderdeel Limiet
Opgeslagen transformaties 50
Regels in één transformatie 20
Overeenkomsten in één regel 10,000
Tijd voor de hele transformatie 1,5 seconde

Er is geen proefuitvoering over meerdere notities. Gebruik Edit › Replace in Notes… om veel notities tegelijk te wijzigen; daarbij krijgt elke notitie een afzonderlijk wijzigingsvoorbeeld.

Een transformatie levert altijd gewone Markdown op. Niets wat ze schrijft is specifiek voor Varlig; een andere editor ziet precies wat Varlig heeft opgeslagen.