Fitxers d'entrada d'escriptori

Un fitxer d'entrada d'escriptori és un fitxer de dades que proporciona informació sobre un element en un menú. El fitxer d'entrada d'escriptori especifica els detalls per a l'element com ara un nom, una ordre a executar, una icona, i així successivament. També conté paraules clau que determinen la ubicació de l'element en la jerarquia del menú.

Desktop entry files must reside in the $XDG_DATA_DIRS/applications directory and must have a .desktop file extension. If $XDG_DATA_DIRS1 is not set, then the default path is /usr/share is used. This also implies that user specific desktop entries may be located at $XDG_DATA_HOME/applications which is searched first. If $XDG_DATA_HOME is not set, then the default path ~/.local/share is used. Desktop entries are collected from all directories in the $XDG_DATA_DIRS environment variable. Directories which appear first in $XDG_DATA_DIRS are given precedence when there are several .desktop files with the same name.

L'exemple següent és un fitxer d'entrada d'escriptori:

[Desktop Entry]
Encoding=UTF-8
Name=Calculator
Name[ca]=Calculadora
...
Comment=Perform calculations
Comment[ca]=Realitza càlculs
...
Exec=gcalctool
Icon=accessories-calculator
Terminal=false
Type=Application
StartupNotify=true
Categories=GNOME;GTK;Utility;Calculator

La Taula 2-2 descriu les claus més importants en els fitxers d'entrada d'escriptori. Per a obtenir més informació sobre els fitxers d'entrada d'escriptori, vegeu l'Especificació de les entrades d'escriptori XDG.

Taula 2-2Claus d'entrada d'escriptori
Clau d'entrada d'escriptori Descripció
Categories

Especifica les paraules clau que descriuen l'element. Les paraules clau se separen amb un punt i coma (;). Per a veure una llista de les paraules clau de categoria estàndard, vegeu l'especificació de menú de l'escriptori a http://www.freedesktop.org/Standards/menu-spec

Els fitxers de definició de menú mapegen les entrades de l'escriptori als menús utilitzant les regles de coincidència amb la clau de Categories.

Comment Especifica una breu descripció de l'element. El comentari es mostra com un indicador de funció quan el ratolí es situa sobre l'element en el menú.
Encoding Especifica la codificació del fitxer d'entrada d'escriptori.
Exec Especifica una ordre a executar quan seleccioneu l'element des del menú.
Icon Especifica el nom del fitxer de la icona que representa l'element. No especifica el camí al nom del fitxer o l'extensió del fitxer.
MimeType Especifica els tipus MIME que l'aplicació pot gestionar.
Name Especifica el nom de l'element. Aquest nom es mostra en l'element en el menú.
NoDisplay Aquesta opció significa que “l'aplicació existeix, però no es mostra en els menús”.
Terminal

Especifica si l'ordre en la clau Exec s'executa en una finestra de terminal. Si el valor és true l'ordre s'executa en una finestra de terminal.

Si l'ordre no crea una finestra on executar-se, el valor d'aquesta clau hauria de ser true.

Type

Especifica el tipus de l'element. Aquest valor és un dels següents:

  • Application: un element que inicia una aplicació.
  • Link: un element que enllaça a un fitxer, carpeta o font remota (com ara un lloc FTP, una pàgina web, un recurs compartit del Windows...).
  • FSDevice: un element que és un dispositiu del sistema de fitxers.
  • Directory: un element que és un directori.

Per a obtenir més informació sobre les claus en els fitxers d'entrada de l'escriptori, vegeu les especificacions d'entrada d'escriptori a l'URL següent:

Els llançadors del quadre i els objectes de l'escriptori també utilitzen fitxers d'entrada d'escriptori. Els fitxers d'entrada d'escriptori per a llançadors i objectes de l'escriptori proporcionen la mateixa informació que per als elements d'un menú. Per exemple, els fitxers d'entrada d'escriptori proporcionen l'ordre a executar quan l'usuari selecciona el llançador o l'objecte.

1

$XDG_DATA_DIRS és la variable d'entorn definida en l'Especificació de base de directori XDG.