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 gedit ▸ Préférences ▸ Greffons.
Sélectionnez Fragments de code pour activer le greffon.

Parcourir les fragments de code

Pour parcourir les fragments de code disponibles :

Choisissez Outils ▸ Gestion des fragments de code.

Assurez-vous que la syntaxe est correctement configurée. La barre de statut 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.
Parcourir les fragments de code disponibles pour votre language 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 le 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 auto-complé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 Outils ▸ Gestion 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 « wonderfull » et « amazing » peuvent être retenus ou supprimés selon votre choix d’utilisation. Pour ce faire, appuyez sur la touche Tab pour choisir entre « wonderfull » et « amazing » et appuyez sur Suppr pour supprimer l’option à rejeter.