====== Personnaliser le menu Xfce ======
Cette page décrit comment personnaliser le menu, avec la version Xfdesktop **4.5 ou supérieure** et libxfce4menu.

===== Fichiers installés par Xfdesktop =====
Xfdesktop installe un fichier de menu, et des fichiers .desktop pour le nœud principal du menu (Exécuter, Terminal, Gestionnaire de fichiers…).  Pour personnaliser votre menu, vous devrez modifier ces fichiers.

===== Éditer le fichier de menu =====
Copiez le menu vers votre répertoire personnel :

  cp $prefix/etc/xdg/menus/xfce-applications.menu ${XDG_CONFIG_HOME:-~/.config}/menus

===== Cacher des entrées du nœud principal =====
Si vous souhaitez supprimer des éléments du nœud principal, vous devez copier les fichiers .desktop vers votre répertoire personnel, et ajouter ou modifier la clé //NoDisplay//. Plus d’informations sur les clés sont disponibles [[http://standards.freedesktop.org/desktop-entry-spec/latest/ar01s05.html|ici]].

Xfdesktop installe les fichiers .desktop suivants :

  * ''$prefix/share/applications/xfce4-about-xfce.desktop''
  * ''$prefix/share/applications/xfce4-file-manager.desktop''
  * ''$prefix/share/applications/xfce4-help.desktop''
  * ''$prefix/share/applications/xfce4-logout.desktop''
  * ''$prefix/share/applications/xfce4-run-program.desktop''
  * ''$prefix/share/applications/xfce4-terminal.desktop''
  * ''$prefix/share/applications/xfce4-web-browser.desktop''

Pour modifier un fichier spécifique, copiez-le dans votre répertoire personnel, par exemple :

  cp $prefix/share/applications/xfce4-web-browser.desktop ~/.local/share/applications

ensuite modifiez ou ajouter la clé NoDisplay :

  NoDisplay=true

Si vous utilisez un autre environnement de bureau (Gnome, KDE ou autres) en parallèle à Xfce et ne désirez cacher une entrée du menu que pour Xfce, préférez l’utilisation de la clé NotShowIn :
<code>NotShowIn=XFCE</code>
 
=== Différence entre NoDisplay et Hidden ===
>> {{wiki:warning.png |}}
>> Si vous avez consulté les spécifications des fichiers .desktop, vous connaissez peut-être déjà la différence entre ces deux clés. NoDisplay masque le fichier.desktop du menu mais le type mime sera toujours associé (par exemple dans Thunar). En contre-partie, la clé Hidden agira comme si le fichier .desktop n’existait pas.

===== Créer des entrées dans le nœud principal =====
Vos propres entrées pour le menu vont dans le répertoire ''~/.local/share/applications''.

Dans ce répertoire, vous pouvez créer des fichiers .desktop pour chaque entrée du menu, p.e. pour exécuter Eclipse, créez le fichier ''eclipse.desktop'' dans ''~/.local/share/applications'' :

  [Desktop Entry]
  Version=1.0
  Type=Application
  Encoding=UTF-8
  Exec=eclipse
  Icon=eclipse
  StartupNotify=false
  Categories=X-XFCE;X-Xfce-Toplevel;
  OnlyShowIn=XFCE;
  Name=Eclipse
  Comment=Eclipse Java IDE

Afin d’afficher cette entrée, modifiez le fichier de menu ''${XDG_CONFIG_HOME:-~/.config}/menus/xfce-applications.menu'', par exemple :

<code xml>
  <Menu>
    <Name>Xfce</Name>

    <DefaultAppDirs/>
    <DefaultDirectoryDirs/>

    <Include>
        <Category>X-Xfce-Toplevel</Category>
    </Include>

    <Layout>
        <Filename>xfce4-terminal.desktop</Filename>
        <Separator/>
        <Filename>eclipse.desktop</Filename>
    
    [...]
</code>

===== Éditer des entrées =====
À partir de la version 4.5, libxfce4menu ne prend pas en charge la commande « Merge ». Cela signifie qu’il n'est pas possible de construire un éditeur de menu esthétique. En conséquence, pour ajouter/supprimer ou modifier des entrées du menu, vous devez copier les fichiers manuellement.

Admettons que « gvim » soit installé, vous devriez avoir le fichier desktop ''/usr/share/applications/gvim.desktop''. Copiez ce fichier dans votre répertoire personnel ''~/.local/share/applications''. Ensuite, vous pourrez l’éditer.

Pour créer de nouvelles entrées pour le menu, vous pouvez créer de nouveaux fichiers .desktop dans le répertoire précédemment cité. ''exo-desktop-item-edit'' facilite la création de tels fichiers. Par exemple, éxécutez ''%%exo-desktop-item-edit --create-new ~/.local/share/applications/%%''.

===== Recharger le menu =====
Si vous n’avez pas de démon de surveillance d’altération de fichier, exécutez ''xfdesktop %%--%%reload'' pour rafraîchir le menu.

Si la commande ci-dessus ne fonctionne pas, vous pouvez essayer la suivante : ''killall -HUP xfdesktop''.

Vous pouvez également quitter puis relancer Xfdesktop avec xfrun4 (utilitaire de lancement d’applications de Xfce). Lancez-le avec le raccourci clavier < ALT+F2 > et entrez dans le champ prévu à cette fin :
<code>xfdesktop --quit</code>
Pour relancer xfdesktop, utilisez à nouveau le raccourci clavier < ALT+F2 > entrez **xfdesktop** puis **Exécuter**

Admirez !