Transformations de texte enregistrées

Une transformation réunit des règles de recherche et remplacement que vous enregistrez puis appliquez à la demande : nettoyer du texte collé, trier une liste, supprimer les espaces de fin de ligne ou entourer un passage de délimiteurs de bloc de code. Vous la choisissez dans le menu Format, examinez les modifications proposées, puis décidez de les appliquer.

Les réglages les décrivent ainsi : « Des règles de recherche et remplacement enregistrées et quelques opérations intégrées sur le texte. Ce ne sont pas des scripts : Varlig n’exécute pour elles aucune commande shell, aucun plugin ni aucune requête réseau. Il n’applique jamais de transformation automatiquement, ni à l’importation, ni au collage, ni à l’ouverture d’une note. Vous en choisissez une dans Format ▸ Transformations et voyez ses modifications avant toute application. »

Emplacement des transformations

Settings › Editor › Text Transformations contient la liste, vide au départ. Tant que vous n’ajoutez pas de transformation, Format › Transformations affiche No Transformations et aucune transformation ne s’exécute.

Add Transformation crée une transformation nommée Transformation, avec une seule règle Find and Replace. Chaque transformation possède :

Chaque ligne de la liste possède aussi un bouton pour dupliquer la transformation et un autre pour la supprimer.

Une transformation incomplète — sans nom, sans règles ou avec une expression régulière qui ne compile pas — est signalée dans les réglages avec la raison. Elle reste absente de Format › Transformations jusqu’à sa correction.

Les transformations de texte enregistrées suivent iCloud entre votre Mac, iPhone et iPad. Sur Mac, activez Sync notes with iCloud. Chaque appareil conserve une copie locale dans ses préférences ; les transformations restent donc disponibles hors connexion. Elles ne sont pas incluses dans les exports de notes ni les sauvegardes de bibliothèque.

Les règles

Les règles s’exécutent dans l’ordre, chacune sur le résultat de la précédente. Il n’y a ni conditions ni embranchements.

Une règle est une liste de valeurs, jamais du code. Les expressions régulières sont compilées et vérifiées par le même moteur que Edit › Find and Replace (Advanced)…. Une expression qui ne compile pas est signalée dans les réglages avant toute application.

Appliquer une transformation

Sur Mac, lancez une transformation via Format › Transformations › name. Sur iPhone et iPad, utilisez le menu Transformations de l’éditeur. Les transformations n’ont pas de raccourci clavier et ne s’exécutent jamais automatiquement à l’ouverture d’une note, lors d’un import ou d’un collage, ni lorsque l’app passe en arrière-plan.

Si Applies to est réglé sur Selection, sélectionnez d’abord le texte. Avec Whole Note, la transformation porte sur toute la note.

Varlig applique les règles à une copie et affiche un aperçu, par exemple Removes 4 lines et Inserts 4 lines. Les listes se limitent aux passages réellement différents et à 40 lignes de chaque côté ; un message indique si d’autres lignes existent. Le bas de la fenêtre rappelle que l’application s’annule en une étape et que rien ne change avant d’appuyer sur Apply. Cancel conserve la note intacte. Apply effectue une seule modification, annulable en une fois avec Edit › Undo (⌘Z).

Si la note a changé depuis que l'aperçu a été fait, Apply refuse et demande une nouvelle exécution plutôt que d'écrire sur le nouveau texte.

Lorsqu’une transformation ne s’exécute pas

En cas d’échec, la note reste exactement intacte : aucune transformation n’est appliquée à moitié. Un message explique le problème sans rien modifier :

• « Les transformations ne s’appliquent pas aux notes protégées, en lecture seule ou dans la corbeille. » Il en va de même pour une bibliothèque en lecture seule.
• « Plus de 10 000 correspondances dans une seule règle. Restreignez la transformation. »
• « La transformation a pris trop de temps. Simplifiez ses règles ou réduisez son périmètre. »
• « Cette transformation ne modifie rien ici. »
• Le message précise aussi les cas suivants : expression invalide, groupe de capture manquant, texte à rechercher absent, transformation sans nom ou sans règles, ou transformation Selection lancée sans texte sélectionné.

Limites

Il n’existe pas de simulation sur plusieurs notes. Pour modifier plusieurs notes à la fois, utilisez Edit › Replace in Notes…, qui présente séparément les modifications de chaque note.

Une transformation ne produit que du Markdown ordinaire, sans syntaxe propre à Varlig. Un autre éditeur voit exactement ce que Varlig a enregistré.