Snippets

Comment fonctionnent les snippets

Un snippet (raccourci de texte) est un raccourci et le texte qu’il représente. Tapez le raccourci dans une note : il devient le texte complet à l’instant où vous tapez son dernier caractère, sans touche à presser ni menu. Si ce n’était pas ce que vous vouliez, appuyez tout de suite sur ⌘Z pour retrouver exactement ce que vous avez tapé. Expand snippets as you type est activé d’emblée ; vous pouvez le désactiver dans Settings ▸ Snippets.

Créer un snippet

1. Ouvrez Snippets dans la barre latérale (⌃8) et cliquez sur + dans l’en-tête.
2. Tapez le raccourci. Les nouveaux raccourcis commencent par deux-points, comme :addr, ce qui les empêche de se déclencher au milieu de mots ordinaires.
3. Ajoutez une description si vous le souhaitez, choisissez une catégorie, et écrivez le texte. C’est du Markdown, et il peut tenir sur plusieurs lignes.
4. Placez $|$ là où le curseur doit arriver après l’expansion, puis cliquez sur Save.

MindLake vous prévient si le raccourci existe déjà, ou s’il est le début d’un autre raccourci : le plus court se déclencherait toujours en premier, et le plus long serait inaccessible.

Depuis n’importe quelle app, la barre de commande en crée un aussi : /newsnippet ;sig Kind regards et ↩ l’enregistre sur-le-champ, tandis que ⌘↩ l’ouvre plutôt dans Snippets.

Tri et catégories

La page Snippets fonctionne comme All Notes, avec la liste à gauche et un aperçu à droite. Le bouton de tri classe la liste par Shortcut, Type, Category, Newest First ou Oldest First ; trier par type ou par catégorie place un titre au-dessus de chaque groupe. Chaque snippet indique sa date de création ; un snippet créé avant que MindLake ne garde ces dates affiche « before » suivi d’une date.

Les catégories sont les vôtres. Tapez-en une directement dans un snippet : vos catégories existantes sont suggérées pendant la frappe, et ⇥ en complète une. Vous pouvez aussi la définir depuis le menu contextuel d’un snippet, qui propose aussi Edit, Duplicate et Delete, ou depuis l’en-tête de l’aperçu. Le bouton des catégories, dans l’en-tête, affiche une catégorie à la fois et renomme les catégories. Il peut aussi proposer de classer par type chaque snippet sans catégorie, en vous montrant les nombres avant que rien ne bouge.

Types et couleurs

L’icône de chaque snippet montre son type, que MindLake déduit du texte : une commande, du code, un lien, une adresse e-mail, un numéro de téléphone, une adresse postale, un nombre, une liste ou du texte simple. Les types sont déduits, jamais stockés. Settings ▸ Theme ▸ Colour snippet types individually donne à chaque type sa propre couleur.

Coller depuis la barre de commande

Les snippets apparaissent quand vous cherchez dans ⌘K ou la barre de commande, et /snippet les liste tous. ↩ colle le texte dans l’app où vous étiez en train de taper, ce qui fonctionne même là où les snippets ne se développent pas. Il faut pour cela l’accès Accessibility ; sans lui, le texte est copié et vous le collez avec ⌘V.

Développer dans les autres apps

Les snippets peuvent se développer dans toutes les apps, pas seulement dans MindLake. Activez Expand in every app, not just MindLake dans Settings ▸ Snippets, et autorisez l’accès Accessibility quand macOS le demande : MindLake en a besoin pour voir ce que vous tapez. C’est désactivé tant que vous ne l’activez pas.

• MindLake colle le texte et rétablit votre presse-papiers un instant plus tard.
• Rien n’est observé ni développé dans les champs de mot de passe.
• MindLake doit être ouvert. Hors de MindLake, $|$ est ignoré et le curseur arrive après le texte.

Importer et synchroniser

Vos snippets vivent dans snippets.json, à la racine de votre coffre : ils voyagent donc avec vos notes. Pour importer une bibliothèque existante, cliquez sur le bouton d’import dans l’en-tête de Snippets. La fenêtre liste les bibliothèques de snippets trouvées sur ce Mac (espanso, Alfred, TextExpander et les remplacements de texte de macOS), chacune avec son nombre de snippets et combien sont nouveaux, et en importe une d’un clic.

• Raycast et Typinator gardent leurs snippets pour eux : exportez-les depuis l’app (Raycast : Export Snippets ; Typinator : exportez un ensemble en CSV) et déposez le fichier sur la fenêtre.
• Vous pouvez aussi déposer ou choisir un export d’aText ou de l’une des apps ci-dessus, ou un fichier CSV ou TSV de raccourcis et de textes. Le dépôt fonctionne aussi sur la page Snippets elle-même, pas seulement sur la fenêtre d’import. Settings ▸ Snippets ▸ Import from another app ▸ Choose file… fait la même chose.
• Un texte déposé qui n’est pas une bibliothèque devient un nouveau snippet.
• MindLake détecte le format lui-même, n’écrase jamais un raccourci que vous avez déjà, et transforme les groupes TextExpander en catégories.
• Si vous utilisiez espanso sur ce Mac, un coffre sans snippets importe les siens de lui-même.