Icon Paths Policy

Политика упаковки пиктограмм. 3-я редакция.

Данная политика относится к упаковке пиктограмм, на которые ссылаются файлы меню оконных менеджеров.

Пиктограммы в .menu/.desktop-файлах

В .menu-файлах (Debian menu, старый формат) пиктограмма указывается параметром icon="icon.file". Значением параметра должно быть имя файла с пиктограммой с расширением, но без пути к файлу, либо (не рекомендуется) полный путь к файлу.

В .desktop-файлах (freedesktop.menu, текущий формат) пиктограмма указывается параметром Icon=iconfile. Значением параметра должно быть имя иконки: имя файла с пиктограммой, но без расширения. Допускается, но не рекомендуется, указание имени с расширением или полного пути к файлу с пиктограммой.

Ссылки на пиктограмму из .menu/.desktop-файлов должны указывать на пиктограмму, упакованную по этой политике, и находящуюся либо в пакете с .menu/.desktop-файлом, либо в пакете, от которого зависит данный.

.menu/.desktop-файлы могут не ссылаться на пиктограммы вообще.

Формат пиктограмм

Допустимые форматы пиктограмм: растровые — PNG, XPM, векторый — SVG. Пиктограммы в других форматы должны быть либо сконвертированы в эти, либо выкинуты при упаковке.

Именование пиктограмм

Имена файлов пиктограмм должны иметь расширения в нижнем регистре: .png, .xpm, .svg для соответствующих типов.

Упаковка пиктограмм

Обязательна упаковка растровой пиктограммы размера 48x48.

Растровые пиктограммы других размеров и векторная пиктограмма рекомендуются к упаковке при наличии.

При наличии PNG и XPM пиктограмм одинакового размера можно не упаковывать XPM-пиктограмму (исправив .desktop/.menu файл при необходимости).

Расположение и размеры пиктограмм

Приложение может содержать как «общие» пиктограммы, так и пиктограммы для определённых «тем».

«Общие» пиктограммы

Должны упаковываться как пиктограммы темы hicolor.

Для упаковки пиктограмм размеров 16x16, 32x32, 48x48 имеются стандартные макросы

%_miconsdir/ (mini,  16x16) [/usr/share/icons/hicolor/16x16/apps]
%_niconsdir/ (normal,32x32) [/usr/share/icons/hicolor/32x32/apps]
%_liconsdir/ (large, 48x48) [/usr/share/icons/hicolor/48x48/apps]

Использование /usr/share/pixmaps не рекомендуется

Согласно freedesktop.org, эта папка может использоваться как синоним %_liconsdir. Однако некоторое время назад стихийно возникла практика использовать /usr/share/pixmaps как свалку для пиктограмм разного размера, что есть плохо.

Допускается, но не рекомендуется, упаковка пиктограмм размера 48×48 в /usr/share/pixmaps.

Вместо этого рекомендуется перемещать все такие пиктограммы 48×48 в %_liconsdir.

Крайне не рекомендуется упаковка пиктограмм в /usr/share/pixmaps, размеров, отличных от размера 48×48. Как исключение, допускается наличие пиктограмм других размеров, если это единственная пиктограмма для приложения.

Пиктограммы определённой «темы»

Векторные пиктограммы должны располагаться в директории /usr/share/icons/<тема>/scalable/apps.

Растровые пиктограммы должны располагаться в директориях /usr/share/icons/<тема>/WWxHH/apps, где WW и HH — ширина и высота пиктограммы в пикселях.

История изменений

Первая редакция

Действие: до Мастера 2.4 включительно.

Требовала наличие пиктограмм 3-х размеров (16x16, 32x32, 48x48) расположенных в /usr/share/icons{,/mini,/large} .

Эти пути были совместимы со старым Debian и старым Mandrake. Устарели после принятия стандарта freedesktop.org.

Миграция с Первой редакции

Необходимо изменить пути (желательно, используя макросы) согласно следующей таблицы.

Старый путь	Новый путь	Старый макрос	Новый макрос
/usr/share/icons/mini	/usr/share/icons/hicolor/16x16/apps	%_miconsdir	%_miconsdir
/usr/share/icons	/usr/share/icons/hicolor/32x32/apps	%_iconsdir	%_niconsdir
/usr/share/icons/large	/usr/share/icons/hicolor/48x48/apps	%_liconsdir	%_liconsdir

Вторая редакция

Действие: бранч 4.0-4.1.

отличалась только требованием наличия пиктограмм 3-х размеров: 16x16, 32x32, 48x48. Теперь, начиная с Третьей редакции, достаточно иметь только одну пиктограмму.

Миграция с Второй редакции

Не требуется. Пакеты, соответствующие Второй редакции, удоволетворяют и Третьей редакции.

Ссылки

Нормативные:

• fd.o Icon Theme Specification

Ненормативные:

• HOWTO по упаковке пиктограмм