# Menu utilisateur

## Configuration

&kile; prend en charge un menu configurable par l'utilisateur, qui apparaîtra comme une partie du menu de &kile;. Ce menu peut être configuré à partir de la boîte de dialogue de configuration de &kile; avec Configuration Configurer Kile Menu utilisateur.

Configuration du menu utilisateur
Configuration du menu utilisateur

Vous avez deux options pour placer ce menu :

- soit le menu Menu utilisateur apparaîtra dans la barre de menu principale entre les menus LaTeX , Assistant et l'assistant de configuration Modifier le menu utilisateur dans le menu Assistant

  Le menu utilisateur est placé dans le menu principal
  Le menu utilisateur est placé dans le menu principal

- ou les deux éléments apparaîtront en bas du menu LaTeX.

  Menu utilisateur comme une partie du menu LaTeX
  Menu utilisateur comme une partie du menu LaTeX

Les balises définies par l'utilisateur déjà existantes dans les anciennes versions de &kile; sont automatiquement transformées dans le nouveau menu configurable par l'utilisateur. Les balises sont enregistrées dans un fichier appelé `usertags.xml` et comme tous les fichiers de définition de menu, elles peuvent être trouvées dans le dossier local du menu utilisateur de &kile; : `KILE_APP_DIR/usermenu/`, &pex; `/home/user/.kde/share/apps/kile/usermenu/`.

Vous pouvez utiliser différents fichiers de définition de menu pour différentes tâches. Utilisez l'assistant du menu utilisateur Assistant Modifier le menu utilisateur ou LaTeX Modifier le menu utilisateur pour installer ou modifier un fichier de définition de menu.

## Assistant

Vous pouvez créer de nouveaux menus ou en modifier en utilisant un assistant de configuration de menu utilisateur confortable depuis Assistant Modifier le menu utilisateur.

Assistant du menu utilisateur
Assistant du menu utilisateur

Sur la gauche, vous verrez une arborescence de menu. Tout comme dans un menu standard, trois types différents d'éléments de menu sont disponibles :

- des entrées de menu standard, qui sont assignées à une action,

- des sous-menus, qui contiennent d'autres éléments de menu,

- des séparateurs, pour obtenir une structure lisible de toutes les entrées.

Pour modifier ce menu, utilisez les six boutons sur le côté gauche. Des actions supplémentaires sont disponibles dans le menu contextuel des éléments de menu déjà existant.

Arborescence de menu définie par l'utilisateur
Arborescence de menu définie par l'utilisateur

Chaque élément de menu standard est assigné à une action parmi trois types possibles, où chacun d'eux dispose d'attributs différents qui peuvent être réglés :

- Texte : &kile; vous donne la possibilité de faire vos propres balises. Une balise est similaire à un raccourci qui lance des commandes ou écrit des texte fréquemment utilisés. Par exemple, Monsieur Martin utilise souvent la phrase`Salut, j'ai été inséré…`. Cette balise sera insérée à la position courante du curseur chaque fois que cette action est appelée (voir ci-dessus). Les métacaractères sont également disponibles (voir ).

- Insérer le contenu d'un fichier : insère le contenu complet d'un fichier donné.

  Insertion du contenu d'un fichier
  Insertion du contenu d'un fichier

- Exécuter un programme : la sortie de ce programme peut être insérée dans un document ouvert. Le métacaractère `%M` est également disponible dans la ligne de commande de ce programme, puisque le texte sélectionné sera enregistré dans un fichier temporaire. Utilisez `%M` pour le nom de ce fichier temporaire.

  Exécution d'un programme externe
  Exécution d'un programme externe

Si une information importante pour une action est manquante, les éléments de menu sont colorés en rouge. Ce peut être par exemple in fichier inexistant.

Fichier inexistant
Fichier inexistant

ou un titre manquant pour l'entrée de menu, qui sera alors affichée avec des points d'interrogation comme `???`.

Titre manquant pour une entrée de menu
Titre manquant pour une entrée de menu

Si vous ouvrez le menu contextuel d'un tel élément de menu coloré en rouge, vous aurez une option supplémentaire pour obtenir des informations concernant l'erreur.

Informations supplémentaires
Informations supplémentaires

D'autres informations sont également disponibles en utilisant le bouton Qu'est-ce que c'est ? de la plupart des éléments graphiques.

## Caractères de remplacement

### Insérer du texte

Il y a quelques caractères de remplacement que vous pouvez utiliser dans vos balises : `%C`, `%B`, `%M`, `%E`, `%R` et `%T`.

- `%C` : ceci correspond à l'emplacement du curseur après l'insertion d'une balise définie par l'utilisateur.

  Position du curseur (%C)
  Position du curseur (%C)

- `%B` : sera remplacé par une puce (voir ).

  Puce (%B)
  Puce (%B)

- `%M` : sera remplacé par le texte sélectionné.

  Texte sélectionné (%M)
  Texte sélectionné (%M)

- `%E` : correspond à la profondeur de l'indentation du texte dans un environnement.

  Indentation du texte dans l'environnement (%E)
  Indentation du texte dans l'environnement (%E)

- `%R` : appellera une boîte de dialogue de référence pour choisir un label précédemment défini. Ceci peut être utilisé pour faire référence à un label prédéfini, que vous pouvez choisir dans une liste déroulante (voir aussi LaTeX Références ref ou LaTeX Références pageref).

  Références (%R)
  Références (%R)

- `%T` : appellera une boîte de dialogue de citation pour choisir une citation précédemment définie. Tout comme lorsqu'on utilise LaTeX Références cite, une liste contenant toutes les clés de citation apparaît.

  Clés de citation (%T)
  Clés de citation (%T)

Considérons un autre exemple, avec la macro suivante `\frac{%M}{%C}`. Nous sélectionnons d'abord un nombre dans notre texte, disons `42`. Maintenant, nous appelons cette macro et obtenons `\frac{42}{}` avec le curseur positionné dans la seconde paire d'accolades.

### Insérer le contenu d'un fichier

Si vous souhaitez insérer le contenu d'un fichier texte, vous pourriez utiliser les mêmes caractères de remplacement.

### Exécuter un programme

Si vous souhaitez exécuter un programme externe, seul `%M` pour le texte sélectionné est reconnu dans la ligne de commande. La sélection sera enregistrée dans un fichier temporaire et le caractère de remplacement `%M` sera remplacé par ce nom de fichier.

Exécution d'un programme externe (%M)
Exécuter un programme externe (%M)

Un autre caractère de remplacement est `%`, qui est remplacé par le nom complet du document actuel sans l'emplacement. Ce nom consiste en tous les caractères dans le fichier jusqu'au dernier point (mais sans l'inclure).

## Paramètre

La plupart des entrées de menu disposent de paramètres supplémentaires explicites, qui peuvent être cochés. Si certains de ces paramètres ne sont pas disponibles pour certaines actions, ils sont désactivés.

Paramètres du menu utilisateur
Paramètres du menu utilisateur

Voici un exemple pour exécuter un programme externe :

Exemple de paramètres
Exemple de paramètres

Vous pouvez voir qu'un script `perl` est appelé, ce qui ne devrait pas fonctionner avec la sélection actuelle. Le paramètre Nécessite du texte sélectionné est coché pour s'assurer qu'il y a une sélection. La sortie de ce script sera insérée (Insérer la sortie du programme choisi) et remplacera la sélection actuelle (Remplacé le texte sélectionné), mais ne sera pas elle-même sélectionnée.

Bien sûr, vous pouvez également appeler vos propres programmes et scripts. Par exemple, vous choisissez une liste de nombres, séparés par des espaces, puis appelez un script ou un programme en Perl, qui transforme cette sélection en code &latex; pour une matrice. Quel que soit ce que vous avez en tête, vous pouvez le réaliser en utilisant les entrées de menu utilisateur suivantes.

Exemple de paramètres 2
Exemple de paramètres 2

## Fichiers de définition de menu

Vous pouvez installer différents menus à chaud pour différentes tâches. Lorsque vous appelez l'assistant de menu utilisateur, le fichier de définition du menu actuel est chargé. Si vous le modifiez et fermez la boîte de dialogue avec Ok, vos modifications seront enregistrées et installées comme le nouveau menu utilisateur. Fermer la boîte de dialogue avec Annuler annulera tous les changements.

Fichier de définition de menu
Fichier de définition de menu

Vous êtes également libre d'enregistrer le fichier modifié dans le dossier des menus utilisateurs ou de charger un autre fichier de définition de menu et de l'installer. Tous les fichiers de définition de menu doivent être enregistrés dans le dossier des menus utilisateurs local de &kile; : `KILE_APP_DIR/usermenu/`.

Regardez le fichier de définition de menu d'exemple `example.xml` pour voir davantage d'entrées de menu et leurs paramètres.