Extraits

Les extraits sont de courtes abréviations qui s’étendent en contenu complet : texte brut, texte enrichi (HTML), ou scripts exécutables (Pro). Quelques lettres + touche de déclenchement → bloc complet. Les variables de modèle comme {{date}}, {{clipboard}} (Pro) sont remplacées à l’expansion. Voir FillIn et variables.

La fenêtre principale a trois volets : groupes à gauche, liste d’extraits au milieu, éditeur à droite. Les groupes Organisation verrouillés ne se modifient pas sur le bureau.

Comment étendre les extraits

• Abréviation et déclencheur — Tapez abréviation + déclencheur (Tab par défaut, ou Espace/Entrée, etc.) pour étendre ; marche dans n’importe quel champ texte.
• Touche de déclenchement : Tab, Espace, Entrée, Alt, ., ,, ;, -, /, =, ` configurables ; « exiger un déclencheur pour étendre » recommandé pour limiter les accidents.
• Modes de correspondance :
  • Gauche à droite : l’abréviation doit correspondre exactement à la saisie (ex. sig → sig+Tab)
  • Droite à gauche : l’abréviation n’a besoin de correspondre qu’en suffixe (ex. mysig → sig+Tab s’étend)
  • Limite de mot : en mode droite à gauche, exiger un caractère de limite de mot avant l’abréviation pour éviter les déclenchements en milieu de mot
  • Casse adaptative : tapez SIG pour une version majuscules, Sig pour une casse de titre
• Recherche en ligne : tapez // (préfixe configurable) pour un popup de recherche d’extraits ; flèches pour choisir, Entrée pour insérer
• Raccourcis (Pro) : fenêtre principale/recherche globale, créer depuis le presse-papiers, nouvel extrait, éditer le dernier étendu, étendre à nouveau le dernier ; raccourci global par extrait. Voir Paramètres → Raccourcis.

Groupes et multi-fichiers

• Groupes en arborescence + préfixe : ex. tout sous ai- s’étend en ai-xxx ; gérez beaucoup d’extraits par scénario. Voir Présentation · Extraits.
• Extraits multi-fichiers : un extrait, plusieurs « fichiers » (langue/env), chacun avec sa propre abréviation et son contenu ; maintenez une fois, étendez partout.
  • Ajouter, copier, supprimer et glisser-déposer pour trier les fichiers
  • Chaque fichier a indépendamment : nom de fichier, runtime, abréviation, contenu, périmètre d’expansion, raccourci global
  • Les extraits multi-fichiers affichent un badge de nombre de fichiers dans la liste

Seulement dans certaines apps ᴾᴿᴼ

N’étendre que dans les apps sélectionnées ; taper la même abréviation ailleurs ne déclenche pas. Gardez l’expansion dans VS Code, Cursor ou le navigateur, sans déclencher dans le chat ou les champs web.

Comment régler

1. Ouvrez les réglages de l’extrait ou du groupe.
2. Trouvez ExpandIn (ou « N’étendre que dans ces apps »).
3. Sélectionnez ou cherchez des apps (ex. VS Code, Chrome, Cursor) ; plusieurs autorisées.
4. Enregistrez ; cet extrait ou groupe ne répond à « abréviation + déclencheur » que dans ces apps.

Si aucune app n’est sélectionnée, ça s’applique partout.

Fonctionnement

• Détection d’app : identifie automatiquement l’application au premier plan ; pas de config technique manuelle.
• Limite au niveau groupe : ExpandIn sur un groupe s’applique à tous les extraits en dessous.
• Limite au niveau extrait : les réglages par extrait peuvent surcharger le groupe, pour un contrôle plus fin.
• Recherche globale : ExpandIn n’affecte que l’expansion « abréviation + déclencheur » ; la fenêtre de recherche globale (raccourci) reste disponible partout.

Scénarios typiques

Notes

• Apps non reconnues : si une app n’est pas détectée (certains Electron), ExpandIn peut ne pas marcher ; désactivez la restriction pour ces extraits.
• Perf : ExpandIn vérifie l’app au premier plan avant chaque déclenchement ; le coût est négligeable.
• Combiner avec la limite de mot : activez « vérification de limite de mot » pour éviter les déclenchements en milieu de mot dans les apps autorisées.

Idéal pour : usage intensif d’extraits dans l’IDE et le navigateur, sans déclencher dans le chat (ex. WeChat, Slack).

Éditeur d’extraits

Types d’éditeur

Bascule automatique selon le runtime de l’extrait :

• Éditeur de code : coloration syntaxique, numéros de ligne, undo/redo. Idéal pour enveloppes de code et extraits scripts.
• Éditeur de texte enrichi : gras, italique, titres, listes, tableaux, images, liens. Idéal pour modèles d’e-mail et contenu mis en forme.

Barre d’outils de l’éditeur

Indice lecture seule : quand un extrait est verrouillé (mode lecture seule), survolez la zone éditeur et l’icône cadenas clignote — cliquez dessus ou appuyez sur Cmd/Ctrl+Shift+L pour déverrouiller et éditer.

Scénarios typiques

• Développeurs : écrire des enveloppes de code (try/catch, logs) avec coloration ; exécuter des scripts directement et copier la sortie.
• Rédacteurs techniques : rédiger de la doc en texte enrichi avec images et tableaux ; capturer et annoter dans la même app.
• Équipes multilingues : partager des extraits entre régions — les extraits de code marchent dans n’importe quel IDE, les modèles s’adaptent aux langues locales via FillIn.

Code vers image

• Partage Carbon : rendre le code en belle image (Carbon.now.sh)
• Rendu local : code vers image (rendu local)

FillIn et variables de modèle

• Variables FillIn — Popup au déclenchement : une ligne / multiligne, menu, case, %date%, curseur %c% (tabstop multi-curseurs pris en charge), presse-papiers %cv%, imbriqué %s:abbr% ; idéal pour prompts et modèles paramétrés.
  • Formatage de casse : camel/pascal/snake/kebab/upper/lower
• Variables de modèle d’extrait (Pro) — Dans le contenu : {{date}}, {{time}}, {{clipboard}}, {{cursor}}, {{input}} ; remplacées à l’expansion.

Types d’extraits et exécution ᴾᴿᴼ

Types intégrés

Runtime personnalisé

Configurez des runtimes personnalisés dans Paramètres pour exécuter n’importe quel exécutable. Prend en charge le passage du contenu de l’extrait, du presse-papiers et du texte sélectionné dans le contexte d’exécution, plus des modèles wrapper pour pré/post-traitement.

Méthodes d’exécution

• Aperçu : bouton exécuter ou Cmd/Ctrl+Shift+P dans l’éditeur ; résultats dans le panneau du bas
• Exécuter et copier : clic droit dans la liste d’extraits → « Exécuter et copier » ; résultat copié dans le presse-papiers après exécution

Historique des versions

Historique auto-enregistré par fichier :

• Enregistrement auto : les éditions sont enregistrées dans l’historique au fil du travail
• Sources de version : création initiale, enregistrement auto, enregistrement manuel, et opérations d’application
• Diff de version : comparaison visuelle côte à côte ; différences ligne par ligne ou mises en forme
• Restaurer : revenir à n’importe quelle version précédente en un clic

Scénarios de récupération typiques :

• Suppression accidentelle → récupérer depuis l’historique en quelques secondes
• Comparer les changements → voir exactement ce qui a changé entre les éditions
• Éditions expérimentales → tester de nouvelles idées sans risque, revenir en arrière à tout moment

Groupes et préfixe

Le volet gauche est l’arbre des groupes. Les extraits vivent dans des groupes ; les abréviations vivent sur les fichiers ; les préfixes vivent sur les groupes.

1. Clic droit dans le vide → Nouveau groupe, ou ajoutez un enfant sous un groupe.
2. Réglages de groupe : nom, préfixe (ex. ai-). Préfixe ai- + abbr fichier gen → tapez ai-gen puis le déclencheur.
3. Gratuit : environ 5 groupes ; Pro illimité. Un sous-groupe peut avoir son propre préfixe. Enregistrez après modification.

Un groupe peut aussi définir ExpandIn / quand étendre / touches de déclenchement locales (non synchronisées), et s’il est envoyé. Les groupes Organisation verrouillés ne se modifient pas sur le bureau. Voir Organisations et Expansion.

Créer et modifier

Le support veut une ligne de politique de retour en ret. Choisissez un de vos groupes, créez un extrait, tapez le corps, enregistrez. La prochaine fois, tapez ret et Tab dans l’e-mail.

1. Sélectionnez un groupe Just Me (un groupe d’org verrouillé ne se modifie pas ici).
2. Cmd/Ctrl+N, ou cliquez sur Nouveau. Le Gratuit s’arrête vers 50 extraits.
3. Nommez-le ; définissez l’abréviation et le corps sur un fichier. Choisissez texte brut, texte enrichi, ou un script (Pro).
4. Enregistrez. Une nouvelle abréviation ou un préfixe de groupe marche dès la prochaine saisie.

Aussi : créer depuis le presse-papiers, déposer un fichier, accepter un extrait suggéré, ou ouvrir un pack de partage. Un extrait peut contenir une signature chinoise et une anglaise, chacune avec sa propre abréviation.

Extraits suggérés

Vous avez tapé la même formule de politesse trois fois aujourd’hui. La fenêtre principale peut demander : enregistrer ça comme abréviation ? Prévisualisez, puis confirmez. Si vous ignorez, la bibliothèque ne change pas. Confirmer l’ajoute au groupe courant. Le plafond Gratuit ~50 s’applique toujours. Les compteurs restent sur cet ordinateur.

Pack de partage

Regroupez groupes/extraits pour un collègue. Ils confirment dans l’app ; les éléments atterrissent dans leur bibliothèque locale, pas une sync d’org en direct.

1. Ouvrez codeexpander://import?d=... (les charges trop longues sont rejetées).
2. L’app affiche une boîte de confirmation après décodage. Ce n’est qu’alors qu’elle écrit. Les plafonds Gratuit s’appliquent toujours.
3. Les packs qui pointent vers des extraits d’org partagés sont reconnus ; copier dans ma bibliothèque crée une copie personnelle éditable.

L’export est dans les menus extrait/groupe et Données → Transfert. Un pack de partage n’est pas un accès d’organisation CE Cloud. Voir Liens profonds.

Partage et sync

• CE Cloud personnel / Organisations / Gist et WebDAV.
• Import/Export : Paramètres → Données ; export JSON et TextExpander.

Plus : Scripts · FillIn · Expansion