Описание ключевых значений стандарта FreeDesktop

Ключевые значения могут быть опциональными(OPTIONAL) или обязательными(REQUIRED). Если ключ опционален, то он может быть, а может и не быть представлен в файле. Однако, если его нет, то реализация стандарта должна корректно обрабатывать данную ситуацию и подставлять некоторое значение по-умолчанию.

Некоторые ключи зависят от других, специфических ключей и имеют значение только если этот специфический ключ так же представлен и установлен в специальное значение. Такие ключи не должны быть использованы, если специфический ключ не представлен или установлен в отличное от необходимого значение. Например, ключ Terminal может быть использован, только когда значение ключа Type установлено в Application.

Если требующий ключ действителен в контексте другого ключа, установленного в специальное значение, то он должен быть представлен, если другой ключ установлен в специальное значение. Например, ключ URL представлен тогда и только тогда, когда ключ Type установлен в значение Link.

Примеры ключей: Name[C], Comment[it].

Таблица 2. Стандартные ключи

Ключ Описание Тип значения Ключ обязателен? Тип
Type Эта спецификация определяет 3 типа элементов рабочего стола: Application(тип 1 - приложение), Link(тип 2 - ссылка) и Directory(тип 3 - директория). Для возможности добавить новые тип в будущем, реализации стандарта должны игнорировать элементы неизвестного типа. строковый ДА
Version Версия Спецификации Элементов Рабочего стола которой отвечают элементы рабочего стола. Элементы отвечающие с этой версией спецификации должны использовать 1.0. Примечание: поле версии не является обязательным. строковый НЕТ 1-3
Name Имя приложения, например, «Mozilla» строка в системной локали ДА 1-3
GenericName Название класса приложения, например, «Web Browser» строка в системной локали НЕТ 1-3
NoDisplay NoDisplay означает, что «это приложение создано, но не будет отображено в меню». Это может быть полезно для ассоциирования с приложениями по MIME типа, и это дает возможность запускать его прямо из файлового менеджера(или другого приложения), без необходимости создавать пункт в меню для него(есть тысячи хороших причин для этого, включающие такие штуки, как netscape -remote или kfmclient openURL) булево НЕТ 1-3
Comment Подсказка для пункта меню, например «Просмотр страниц в интернете». Значение должно отличаться от значений ключей Name и GenericName. строка в системной локали НЕТ 1-3
Icon Иконка для отображения в менеджере файлов, меню и тд. Если имя является абсллютным путем, будет использован этот файл. Если имя это не абсолютный путь, то будет выбран алгоритм поиска иконки, описанный в Спецификации Тем Иконок. строка в системной локали НЕТ 1-3
Hidden Hidden(скрытый) должно называться Deleted(удаленный). Это означает что-то удаленное пользователем (на этом уровне), что было представлено (на более высоком уровне, например, в системной директории). Это эквивалентно тому, что .desktop-файл не создан ввиду участия пользователя. Это так же может быть использовано для «удаления» созданных файлов (например, в результате переименования) - давая make install установливать файлы с ключем Hidden=true в них. булево ДА 1-3
OnlyShowIn, NotShowIn Список строк, определяющий в каких окружениях элемент должен/не должен быть показан. Только один из этих ключей может присутствовать в группе (смотри возможные значения здесь) строка(и) НЕТ 1
TryExec Путь до исполняемого файла, используемый, чтобы определить, действительно ли установлена программа. Если это не абсолютный путь, файл ищется в местах, указанной переменной окружения $PATH. Если файла не существует, или если он не имеет прав на исполнение, элемент может быть проигнорирован. (например не показан в меню) строка НЕТ 1
Exec Программа для выполнения, может быть с параметрами. строка ДА 1
Path Устанавливает рабочую директорию для запуска для элементов типа Application(приложение). строка НЕТ 1
Terminal Устанавливает, должна ли программа запускаться в терминале. булево НЕТ 1
MimeType Тип(ы) MIME, поддерживаемые приложением. булево НЕТ 1
Categories Группы меню, в которых элемент должен показываться (возможные значения смотри здесь) строка(и) НЕТ 1
StartupNotify Если true, приложение отправит сообщение remove(об удалении), когда запускается с установленной переменной окружения DESKTOP_STARTUP_ID. Если false, приложение не будет использовать оповещение при запуске (не будут показываться какие-либо окна, прерываться при использовании StartupWMClass и тд). Если отсутствует, то действия зависят от реализации (считается равным false, используется StartupWMClass и тд). (дополнительную информацию смотри в Протоколе Оповещения при Запуске). булево НЕТ 1
StartupWMClass Если определено, то приложение отобразит как минимум одно окно с переданной строкой в качестве WM Class или WM name (подробнее смотри в Протоколе Оповещения при Запуске). строка НЕТ 1
URL Если элемент типа Link, определяет его URL. строка(и) ДА 2

Это перевод страницы из спецификации FreeDesktop. Ссылка на оригинал : http://standards.freedesktop.org/desktop-entry-spec/latest/ar01s05.html .


Личные инструменты