Branding

Пакеты branding

Пакеты branding-бренд-дистрибутив содержат в себе по возможности всю дистрибутивоспецифичную информацию (графику, настройки и тексты). Исходный git-репозиторий находится в git.alt boyarsh@ (обратите внимание на набор бранчей).

Минимальная адаптация состоит в замене нескольких констант в spec-файле: например, для Lite:

%define theme lite
%define Theme Lite
%define codename none
%define brand altlinux
%define Brand ALT Linux

%define variants ...

%define status альфа
%define status_en alpha
%define distro_name ALT Linux Lite (alpha)
%define distro_name_ru Альт Линукс Лёгкий (альфа)

При желании можно поменять картинки (потребуются 800x600 и 1920x1080). Но по крайней мере в текстах почти везде в качестве имени дистрибутива, версии и производителя будут введённые вами значения.

Внимание! Нелатинские буквы должны (например, в %define status) должны идти сильно ниже заголовка по требованию rpmbuild. Поэтому в начале следует %define variants с большим объёмом текста

Примечание: Непустой статус (%define status) отрисовывается на обоях. Чтобы сделать его пустым, укажите

%define status %nil
%define status_en %nil

Некоторые ресурсы могут попадать в несколько подпакетов, некоторые предназначены для целевой укладки.

Политика конфликтов

Чтобы не было конфликтов по именам файлов, необходимо объявить возможные варианты брендингов для каждого подпакета:

%define variants altlinux-backup-server altlinux-desktop altlinux-gnome-desktop altlinux-kdesktop \
altlinux-lite altlinux-lxdesktop altlinux-office-desktop altlinux-office-server altlinux-school-server altlinux-sisyphus \
altlinux-spt altlinux-tablet altlinux-workbench informika-schoolmaster ivk-chainmail lxde-desktop lxde-school-lite \
Platform6-server-light school-junior school-lite school-master school-server school-teacher school-terminal simply-linux \
sisyphus-server-light

Далее в подпакетах (например, для bootloader) прописывается:

Conflicts: %(for n in %variants ; do [ "$n" = %brand-%theme ] || echo -n "branding-$n-bootloader ";done )

Состав

Обычно состоит из пакетов:

branding-<название дистрибутива>-alterator

стили оформление программы установки и Центра управления системой (alterator), включая значки этапов

branding-<название дистрибутива>-bootloader

оформление меню загрузки с диска и загрузчика ОС (lilo или grub)

branding-<название дистрибутива>-bootsplash

оформление экрана прогресса загрузки (plymouth)

branding-<название дистрибутива>-graphics

обои, аватары и логотипы

branding-<название дистрибутива>-indexhtml

титульная страница дистрибутва со ссылками

branding-<название дистрибутива>-menu

пункты меню (если используется настраиваемое меню)

branding-<название дистрибутива>-notes

лицензионный договор и примечания к выпуску (показываются в конце установки)

branding-<название дистрибутива>-release

название дистрибутива (обычно с кодовым именем) в /etc/redhat-release

branding-<название дистрибутива>-slideshow

изображения для слайдшоу при установке

branding-<название дистрибутива>-*-settings

параметры среды по умолчанию

Типичная насыщенность изображений деталями: bootloader <= installer <= wallpaper (в любом случае перебарщивать ни к чему).

branding-*-bootloader

images/boot.png

первая картинка, которую увидит пользователь при загрузке образа или установленной системы. Автоматически ужимается до размера 800x600.

components/bootloader/gfxboot.cfg.in или bootloader/gfxboot.cfg.in

значение theme в секции [base] должно соответствовать тому, куда в подпакете branding-*-bootsplash укладываются файлы (/boot/splash/%theme)

Внимание! gfxboot (см. тж. здесь) весьма привередлив по части вариаций сжатия и прочего; см. скрипты zerg@ во избежание чёрной картинки под загрузочным меню вместо images/boot.jpg (который становится back.jpg перед попаданием в cpio-архив bootlogo). Известно, что grub не переваривает PNG с индексированным цветом.

Для того, чтобы для grub установить цвет полосы выделения (он может быть задан в теме grub только изображением), выполните в branding (пример), допустим, для цвета #0c2c6c:

convert -size 16x16 -define png:color-type=2 -depth 8 xc:'#0c2c6c' components/grub2/selected_blob_c.png

Расположение элементов и их цвета задаются в components/bootloader/gfxboot.cfg.in. Наиболее важные:

Название параметра	Описание
mainmenu.bar.color	Цвет фона полосы выделения
mainmenu.normal.fg	Цвет текста неактивного пункта меню
mainmenu.selected.fg	Цвет текста выделенного пункта меню
bootopt.label.fg	Цвет надписи параметров ядра
bootopt.text.fg	Цвет текста в поле параметров ядра
progress.bar.color	Цвет полосы прогресса загрузки ядра
panel.title.fg	Цвет надписи функциональной клавиши внизу
panel.normal.fg	Цвет значения функциональной клавиши внизу
panel.f-key.fg	Цвет функциональной клавиши внизу

branding-*-bootsplash

bootsplash/images/silent-*.jpg (если присутствуют, а не генерируются)

картинки для отображения в процессе загрузки установленной системы (для разных разрешений фреймбуфера; начинать стоит либо с дефолтного 800x600, либо с наиболее высокого из поддерживаемых — уменьшать проще)
Внимание: bootsplash «переваривает» не всякие jpeg, при проблемах попробуйте сжать другим инструментом
Внимание: plymouth не поддерживает jpeg и принимает png, но будьте осторожны с размером — слишком большой full.cz может привести к проблемам загрузки на UEFI, при проблемах включайте indexed color и/или понижайте разрешение (например, с 1920x1080 до 1600x900).

Подпакет должен содержать Provides: plymouth(system-theme) во избежание излишнего вытягивания, скажем, plymouth-theme-fade-in.

branding-*-graphics

альтернатива /usr/share/design/current; для совместимости могут быть альтернативы

• /usr/share/artworks
• /usr/share/design-current

фоновый рисунок: /usr/share/design/current/backgrounds/default.png

NB: для kde4 разрешение background.png и название каталога под graphics/kde4/ksplash-themes/Default/ должны соответствовать друг другу!

branding-*-indexhtml

components/indexhtml/*

содержание и оформление страницы по умолчанию для браузеров

branding-*-release

/etc/altlinux-release (%_sysconfdir/altlinux-release), генерируемый в branding.spec.

branding-*-notes

notes/*.html*

лицензионное соглашение, примечания к дистрибутиву, домашняя страница по умолчанию

branding-*-slideshow

slideshow/*.{svg,jpg,png,mng,gif}

картинки до 830x380 для слайдов в процессе установки

Примечание: Если не хотите показа слайд-шоу, удалите все графические файлы и создайте текстовый файл любого содержимого (хоть пустой).

Сборка

Во время сборки запускается скрипт configure, которому передаются параметры для подстановки:

%build
autoconf
THEME=%theme NAME='%name' BRAND_FNAME='%brand' BRAND='%brand' STATUS_EN=%status_en STATUS=%status \
VERSION=%version PRODUCT_NAME_RU='%distro_name_ru' PRODUCT_NAME='%distro_name' CODENAME='%codename' X86='%x86' \
./configure 
make

Примечание: Значения, которые могут содержать пробелы должны обязательно указываться в одинарных кавычках

Подстановка значений

Перечень подставляемых значений и файлы, где осуществляется подстановка описываются в файле configure.ac. По традиции файлы, в которых осуществляется подстановка, имеют суффикс .in, который во время подстановки удаляется.

Сначала описываются все переменные подстановки, например,

AC_SUBST(NAME)

Затем все файлы, где будут сделаны подстановки всех заявленных переменных (без суффикса .in), но будут обработаны именно файлы Makefile.in и так далее:

AC_CONFIG_FILES([
		 Makefile
		 components/bootloader/config
		 components/bootsplash/theme.plymouth
		 ...
])

В указанных файлах с расширением .in подстановочные значения указываются в виде @ИМЯ_ПЕРЕМЕННОЙ@. Например, так:

NAME=@NAME@

Настройки

Пакеты из серии *-settings-* содержат в себе настройки по-умолчанию, которые делают пользовательские окружения более удобными в работе и/или затачивают их под какую-нибудь задачу. В идеале настройки не должны производиться через /etc/skel-каталог, т.к. тогда они будут влиять только на новых пользователей и их нельзя будет централизованно сменить.

Более подробно настройки описываются далее:

• xfce-settings-*

Изменение всех branding-*

Изменения, которые хочется видеть во всех branding-*, надо делать в бранче master и потом мержить в другие бранчи. Писать по поводу принятия полезных вещей в апстрим стоит boyarsh@; при существенных изменениях стоит предварительно обсудить в devel-distro@ (подписывает mike@).

Отключение в инсталяторе

С версии installer-1.4.11-alt1 введена опция загрузки nodesign; см. тж. tests/ в mkimage-profiles-desktop.

Сообщения об ошибках

Существующие; метабаг

Советы и секреты

Обратите внимание на то, что в наработках cas@ уделено заметное внимание вычистке дублирующихся изображений; собственный вариант брендинга есть смысл начинать именно от его веток branding-school-*.

Обои по умолчанию

Обои по умолчанию должны быть сохранены в файле /usr/share/design/current/backgrounds/default.png. Этот путь из темы формируется альтернативой:

install -d %buildroot//etc/alternatives/packages.d
cat >%buildroot/etc/alternatives/packages.d/%name-graphics <<__EOF__
%_datadir/design-current        %_datadir/design/%theme $GRAPHICS_ALTPRIO
%_datadir/design/current        %_datadir/design/%theme $GRAPHICS_ALTPRIO
__EOF__
...
%files graphics
%config /etc/alternatives/packages.d/%name-graphics

Значки на рабочий стол

Для KDE4

Поместите файл .desktop в %_datadir/kde4/apps/kio_desktop/DesktopLinks/

Пустой экран в KDE4

Не упаковывайте файл /etc/skel/.kde4/share/config/plasmarc — это может привести к пустому рабочему столу Plasma. Виджеты и прочие элементы по умолчанию настраиваются через каталоги /usr/share/kde4/apps/plasma-desktop/init и /usr/share/kde4/apps/plasma/layout-templates.

Переключение в профиле сборки дистрибутива

В mkimage-profiles реализована фича branding, которая смотрит в переменную BRANDING; получив ошибку сборки вроде

E: Couldn't find package branding-alt-sisyphus-release

-- попробуйте для проверки передать make параметр вроде BRANDING=alt-starterkit, а в профиле можно выставить так:

        @$(call set,BRANDING,alt-starterkit)