Icon Paths Policy

Материал из ALT Linux Wiki

(Различия между версиями)
Перейти к: навигация, поиск
(→Использование /usr/share/pixmaps)
Строка 1: Строка 1:
{{Policy|since_branch=4.0|responsible=Игорь Власенко|metabug=repocop icon_path тест статус}}
{{Policy|since_branch=4.0|responsible=Игорь Власенко|metabug=repocop icon_path тест статус}}
{{викифицировать}}
{{викифицировать}}
-
 
+
{{span|font-size: 180%|Политика упаковки пиктограмм}}
-
== Политика упаковки пиктограмм ==
+
-
 
+
-
__TOC__
+
Данная политика относится к упаковке пиктограмм, на которые ссылаются файлы меню оконных менеджеров.
Данная политика относится к упаковке пиктограмм, на которые ссылаются файлы меню оконных менеджеров.
-
=== Ссылки ===
+
== Ссылки ==
-
 
+
Нормативные:
Нормативные:
* [[Policy/MenuFiles|Политика упаковки файлов для меню оконных менеджеров]]
* [[Policy/MenuFiles|Политика упаковки файлов для меню оконных менеджеров]]
Строка 16: Строка 12:
* [[IconsPackaging|HOWTO по упаковке пиктограмм]]
* [[IconsPackaging|HOWTO по упаковке пиктограмм]]
-
=== Пиктограммы в .menu/.desktop-файлах ===
+
== Пиктограммы в .menu/.desktop-файлах ==
-
 
+
В <tt>.menu</tt>-файлах (Debian menu, старый формат) пиктограмма указывается параметром <tt>icon="icon.file"</tt>. Значением параметра должно быть имя файла с пиктограммой с расширением, но без пути к файлу, либо (не рекомендуется) полный путь к файлу.
В <tt>.menu</tt>-файлах (Debian menu, старый формат) пиктограмма указывается параметром <tt>icon="icon.file"</tt>. Значением параметра должно быть имя файла с пиктограммой с расширением, но без пути к файлу, либо (не рекомендуется) полный путь к файлу.
Строка 26: Строка 21:
<tt>.menu</tt>/<tt>.desktop</tt>-файлы могут не ссылаться на пиктограммы вообще.
<tt>.menu</tt>/<tt>.desktop</tt>-файлы могут не ссылаться на пиктограммы вообще.
-
=== Формат пиктограмм ===
+
== Формат пиктограмм ==
-
 
+
Допустимые форматы пиктограмм: растровые — PNG, XPM, векторый — SVG. Пиктограммы в других форматы должны быть либо сконвертированы в эти, либо выкинуты при упаковке.
-
Допустимые форматы пиктограмм: растровые - PNG, XPM, векторый - SVG. Пиктограммы в других форматы должны быть либо сконвертированы в эти, либо выкинуты при упаковке.
+
-
 
+
-
=== Именование пиктограмм ===
+
 +
== Именование пиктограмм ==
Имена файлов пиктограмм должны иметь расширения в нижнем регистре: <tt>.png</tt>, <tt>.xpm</tt>, <tt>.svg</tt> для соответствующих типов.
Имена файлов пиктограмм должны иметь расширения в нижнем регистре: <tt>.png</tt>, <tt>.xpm</tt>, <tt>.svg</tt> для соответствующих типов.
-
=== Упаковка пиктограмм ===
+
== Упаковка пиктограмм ==
-
 
+
Обязательна упаковка растровой пиктограммы размера 48x48. Растровые пиктограммы других размеров и векторная пиктограмма рекомендуются к упаковке при наличии.
Обязательна упаковка растровой пиктограммы размера 48x48. Растровые пиктограммы других размеров и векторная пиктограмма рекомендуются к упаковке при наличии.
При наличии PNG и XPM пиктограмм одинакового размера можно не упаковывать XPM-пиктограмму (исправив <tt>.desktop</tt>/<tt>.menu</tt> файл при необходимости).
При наличии PNG и XPM пиктограмм одинакового размера можно не упаковывать XPM-пиктограмму (исправив <tt>.desktop</tt>/<tt>.menu</tt> файл при необходимости).
-
=== Расположение и размеры пиктограмм ===
+
== Расположение и размеры пиктограмм ==
-
 
+
Приложение может содержать как «общие» пиктограммы, так и пиктограммы для определённых «тем».
-
Приложение может содержать как "общие" пиктограммы, так и пиктограммы для определённых "тем".
+
-
 
+
-
==== "Общие" пиктограммы ====
+
 +
=== «Общие» пиктограммы ===
Упаковываются как пиктограммы темы <tt>hicolor</tt>.
Упаковываются как пиктограммы темы <tt>hicolor</tt>.
-
Для упаковки питограмм размеров 16x16, 32x32, 48x48 имеются стандартные макросы
+
Для упаковки пиктограмм размеров 16x16, 32x32, 48x48 имеются стандартные макросы
<pre>
<pre>
%_miconsdir/ (mini,  16x16) [/usr/share/icons/hicolor/16x16/apps]
%_miconsdir/ (mini,  16x16) [/usr/share/icons/hicolor/16x16/apps]
Строка 55: Строка 45:
</pre>
</pre>
-
==== Использование /usr/share/pixmaps ====
+
=== Использование /usr/share/pixmaps ===
 +
Согласно freedesktop.org, эта папка может использоваться как синоним %_liconsdir. Однако некоторое время назад стихийно возникла практика использовать {{path|/usr/share/pixmaps}} как свалку для пиктограмм разного размера, что есть плохо.
-
Согласно freedesktop.org, эта папка может использоваться как синоним %_liconsdir. Однако
+
'''Допускается''', но не рекомендуется, упаковка пиктограмм размера 48x48 в {{path|/usr/share/pixmaps}}.
-
некоторое время назад стихийно возникла практика использовать {{path|/usr/share/pixmaps}} как свалку
+
-
для пиктограмм разного размера, что есть плохо.
+
-
 
+
-
'''Допускается''', но не рекомендуется, упаковка питограмм размера 48x48 в {{path|/usr/share/pixmaps}}.
+
Вместо этого рекомендуется перемещать все такие пиктограммы 48x48 в %_liconsdir.
Вместо этого рекомендуется перемещать все такие пиктограммы 48x48 в %_liconsdir.
-
Крайне не рекомендуется упаковка питограмм в {{path|/usr/share/pixmaps}}, размеров, отличных от размера 48x48.
+
Крайне не рекомендуется упаковка пиктограмм в {{path|/usr/share/pixmaps}}, размеров, отличных от размера 48x48. При наличии пиктограммы 48x48 требуется перемещать такие пиктограммы в подкаталоги {{path|/usr/share/icons/hicolor/}}.
-
При наличии пиктограммы 48x48 требуется перемещать такие пиктограммы в подкаталоги {{path|/usr/share/icons/hicolor/}}.
+
-
 
+
-
==== Пиктограммы определённой "темы" ====
+
 +
=== Пиктограммы определённой «темы» ===
Векторные пиктограммы должны располагаться в директории <tt>/usr/share/icons/<тема>/scalable/apps</tt>.
Векторные пиктограммы должны располагаться в директории <tt>/usr/share/icons/<тема>/scalable/apps</tt>.
-
Растровые пиктограммы должны располагаться в директориях <tt>/usr/share/icons/<тема>/WWxHH/apps</tt>, где WW и HH - ширина и высота пиктограммы в пикселях.
+
Растровые пиктограммы должны располагаться в директориях <tt>/usr/share/icons/<тема>/WWxHH/apps</tt>, где WW и HH — ширина и высота пиктограммы в пикселях.

Версия 15:30, 6 марта 2009

Stamp90cw.png
Действующая политика Sisyphus

Политика действует, начиная со стабильного бранча 4.0 и выше.

Ответственный за проведение политики в жизнь — Игорь Власенко.

Нарушения политики отслеживаются: repocop icon_path тест статус


42px-Wikitext-ru.svg.png
Эту статью следует викифицировать.

Политика упаковки пиктограмм

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

Содержание

Ссылки

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

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

Пиктограммы в .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 как свалку для пиктограмм разного размера, что есть плохо.

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

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

Крайне не рекомендуется упаковка пиктограмм в /usr/share/pixmaps, размеров, отличных от размера 48x48. При наличии пиктограммы 48x48 требуется перемещать такие пиктограммы в подкаталоги /usr/share/icons/hicolor/.

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

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

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

 
Личные инструменты