icewm-menu-fdo(1)

ИМЯ

 icewm-menu-fdo - генератор меню из .desktop файлов

СИНОПСИС

icewm-menu-fdo [OPTIONS] [FILENAME]

ОПИСАНИЕ

icewm-menu-fdo генерирует меню для диспетчера окон IceWM из XDG описателей меню (или FreeDesktop.Org .desktop файлов). При включении этой команды в icewm-menu(1), системные приложения станут доступными в стартовом меню icewm.

АРГУМЕНТЫ

[FILENAME]

Дополнительный аргумент FILENAME это положение .desktop файла. Когда он задан, icewm-menu-fdo запустит приложение с использованием строки "Exec" из .desktop файла.

ПАРАМЕТРЫ

-g, --generic

Включить общее название в круглых скобках в заголовки записей программ.

--seps

Напечатать передний и задний разделители.

--sep-before

Напечатать передний разделитель.

--sep-after

Напечатать задний разделитель.

--no-sub-cats

Не размещать подкатегории во вложенных меню. Правильность размещения зависит от правильности описания приложения, в котором всегда должна быть указана основная категория. Неправильно помеченные описания будут отсортированы в меню "Другие".

-o, --output=FILE

Записать вывод в FILE.

-t, --terminal=NAME

Использовать NAME чтобы запустить эмулятор терминала, поддерживающий параметр '-e'.

-s, --no-lone-app

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

-S, --no-lone-hint

Дополнить записи приложений, перемещенные с помощью опции -s, подсказками об исходных меню, в которых они отображались бы в противном случае. Подразумевает -s.

-d TIMEOUT, --deadline-apps=TIMEOUT

Определить некоторое значение времени в миллисекундах, чтобы чтение файлов *.desktop (для приложений) прерывалось после его истечения. Это может помочь избежать длительного ожидания ответа на вызов. См. также следующую операцию -D.

-D TIMEOUT, --deadline-all=TIMEOUT

Указать общее время ожидания в миллисекундах, по истечении которого icewm-menu-fdo должно завершиться, независимо от того, было ли сформировано меню и оформление (применяется после чтения файла *.desktop) или нет. Это приведет к выводу содержимого меню, которое было рассчитано на данный момент, поэтому это время следует установить до фактического крайнего срока, к которому программа должна быть завершена. В выводимых данных может не быть переводов и значков.

-l LANGUAGE, --lang=LANGUAGE

Вместо переменной окружения "LANG" использовать LANGUAGE для перевода.

-L MAX, --limit-max-len=MAX

Обрезать вычисленные строки названий программ (после перевода и добавления подсказок, см. "-C" и "-g") до "MAX" символов с последующими многоточиями. Это может помочь ограничить ширину меню в случаях, когда некоторые записи получаются слишком длинными.

--flat

Показать приложения из всех категорий на одном уровне, с заголовками, содержащими информацию о категориях в качестве префикса.

-F sep, --flat-sep="sep"

При использовании с "--flat", определяет последовательность символов, которая используется как разделитель между секциями заголовка.

-m filter, --match=filter

Определить фильтр для показа только приложений, которые содержат его как подстроку внутри своего заголовка.

-M filter, --imatch=filter

Как "--match", но применяется с любым регистром символов. С некоторыми настройками локали может привести к некорректным результатам.

--match-sec

Применяет фильтр от "--match" или "--imatch" как к приложениям, так и к заголовкам секций.

--match-osec

Применяет фильтр от "--match" или "--imatch" только к заголовкам секций.

-h, --help

Напечатать краткую справку об использовании на stdout и выйти.

-V, --version

апечатать версию программы на stdout и выйти.

-C, --copying

Напечатать разрешения на копирование для программы на stdout и выйти.

ИСПОЛЬЗОВАНИЕ

Эта утилита обычно не используется сама по себе. Она предназначена для выполнения в записи menuprog в icewm-menu(5).

ПРИМЕРЫ

Следующая строка в файле icewm-menu(5) будет динамически генерировать комплексный набор меню для лёгкого доступа к .desktop файлам, добавив в меню вызов "Desktop Apps".

    menuprog "Desktop Apps" folder icewm-menu-fdo

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

    includeprog icewm-menu-fdo --seps

ОКРУЖЕНИЕ

XDG_DATA_HOME или XDG_DATA_DIRS рассматриваются как рекомендованные XDG Base Directory Specification.

TERMINAL может определить эмулятор терминала, поддерживающий параметр '-e'. Параметр игнорируется, если заданная команда не будет найдена и вместо этого используется значение по умолчанию.

СООТВЕТСТВИЕ С

icewm-menu-fdo примерно соответствует "XDG .desktop file and menu specification", см. "Desktop Entry Specification" (Дата: 2020-04-27, Версия: Version 1.5) и "Desktop Menu Specification" (Дата: 20 August 2016, Версия: Version 1.1).

ПРЕДОСТЕРЕЖЕНИЯ

Программа icewm-menu-fdo собирается только когда пакет icewm(1) сконфигурирован с параметром --enable-menus-fdo и работает только с параметром --enable-i18n.

Интеграция файлов XDG-menu несколько меняется по качеству, во многом это зависит от правильности метаданных, таких как переводы и секции (категории меню) подсказок.

СМ. ТАКЖЕ

Base Directory Specification, Desktop Entry Specification, Desktop Menu Specification, icewm(1), icewm-menu(5), icewm-preferences(5), icewm-programs(5).

ОШИБКИ

Пожалуйста, сообщайте об ошибках на <https://github.com/ice-wm/icewm/issues>.

АВТОР

Eduard Bloch <edi@gmx.de>.

См. --copying для полного уведомления об авторских правах и разрешений на копирование.

ПЕРЕВОД

Перевод данного текста на русский язык, а также поддержка пакета программного обеспечения icewm в ALTLinux Dmitriy Khanzhin <jinn@altlinux.org>.

ЛИЦЕНЗИЯ

IceWM лицензирован под GNU Library General Public License. См. файл COPYING в комплекте поставки или используйте флаг --copying, чтобы показать разрешения на копирование.