Utilisation des fichiers d'entrée de bureau

Langue :

Un fichier d'entrée de bureau est un fichier de données qui fournit des informations sur un élément d'un menu. Le fichier d'entrée de bureau spécifie les détails de l'élément tels qu'un nom, une commande à exécuter, une icône, etc. Le fichier d'entrée de bureau contient aussi des mots clés qui déterminent l'emplacement d'un élément dans la hiérarchie des menus. Les fichiers d'entrée de bureau se trouvent dans le répertoire $XDG_DATA_DIRS/applications et doivent porter l'extension .desktop.

Ordre dans lequel les chemins par défaut sont recherchés pour résoudre l'emplacement des fichiers .desktop, comme suit :

Recherchez dans le répertoire $XDG_DATA_HOME/applications. Si la variable d'environnement $XDG_DATA_HOME n'est pas définie, recherchez dans le répertoire par défaut ~/.local/share/applications.
Recherchez les sous-répertoires d'applications de chaque répertoire dans $XDG_DATA_DIRS. Si la variable d'environnement $XDG_DATA_DIRS n'est pas définie, recherchez dans le répertoire par défaut /usr/share/applications.
Si plusieurs fichiers .desktop avec le même nom sont trouvés, le premier fichier trouvé est prioritaire.

Voici un exemple de fichier d'entrée de bureau.

[Desktop Entry]
Encoding=UTF-8
Name=Calculator
Name[fr]=Calculatrice
...
Comment=Perform calculations
Comment[fr]=Effectue des calculs compliq

ue
...
Exec=gcalctool
Icon=accessories-calculator
Terminal=false
Type=Application
StartupNotify=true
Categories=GNOME;GTK;Utility;Calculator

Le tableau suivant décrit certaines des clés importantes dans les fichiers d'entrée de bureau. Pour plus d'informations sur les fichiers d'entrée de bureau, reportez-vous à la XDG Desktop Entry Specification.

Table 3-3 Clés d'entrée de bureau

Clé d'entrée de bureau	Description
`Categories`	Spécifie les mots clés qui décrivent l'élément. Les mots clés sont séparés par des points virgules (`;`). Pour une liste de mots clés de catégorie standard, reportez-vous à la spécification de menu de bureau à l'adresse http://www.freedesktop.org/Standards/menu-spec. Pour découvrir comment mapper des entrées de bureau aux menus à l'aide de règles de correspondance avec la clé Categories, reportez-vous à la section Working With Menu Definition Files.
`Comment`	Spécifie une brève description de l'élément. Le commentaire est affiché sous forme d'infobulle quand vous pointez sur l'élément du menu.
`Encoding`	Spécifie le codage du fichier d'entrée de bureau.
`Exec`	Spécifie une commande à exécuter quand vous choisissez l'élément dans le menu.
`Icon`	Spécifie le nom de fichier d'une icône qui représente l'élément. Ne spécifie pas le chemin vers le nom de fichier ou de l'extension de fichier.
`MimeType`	Spécifie les types MIME que l'application peut gérer.
`Name`	Spécifie le nom de l'élément. Ce nom est affiché sur l'élément dans le menu.
`NoDisplay`	Spécifie qu'une application existante ne doit pas être affichée dans le menu.
`Terminal`	Spécifie si la commande dans la clé `Exec` s'exécute dans une fenêtre de terminal. Si la valeur est `true`, la commande s'exécute dans une fenêtre de terminal. Si la commande n'ouvre pas une fenêtre pour s'exécuter, la valeur de cette clé doit être définie sur `true`.
`Type`	Spécifie le type d'élément. La valeur de la clé `Type` est une des suivantes : `Application` : élément qui lance une application. `Link` : élément qui se lie à un fichier, un dossier ou une source distante (telle qu'un site FTP ou une page Web). `FSDevice` : élément qui est un périphérique de système de fichiers. `Directory` : élément qui est un répertoire.

Pour plus d'informations sur les clés dans les fichiers d'entrée de bureau, reportez-vous à laspécification d'entrée de bureau.

Remarque - Les lanceurs de tableau de bord et objets de bureau utilisent aussi des fichiers d'entrée de bureau. Les fichiers d'entrée de bureau pour les lanceurs et objets de bureau fournissent les mêmes informations que ceux pour les éléments d'un menu. Par exemple, les fichiers d'entrée de bureau fournissent la commande à exécuter quand un utilisateur choisit le lanceur ou l'objet.