Uso de archivos de definición de menús

Idioma:

Los archivos de menú definen la jerarquía de los menús que se utilizan en la barra de menús de Oracle Solaris Desktop. Al modificar estos archivos, es posible personalizar los menús para todos los usuarios o para un solo usuario según la ubicación del archivo applications.menu que modifique.

Los archivos de menú deben residir en el directorio $XDG_CONFIG_DIRS/menus/applications.menu. Para trabajar con archivos de menú, debe establecer la variable del entorno $XDG_CONFIG_DIRS, definida en la XDG base directory specification.

Para resolver la ubicación del archivo applications.menu, el sistema realiza una búsqueda en la ruta predeterminada en el siguiente orden:

Realiza una búsqueda en cada directorio de la ruta $XDG_CONFIG_HOME para encontrar el archivo menus/applications.menu. Si no se establece la variable del entorno $XDG_CONFIG_HOME, de manera predeterminada la búsqueda se realiza en el directorio ~/.config/.
Realiza una búsqueda en cada directorio de la ruta $XDG_CONFIG_DIRS para encontrar el archivo menus/applications.menu. Si no se establece la variable del entorno $XDG_CONFIG_DIRS, de manera predeterminada la búsqueda se realiza en el directorio /etc/xdg/.
Usa el primer archivo applications.menu encontrado.

A continuación, se muestra un archivo .menu de ejemplo:

Ejemplo 3-1 Ejemplo de un archivo .menu

<!DOCTYPE Menu PUBLIC "-//freedesktop//DTD Menu 1.0//EN"
 "http://www.freedesktop.org/standards/menu-spec/1.0/menu.dtd">
<Menu>
  <Name>Applications</Name>
  <Directory>Applications.directory</Directory>

  <!-- Read standard .directory and .desktop file locations -->
  <DefaultAppDirs/>
  <DefaultDirectoryDirs/>

  <!-- Accessories submenu -->
  <Menu>
    <Name>Accessories</Name>
    <Directory>Accessories.directory</Directory>
    <Include>
      <And>
        <Category>Utility</Category>
        <Not>
        

<Category>System</Category>
        </Not>
      </And>
    </Include>
  </Menu> <!-- End Accessories -->

  <!-- possibly more submenus -->

</Menu> <!-- End Applications -->

En este ejemplo, el menú de nivel superior se denomina Applications, que se especifica mediante el elemento <Name>. El menú Applications contiene un solo submenú, pero se permiten varios submenús. Cada submenú también puede tener un elemento <Include> para filtrar el conjunto de entradas de escritorio disponibles utilizando reglas de coincidencia.

Por ejemplo, el elemento <Category> es una regla de coincidencia básica que selecciona un archivo de entrada de escritorio únicamente si la clave Categories incluye el contenido del elemento <Category>. En el ejemplo, el menú Accessories incluirá una entrada de escritorio únicamente si el menú contiene la palabra “Utility”, pero no “System”, en la clave Categories. Para obtener más información sobre la clave Categories, consulte Working With Desktop Entry Files.

En la siguiente tabla, se describen algunos de los elementos de los archivos .menu.

Tabla 3-1 Elementos del archivo de definición de menús

Elemento	Descripción
`Menu`	Elemento raíz que puede contener elementos anidados de `<Menu>`. Los elementos anidados definen submenús. La forma en la que se anidan estos elementos determina la estructura del menú.
`Name`	Especifica el nombre del menú. Cada elemento `<Menu>` debe contener un elemento `<Name>`.
`Directory`	Especifica el nombre del archivo de entrada de directorio que especifica el nombre, el comentario y el icono del menú. Si no se especifica este elemento, se debe utilizar el elemento `<Name>` para mostrar el nombre del menú. De manera predeterminada, los archivos `.directory` se buscan en el directorio `$XDG_DATA_DIRS/desktop-directories/`, como se define en la especificación de menús de XDG.
`DefaultAppDirs`	Una instrucción que indica que se deben analizar todas las entradas de escritorio disponibles del directorio `$XDG_DATA_DIRS/applications/`. Si no se incluye esta instrucción, estas ubicaciones no se analizan en busca de entradas de escritorio.
`DefaultDirectoryDirs`	Una instrucción que indica que se deben analizar todas las entradas de directorio disponibles del directorio `$XDG_DATA_DIRS/desktop-directories/`. Si no se incluye la instrucción, estas ubicaciones no se analizan en busca de entradas de directorio.
`Include`	Contiene una lista de reglas de coincidencia mediante las cuales se genera el contenido de un menú. Puede incluir las reglas de coincidencia `<Filename>`, `<Category>`, `<And>`, `<Or>` , `<Not>` o `<All>`.
`Exclude`	Elemento contrario a `<Include>`. Si hay entradas de escritorio que coinciden con este elemento, las entradas se excluyen del conjunto anterior de elementos incluidos. Por este motivo, este elemento debe aparecer después del elemento `<Include>`.
`Filename`	Una regla de coincidencia que selecciona una entrada de escritorio cuando `Desktop File-Id` coincide con el contenido del elemento `<Filename>`.
`Category`	Una regla de coincidencia que selecciona una entrada de escritorio cuando la clave `Categories` coincide con el contenido del elemento `<Category>`.
`And`	Una regla de coincidencia que selecciona una entrada de escritorio cuando la entrada es seleccionada por todas las reglas de coincidencia anidadas en el elemento `<And>`.
`Or`	Una regla de coincidencia que selecciona una entrada de escritorio cuando la entrada es seleccionada por cualquier regla de coincidencia anidada en el elemento `<Or>`.
`Not`	Una regla de coincidencia que no selecciona una entrada de escritorio cuando la entrada es seleccionada por cualquier regla de coincidencia anidada en el elemento `<Not>`.
`All`	Una regla de coincidencia que selecciona todas las entradas de escritorio.

Para obtener una descripción detallada de los elementos de los archivos .menu, consulte la especificación de menús de XDG.