Ficheiros de Definição de Iniciador

Um ficheiro de definição de iniciador é um ficheiro de dados que disponibiliza informação sobre um item num menu. O ficheiro de definição de iniciador especifica os detalhes do item tais como o nome, comando a executar, um ícone, etc. Também contém palavras-chave que determinam a localização do item na hierarquia de menus.

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.

O seguinte é um exemplo de um ficheiro de definição de iniciador:

[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

Tabela 2-2 descreve as chaves mais importantes nos ficheiros de definição de iniciadores. Para obter mais informações sobre os ficheiros de definição de iniciadores, consulte a Especificação de Definição de Iniciadores XDG.

Tabela 2-2Chaves de Definição de Iniciador
Chave de Definição de Iniciador Descrição
Categories (Categorias)

Especifica as palavras-chave que descrevem o item. As palavras-chave são separadas por pontos-e-vírgula (;). Para ver uma lista das palavras-chave de categoria mais comuns, consulte a especificação de definição de iniciador em http://www.freedesktop.org/Standards/menu-spec

Ficheiros de Definição de Menu mapeiam definições de iniciadores para menus utilizando regras de equivalência sobre as chaves de Categorias.

Comment (Comentário) Especifica uma descrição breve do item. O comentário é apresentado como uma dica de menu quando se coloca o rato sobre o item no menu.
Encoding (Codificação) Especifica a codificação do ficheiro de definição de iniciador.
Exec (Executar) Especifica o comando a executar quando selecciona o item no menu.
Icon (Ícone) Especifica o nome do ficheiro de um ícone que represente o item. Não especifica o caminho do ficheiro, nem a extensão do mesmo.
MimeType (Tipo MIME) Especifica os tipos MIME que a aplicação é capaz de manipular.
Name (Nome) Especifica o nome do item. Este nome é apresentado no item no menu.
NoDisplay (Não Apresentar) Esta opção significa “Esta aplicação existe, mas não deve ser visível nos menus”.
Terminal (Consola)

Especifica se o comando que consta na chave Exec deve ser executado numa janela de consola. Se o valor for true (verdadeiro) o comando será executado numa janela de consola.

Se o comando não criar uma janela onde correr, o valor desta chave terá de ser true.

Type (Tipo)

Especifica o tipo de item. Este valor é um dos seguintes:

  • Application (Aplicação): Um item que inicia uma aplicação.
  • Link (Atalho): Um item que é um atalho para um ficheiro, pasta, ou um recurso remoto (tal como um servidor FTP, uma página web, uma partilha Windows...).
  • FSDevice (Dispositivo de Sistema de Ficheiros): Um item que representa um dispositivo de sistema de ficheiros.
  • Directory (Directório): Um item que representa um Directório.

Para mais informações sobre chaves nos ficheiros de definição de iniciadores, consulte a especificação de definição de iniciador no seguinte URL:

Iniciadores de painel e objectos de área de trabalho também utilizam ficheiros de definição de iniciador. Os ficheiros de definição de iniciador em painéis e objectos de área de trabalho disponibilizam a mesma informação que os itens num menu. Por exemplo, os ficheiros de definição de iniciador disponibilizam o comando a executar quando o utilizador selecciona o iniciador ou objecto.

1

$XDG_DATA_DIRS é a variável de ambiente definida na especificação de directório base XDG.