Trasformazioni di testo salvate

Una trasformazione è un piccolo insieme di regole di ricerca e sostituzione che salvi e applichi quando vuoi: ripulire il testo incollato, ordinare un elenco, eliminare gli spazi finali o racchiudere del testo nei delimitatori di un blocco di codice. La scegli dal menu Format, controlli le modifiche proposte e decidi se applicarle.

Le impostazioni ne chiariscono il funzionamento: "Regole di ricerca e sostituzione salvate e alcune operazioni sul testo integrate. Non sono script: Varlig non esegue comandi shell, plugin o richieste di rete per applicarle. Non le avvia mai automaticamente, neppure quando importi, incolli o apri una nota. Scegli una trasformazione da Format ▸ Transformations e ne controlli le modifiche prima che vengano applicate."

Dove trovare le trasformazioni

Settings › Editor › Text Transformations contiene l'elenco, inizialmente vuoto. Finché non aggiungi una trasformazione, Format › Transformations mostra No Transformations e non viene eseguito nulla.

Add Transformation crea una trasformazione chiamata Transformation, con una sola regola Find and Replace. Ogni trasformazione ha:

Ogni riga dell'elenco include anche un pulsante per duplicare la trasformazione e uno per eliminarla.

Le trasformazioni incomplete, senza nome, senza regole o con un'espressione che non può essere compilata, sono segnalate nelle impostazioni con il relativo motivo. Restano escluse da Format › Transformations finché non le correggi.

Le trasformazioni di testo salvate seguono iCloud tra Mac, iPhone e iPad. Sul Mac, attiva Sync notes with iCloud. Ogni dispositivo conserva una copia locale nelle preferenze, quindi le trasformazioni funzionano anche offline; non sono incluse nelle esportazioni delle note né nei backup della libreria.

Le regole

Le regole vengono eseguite in ordine, ciascuna sul risultato della precedente. Non sono previste condizioni né diramazioni.

Una regola è un insieme di valori, mai codice. Le espressioni regolari vengono compilate e verificate dallo stesso motore di Edit › Find and Replace (Advanced)…. Se un'espressione non può essere compilata, viene segnalata nelle impostazioni prima che tu possa applicarla.

Applicare una trasformazione

Sul Mac, esegui una trasformazione da Format › Transformations › name. Su iPhone e iPad, usa il menu Transformations dell’editor. Le trasformazioni non hanno scorciatoie da tastiera e non vengono mai eseguite automaticamente quando apri una nota, importi, incolli o lasci l’app in background.

Se Applies to è impostato su Selection, seleziona prima il testo. Con Whole Note, la trasformazione si applica all'intera nota.

Varlig esegue le regole su una copia e mostra un pannello di anteprima con voci come Removes 4 lines e Inserts 4 lines. Gli elenchi mostrano soltanto le parti diverse, fino a 40 righe per ciascun lato, segnalando se ce ne sono altre. In fondo compare: "L'operazione è annullabile in un solo passaggio. Non cambia nulla finché non premi Apply." Cancel lascia la nota invariata; Apply applica tutto come un'unica modifica, annullabile con Edit › Undo (⌘Z).

Se la nota è cambiata dopo la creazione dell'anteprima, Apply rifiuta di procedere e chiede di rieseguire la trasformazione, senza sovrascrivere il testo più recente.

Quando una trasformazione non può essere eseguita

In caso di errore, la nota resta esattamente com'era: una trasformazione non viene mai applicata solo in parte. Il messaggio spiega il problema senza modificare nulla:

• "Le trasformazioni non si applicano alle note protette, di sola lettura o nel Cestino." Lo stesso vale per una libreria di sola lettura.
• "Più di 10.000 corrispondenze in una regola. Restringi la trasformazione."
• "La trasformazione ha richiesto troppo tempo. Semplifica le regole o applicala a una porzione di testo più piccola."
• "Questa trasformazione non cambia nulla qui".
• Il messaggio indica il problema specifico: una regola con un'espressione non valida, un gruppo di cattura mancante o nessun testo da cercare; una trasformazione senza nome o senza regole; oppure una trasformazione Selection avviata senza una selezione.

Limiti

Non è prevista un'anteprima di trasformazione su più note. Per modificare molte note insieme, usa Edit › Replace in Notes…, che mostra separatamente l'anteprima di ciascuna nota.

Una trasformazione produce sempre normale Markdown. Nulla di ciò che scrive è esclusivo di Varlig: un altro editor vede esattamente il contenuto salvato.