# Manuel de l'éditeur de menus de &kde;

## Introduction

&kmenuedit; vous permet de modifier le menu des lanceurs d'applications de &kde;.

&kmenuedit; peut être démarré soit en cliquant avec le &BDS; sur le bouton du lanceur d'applications dans le tableau de bord et en sélectionnant Modifier les applications…, ou n saisissant `kmenuedit` dans la ligne du &krunner;.

&kmenuedit; vous permet de :

- Afficher et modifier le menu utilisé par le lanceur d'applications actuel.

- Couper, Copier et Coller les sous-menus et les éléments

- créer et supprimer des sous-menus et des éléments

- changer l'ordre des sous-menus et des éléments

- masquer des éléments et ajouter de nouveaux sous-menus et éléments.

Par défaut, toutes les applications installées sur l'ordinateur apparaissent pour tous les utilisateurs dans le menu des lanceurs d'applications. Des applications peuvent apparaître plus d'une fois dans des menus différents. Des catégories de sous-menus vides définies dans les spécifications de menu du bureau sont également présente, mais ne sont pas visibles dans les lanceurs d'applications, à moins que vous n'installiez des applications appartenant à ces catégories.

La vue arborescente dispose de deux types d'éléments différents :

- sous-menus : seuls les champs Nom, Commentaire et Description ainsi que le bouton pour sélectionner une icône sont activés. L'onglet Avancé est désactivé. Tout sous-menu peut contenir d'autres sous-menus et / ou des éléments.

- Éléments : utilisez cette entrée pour saisir les données pour l'application que vous souhaitez ajouter. Pour des informations détaillées, consultez Utiliser &kmenuedit;.

&kmenuedit; dispose de deux modes de vues arborescentes - normal, et affichage des éléments cachées. Pour voir ces dernières, cochez l'option Afficher les éléments cachés dans la boîte de dialogue de configuration, dans la page Général.

Beaucoup d'éléments supplémentaires apparaissent dans l'arborescence en mode affichage des éléments cachées. Plusieurs éléments cachées semblent juste être des doublons, mais ont des options de commandes différentes. Habituellement, vous ne devriez jamais modifier ces éléments cachées sinon vous risquez de perdre certaines fonctionnalités du système.

En mode affichage des éléments cachés, un sous-menu spécial .hidden [Hidden] apparaît à la racine de l'arborescence. Ce sous-menu spécial n'est pas modifiable. Dans ce sous-menu, tous les éléments supprimés seront affichés au prochain démarrage de &kmenuedit;.

Il n'est pas possible de supprimer un élément en utilisant l'interface graphique dans se sous-menu spécial. Il apparaîtra de nouveau au prochain démarrage de &kmenuedit;.

### Cas d'utilisation

#### Adapter le menu pour un utilisateur

##### Réorganiser les éléments

Ceci devrait être fait en mode affichage des éléments cachés où seuls les sous-menus et éléments visibles dans le menu du lanceur d'applications sont affichés.

Par défaut, le menu est trié par ordre alphabétique en utilisant les noms en anglais ou les descriptions. En utilisant une autre langue que l'anglais, certains sous-menus et éléments n'apparaîtront pas correctement triés.

Utilisez les options dans Modifier Trier pour trier soit par nom ou par description. Si vous utilisez le lanceur d'applications classique, vous devez choisir l'option de Format correspondant dans la boîte de dialogue de configuration. Dans le lanceur &kickoff;, cochez Afficher les applications par nom si vous les triez ici par nom.

Il est plus facile de sélectionner vos éléments et sous-menus utilisés fréquemment si vous les groupez ensemble, par exemple en haut du menu. Pour changer l'ordre d'éléments ou sous-menus particuliers dans l'arborescence, utilisez les bouton Déplacer vers le haut ou Déplacer vers le bas dans la barre d'outils, ou ces actions dans le menu.

Tous les lanceurs d'application utiliseront l'ordre des sous-menus défini dans &kmenuedit;.

##### Enlever des éléments dans l'affichage du menu

Afficher toutes les applications installées sur un ordinateur peut être déroutant pour certains utilisateurs. Vous voudrez peut-être masquer les éléments ou sous-menus les moins souvent utilisés. Il y a deux façons de faire :

Basculez en mode d'affichage normal sans les éléments cachés. Si vous supprimez des éléments, ils sont déplacés dans le sous-menu .hidden [Masqué]. Vous pouvez les déplacer dans l'arborescence pour les intégrer de nouveau dans le menu.

Si vous supprimez un sous-menu, il sera véritablement supprimé avec tous ses sous-menus et éléments. Pour les recréer, vous pouvez utiliser Modifier Restaurer le menu système, mais ceci enlèvera tous vous sous-menus et éléments personnalisés, et les fichiers `.desktop` correspondant seront également supprimés. Cette action ne peut être annulée.

La façon recommandée d'enlever des sous-menus et des éléments pour un lanceur d'application est de cocher Élément caché dans l'onglet Général puis basculer en mode d'affichage masqué. Le seul inconvénient est que vous devez masquer tous les éléments dans un sous-menu manuellement pour masquer la totalité du sous-menu de l'affichage.

#### Ajouter des éléments personnalisés

Pour ajouter des éléments personnalisés (sous-menu ou élément), utilisez les actions dans le menu ou la barre d'outils. Les éléments nécessitent un nom et une commande. Sans commande, un élément ne sera pas enregistré et votre ajout sera perdu.

Lorsque vous ajoutez un élément, il est inséré comme sous-élément dans la position mise en surbrillance dans l'arborescence. Déplacez un élément en le glissant avec le bouton de la souris ou en utilisant le bouton Déplacer vers le bas vers le bas de l'arborescence pour en faire un élément de plus haut niveau.

#### Transfert de la configuration du lanceur d'application

Il n'y a aucun moyen de transférer la configuration du menu en utilisant l'interface graphique, vous devez le faire manuellement et copier les fichiers suivant :

&kmenuedit; enregistre la hiérarchie du menu dans `menus/applications-kmenuedit.menu` dans le dossier `$(qtpaths --paths GenericConfigLocation)` et `desktop-directories` dans le dossier `$(qtpaths --paths GenericDataLocation)`, contenant les fichiers de bureau pour les sous-menus que vous avez créés. Dans `applications/` dans le dossier `$(qtpaths --paths GenericDataLocation)`, vous trouvez les fichiers de bureau pour les éléments personnalisés que vous avez créés.

Les raccourcis pour chaque application sont enregistrés dans `kglobalshortcutsrc`, dans le dossier `$(qtpaths --paths GenericConfigLocation)`. Mais, l'importation / exportation ne fonctionnent pas parce que les « UUID » des raccourcis ne correspondent pas entre les systèmes, bien que les fichiers en extension `.desktop` soient les mêmes. Vous devez assigner à nouveau tous les raccourcis manuellement.

## Ajouter un élément de menu

Dans cet exemple, nous ajouterons &firefox; au sous-menu Internet.

Pour démarrer, nous avons besoin d'ouvrir &kmenuedit;. Cliquez avec le &BDS; sur le menu du lanceur d'applications, cliquez sur Modifier les applications… pour démarrer &kmenuedit;. Après le démarrage de &kmenuedit;, choisissez Internet comme le montre la figure ci-dessous. Choisissez Internet Choisissez Internet

Une fois que vous avez choisi Internet, cliquez sur Fichier Nouvel élément... ouvre la boîte de dialogue Nouvel élément, comme montré ci-dessous. Saisissez le nom du programme que vous souhaitez ajouter. Dans notre cas, saisissez `firefox`. Boîte de dialogue Nouvel élément La boîte de dialogue Nouvel élément.

Appuyez sur entrée, et vous devriez voir quelque chose comme ce qui est montré sur la figure ci-dessous dans la fenêtre principale. Nouvel élément Le nouvel élément créé.

Remplissons maintenant la Description. Dans notre cas, saisissez `Navigateur internet`.

La façon dont la description et le nom seront affichés dépend de la configuration du lanceur d'applications, par exemple Navigateur internet (Firefox) ou Firefox (navigateur web).

Nous devons saisir le nom de l'exécutable dans le champ Commande. Dans notre exemple, nous saisissons ``firefox``.

La commande doit se trouver dans votre variable `PATH` ou vous devez spécifier l'emplacement complet de l'exécutable. Si vous ne connaissez pas le nom de l'exécutable d'une application, utilisez la commande ``locate`` pour chercher le fichier desktop et saisir la chaîne depuis la ligne Exec comme commande ici.

À la suite de la commande, vous pouvez avoir plusieurs variables qui seront remplacées par les valeurs réelles lorsque le programme est démarré :

- %f - un nom de fichier unique
- %F - une liste de fichiers ; utilisé pour les applications qui peuvent ouvrir plusieurs fichiers locaux en même temps
- %u - une URL unique
- %U - une liste d'URL
- %d - le dossier d'un fichier à ouvrir
- %D - une liste de dossiers
- %i - l'icône
- %m - l'icône miniature
- %c - la légende

Par exemple, si vous voulez démarrer firefox en commençant à www.kde.org - au lieu de `firefox`, vous saisiriez `firefox %u www.kde.org`.

La plupart des applications acceptent des options supplémentaires, &pex; le nom d'un profil particulier, comme &konqueror; ou &konsole;. Pour afficher les options d'une application, lancez ``kcmshell``--help`` dans &konsole;.

Nous voulons une icône plus créative, nous cliquons sur l'icône générique qui se trouve à côté de Nom : (notez que l'icône par défaut peut être vide, dans ce cas, cliquez sur la zone située à droite de la boîte de saisie du nom). La boîte de dialogue Choisir une icône apparaît, nous permettant de choisir une icône, comme montré ci-dessous. Boîte de dialogue Choisir une icône La boîte de dialogue Choisir une icône.

Nous choisissons l'icône de firefox dans la liste, et appuyons sur &Entree;. Votre écran final devrait ressembler à quelque chose comme la capture d'écran ci-dessous. Capture d'écran finale Voilà à quoi doit ressembler l'élément de menu.

L'emplacement du nouvel élément de menu peut être modifié en utilisant les boutons Déplacer vers le haut et Déplacer vers le bas de la barre d'outils de &kmenuedit;, ou en le glissant avec la souris.

Les sous-menus peuvent être triés en utilisant le bouton trier dans la barre d'outils de &kmenuedit;, ou l'élément de menu Modifier Trier.

Cliquez sur Fichier Enregistrer, attendez que la boîte de dialogue Mise à jour de la configuration se termine. Vous devriez maintenant trouver &firefox; dans le lanceur d'applications, sous-menu Internet.

## Utiliser &kmenuedit;

La zone de gauche montre la structure du lanceur d'applications. Quand vous naviguez parmi les éléments de la zone de gauche, la zone de droite montre des informations détaillées pour l'élément de menu surligné.

### Onglet Général

Nom :

- Ceci est le nom de votre programme comme il apparaît dans le lanceur d'applications. Il peut être différent du nom réel de l'exécutable. Par exemple, le nom de l'exécutable `mc` est « Midnight Commander ».

Description :

- La description sera affichée avec le nom dans le lanceur d'applications. C'est totalement optionnel.

Commentaire :

- Ce champ permet de décrire quelque peu le programme en question. Ceci est tout à fait facultatif.

Commande :

- Ceci est le nom du programme exécutable. Assurez-vous que vous avez la permission pour lancer ce programme.

Activer le témoin de démarrage

- Si cette case est cochée, cela affichera un témoin de démarrage lorsque l'application est en cours d'exécution.

Afficher uniquement dans &kde;

- Lorsque cette case est cochée, l'élément de l'application ne sera visible que dans les lanceurs d'application &kde;, mais pas dans les autres environnements de bureau.

Élément caché

- Enlève un élément de l'affichage du menu dans le lanceur d'applications.

### Onglet Avancé

Dossier de travail :

- Précise l'emplacement vers le programme. Ceci sera l'emplacement (path) courant du programme. Il n'a pas besoin d'être identique à l'emplacement de l'exécutable.

Exécuter dans un terminal

- Vous devez cocher cette case si votre programme nécessite un émulateur de terminal pour fonctionner. Ceci s'applique surtout aux applications de terminal.

Options du terminal :

- Mettez toutes les options de terminal dans ce champ.

Exécuter en tant qu'utilisateur différent

- Si vous voulez lancer ce programme en tant qu'utilisateur différent (pas vous), cochez cette case et saisissez le nom d'utilisateur dans le champ Nom d'utilisateur : .

Raccourci clavier actuel :

- Vous pouvez assigner un raccourci clavier pour démarrer votre programme.

  Cliquez sur le bouton Aucun à la droite de la case à cocher Raccourci clavier actuel : .

  Le texte du bouton se transformera en Entrée... et vous pouvez appuyer sur la combinaison de touches que vous souhaitez assigner à votre programme.

  Vous pouvez réinitialiser le raccourci clavier à Aucun en utilisant ce bouton :

  N'oubliez pas d'enregistrer vos réglages en cliquant sur le bouton Enregistrer de la barre d'icônes, ou en utilisant l'élément de menu Fichier Enregistrer.

## Guide des menus

La plupart des actions de la barre de menu sont également dans le menu contextuel ouvert d'un clic droit de la souris sur un élément de la vue arborescente.

&Ctrl;N Fichier Nouvel élément...

- Ajoute un nouvel élément au menu.

Fichier Nouveau sous-menu...

- Ajoute un nouveau sous-menu.

&Ctrl;S Fichier Enregistrer

- Enregistre le menu

&Ctrl;Q Fichier Quitter

- Quitte &kmenuedit;.

Modifier Déplacer vers le haut

- déplace l'élément sélectionné vers le haut dans son sous-menu

Modifier Déplacer vers le bas

- déplace l'élément sélectionné vers le bas dans son sous-menu

&Ctrl;X Édition Couper

- Coupe le menu sélectionné et le place dans le presse-papiers. Si vous voulez déplacer un élément de menu, vous devez d'abord le couper, vous déplacer vers l'emplacement de destination et utiliser la commande Coller pour le prendre dans le presse-papiers et l'insérer à l'endroit désiré.

&Ctrl;C Édition Copier

- Copie le menu courant dans le presse-papiers. Vous pourrez l'utiliser plus tard grâce à la fonction Coller pour l'ajouter là où vous le désirez. Vous pouvez coller le même élément plusieurs fois.

&Ctrl;V Édition Coller

- Colle l'élément de menu à partir du presse-papiers à l'endroit sélectionné dans le menu principal. Vous devez d'abord utiliser Couper ou Copier avant de pouvoir Coller.

Suppr. Modifier Supprimer

- Efface le menu actuellement sélectionné.

Modifier trier

- ouvre un sous-menu pour trier le sous-menu sélectionné, ou toute l'arborescence de menus. Deux sortes de tri sont disponibles, par nom, et par description.

Modifier Restaurer le menu du système

- Ceci réinitialisera le lanceur d'application vers sa configuration par défaut, et enlèvera tous vos réglages personnalisés. Un message vous demandera de confirmer.

&kmenuedit; possède des éléments communs de menu &kde; Configuration et Aide. Pour plus d'informations, veuillez consulter les sections Menu de configuration et Menu d'aide des fondamentaux de &kde;.

## Remerciements et licence

&kmenuedit;

Programme copyright © 2002, &Raffaele.Sandrini;

Collaborateurs :

- &Matthias.Elter; &Matthias.Elter.mail; - auteur original

- &Matthias.Ettrich; &Matthias.Ettrich.mail;

- &Daniel.M.Duley; &Daniel.M.Duley.mail;

- &Preston.Brown; &Preston.Brown.mail;

Documentation copyright © 2000 &Milos.Prudek;

Documentation sous copyright © 2008 &Anne-Marie.Mahfouf;

Mise à jour pour &kde; 3.0 par &Lauri.Watts; &Lauri.Watts.mail; 2002

Traduction française par &EquipeKDE;

&underFDL; &underGPL;

## Glossaire

Application de terminal

Une application écrite au départ pour un environnement non graphique, orienté texte. De telles applications fonctionnent très bien sous &kde;. Elles doivent être lancées dans un émulateur de terminal, comme &konsole;. Elles ne sont pas averties automatiquement quand vous fermez votre session &kde;. Pour cette raison, vous ne devez pas oublier d'enregistrer vos documents ouverts dans ces applications avant de quitter &kde;.

Les applications de terminal gèrent le copier-coller des applications écrites pour KDE. Vous devez simplement surligner le texte à copier dans le terminal avec votre souris, puis vous placer dans une application KDE et faire la combinaison de touches &Ctrl;V pour coller le texte. Si vous voulez copier depuis une application &kde; vers une application terminal, surlignez d'abord le texte à la souris, faites &Ctrl;C, passez dans l'application terminal et cliquez sur le bouton central de votre souris.

Si votre souris n'a pas de bouton central, vous devez cliquer simultanément sur les boutons gauche et droit. On appelle cela l'émulation du bouton central et cette fonction doit être activée dans votre système pour fonctionner.

.
&documentation.index;