Archivos de entrada de escritorio

Un archivo de entrada de escritorio es un archivo de datos que proporciona información acerca de un elemento en un menú. El archivo de entrada de escritorio especifica los detalles para el elemento del menú, tales como un nombre, comando a ejecutar, un icono y demás. También contiene palabras clave que determinan la ubicación para el elemento en la jerarquía del menú.

Los archivos de entrada de escritorio deben estar en el directorio $XDG_DATA_DIRS/applications y deben tener una extensión de archivo .desktop. Si $XDG_DATA_DIRS1 no está activado, entonces la ruta predeterminada que usar es /usr/share. Esto también implica que las entradas de escritorio específicas del usuario deben ubicarse en $XDG_DATA_HOME/applications, en el que se busca primero. Si $XDG_DATA_HOME no está activado, entonces se usa ~/.local/share como ruta predeterminada. Las entradas de escritorio se recogen de todos los directorios en la variable de entorno $XDG_DATA_DIRS. Los directorios que aparezcan primero en $XDG_DATA_DIRS tienen preferencia cuando hay varios archivos .desktop con el mismo nombre.

Lo siguiente es un ejemplo de un archivo de entrada de escritorio:

[Desktop Entry]
Encoding=UTF-8
Name=Calculator
Name[fr]=Calculatrice
...
Comment=Perform calculations
Comment[fr]=Effectue des calculs compliqués
...
Exec=gcalctool
Icon=accessories-calculator
Terminal=false
Type=Application
StartupNotify=true
Categories=GNOME;GTK;Utility;Calculator

La Tabla 2-2 describe las claves más importantes en los archivos de entrada de escritorio. Para obtener más información acerca de los archivos de entrada de escritorio, vea la Especificación de entrada de escritorio XDG.

Tabla 2-2Claves de entrada de escritorio
Clave de entrada de escritorio Descripción
Categories

Especifica las palabras clave que describen al elemento. Las palabras clave están separados con punto y coma (;). Para ver una lista de las palabras clave de categoría estándar, vea la especificación de menús del escritorio en http://www.freedesktop.org/Standards/menu-spec.

Los archivos de definición de menú redireccionan las entradas de menú usando reglas de coincidencias contra las claves de las Categorías.

Comment Especifica una corta descripción del elemento. El comentario se muestra como un consejo cuando posicione el ratón encima del elemento del menú.
Encoding Especifica la codificación del archivo de entrada de escritorio.
Exec Especifica el comando a ejecutar cuando elija el elemento del menú.
Icon Especifica el nombre del archivo del icono que representa el elemento. No especifica la ruta al nombre del archivo o la extensión del archivo.
MimeType Especifica el tipo MIME que puede manejar la aplicación.
Name Especifica el nombre del elemento. Este nombre se muestra en el elemento en el menú.
NoDisplay Estas opciones significan «Esta aplicación existe, pero no se muestra en el menú».
Terminal

Especifica si el comando en la clave Exec se ejecuta en una ventana del terminal. Si el valor es true el comanjo se ejecuta en una ventana del terminal.

Si el comando no crea una ventana en la que ejecutarse, el valor de esta clave debe ser true.

Type

Especifica el tipo de elemento. Este valor es uno de los siguientes:

  • Application: Un elemento que inicia una aplicación.
  • Link: Un elemento que enlaza a un archivo, carpeta o recurso remoto (tal como un sitio FTP, una página web, un recurso compartido de Windows...).
  • FSDevice: Un elemento que es un dispositivo del sistema de archivos.
  • Directory: Un elemento que es un Ddirectorio.

Para obtener más información acerca de las claves en los archivos de entrada de escritorio, vea la especificación de entradas del escritorio en el siguiente URL:

Los lanzadores del panel y los objetos del escritorio también usan archivos de entrada de escritorio. Los archivos de entrada de escritorio para los lanzadores y objetos del panel proporcionan la misma información que para los elementos de un menú. Por ejemplo, los archivos de entrada de escritorio proporcionan el comando a ejecutar cuando un usuario elije el lanzador o el objeto.

1

$XDG_DATA_DIRS es la variable de entorno definida en la especificación de base de directorio XDG.