Desktop Menu Entry Policy: различия между версиями

Версия от 23:42, 11 апреля 2011

Черновик политики Sisyphus

Автор(ы) — viy@

Обсуждается с 10.04.2011

Общие требования

.desktop файл должен быть оформлен в соответствии с Desktop Entry Specification
.desktop файл, не предназначенный для установки в меню (например, чистый обработчик mime-type), должен иметь Hidden=true.
.desktop файл, предназначенный для установки в меню, должен иметь заполненным поле Categories.
.в поле Categories обязательно должна быть указана одна главная (Main) категория из списка Registered Categories и одна вторичная (Secondary).

Замечание: для проверки .desktop файлов используется стандартная утилита desktop-file-validate. Однако, код проверки категорий реализован там недостаточно хорошо, поэтому к сообщениям этой утилиты нало относиться с рассуждением. Если вывод утилиты кажется вам ошибочным, сообщайте, это, возможно,баг.

Также, иногда может быть тяжело поместить приложение в меню, используя только стандартные категории. В таком случае, можно обсудить с майнтейнерами системного freedesktop menu поддержку дополнительной пользовательской категории, начинающейся на X-. Например, X-EducationTools.

Требует решения в freedesktop policy

Известные примеры, когда стандартная утилита desktop-file-validate, судя по всему, ошибается. Подобные случаи надо решать с апстримом desktop-file-utils.

warn    mova-mueller7-1.2-alt2.qa3.noarch       desktop-file-validate utility exited abnormally with the following message(s): 
/usr/share/applications/mova-mueller7.desktop: error: (will be fatal in the future): value "TextTools" in key "Categories" 
in group "Desktop Entry" requires another category to be present among the following categories: Utility;

Документация

Для добавления в меню документации не рекомендуется использовать Type=Link, так как не все меню отображают его корректно. Вместо этого рекомендуется воспользоваться Type=Application и в поле Exec открыть нужный документ с помощью url_handler.sh:

[Desktop Entry]
Version=1.0
Type=Application
Name=GNU Documentation
Comment=Manuals and other non-technical ducuments (html format, in Russian) from GNU Project
Icon=howto
Exec=url_handler.sh /usr/share/doc/doc-gnu-ru/HTML/index.html
Categories=Development;Documentation;

теоретически, надо пользоваться xdg-open, но пока этому мешают баги #25413.

@@ Строка 8: / Строка 8: @@
 * .desktop файл должен быть оформлен в соответствии с [http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html Desktop Entry Specification]
+* .desktop файл, не предназначенный для установки в меню (например, чистый обработчик mime-type), должен иметь Hidden=true.
+* .desktop файл, предназначенный для установки в меню, должен иметь заполненным поле {{term|Categories}}.
+* .в поле {{term|Categories}} обязательно должна быть указана одна главная (Main) категория из списка [http://standards.freedesktop.org/menu-spec/menu-spec-latest.html#category-registry Registered Categories] и одна вторичная (Secondary).
+Замечание: для проверки .desktop файлов используется стандартная утилита desktop-file-validate. Однако, код проверки категорий реализован там недостаточно хорошо, поэтому к сообщениям этой утилиты нало относиться с рассуждением. Если вывод утилиты кажется вам ошибочным, сообщайте, это,
+возможно,баг.
+Также, иногда может быть тяжело поместить приложение в меню, используя только стандартные категории. В таком случае, можно обсудить с майнтейнерами
+системного freedesktop menu поддержку дополнительной пользовательской категории, начинающейся на X-. Например, X-EducationTools.
 === Требует решения в freedesktop policy ===
-warn    mova-mueller7-1.2-alt2.qa3.noarch       desktop-file-validate utility exited abnormally with the following message(s): /usr/share/applications/mova-mueller7.desktop: error: (will be fatal in the future): value "TextTools" in key "Categories" in group "Desktop Entry" requires another category to be present among the following categories: Utility;
+Известные примеры, когда стандартная утилита desktop-file-validate, судя по всему, ошибается.
+Подобные случаи надо решать с апстримом {{pkg|desktop-file-utils}}.
+ warn    mova-mueller7-1.2-alt2.qa3.noarch       desktop-file-validate utility exited abnormally with the following message(s):
+ /usr/share/applications/mova-mueller7.desktop: error: (will be fatal in the future): value "TextTools" in key "Categories"
+ in group "Desktop Entry" requires another category to be present among the following categories: Utility;
 === Документация ===