xdg-desktop-menu - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

xdg-desktop-menu - інструмент командного рядка для (де)інсталяції елементів меню робочого столу

СИНТАКСИС

xdg-меню робочого столу встановити [--noupdate] [--продавець] [--режим режим] файл(и) каталогу
файл(и) робочого столу

xdg-меню робочого столу видалити [--noupdate] [--режим режим] файл(и) каталогу файл(и) робочого столу

xdg-меню робочого столу примусове оновлення [--режим режим]

xdg-меню робочого столу {--допомога | --посібник | -- версія}

ОПИС

Програму xdg-desktop-menu можна використовувати для встановлення нових пунктів меню на робочому столі
меню програми.

Меню програми працює відповідно до специфікації меню робочого столу XDG за адресою
http://www.freedesktop.org/wiki/Specifications/menu-spec

КОМАНДИ

встановлювати
Встановіть одну або кілька програм у підменю системи меню робочого столу.

робочий стіл-файл: файл робочого столу являє собою один пункт меню в меню. Файли робочого столу
визначаються специфікацією запису для робочого столу freedesktop.org. Найбільш важливим
аспекти файлів *.desktop наведено нижче.

Пункти меню можна додати до системи меню двома різними способами. Вони можуть бути
додано до попередньо визначеного підменю в системі меню на основі однієї або кількох категорій
ключові слова, або їх можна додати до нового підменю.

Щоб додати пункт меню до попередньо визначеного підменю, файл робочого столу, який представляє меню
запис має містити запис Categories=, який містить одне або кілька ключових слів. Пункт меню
буде включено у відповідне підменю на основі включених ключових слів.

Щоб додати пункти меню до нового підменю, перед файлами робочого столу має бути а
каталог-файл, що описує підменю. Якщо вказано кілька файлів робочого столу,
всі записи будуть додані до одного меню. Якщо в меню встановлено записи
було створено з попереднім викликом до xdg-меню робочого столу записи будуть
встановлюється на додаток до будь-яких уже існуючих записів.

каталог-файл: файл каталога *., позначений каталог-файл представляє підменю.
Файл каталогу містить назву та піктограму для підменю. Ім'я каталогу
файл використовується для ідентифікації підменю.

Якщо надано декілька файлів каталогів, кожен файл представлятиме підменю в межах
меню, яке йому передує, створюючи вкладену ієрархію меню (підменю). Меню
самі записи будуть додані до останнього підменю.

Файли каталогу відповідають синтаксису, визначеному Freedesktop.org Desktop Entry
Специфікація.

деінсталяція
Видаліть програми або підменю з системи меню на робочому столі, раніше встановленої за допомогою
xdg-меню робочого столу встановлювати.

Підменю та пов’язаний файл каталогу видаляються лише тоді, коли підменю більше не працює
містить будь-які пункти меню.

примусове оновлення
Примусово оновити систему меню.

Ця команда корисна лише в тому випадку, якщо останній виклик xdg-desktop-menu включав
--noupdate варіант.

ВАРІАНТИ

--noupdate
Відкласти оновлення системи меню. Якщо в системі меню зроблено кілька оновлень
послідовність цей прапор може використовуватися, щоб вказати, що будуть наступні додаткові зміни та
що не потрібно відразу оновлювати систему меню.

--продавець
Зазвичай xdg-desktop-menu перевіряє наявність файлів *.directory та *.desktop
для встановлення має префікс постачальника. Цей параметр можна використовувати, щоб вимкнути цю перевірку.

Префікс постачальника складається з альфа-символів ([a-zA-Z]) і закінчується тире
("-"). Компаніям та організаціям рекомендується використовувати слово або фразу, бажано
назва організації, для якої вони мають торгову марку як префікс постачальника. The
Метою префікса постачальника є запобігання конфліктам імен.

--режим режим
режим може бути користувач or система. У режимі користувача файл (де)інсталюється на поточний момент
тільки користувач. У системному режимі файл (де)інсталюється для всіх користувачів системи.
Зазвичай в системному режимі дозволяється встановлювати тільки root.

За замовчуванням використовувати системний режим при виклику через root і використовувати режим користувача при виклику
користувачем без права root.

--допомога
Показати синопсис команди.

--посібник
Показати цю сторінку посібника.

-- версія
Показати інформацію про версію xdg-utils.

ДЕКСТОП ФАЙЛИ

Пункт програми в меню програми представлений файлом *.desktop. А
Файл *.desktop складається з a [Робочий стіл Вхід] заголовок, а потім кілька ключ=значення лінії

Файл *.desktop може надати ім’я та опис програми в кількох
різними мовами. Це робиться шляхом додавання коду мови, який використовується LC_MESSAGES в
квадратні дужки позаду ключ. Таким чином можна вказати різні значення для одного і того ж ключ
залежно від поточної вибраної мови.

Часто використовуються такі ключі:

Type = додатків
Це обов’язкове поле, яке вказує, що файл *.desktop описує файл
програма запуску.

Name =додаток ІМ'Я
Назва програми. Наприклад Mozilla

GenericName=Загальний ІМ'Я
Загальний опис програми. Наприклад Сайт браузер

Коментар =коментар
Необов’язкове поле для вказівки спливаючої підказки для програми. Наприклад візит веб-сайти on
інтернет

Icon =Іконка філе
Значок, який потрібно використовувати для програми. Це може бути або абсолютний шлях до зображення
файл або ім'я значка. Якщо вказано ім’я значка, виконується пошук зображення за назвою
поточна тема значків користувача. The xdg-icon-resource команду можна використовувати для встановлення
файли зображень у теми піктограм. Перевага використання назви значка замість an
Абсолютний шлях полягає в тому, що за допомогою імені значка можна надати значок програми
кілька різних розмірів, а також у кількох різних тематичних стилях.

Exec=Command Лінія
Командний рядок для запуску програми. Якщо програма може відкривати файли, %f
слід вказати заповнювач. Коли файл скидається на панель запуску програм
%f замінюється на шлях до файлу, що вилучено. Якщо може бути декілька файлів
у командному рядку слід використовувати заповнювач %F замість %f. Якщо
програма може відкривати URL-адреси на додаток до локальних файлів, тоді можна використовувати %u або %U
замість %f або %F.

Категорії=Категорії
Список категорій, розділених крапкою з комою. Категорія – це ключове слово, яке описує
і класифікує додаток. За замовчуванням програми організовані в
меню програми на основі категорії. Коли пункти меню явно призначаються новому
підменю не потрібно перераховувати будь-які категорії.

При використанні категорій рекомендується включати одну з наступних категорій:
Аудіовідео, Розробка, Освіта, Гра, Графіка, Мережа, Офіс, Налаштування, Система,
Утиліта.

Див. Додаток A специфікації меню робочого столу XDG для отримання інформації про додаткові
категорії:
http://standards.freedesktop.org/menu-spec/menu-spec-1.0.html#категорія-реєстр

MimeType =Міметипи
Список типів mime, розділених крапкою з комою. Це поле використовується для вказівки якого
типи файлів, які програма може відкрити.

Повний огляд формату файлу *.desktop див
http://www.freedesktop.org/wiki/Specifications/desktop-entry-spec

ДОВІДНИК ФАЙЛИ

Зовнішній вигляд підменю в меню програми забезпечується файлом *.directory. в
зокрема, він містить назву підменю та можливу піктограму. Файл *.directory
складається з [Робочий стіл Вхід] заголовок, а потім кілька ключ=значення лінії

Файл *.directory може надати назву (ім'я) для підменю в кількох різних варіантах
мови. Це робиться шляхом додавання коду мови, який використовується LC_MESSAGES у квадраті
дужки позаду ключ. Таким чином можна вказати різні значення для одного і того ж ключ
залежно від поточної вибраної мови.

Для підменю актуальні такі клавіші:

Тип=Довідник
Це обов’язкове поле, яке вказує, що файл *.directory описує a
підменю.

Name =Меню ІМ'Я
Назва підменю. Наприклад Mozilla

Коментар =коментар
Додаткове поле для вказівки спливаючої підказки для підменю.

Icon =Іконка філе
Значок для підменю. Це може бути або абсолютний шлях до файлу зображення
або ім'я значка. Якщо вказано ім’я значка, пошук зображення за назвою виконується в
поточна тема значків користувача. The xdg-icon-resource команду можна використовувати для встановлення образу
файли в теми піктограм. Перевага використання назви значка замість абсолютного
шлях полягає в тому, що за допомогою імені значка піктограму підменю можна надати кількома різними
розмірів, а також у кількох різних тематичних стилях.

НАВКОЛИШНЄ СЕРЕДОВИЩЕ ЗМІННІ

xdg-desktop-menu враховує такі змінні середовища:

XDG_UTILS_DEBUG_LEVEL
Установлення цієї змінної середовища на ненульове числове значення створює xdg-desktop-menu
робити докладніші звіти про stderr. Встановлення більшого значення збільшує докладність.

XDG_UTILS_INSTALL_MODE
Ця змінна середовища може використовуватися користувачем або адміністратором для заміни
режим установки. Допустимі значення є користувач та система.

EXIT КОДИ

Код виходу 0 вказує на успіх, а ненульовий код виходу вказує на помилку. The
можна повернути такі коди помилок:

1
Помилка в синтаксисі командного рядка.

2
Один із файлів, переданих у командному рядку, не існував.

3
Не вдалося знайти необхідний інструмент.

4
Акція провалилася.

5
Немає дозволу на читання одного з файлів, переданих у командному рядку.

Використовуйте xdg-desktop-menu онлайн за допомогою служб onworks.net