Utiliser des fragments de code pour insérer rapidement les morceaux de texte fréquemment utilisés.
Vincent Untz
vuntz@gnome.org 2006.
Jonathan Ernst
jonathan@ernstfamily.ch 2006.
Philippe Lefevre
ph.l@libertysurf.fr 2006.
Christophe Bliard
christophe.bliard@trux.info 2006.
Claude Paroz
claude@2xlibre.net 2007-2011.
Bruno Brouard
annoa.b@gmail.com 2011.
Luc Pionchon
pionchon.luc@gmail.com 2011.
Alain Lojewski
allomervan@gmail.com 2011-2014.
Alexandre Franke
alexandre.franke@gmail.com 2013.
Julien Hardelin
jhardlin@orange.fr 2013.
Guillaume Bernard
associations@guillaume-bernard.fr 2018
Charles Monzat
charles.monzat@free.fr 2020

# Fragments de code

Fragments de code permet une insertion aisée de morceaux de texte fréquemment utilisés dans vos fichiers. Par exemple, un fragment de code HTML pour l’étiquette `<img>` insère les parties ouvrante et fermante de l’étiquette mais aussi les emplacements fixés où vous pouvez saisir les attributs de l’image. Cela peut accélérer et vous faciliter l’écriture du code.

# Activation du greffon Fragments de code

Pour activer le greffon Fragments de code :

Choisissez geditPréférencesGreffons.

Sélectionnez Fragments de code pour activer le greffon.

# Parcourir les fragments de code

Pour parcourir les fragments de code disponibles :

Choisissez OutilsGestion des fragments de code.

Assurez-vous que la syntaxe est correctement configurée. La barre d’état en bas de la fenêtre gedit affiche le paramétrage actuel de langage. Ce paramétrage est ce qui permet à gedit d’insérer les fragments de code corrects. Gedit devrait normalement détecter le langage ou la syntaxe du fichier que vous êtes en train d’utiliser, mais parfois il est nécessaire de le définir.

Dans cet exemple, le langage est défini à HTML.

Parcourez les fragments de code disponibles pour votre langage ou votre syntaxe.

# Utilisation des fragments de code

Pour insérer un fragment de code dans le document actuel :

Saisissez le nom du fragment de code voulu n’importe où dans le document actuel.

Appuyez sur la touche Tab pour insérer le fragment de code associé au nom que vous avez saisi.

# Exemple d’utilisation de fragment de code

Par exemple, si vous paramétrez la syntaxe à HTML, saisissez `head` et appuyez sur la touche Tab. Le texte devrait s’être autocomplété en un fragment de code tel que :

<head> <meta http-equiv="Content-type" content="text/html; charset=utf-8" /> <title>Page Title</title> </head>

# Ajout de fragments de code

Vous pouvez ajouter d’autres fragments de code fonctionnant soit globalement (c’est-à-dire indépendamment du langage), soit dans une syntaxe particulière.

Choisissez OutilsGestion des fragments de code.

Dans le panneau latéral de Gestion des fragments de code, choisissez la syntaxe voulue et cliquez sur le bouton « + » pour dérouler la liste des fragments de code existants concernant la syntaxe choisie.

Pour ajouter un fragment de code fonctionnant globalement (c’est à dire sans qu’aucune syntaxe ou aucun langage n’ait été défini pour le document), choisissez Global dans le panneau latéral de Gestion des fragments de code.

Pour ajouter un nouveau fragment de code, cliquez sur l’icône « plus » dans le panneau latéral de Gestion des fragments de code.

Saisissez un nom pour le nouveau fragment de code. Ce nom peut être différent du contenu du fragment de code.

Dans la rubrique Activation, vous devez saisir un terme dans la zone de texte Mot déclencheur. Vous utiliserez ce terme pour insérer votre fragment de code.

Si vous souhaitez insérer un fragment de code avec un raccourci clavier, cliquez sur la zone de texte Touche de raccourci et appuyez sur la combinaison de touche voulue. Après pression puis relâchement des touches, le raccourci clavier est défini.

Dans la zone de texte Édition, saisissez le texte du fragment de code. Vous pouvez utiliser `${n}` pour indiquer les variables, où n est à remplacer par un nombre représentant l’ordre numérique des variables incluses.

# Exemple d’un nouveau fragment de code

Supposons que vous ayez créé un fragment de code avec le terme greetings dans Mot déclencheur. La zone de texte Édition contient :

<greetings>Hello ${1:wonderful}${2:amazing} world! </greetings>

Vous pouvez insérer ce fragment de code en saisissant greetings dans le document et en appuyant sur la touche Tab. Le texte du fragment de code suivant est alors inséré :

<greetings>Hello wonderfulamazing world!</greetings>

Les mots « wonderful » et « amazing » peuvent être retenus ou supprimés selon votre choix d’utilisation. Pour ce faire, appuyez sur la touche Tab pour choisir entre « wonderful » et « amazing » et appuyez sur Suppr pour supprimer l’option à rejeter.