xdg-utils (Русский)

From ArchWiki

Состояние перевода: На этой странице представлен перевод статьи xdg-utils. Дата последней синхронизации: 19 апреля 2022. Вы можете помочь синхронизировать перевод, если в английской версии произошли изменения.

xdg-utils предоставляет официальные утилиты для управления MIME-приложениями XDG.

  • xdg-desktop-menu(1) — установка элементов меню рабочего стола
  • xdg-desktop-icon(1) — копирование ярлыков приложений на рабочий стол пользователя
  • xdg-email(1) — открытие предпочитаемого пользователем клиента электронной почты (с возможностью указания темы и других параметров создаваемого сообщения)
  • xdg-icon-resource(1) — установка значков
  • xdg-mime(1) — запрос и установка типов и ассоциаций MIME
  • xdg-open(1) — открытие файла или URI в предпочтительном приложении пользователя
  • xdg-screensaver(1) — разрешение, запрещение или приостановка хранителя экрана
  • xdg-settings(1) — установка веб-браузера и обработчиков URL-адресов по умолчанию

Установка

Установите пакет xdg-utils.

Использование

Переменные окружения

Примечание: Нормально работающая среда рабочего стола должна автоматически устанавливать эти переменные. Этот раздел необходим только для понимания того, как работает xdg-utils, то есть для устранения неполадок.

xdg-utils пытается интегрироваться с вашей средой рабочего стола, вызывая специализированные программы, которые она предоставляет, где это применимо. Выяснение текущей среды ребочего стола происходит так [1][устаревшая ссылка 2023-05-06 ⓘ]:

  • Если стандартная переменная окружения XDG_CURRENT_DESKTOP содержит одно из известных значений, то используется оно.
  • Если присутствуют какие-либо классические fallback'и или специфичные для среды переменные, такие как KDE_FULL_SESSION в KDE, то используется соответствующее значение.
  • Если старая переменная окружения DESKTOP_SESSION содержит одно из известных значений, то используется оно.

Когда совпадение найдено, переменная DE внутренне перезаписывается нормализованным значением обнаруженной среды рабочего стола. Таким образом, DE — это и переменная окружения, и внутренняя переменная состояния xdg-utils. Например, если XDG_CURRENT_DESKTOP имеет значение KDE, то xdg-utils внутренне установит DE в значение kde. Если соответствие не найдено, то будет использовано любое ранее существующее значение DE; то есть, установка XDG_CURRENT_DESKTOP=KDE — это то же самое, как если бы переменная XDG_CURRENT_DESKTOP отсутствовала, а вместо неё была бы DE=kde. Это важная деталь реализации заслуживает внимания, так как следствие — предварительно установленная переменная DE игнорируется, если среда рабочего стола указана где-то ещё.

Значения переменных, которые распознаёт xdg-utils, следующие:

Среда XDG_CURRENT_DESKTOP DE DESKTOP_SESSION
X-Generic1 generic
Cinnamon Cinnamon, X-Cinnamon deepin
Deepin Deepin, DEEPIN, deepin1 cinnamon
Enlightenment ENLIGHTENMENT1 enlightenment
GNOME GNOME2 gnome gnome
GNOME Flashback GNOME-Flashback, GNOME-Flashback:GNOME2 gnome gnome
KDE Plasma KDE kde
LXDE LXDE lxde LXDE
LXQt LXQt lxqt
MATE MATE mate mate
Xfce XFCE xfce xfce, xfce4, Xfce Session
  1. Это не среда, зарегистрированная на freedesktop.org.
  2. Варианты GNOME, в том числе режим GNOME Classic, рассматриваются xdg-utils как одно и то же.

Имейте в виду, что это лишь список того, что способны обнаружить скрипты, которые предоставляет xdg-utils. Скрипты всё равно будут выполнять общие действия, не зависящие от среды, при следующих условиях:

  • Была запрошена общая процедура через XDG_CURRENT_DESKTOP=X-Generic или DE=generic.
  • Определить среду не удалось. Все соответствующие переменные окружения были не распознаны или не установлены, а поиск классических fallback'ов ни к чему не привёл.
  • Действия, специфичные для среды, были выполнены, но не увенчались успехом, например, из-за отсутствия нужной программы.

xdg-mime

xdg-mime(1) — это скрипт для прямого запроса и изменения стандартных приложений MIME. Он используется в других скриптах, таких как xdg-open, а также является полезным инструментом при устранении неполадок.

Определение MIME-типа файла:

$ xdg-mime query filetype photo.jpeg
image/jpeg

Определение приложения по умолчанию для MIME-типа:

$ xdg-mime query default image/jpeg
gimp.desktop

Изменение приложения по умолчанию для MIME-типа:

$ xdg-mime default feh.desktop image/jpeg

Отладка приложения по умолчанию для MIME-типа:

$ env XDG_UTILS_DEBUG_LEVEL=10  xdg-mime query default text/html
Checking /home/пользователь/.config/mimeapps.list
Checking /home/пользователь/.local/share/applications/defaults.list and /home/пользователь/.local/share/applications/mimeinfo.cache
Checking /usr/local/share/applications/defaults.list and /usr/local/share/applications/mimeinfo.cache
Checking /usr/share/applications/defaults.list and /usr/share/applications/mimeinfo.cache
qutebrowser.desktop

Когда нужно определить MIME-тип файла, xdg-mime пытается использовать программу, подходящую для среды рабочего стола:

Среда Программа Пакет
Cinnamon gio glib2
GNOME
GNOME Flashback
LXDE
MATE
Xfce
Deepin
Enlightenment
LXQt
KDE Plasma kmimetypefinder kde-cli-tools

В общем случае xdg-mime будет:

  • Обращаться к mimetype, если он доступен (пакет perl-file-mimeinfo).
  • Обращаться к file, если он доступен.

xdg-open

xdg-open(1) — это инструмент открытия ресурсов, используемый многими приложениями, реализующий стандарт XDG MIME Applications и при этом максимально интегрированный со средой рабочего стола.

Если среда рабочего стола обнаружена, будет вызван предоставляемый ею обработчик [2][устаревшая ссылка 2023-05-06 ⓘ]:

Среда Программа Пакет
Cinnamon gio glib2
GNOME
GNOME Flashback
MATE
Deepin dde-open deepin-api
Enlightenment enlightenment_open enlightenment
KDE Plasma kde-open kde-cli-tools
LXDE pcmanfm pcmanfm
LXQt
Xfce exo-open1 exo
  1. Также может быть предпринята попытка использования gio из пакета glib2.

В общем случае xdg-open:

  • Обратится к #xdg-mime, чтобы узнать связанное с ресурсом приложение по умолчанию, прочитает соответствующий .desktop файл и запустит прописанную в нём команду.
  • Обратится к run-mailcap, если он доступен (пакет run-mailcapAUR).
  • Обратится к mimeopen, если он доступен (пакет perl-file-mimeinfo).
Совет: Чтобы узнать, какой бэкенд будет использовать xdg-open, установите переменную окружения XDG_UTILS_DEBUG_LEVEL=3.

Поскольку xdg-mime полагается на пакет perl-file-mimeinfo для реализации стандарта XDG MIME Applications, если вы не используете среду рабочего стола, вам нужно либо установить пакет perl-file-mimeinfo, либо выбрать другой инструмент открытия ресурсов.

xdg-settings

См. xdg-settings(1).

Ярлык для открытия всех веб-типов MIME с помощью одного приложения:

$ xdg-settings set default-web-browser firefox.desktop

Ярлык для установки приложения по умолчанию для схемы URL:

$ xdg-settings set default-url-scheme-handler irc xchat.desktop

Советы и рекомендации

Обработчики URL схем

Для установки приложений по умолчанию для URL схем необходимо определить приложение по умолчанию для x-scheme-handler/* MIME-типов.

$ xdg-mime default firefox.desktop x-scheme-handler/https x-scheme-handler/http