[devel] RFC: menu policy

[devel] RFC: menu policy

[Igor Vlasenko]

Уважаемые коллеги,
выношу на обсуждение Menu Policy,
описывающее общесистемное меню 0.30 и выше.

http://www.altlinux.org/Menu_Policy

------------------------------------------------------------------------
Menu Policy
Материал из ALT Linux Wiki
Черновик политики Sisyphus
Автор(ы) -- viy@altlinux.org

Содержание

    * 1 общесистемное меню
          o 1.1 Адаптированное общесистемное меню для WM/DE
          o 1.2 Порядок слияния подменю в адаптированном общесистемном
меню для WM/DE
    * 2 Настройка и брендинг общесистемного меню в WM/DE
    * 3 Ссылки

общесистемное меню

    * В системе может быть несколько вариантов общесистемного
меню,выбираемых через альтернативу
/etc/xdg/menus/altlinux-applications.menu.

    * Каждый вариант общесистемного меню должен быть совместим с меню
GNOME по внутренним идентификаторам подменю. Это необходимо для
совместимости со сторонними приложениями.

    * По стандартному пути /etc/xdg/menus/applications.menu находится
неспецифическое (generic) меню по умолчанию, которым может
пользоваться любой WM/DE в отсутствие своего родного меню.

 Адаптированное общесистемное меню для WM/DE

Наличие родных приложений, настроек и т.д. является поводом, чтобы
создать для WM/DE адаптированное общесистемное меню. Рекомендуется
размещать адаптированное меню по пути /etc/xdg/menus/<WM/DE
name>-applications.menu. Чтобы WM/DE нашел свое меню по этому пути
обычно достаточно указать в start<DE>

export XDG_MENU_PREFIX="<WM/DE name>-"

Адаптированное общесистемное меню для WM/DE должно предоставлять
виртуальный пакет <NAME>-freedesktop-menu.

WM/DE должен иметь зависимость на виртуальный пакет
<NAME>-freedesktop-menu. Это позволяет при необходимости установить
для WM/DE вместо имеющегося адаптированного общесистемного меню
произвольное другое меню.

Если с WM/DE в комплекте идет свое оригинальное меню, предлагаемое
разработчиками,то WM/DE должен выносить свое оригинальное меню,
предлагаемое разработчиками, в отдельный подпакет либо вообще
отключать его. Также, WM/DE не должен явно требовать свое оригинальное
меню. Вместо этого он должен иметь зависимость на виртуальный пакет
<NAME>-freedesktop-menu
[править] Порядок слияния подменю в адаптированном общесистемном меню для WM/DE

Адаптированное меню /etc/xdg/menus/<WM/DE name>-applications.menu
должно осуществлять слияние подменю в следующем порядке:

    * явно сливается общесистемное меню
/etc/xdg/menus/altlinux-applications.menu, выбираемое через
альтернативу.

    * явно сливается общесистемный каталог подменю
/etc/xdg/menus/applications-merged

    * накладываются настройки меню, описанные собственно в адаптированном меню

    * явно сливается личный каталог подменю для WM/DE, обычно
/etc/xdg/menus/<WM/DE name>-applications-merged. Исключение -- KDE4,
где в качестве персонального каталога подменю используется каталог
/etc/xdg/kde4/menus/applications-merged.

    * явно сливается файл настроек пользователя applications-menueditor.menu

    * явно сливается файл настроек пользователя <WM/DE
name>-applications-menueditor.menu

Настройка и брендинг общесистемного меню в WM/DE

Настройка и брендинг общесистемного меню в WM/DE осуществляется с
помощью специальных меню, содержащих команды редактирования меню в
соответствии со стандартом, имеющих расширение .menu и размещаемых
следующим образом:

    * системные настройки, действующие на все WM/DE, должны
размещаться в общесистемном каталоге подменю
/etc/xdg/menus/applications-merged.

    * системные настройки, специфические для конкретного WM/DE, должны
размещаться в персональном каталоге подменю для конкретного WM/DE,
обычно /etc/xdg/menus/<WM/DE name>-applications-merged. Исключение --
KDE4, где в качестве персонального каталога подменю используется
каталог /etc/xdg/kde4/menus/applications-merged.

    * настройки пользователя,действующие на все WM/DE, должны
размещаться в файле
$XDG_CONFIG_HOME/menus/applications-menueditor.menu.

    * настройки пользователя для конкретного WM/DE должны размещаться
в файле $XDG_CONFIG_HOME/menus/<WM/DE
name>-applications-menueditor.menu.


Системные настройки меню требуют прав root. Они выполняются
администратором системы либо идут в комплекте с дистрибутивом (в виде
пакетов branding-*, подготовленных релиз-менеджером дистрибутива).

Для выполнения настроек пользователя не требуются ни права root, ни
знание синтаксиса файлов .menu. Достаточно отредактировать меню в
редакторе меню anakondi или kmenueditor и при необходимости вручную
переименовать файл $XDG_CONFIG_HOME/menus/applications-menueditor.menu
в файл $XDG_CONFIG_HOME/menus/<WM/DE
name>-applications-menueditor.menu.

Re: [devel] RFC: menu policy

[Sergey V Turchin]

[-- Attachment #1: Type: Text/Plain, Size: 961 bytes --]

On Thursday 05 May 2011 17:48, Igor Vlasenko wrote:

[...]
>     * Каждый вариант общесистемного меню должен быть совместим с
>     меню GNOME
нужно пояснить, что это и где взять

>     по 
>     внутренним идентификаторам подменю.
нужно пояснить, что это и где взять

[...]
>     * настройки пользователя,действующие на все WM/DE, должны
> размещаться в файле
> $XDG_CONFIG_HOME/menus/applications-menueditor.menu.
> 
>     * настройки пользователя для конкретного WM/DE должны размещаться
> в файле $XDG_CONFIG_HOME/menus/<WM/DE
> name>-applications-menueditor.menu.
Здесь наверняка будет проблема.
Путь может изменяться прямо в процессе редактирования пункта меню в 
зависимости от опций. Или если пункт был загружен из файла без префикса, то 
уже с обоими файлами придется работать, если сохранять этот самый пункт уже c 
префиксом нужно.

Лучше оставить 1 файл и на откуп пользователю.

[...]

-- 
Regards, Sergey.       ALT Linux, http://www.altlinux.ru/

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [devel] RFC: menu policy

[Igor Vlasenko]

[...]
>     * Каждый вариант общесистемного меню должен быть совместим с
>     меню GNOME
нужно пояснить, что это и где взять

>     по внутренним идентификаторам подменю.
нужно пояснить, что это и где взять

сделано

Re: [devel] RFC: menu policy

[Igor Vlasenko]

[...]
> >     * настройки пользователя,действующие на все WM/DE, должны
> > размещаться в файле
> > $XDG_CONFIG_HOME/menus/applications-menueditor.menu.
> >
> >     * настройки пользователя для конкретного WM/DE должны размещаться
> > в файле $XDG_CONFIG_HOME/menus/<WM/DE
> > name>-applications-menueditor.menu.
> Здесь наверняка будет проблема.
> Путь может изменяться прямо в процессе редактирования пункта меню в
> зависимости от опций. Или если пункт был загружен из файла без префикса,
да

> то уже с обоими файлами придется работать, если сохранять этот самый пункт уже c
> префиксом нужно.

Я имел в виду, что если надо, руками переименует:
------------------------------------------------------------------------------------------------------------
Для выполнения настроек пользователя не требуются ни права root, ни
знание синтаксиса файлов .menu. Достаточно отредактировать меню в
редакторе меню anakondi или kmenueditor и при необходимости вручную
переименовать файл $XDG_CONFIG_HOME/menus/applications-menueditor.menu
в файл $XDG_CONFIG_HOME/menus/<WM/DE
name>-applications-menueditor.menu.
-------------------------------------------------------------------------------------------------------------

> Лучше оставить 1 файл и на откуп пользователю.

Это само собой останется. Что же касается именованных файлов,
это только для продвинутых пользователей, которые, например, $HOME в git хранят
и на разных машинах пользуются разными DE.

Т.е. никто ими пользоваться не заставляет, но иметь такую возможность
кажется полезным.

Re: [devel] RFC: menu policy

[Sergey V Turchin]

[-- Attachment #1: Type: Text/Plain, Size: 261 bytes --]

On Thursday 05 May 2011 21:46, Igor Vlasenko wrote:

[...]
> Я имел в виду, что если надо, руками переименует:
Там написано "должны"; policy для мантейнера.
Т.е. максимум -- "рекомендуется".

[...]

-- 
Regards, Sergey.       ALT Linux, http://www.altlinux.ru/

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [devel] RFC: menu policy

[Igor Vlasenko]

> Я имел в виду, что если надо, руками переименует:
Там написано "должны"; policy для мантейнера.
Т.е. максимум -- "рекомендуется".

сделано.

Re: [devel] RFC: menu policy

[Sergey V Turchin]

[-- Attachment #1: Type: Text/Plain, Size: 288 bytes --]

On Thursday 05 May 2011 17:48, Igor Vlasenko wrote:

[...]
>     * Каждый вариант общесистемного меню должен быть совместим с меню
> GNOME по внутренним идентификаторам подменю.
А почему именно с GNOME, а не shallow ?

[...]

-- 
Regards, Sergey.       ALT Linux, http://www.altlinux.ru/

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [devel] RFC: menu policy

[Sergey V Turchin]

[-- Attachment #1: Type: Text/Plain, Size: 423 bytes --]

On Friday 06 May 2011 17:02, Sergey V Turchin wrote:
> On Thursday 05 May 2011 17:48, Igor Vlasenko wrote:
> 
> [...]
> 
> >     * Каждый вариант общесистемного меню должен быть совместим с меню
> > 
> > GNOME по внутренним идентификаторам подменю.
> 
> А почему именно с GNOME, а не shallow ?
Да. И о какой несовместимости сторонних приложений речь?

> [...]

-- 
Regards, Sergey.       ALT Linux, http://www.altlinux.ru/

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [devel] RFC: menu policy

[Igor Vlasenko]

> Да. И о какой несовместимости сторонних приложений речь?

вписал:
Это необходимо для совместимости со сторонними приложениями, которые
добавляют несколько приложений, собранных в приватное подменю.

Поясню еще на примере. У нас runawfe вставляет подменю Runa WFE:
/etc/xdg/menus/applications-merged/runawfe.menu:
[...]
<Menu>
    <Name>Applications</Name>
    <Menu>
        <Name>Office</Name>
        <Menu>
            <Name>Runa WFE</Name>
[...]

чтобы это сработало, в системном меню нужны <Name>Applications</Name>
и <Name>Office</Name>

> А почему именно с GNOME, а не shallow ?

апстримы о нашем shallow меню не имеют понятия.
GNOME -- стандарт де-факто.

Re: [devel] RFC: menu policy

[Michael Shigorin]

On Thu, May 05, 2011 at 04:48:00PM +0300, Igor Vlasenko wrote:
> выношу на обсуждение Menu Policy

Прочёл, поправил запятые и формулировки (предполагая отсутствие
изменения смысла), вроде нормально.

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

Re: [devel] RFC: menu policy

[Sergey V Turchin]

[-- Attachment #1: Type: Text/Plain, Size: 330 bytes --]

On Friday 06 May 2011 18:49, Igor Vlasenko wrote:

[...]
> > А почему именно с GNOME, а не shallow ?
> апстримы о нашем shallow меню не имеют понятия.
> GNOME -- стандарт де-факто.
Тогда почему бы shallow не сделать совместимым с меню GNOME по этим 
идентификаторам?

-- 
Regards, Sergey.       ALT Linux, http://www.altlinux.ru/

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [devel] RFC: menu policy

[Igor Vlasenko]

On Thu, May 05, 2011 at 04:48:00PM +0300, Igor Vlasenko wrote:
> Уважаемые коллеги,
> выношу на обсуждение Menu Policy,
> описывающее общесистемное меню 0.30 и выше.
> 
> http://www.altlinux.org/Menu_Policy
-------------------------------------
Обсуждение проведено, замечания внесены,
пора помечать как действующее полиси.

-- 

Dr. Igor Vlasenko
--------------------
Topology Department
Institute of Math
Kiev, Ukraine