Total Kontrol/TKT/Стандарт именования изображений
Для удобства разработки, редактирования и переноса веб-интерфейсов и их фрагментов все файлы изображений должны иметь имена в соответствии с данным стандартом. Имя файла должно состоять из ряда человеко-понятных идентификаторов, разделённых точками. Идентификаторы должны быть, с одной стороны, короткими (чтобы не перегружать XML), с другой - имеющими однозначный смысл. Поскольку большинство видимых элементов является кнопками, для них должно присутствовать как минимум 2 изображения: нажатое и отжатое состояние, соответственно, последний идентификатор должен указывать на состояние, представленное данным изображением. Стандартных состояний три:
- prs - нажато;
- rls - отжато;
- un - недоступно.
Таким образом, имя изображения для некоей нажатой кнопки должно выглядеть как btn.prs.png. Не запрещается использование любых других имён файлов, но вследствие их большого количества даже в сравнительно простом веб-интерфейсе их бессистемное именование может вызвать путаницу. Кроме того, рекомендуется хранить изображения в интуитивно-понятной иерархии папок.
Рекомендуется следующее дерево папок в папке /img:
- back - фоновые изображения;
- bt - кнопки:
- kbd - кнопки цифровой клавиатуры;
- mode - кнопки выбора режима работы конференц-системы;
- popup - кнопки для всплывающих окон;
- pwr - кнопки управления питанием;
- setup - кнопки, специфические для страницы настроек;
- icn - пиктограммы, отличаются тем что имеют только одно видимое состояние;
- obs - основная тёмная тема "Obsidian", набор пиктограмм в трёх состояниях:
- arr - стрелки навигации;
- fad - изображения для фейдеров;
- surf - пиктограммы, "стоящие" на зеркальной поверхности;
- wht - белые пиктограммы;
- pan - панели, заголовки и т. п.;
- text - текстовые надписи в виде изображений.
Чтобы не множить количество папок, допускается внутри одной папки группировать изображения первым идентификатором. Например, в стандартном наборе /img/bt/pwr имена файлов кнопок, управляющие освещением, начинаются на "lt": lt.hall.prs.png - нажатое состояние для кнопки, включающей освещение зала.