Desktop entries (Русский) - ArchWiki

Jump to content

# Desktop entries (Русский)

From ArchWiki
Состояние перевода: На этой странице представлен перевод статьи 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

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

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

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

### fbrokendesktop

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

Примеры

    $ fbrokendesktop
    $ fbrokendesktop /usr
    $ fbrokendesktop /usr/share/xsessions/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. Такие инструменты, как dapperAUR, dex или fbautostartAUR, могут использоваться для предоставления автозапуска 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/`.

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

- Ярлык (компьютер)
- Информация для разработчиков

Categories:

- Freedesktop.org (Русский)
- Configuration files (Русский)
- Package development (Русский)