Desktop entries (Русский)

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Состояние перевода: На этой странице представлен перевод статьи Desktop entries. Дата последней синхронизации: 12 июля 2017. Вы можете помочь синхронизировать перевод, если в английской версии произошли изменения.

Спецификация freedesktop ярлык приложения предусматривает стандарт для приложений для интеграции в среду рабочего стола. Ярлыки приложений - это файлы конфигурации, описывающие, как запускается приложение, и какие данные оно может обрабатывать. Они также настраивают, как появляются приложения в меню со значком, на который распространяется соответствующий стандарт спецификации меню.

Наиболее распространенные ярлыки приложений представлены файлами .desktop и .directory. В этой статье кратко объясняется, как создавать полезные и соответствующие стандарту ярлыки приложений. Она в основном предназначена для разработчиков и сопровождающих пакетов(ы), но может также быть полезна разработчикам программного обеспечения и другим.

Существует примерно три типа ярлыков приложений:

Приложение: ярлык приложения
Ссылка: ярлык на веб-ссылку
Каталог: контейнер метаданных в меню

В следующих разделах будет примерно показано, как они создаются и проверяются.

Связанное с этим материалом, а также определенные в файлах .desktop, являются ассоциациями типа MIME для файлов данных. Приложения по умолчанию описывают, как они настроены.

Ярлык приложения

Ярлыки для приложений или файлов .desktop, как правило, представляют собой комбинацию метаинформационных ресурсов и ярлыков приложений. Эти файлы обычно находятся в /usr/share/applications или /usr/local/share/applications для приложений, установленных в системе, или ~/.local/share/applications для пользовательских приложений. Пользовательские ярлыки имеют приоритет над системными ярлыками.

Пример файла

Ниже приведен пример его структуры с дополнительными комментариями. Этот пример предназначен только для быстрого ознакомления и не показывает, как использовать все возможные ключи ввода. Полный список ключей можно найти в спецификация freedesktop.org.

[Desktop Entry]

# Определение типа ярлыка приложений
Type=Application

# Версия спецификации ярлыков приложений, которой соответствует этот файл
Version=1.0

# Название приложения
Name=jMemorize

# Комментарий, который может/будет использоваться в качестве подсказки
Comment=Flash card based learning tool

# Путь к папке, в которой выполняется исполняемый файл
Path=/opt/jmemorise

# Исполняемый файл приложения, возможно с аргументами.
Exec=jmemorize

# Имя значка, который будет использоваться для отображения этого ярлыка.
Icon=jmemorize

# Описывает, должно ли это приложение запускаться в терминале или нет
Terminal=false

# Описывает категории, в которых должна отображаться этот ярлык
Categories=Education;Languages;Java;

Определение ключа

Все признанные Desktop ярлыки приложений можно найти на сайте freedesktop.org. Например, ключ Type определяет три типа ярлыков: Приложение (тип 1), Ссылка (тип 2) и Каталог (тип 3).

Ключ Version обозначает версию спецификации ярлыка приложения, которая соответствует этому файлу, но не как не версию приложения.

Name, GenericName и Comment часто содержат избыточные значения в виде комбинаций из них, например:

Name=Pidgin Internet Messenger
GenericName=Internet Messenger

или

Name=NoteCase notes manager
Comment=Notes Manager

Этого следует избегать, поскольку это только будет запутывать пользователей. Ключ Name должен содержать только имя или хотя бы аббревиатуру/акроним, если они доступны.

GenericName должен указывать на категорию приложения, которая обозначает особый признак этого конкретного приложения (например Firefox является "веб-браузером").
Comment должен содержать любую полезную дополнительную информацию.

Осуждение

Существует много ключей, которые стали устаревшими с течением времени по мере созревания стандарта. Лучший/самый простой способ - использовать инструмент desktop-file-validate, который является частью пакета desktop-file-utils. Чтобы проверить, выполните

$ desktop-file-validate <твой desktop-файл>

Это даст вам очень подробные и полезные предупреждения и сообщения об ошибках.

Значки

Смотрите также спецификация тем значков.

Распространенные форматы изображений

Ниже приведен краткий обзор форматов изображений, обычно используемых для значков.

Поддержка форматов изображений для значков, указанных в стандарте freedesktop.org.
Расширение	Полное имя и/или описание	Тип графики	Формат контейнера	Поддерживаемый
.png	Portable Network Graphics	Raster	Нет	Да
.svg(z)	Scalable Vector Graphics	Vector	Нет	Да (опционально)
.xpm	X PixMap	Raster	Нет	Да (устаревший)
.gif	Graphics Interchange Format	Raster	Нет	Нет
.ico	MS Windows Icon Format	Raster	Да	Нет
.icns	Apple Icon Image	Raster	Да	Нет

Преобразование значков

Если вы наткнулись на значок, который находится в формате, который не поддерживается стандартом freedesktop.org (например, gif или ico), вы можете использовать инструмент преобразования (который является частью пакета imagemagick), чтобы преобразовать его в поддерживаемый/рекомендованный формат, например:

$ convert <icon name>.gif <icon name>.png

Если вы преобразуете из формата контейнера, такого как ico, вы получите все изображения, которые были инкапсулированы в файл ico в форме <icon name>-<number>.png. Если вы хотите узнать размер изображения или количество изображений в файле контейнера, например ico, вы можете использовать инструмент идентификации (также часть пакета imagemagick):

$ identify /usr/share/vlc/vlc48x48.ico

/usr/share/vlc/vlc48x48.ico[0] ICO 32x32 32x32+0+0 8-bit DirectClass 84.3kb
/usr/share/vlc/vlc48x48.ico[1] ICO 16x16 16x16+0+0 8-bit DirectClass 84.3kb
/usr/share/vlc/vlc48x48.ico[2] ICO 128x128 128x128+0+0 8-bit DirectClass 84.3kb
/usr/share/vlc/vlc48x48.ico[3] ICO 48x48 48x48+0+0 8-bit DirectClass 84.3kb
/usr/share/vlc/vlc48x48.ico[4] ICO 32x32 32x32+0+0 8-bit DirectClass 84.3kb
/usr/share/vlc/vlc48x48.ico[5] ICO 16x16 16x16+0+0 8-bit DirectClass 84.3kb

Как вы можете видеть, на примере файла ico, что по названию можно предположить одно изображение размером 48x48, но на самом деле оно содержит не менее 6 разных размеров, из которых один больше 48x48, а именно 128x128.

Кроме того, вы можете использовать icotool (из icoutils) для извлечения png-изображений из контейнера ico:

$ icotool -x <icon name>.ico

Для извлечения изображений из контейнера .icns вы можете использовать icns2png (предоставленный libicns):

$ icns2png -x <icon name>.icns

Получение значков

Хотя пакеты, которые уже поставляются с файлом .desktop, наверняка содержат значок или набор значков, иногда бывает, что разработчик не создал файл .desktop, но тем не менее может отправить значки. Поэтому неплохо начать поиск значков в исходном пакете. Вы можете, например, сначала фильтровать расширение с помощью find, а затем использовать grep для дальнейшей фильтрации по определенным ключевым словам, таких как имя пакета, "значок", "логотип" и т.д., если изображений достаточно много в исходном пакете.

$ find /path/to/source/package -regex ".*\.\(svg\|png\|xpm\|gif\|ico\)$"

Если разработчики приложения не включают значки в свои исходные пакеты, тогда следующим шагом будет поиск значков на их сайте. В некоторых проектах, например, tvbrowser, есть страница с изображением/логотипом, где могут быть найдены дополнительные значки. Если проект мультиплатформенный, может случиться так, что в пакете linux/unix отсутствует значок, тогда пакет Windows может предоставить его. Если в проекте используется система управления версиями, например CVS/SVN и т.д., и у вас есть некоторый опыт работы с ней, вы также можете рассмотреть возможность просмотра ее для значков. Если все не удастся, проект может просто не иметь значка/логотипа еще.

Инструменты

gendesk

gendesk стартовал как инструмент, специально предназначенный для Arch Linux для генерации файлов .desktop, путем сбора необходимой информации непосредственно из файлов PKGBUILD. Теперь это общий инструмент, который принимает аргументы командной строки.

Значки могут быть автоматически загружены из openiconlibrary, если они доступны. (Источник значков можно легко изменить в будущем).

Как использовать

Добавьте gendesk в makedepends

Запустите функцию prepare() с:

gendesk --pkgname "$pkgname" --pkgdesc "$pkgdesc"

Альтернативно, если значок уже предоставлен (например, $pkgname.png). Флаг -n предназначен для не загрузки значка или использования значка по умолчанию. Пример:

gendesk -n --pkgname "$pkgname" --pkgdesc "$pkgdesc"

$srcdir/$pkgname.desktop будет создан и может быть установлен в функции package() с:

install -Dm644 "$pkgname.desktop" "$pkgdir/usr/share/applications/$pkgname.desktop"

Значок можно установить с помощью:

install -Dm644 "$pkgname.png" "$pkgdir/usr/share/pixmaps/$pkgname.png"

Используйте --name='Program Name' для выбора имени для входа в меню..

Для установки поля exec используйте --exec='/opt/some_app/elf --with-ponies'.

Смотрите проект gendesk для получения дополнительной информации.

Список или поиск в файлах .desktop

lsdesktopf^AUR может отображать доступные файлы .desktop или искать их содержимое.

$ lsdesktopf
$ lsdesktopf --list
$ lsdesktopf --list gtk zh_TW,zh_CN,en_GB

Он также может выполнять поиск по типу MIME. Смотрите приложения по умолчанию#lsdesktopf.

fbrokendesktop

Скрипт fbrokendesktop^AUR с использованием команды which для обнаружения сломанного Exec, который указывает на не существующий путь. Без каких-либо параметров он использует предварительно установленные каталоги в массиве DskPath. Он показывает только сломанный .desktop с полным отсутствием пути и имени файла.

Примеры

$ fbrokendesktop
$ fbrokendesktop /usr
$ fbrokendesktop /usr/share/apps/kdm/sessions/icewm.desktop

Советы и хитрости

Скрытие ярлыков приложений

Во-первых, скопируйте ярлык приложения в ~/.local/share/applications, чтобы ваши изменения не были перезаписаны.

Затем, чтобы скрыть ярлык приложения во всех средах, откройте его в текстовом редакторе и добавьте следующую строку: NoDisplay=true.

Чтобы скрыть ярлык приложения на конкретной среде рабочего стола добавьте следующую строку в него: NotShowIn=desktop-name

где desktop-name может быть таким, как GNOME, Xfce, KDE и т.д. Ярлык приложения может быть скрытым более, чем в одной среде рабочего стола сразу - просто разделяйте имена сред рабочего стола точкой с запятой.

Автозапуск

Если вы используете среду рабочего стола, совместимую с XDG, например GNOME или KDE, то она автоматически запускает файлы *.desktop, найденные в следующих каталогах:

Общесистемный: $XDG_CONFIG_DIRS/autostart/ (/etc/xdg/autostart/ по умолчанию)

GNOME также запускает файлы, найденные в /usr/share/gnome/autostart/

Пользовательский: $XDG_CONFIG_HOME/autostart/ (~/.config/autostart/ по умолчанию)

Пользователи могут переопределять общесистемные файлы *.desktop скопировав их в пользовательский каталог ~/.config/autostart/.

Для более конкретного описания используемых каталогов смотрите спецификацию автозапуска ярлыков приложений.

Примечание: Этот способ поддерживается только средами рабочего стола, совместимыми с XDG. Такие инструменты, как dapper^AUR, dex или fbautostart^AUR, могут использоваться для предоставления автозапуска XDG в неподдерживаемых средах рабочего стола, если существует какой-либо другой механизм автозапуска. Используйте существующий механизм, чтобы запустить инструмент автозапуска, совместимый с xdg.

Изменение переменных среды

Отредактируйте команду Exec, добавив env, чтобы задать переменные окружения. Например:

~/.local/share/applications/abiword.desktop

Exec=env LANG=he_IL.UTF-8 abiword %U

Совет: Предпочтительно скопировать файл .desktop в директорию ~/.local/share/applications/ вместо изменения его в /usr/share/applications/.

Смотрите также