Branding: различия между версиями

Материал из ALT Linux Wiki
м (→‎Состав: викификация)
м (→‎Советы и секреты: спасибо Ивану Хахаеву)
 
(не показано 8 промежуточных версий 3 участников)
Строка 46: Строка 46:
Обычно состоит из пакетов:  
Обычно состоит из пакетов:  
; branding-<название дистрибутива>-alterator
; branding-<название дистрибутива>-alterator
: стили оформление программы установки и Центра управления системой (Alterator), включая значки этапов
: стили оформление программы установки и Центра управления системой ([[alterator]]), включая значки этапов
; branding-<название дистрибутива>-bootloader
; branding-<название дистрибутива>-bootloader
: оформление меню загрузки с диска и загрузчика ОС (lilo или grub)
: оформление меню загрузки с диска и загрузчика ОС ([[lilo]] или [[grub]])
; branding-<название дистрибутива>-bootsplash
; branding-<название дистрибутива>-bootsplash
: оформление экрана прогресса загрузки (Plumouth)
: оформление экрана прогресса загрузки ([[plymouth]])
; branding-<название дистрибутива>-graphics
; branding-<название дистрибутива>-graphics
: обои, аватары и логотипы
: обои, аватары и логотипы
Строка 63: Строка 63:
; branding-<название дистрибутива>-slideshow
; branding-<название дистрибутива>-slideshow
: изображения для слайдшоу при установке
: изображения для слайдшоу при установке
; branding-<название дистрибутива>-xfce-settings
; branding-<название дистрибутива>-*-settings
: параметры среды по умолчанию
: параметры среды по умолчанию


Строка 135: Строка 135:


=== [[Branding/slideshow|branding-*-slideshow]] ===
=== [[Branding/slideshow|branding-*-slideshow]] ===
; slideshow/*.{jpg,png,gif}
; slideshow/*.{svg,jpg,png,mng,gif}
: картинки 650x300 для слайдов в процессе установки
: картинки до 830x380 для слайдов в процессе установки


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


== Сообщения об ошибках ==
== Сообщения об ошибках ==
[https://bugzilla.altlinux.org/buglist.cgi?query_format=advanced&classification=Development&product=Sisyphus&component=^%28branding|design%29-.*%24&component_type=regexp&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailassigned_to2=1&emailreporter2=1&emailqa_contact2=1&emailcc2=1&chfieldto=Now&cmdtype=doit&order=Reuse%20same%20sort%20as%20last%20time Существующие]; [https://bugzilla.altlinux.org/show_bug.cgi?id=22482 метабаг]
[https://bugzilla.altlinux.org/buglist.cgi?query_format=advanced&classification=Development&product=Sisyphus&component=^%28branding|design%29-.*%24&component_type=regexp&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailassigned_to2=1&emailreporter2=1&emailqa_contact2=1&emailcc2=1&chfieldto=Now&cmdtype=doit&order=Reuse%20same%20sort%20as%20last%20time Существующие]; [[altbug:22482|метабаг]]


== Советы и секреты ==
== Советы и секреты ==
Обратите внимание на то, что в [http://git.altlinux.org/people/cas/packages/?p=branding.git наработках cas@] уделено заметное внимание вычистке дублирующихся изображений; собственный вариант брендинга есть смысл начинать именно от его веток <tt>branding-school-*</tt>.


=== Обои по умолчанию ===
=== Обои по умолчанию ===
Строка 207: Строка 208:


Не упаковывайте файл {{path|/etc/skel/.kde4/share/config/plasmarc}} — это может привести к пустому рабочему столу Plasma. Виджеты и прочие элементы по умолчанию настраиваются через каталоги {{path|/usr/share/kde4/apps/plasma-desktop/init}} и {{path|/usr/share/kde4/apps/plasma/layout-templates}}.
Не упаковывайте файл {{path|/etc/skel/.kde4/share/config/plasmarc}} — это может привести к пустому рабочему столу Plasma. Виджеты и прочие элементы по умолчанию настраиваются через каталоги {{path|/usr/share/kde4/apps/plasma-desktop/init}} и {{path|/usr/share/kde4/apps/plasma/layout-templates}}.
=== Переключение в профиле сборки дистрибутива ===
В [[mkimage-profiles]] реализована фича <tt>branding</tt>, которая смотрит в переменную <tt>BRANDING</tt>; получив ошибку сборки вроде
E: Couldn't find package branding-alt-sisyphus-release
-- попробуйте для проверки передать {{cmd|make}} параметр вроде <tt>BRANDING=alt-starterkit</tt>, а в профиле можно выставить так:
        @$(call set,BRANDING,alt-starterkit)
=== Фон загрузчика GRUB ===
Для получения графического меню загрузчика GRUB2 в live-варианте нужен файл boot.png с разрешением 800х600 и цветовой схемой sRGB IEC61966-2.1.


== Примечания ==
== Примечания ==

Текущая версия от 14:34, 26 августа 2024


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

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

Изменение всех 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)

Фон загрузчика GRUB

Для получения графического меню загрузчика GRUB2 в live-варианте нужен файл boot.png с разрешением 800х600 и цветовой схемой sRGB IEC61966-2.1.

Примечания

  1. 30M уже слишком много, 24M работает; с 26M пока неясно