Просмотр исходного текста страницы Grub2 (руководство по созданию темы)

<span style="font-size: 300%">'''Grub2 2.00'''</span>
<br>
В необъятных просторах всемирной паутины я не нашёл рукодства по созданию тем для GRUB2, в котором бы были показаны значения всех опций на конкретных примерах. А хочется, чтобы при создании темы результат соответствовал ожиданиями с точностью до пикселя. Поэтому, изучив исходники, я решил написать такое руководство.
Цель документа - дать читателю представление о всех возможностях графического оформления, объяснить ограничения и особенности, предоставить схему для построения темы, в точности соответствующей ожидаемому результату.


='''С чего начать'''=

Итак, мы хотим создать собственную тему. Пойдём по порядку.

=='''создание директории'''==

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

Рекомендуется создать под-директорию в <tt>/boot/grub2/themes/</tt>

(здесь и далее - предполагаем, что загрузчик установлен в директорию <tt>/boot/grub2/</tt>)

Пусть это будет директория <tt>/boot/grub2/themes/test/</tt>

=='''создание тектового файла'''==

В созданной директории необходимо создать главный файл темы.

Рекомендуется назвать файл <tt>theme.txt</tt>.

Итак, мы создали файл <tt>/boot/grub2/themes/test/theme.txt</tt>

(Здесь и далее - <tt>theme.txt</tt> или главный файл темы)

=='''параметр <tt>GRUB_THEME</tt> в <tt>/etc/default/grub</tt>'''==

Для того, чтобы загрузчик переключился на нашу тему, нужно прописать

в файле <tt>/etc/default/grub</tt> параметр <tt>GRUB_THEME</tt>.

Или, проще говоря, добавить строчку <tt>GRUB_THEME=/boot/grub2/themes/test/theme.txt</tt>.

После знака "<tt>=</tt>" нужно прописать абсолютный путь к главному файлу темы.

Если в <tt>/etc/default/grub</tt> уже есть строчка вида <tt>GRUB_THEME=...</tt>,

то её нужно привести к виду <tt>GRUB_THEME=/boot/grub2/themes/test/theme.txt</tt>.

Не должно быть двух строк для одного и того же параметра.

=='''файл конфигурации загрузчика <tt>/boot/grub2/grub.cfg</tt>'''==

До тех пор, пока мы не перегенерируем файл конфигурации загрузчика, наши изменения не вступят в силу.

Обычно в системе есть скрипт <tt>update-grub2</tt>, который необходимо запустить с правами <tt>root</tt>.

Если такого скрипта нет, то нужно выполнить (опять же, с правами <tt>root</tt>) команду <tt>grub2-mkconfig -o /boot/grub2/grub.cfg</tt>.

Собственно, <tt>update-grub2</tt> выполняет именно эту команду.

<tt>update-grub2</tt> Необходимо вызывать всякий раз, когда мы вносим изменения в <tt>/etc/default/grub</tt>.

Почти всё, что касается темы Grub2, описано в <tt>theme.txt</tt>. Grub2 парсит этот файл каждый раз при загрузке. А значит, чтобы посмотреть изменения, внесённые в <tt>theme.txt</tt> или в директорию нашей новой темы, достаточно перезагрузиться. <tt>update-grub2</tt> прописывает адрес к главному файлу темы в файл конфигурации загрузчика.

<br>

='''Общие концепции'''=

Для начала ознакомьтесь со [[Тема Grub2 / синтаксис#Структура главного файла | структурой главного файла]].

Каждый параметр имеет определённый тип.

С типами данных можно ознакомиться по следующей ссылке:
[[Тема Grub2 / синтаксис#Типы данных | Типы данных]]

Обратите внимание, что глобальные опции и названия компонентов проверяются. И если допущена ошибка, при загрузке будет отображено сообщение об ошибке. Для параметров компонентов это не работает. Если допущена ошибка, то параметр не будет применён и сообщение об ошибке не будет показано.

=='''Типы элементов'''==
Есть несколько предопределённых типов:

; Корневой элемент
: Верхний уровень <tt>theme.txt</tt>, здесь указываются общие свойства.

; Загрузочное меню (<tt>boot_menu</tt>)
: Основной элемент, здесь указываются свойства меню загрузки.

; Горизонтальный индикатор обратного отсчёта времени (<tt>progress_bar</tt>)
: Отображение времени, оставшегося до загрузки пункта по-умолчанию с помощью горизонтальной полосы и \ или текста.

; Круговой индикатор обратного отсчёта времени (<tt>circular_progress</tt>)
: Отображение времени, оставшегося до загрузки пункта по-умолчанию с помощью круговой анимации.

; Строка (<tt>label</tt>)
: Вывод текстовой строки.

; Изображение (<tt>image</tt>)
: Вывод изображения.

; Вертикальный контейнер (<tt>vbox</tt>)
: Контейнер, элемент, родительский для других элементов. Отображает элементы по очереди сверху вниз по вертикали.

; Горизонтальный контейнер (<tt>hbox</tt>)
: Контейнер, элемент, родительский для других элементов. Отображает элементы по очереди слева направо по горизонтали.

; Канва (<tt>canvas</tt>)
: Контейнер, элемент, родительский для других элементов. Позволяет задать координаты для дочерних элементов.

Корневой элемент - на самом деле, это канва с дополнительными опциями, растянутая на весь экран.

=='''Изображения'''==
Изображения растягиваются до указанных размеров, если указанные размеры больше реального размера изображения. Минимальные значения - реальные размеры изображение.

При выборе фона необходимо учесть эту особенность. Есть различные типы матриц мониторов. На матрице с соотношением сторон 4:3 и на матрице с соотношением сторон 16:9 одно и то же изображение может выглядеть по-разному.

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

За счёт растяжения удобно делать градиентную заливку - можно сделать полоску с градиентом шириной в 1 пиксель.

=='''Оформление элемента'''==
Оформление элемента состоит из 9 зон - центральная, южная, юго-западная, западная и т.д.

4 угловых зоны (северо-западный и т.д.) не подвергаются растяжению.

Западная и восточная зоны - растягиваются по вертикали.

Северная и южная зоны - растягиваются по горизонтали.

Центральная растягивается по горизонтали и по вертикали.

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

=='''Шрифты'''==
Шрифты необходимо создавать с помощью специальной утилиты <tt>grub2-mkfont</tt>. Подробнее в разделе [[#Руководство по созданию шрифтов|"Создание шрифтов"]].

<br>

='''Описание тестовой схемы'''=

=='''элементы оформления'''==
Увеличены в 5 раз для наглядности. Alpha-канал - 75%. (прозрачность)

Тёмно-красный фон - для наглядности.

===графический элемент оформления схемы===

{| class="wikitable" border="1" style="background: #600000;"
|+ inbox_*.png
|-
| [[Image:grub2_guide_inbox_nw.png|25px]] || [[Image:grub2_guide_inbox_n.png|5px]] || [[Image:grub2_guide_inbox_ne.png|25px]]
|-
| [[Image:grub2_guide_inbox_w.png|25px]] || [[Image:grub2_guide_inbox_c.png|5px]] || [[Image:grub2_guide_inbox_e.png|25px]]
|-
| [[Image:grub2_guide_inbox_sw.png|25px]] || [[Image:grub2_guide_inbox_s.png|5px]] || [[Image:grub2_guide_inbox_se.png|25px]]
|}

===графический элемент оформления схемы===
{| class="wikitable" border="1" style="background: #600000;"
|+ button_*.png
|-
| [[Image:grub2_guide_inbox_se.png|25px]] || [[Image:grub2_guide_inbox_s.png|5px]] || [[Image:grub2_guide_button_ne.png|25px]]
|-
| [[Image:grub2_guide_inbox_e.png|25px]] || [[Image:grub2_guide_inbox_c.png|5px]] || [[Image:grub2_guide_inbox_w.png|25px]]
|-
| [[Image:grub2_guide_button_ne.png|25px]] || [[Image:grub2_guide_inbox_n.png|5px]] || [[Image:grub2_guide_inbox_nw.png|25px]]
|}

===оформление меню загрузки===

{| class="wikitable" border="1" style="background: #600000;"
|+ menu_*.png
|-
| [[Image:grub2_guide_inbox_nw.png|25px]] || [[Image:grub2_guide_inbox_n.png|5px]] || [[Image:grub2_guide_menu_ne.png|75px]]
|-
| [[Image:grub2_guide_inbox_w.png|25px]] || [[Image:grub2_guide_inbox_c.png|5px]] || [[Image:grub2_guide_menu_e.png|75px]]
|-
| [[Image:grub2_guide_inbox_sw.png|25px]] || [[Image:grub2_guide_inbox_s.png|5px]] || [[Image:grub2_guide_menu_se.png|75px]]
|}

===фон полосы прокрутки===

{| class="wikitable" border="1" style="background: #600000;"
|+ scrollbar_frame_*.png
|-
| [[Image:grub2_guide_frame_n.png|50px]]
|-
| [[Image:grub2_guide_frame_c.png|50px]]
|-
| [[Image:grub2_guide_frame_s.png|50px]]
|}

===ползунок полосы прокрутки===

{| class="wikitable" border="1" style="background: #600000;"
|+ scrollbar_thumb_*.png
|-
| [[Image:grub2_guide_thumb_n.png|50px]]
|-
| [[Image:grub2_guide_thumb_c.png|50px]]
|-
| [[Image:grub2_guide_thumb_s.png|50px]]
|}

===оформление горизонтального индикатора оставшегося времени===
{| class="wikitable" border="1" style="background: #600000;"
|+ progress_*.png
|-
| [[Image:grub2_guide_progress_c.png|5px]]
|}

=='''изображения'''==

===центральное изображение кругового индикатора оставшегося времени===
{| class="wikitable" border="1" style="background: #600000;"
|+ center.png
|-
| [[Image:grub-guide-circular-center.png]]
|}

===изображение такта для кругового индикатора оставшегося времени===
{| class="wikitable" border="1" style="background: #600000;"
|+ tick.png
|-
| [[Image:grub-guide-circular-tick.png|25px]]
|}

<br>

='''Опции элементов'''=

Подробное описание значений опций со скриншотами и схемами.

<br>

=='''Общие опции'''==
[[Тема Grub2 / синтаксис#Общие свойства для всех объектов | краткое описание]]

<tt>left, top, width, height</tt> - Координаты прямоугольника, содержащего элемент.

<tt>id</tt> - идентификатор. Есть несколько особых значений, которые влияют на поведение некоторых элементов. Использование с другим значениями не приносит никаких бонусов.

<br>

=='''Корневой элемент'''==
[[Тема Grub2 / синтаксис#Глобальные свойства | краткое описание]]

Корневой элемент - элемент, в котором можно задать некоторые глобальные свойства и в котором размещаются все остальные элементы. Является расширенным элементом типа "канва".

Обратите внимание, что в имени глобальных свойств пишется дефис (<tt>"-"</tt>, например <tt>"terminal-box"</tt>), а в свойствах элементов - нижнее подчёркивание (<tt>"_"</tt>, например <tt>"item_height"</tt>). Также обратите внимание, что для глобальных свойств используется разделитель двоеточие (<tt>":"</tt>, например <tt>"title-text: "GNU Grub""</tt>), а для свойств элементов разделителем является знак равенства (<tt>"="</tt>, например <tt>"item_height = 20"</tt>).

===<tt>desktop-color, desktop-image</tt> - фон===
Первое - цвет фона.

Второе - фоновая картинка.

Если задано <tt>desktop-image</tt>, то <tt>desktop-color</tt> не используется.

Картинка должна лежать в директории темы.

Картинка растягивается по размеру экрана.

===<tt>title-text, title-color, title-font</tt> - вид заголовка===
Оформление заголовка. Если мы не хотим его отображать, зададим <tt>title-text=""</tt>.

Текст заголовка всегда будет центрирован по горизонтали и базовая линия шрифта будет отстоять от верхнего края экрана на <tt>40 + подъём</tt> (см [[#Руководство по созданию шрифтов|описание шрифтов]])

 title-text: "Title Text"
 title-color: "#FFFFFF"
 desktop-image: "background.png"

[[Image:grub2-guide-title-ru.png]]

===<tt>terminal-box</tt> - оформление консоли===
Графическое оформление консоли.

Оформление рисуется СНАРУЖИ прямоугольника консоли. Координаты консоли неизменные и прописаны в исходном коде. Их можно изменить патчем. Смотри [[#Перемещение консоли|ниже]].

Обратите внимание, что консоль рисуется поверх центрального элемента с отступом 3 пикселя со всех сторон.

Фон консоли задаётся в <tt>/etc/default/grub</tt>. Подробнее [[#GRUB_BACKGROUND|ниже]].

Изображение для фона консоли должно быть непрозрачным.

По умолчанию вместо центрального элемента будет чёрный экран.

===<tt>terminal-font</tt> - шрифт консоли===
Имя шрифта, используемого в консоли.

После добавления шрифта в директорию темы необходимо перезапустить <tt>update-grub2</tt>.

Подробнее о создании шрифтов в [[#Руководство по созданию шрифтов|разделе о шрифтах]].

 title-text: ""
 desktop-image: "background.png"
 terminal-font: "Droid Sans Mono Regular 11"
 terminal-box: "inbox_*.png"

Здесь и далее - глобальные опции будут в точности такими.

[[Image:grub2-guide-terminal-ru.png]]

===<tt>message-font, message-color, message-bg-color</tt> - не используются===
На текущий момент эти параметры можно задать, но они никак не используются.

<br>

=='''<tt>boot_menu</tt> - меню загрузки'''==
[[Тема Grub2 / синтаксис#Меню загрузки (boot_menu) | краткое описание]]

Основной элемент. Здесь отображается список установленных на компьютере систем и здесь мы выбираем, какую систему мы хотим загрузить.

===<tt>left, top, width, height</tt> - координаты прямоугольника===
Стандартные параметры, не забудьте их указать.

===<tt>item_color, item_font, selected_item_color, selected_item_font</tt> - шрифт и цвет пунктов меню===
Чтобы понимать, какой пункт выбран, нужно его как-то выделить - цветом, шрифтом или оформлением.
<tt>item_color, item_font</tt> - цвет и шрифт неактивных пунктов меню
<tt>selected_item_color, selected_item_font</tt> - цвет и шрифт выбранного пункта

 + boot_menu {
         left = 50%-300
         top = 50%-100
         width = 600
         height = 300
    
         selected_item_color = "#0000FF"
 }

[[Image:grub2-guide-bootmenu-simple-ru.png]]

Подробнее о создании шрифтов в [[#Руководство по созданию шрифтов|разделе о шрифтах]].

===<tt>seleted_item_pixmap_style, item_pixmap_style</tt>  - оформление пунктов===
Оформление рисуется СНАРУЖИ пункта меню.

По умолчанию можно сделать "рамку" только для активного пункта меню.

В ROSA можно сделать оформление для неактивного пунтка.

Обозначим размеры "рамки" выбранного элемента как <tt>pad_left</tt>, <tt>pad_top</tt>, <tt>pad_right</tt>, <tt>pad_bottom</tt>. Полная высота элемента будет <tt>item_height + pad_top + pad_bottom - 1</tt>.

Стоит учесть уменьшение на 1, если мы хотим достичь требуемого размера выбранного пункта.

 + boot_menu {
         left = 50%-300
         top = 50%-100
         width = 600
         height = 300
    
         selected_item_color = "#0000FF"
         selected_item_pixmap_style = "button_*.png"
 }

[[Image:grub2-guide-bootmenu-selected-box-ru.png]]

===<tt>menu_pixmap_style</tt> - оформление меню===
Оформление меню рисуется ВНУТРИ указанного для меню прямоугольника. Размеры оформления учитываются для пунтов меню (пункты меню рисуются в центральной области). Для полосы прокрутки немного сложнее (смотри [[#scrollbar_frame, scrollbar_thumb, scrollbar_width, scrollbar - скроллбар, полоса прокрутки|ниже]]).

===<tt>item_padding</tt> - отступ===
Определяет область прорисовки пунктов меню - прямоугольник внутри центральной области оформления меню (или внутри прямоугольника меню, если не задано оформление меню), с отступом <tt>item-padding</tt> от всех краёв центральной области (или от краёв прямоугольника меню, если не задано оформление меню).

Обратите внимание, что <tt>item_padding</tt> не работает для скроллбара. Если требуется изменить отступы скроллбара, переделайте оформление меню и оформление скроллбара (например, добавьте прозрачных пикселей к соответствующим областям).

===<tt>height, item_height, item_spacing</tt> - расположение элементов===
Расстояние между нижними краями строчек меню (см иллюстрацию) всегда <tt>item_height + item_spacing.</tt>

Стоит учесть, что количество выводимых пунктов меню рассчитывается с учётом "рамки" и <tt>item_padding</tt>, но без учёта <tt>pad_top</tt> и <tt>pad_bottom</tt>. (см иллюстрацию)

<tt>height</tt> нужно рассчитывать по неочевидной формуле. Пусть мы хотим видеть N пунктов. Тогда общую высоту меню нужно выставить равной

<tt>2*item_padding + menu_pad_top + menu_pad_bottom + (N - 1)*(item_height + item_spacing)
+ pad_top + pad_bottom + item_height - 1</tt>

Также стоит учесть, что минимальное число отображённых элементов (N) - это 3.

Если сделать <tt>height</tt> меньше величины, вычисленной по формуле, то при достаточном количестве пунктов меню при выборе самого нижнего в списке элемента его "рамка" будет недорисована. Если выбрать больше, то при выборе самого нижнего элемента нижний край скроллбара не будет соответствовать нижнему краю пункта.

 + boot_menu {
         left = 50%-300
         top = 50%-100
         width = 600
         height = 289
     
         selected_item_color = "#0000FF"
         selected_item_pixmap_style = "button_*.png"
 
         menu_pixmap_style = "inbox_*.png"
 
         item_padding = 20
         
         item_spacing = 20
         item_height = 30
 }
Высота вычислена по формуле.

[[Image:grub2-guide-bootmenu-vertical-scheme.png]]

===<tt>icon-width, icon-height, item_icon_space</tt> - иконки и пространство для них===
По умолчанию,
 icon_width = 32
 icon_height = 32
 item_icon_space = 4

Текст будет дополнительно отступать на <tt>icon_width + item_icon_space</tt> от левого края области рисования пункта.
Проще говоря, место под иконку оставляется независимо от того, есть иконка или нет.

Если это поведение нежелательно, стоит обнулить <tt>icon_width</tt> и выставить нужное значение для <tt>item_icon_space</tt>.

Стоит также учесть, что ширина пунктов меню дополнительно уменьшено на 2 пикселя. Таким образом, справа мы будем иметь дополнительно два пикселя до рамки меню.

Обратите внимание, что символ шрифта может включать пустые пиксели с любой из сторон. Например, в тестовой схеме расстояние от левой "рамки" по умолчанию - 36 (<tt>icon_width + item_icon_space</tt>), но расстояние до первого пикселя буквы - 37.

[[Image:grub2-guide-bootmenu-icon-space.png]]

===Использование иконок===

Для того, чтобы использовать иконки, нужно завести директорию <tt>image</tt> в директории темы.

После этого необходимо поместить в директорию <tt>image</tt> иконки в формате <tt>png</tt> с именем, соответствующим классу.

Список классов по-умолчанию:
* windows > os
* gnu-linux > gnu > os
* osx > darwin > os
* hurd > gnu > os

Слева направо по убыванию важности. Если найдена иконка <tt>windows.png</tt>, то будет отображена она, а не иконка <tt>os.png</tt>.

Также, для основной системы, под которой был установлен Grub2, доступен класс с её именем. (более важный, чем <tt>gnu-linux</tt>).

Например, для системы ROSA класс будет "<tt>rosa</tt>" и тп. Классы можно найти в файле <tt>/boot/grub2/grub.cfg</tt>.

С патчем, применённым в ROSA, подобный класс выводится для остальных установленных на компьютере операционных систем.

===<tt>scrollbar_frame, scrollbar_thumb, scrollbar_width, scrollbar</tt> - скроллбар, полоса прокрутки===

Подробнее про полоску прокрутки.

* Не стоит использовать элементы оформления, отличные от севера, центра и юга для <tt>scrollbar_thumb</tt>.

* Для <tt>scrollbar_frame</tt> можно использовать все 9 областей.

* Добавляя прозрачные пиксели к крайним областям <tt>scrollbar_frame</tt>, можно добиться увеличения отступов от краёв экрана и от пунктов меню загрузки.

* Полоска прокрутки рисуется, начиная от правого края центрального среза. Т.е. если у нас нет оформления меню или в оформлении меню нет восточной части, мы не увидим полоску прокрутки, даже когда она нужна.

* Полоска рисуется только тогда, когда необходима.

* Стоит учесть, что ширина элемента меню уменьшена на 2 пикселя от максимальной. Таким образом расстояние от пунктов меню до скроллбара у нас всегда минимум два пикселя.

* Нужно обязательно указать и <tt>scrollbar_frame</tt>, и <tt>scrollbar_thumb</tt>. Если указан только один из элементов, то скроллбар не будет прорисован.

* Ширина <tt>scrollbar_frame</tt> и <tt>scrollbar_thumb</tt> может быть разной.

* <tt>scrollbar_frame</tt> рисуется в восточной части оформления меню. <tt>scrollbar_thumb</tt> рисуется целиком в центральной части <tt>scrollbar_frame</tt>.

* <tt>scrollbar_width</tt> - ширина скроллбара. А именно, ширина центральной части <tt>scrollbar_frame</tt>. Если сумма <tt>scrollbar_width</tt> и ширин восточной и западной областей <tt>scrollbar_frame</tt> меньше ширины восточной части оформления меню, то не вся полоска будет прорисована.

* Можно задать значение <tt>False</tt> для <tt>scrollbar</tt>. Тогда полоса прокрутки не будет показана. Можно просто не указывать <tt>scrollbar_thumb</tt> и <tt>scrollbar_frame</tt>.

* Как уже говорилось выше, на скроллбар не действует параметр <tt>item_padding</tt>.

В этом примере к "рамке" не добавлены дополнительные пиксели под скроллбар.
 + boot_menu {
        left = 50%-300
        top = 50%-100
        width = 600
        height = 289
         
        selected_item_color = "#0000FF"
        selected_item_pixmap_style = "button_*.png"
         
        menu_pixmap_style = "inbox_*.png"
        
        item_padding = 20
          
        item_height = 30
        item_spacing = 20
         
        scrollbar_thumb = "scrollbar_thumb_*.png"
        scrollbar_frame = "scrollbar_frame_*.png"
        scrollbar_width = 10
 }

Как видим, скроллбар недорисован.

[[Image:grub2-guide-bootmenu-scrollbar-incorrect-menu-box.png]]

В этом примере мы заменили "рамку" меню на специально созданную. Далее используем именно такое описание <tt>boot_menu</tt>.
 + boot_menu {
        left = 50%-300
        top = 50%-100
        width = 600
        height = 289
         
        selected_item_color = "#0000FF"
        selected_item_pixmap_style = "button_*.png"
         
        menu_pixmap_style = "menu_*.png"
        
        item_padding = 20
          
        item_height = 30
        item_spacing = 20
         
        scrollbar_thumb = "scrollbar_thumb_*.png"
        scrollbar_frame = "scrollbar_frame_*.png"
        scrollbar_width = 10
 }

Как видим, теперь скроллбар отображается корректно. Также видим, что <tt>item_padding</tt> не влияет на скроллбар.

[[Image:grub2-guide-bootmenu-scrollbar-menu-box.png]]

===<tt>visible</tt> - не показывать меню загрузки===
Можно задать значение <tt>False</tt> для <tt>visible</tt> - тогда меню загрузки не будет показано. Аналогично, можно не описывать компонент <tt>boot_menu</tt> в главном файле темы.

<br>

=='''<tt>progress_bar</tt> - Горизонтальный индикатор обратного отсчёта времени'''==
[[Тема Grub2 / синтаксис#Horizontal indicator of elapsed time (progress_bar) | краткое описание]]

Этот элемент служит для отображения времени, оставшегося до автоматической загрузки пунта, выделенного по умолчанию.

Изначально прогресс показывается не от начала индикатора.

===<tt>left, top, width, height</tt> - координаты прямоугольника===
Стандартные параметры, не забудьте их задать.

Обратите внимание, что если <tt>width</tt> или <tt>height</tt> будет меньше, чем необходимо для отображения заданного текста, то <tt>width</tt> или <tt>height</tt> будет автоматически увеличено.

===<tt>id</tt> - идентификатор===
Чтобы происходило отображение обратного отсчёта времени (текстом или визуально), необходимо задать предопределённое значение для <tt>id</tt>.
 id = "__timeout__"

===<tt>text</tt> - текст, выводимый на индикаторе===
Текст, выводимый на индикаторе отсчёта времени.
Есть несколько встроенных особых значений. Они имеют особый смысл и переводятся на разные языки.
* @TIMEOUT_NOTIFICATION_SHORT@ для "Nс"
* @TIMEOUT_NOTIFICATION_MIDDLE@ для "осталось Nс."
* @TIMEOUT_NOTIFICATION_LONG@ для "Выделенный пункт будет выполнен автоматически через Nс."
<tt>N</tt> - это количиство секунд до автозапуска пункта по умолчанию. Строка обновляется каждую секунду.
Также можно задать любое значение.

===<tt>text-color, font</tt> - цвет шрифта и шрифт===
Цвет шрифта и шрифт для выводимого на индикаторе текста.

Подробнее о создании шрифтов в [[#Руководство по созданию шрифтов|разделе о шрифтах]].

===Одноцветный режим и режим с оформлением===
Предусмотрены два варианта оформления:
* одноцветный, с заливкой областей фиксированными цветами и однопиксельной рамкой
* с элементам оформления, или "рамочками"
Если использована хотя бы одна опция для оформления с использованием "рамочек", то будет включён второй режим. Иначе используется первый режим.

Подбробнее далее.

===<tt>bg_color, fg_color, border_color</tt> - для одноцветного режима===

 + progress_bar {
         left = 50%-300
         top = 50%+200
         width = 600
         height = 50
        
         id = "__timeout__"
         text = "@TIMEOUT_NOTIFICATION_LONG@"
        
         border_color = "white"
 }

В примере используются значения по умолчанию:
 bg_color = "128, 128, 128"
 fg_color = "200, 200, 200"

[[Image:grub2-guide-progress-bar-mono-ru.png]]

===<tt>bar_style, highlight_style</tt> - для режима с оформлением===
Обратите внимание, что для <tt>highlight_style</tt> рекомендуется использовать элементы оформления, состоящие только из центральной области. Иначе индикатор отсчёта времени будет отображён некорректно.

Обратите внимание, что достаточно использовать одну из опций для включения режима.

 + progress_bar {
         left = 50%-300
         top = 50%+200
         width = 600
         height = 50
        
         id = "__timeout__"
         text = "@TIMEOUT_NOTIFICATION_LONG@"
        
         bar_style = "inbox_*.png"
         highlight_style = "progress_*.png"
 }

[[Image:grub2-guide-progress-bar-styled-ru.png]]

===Убрать оформление===

Чтобы убрать оформление и оставить только текстовую строку, нужно придать одинаковые значения <tt>bar_style</tt> и <tt>highlight_style</tt>.

Значение может быть любым, не обязательно, чтобы оно соответствовало какому-то реальному элементу оформления.

В значении обязательно должен присутствовать символ "<tt>*</tt>".

В примере текст сообщения сделан белым.

 + progress_bar {
         left = 50%-300
         top = 50%+200
         width = 600
         height = 50
        
         id = "__timeout__"
         text = "@TIMEOUT_NOTIFICATION_LONG@"
       
         text_color = "white"
        
         bar_style = "*"
         highlight_style = "*"
 }

[[Image:grub2-guide-progress-bar-only-text-ru.png]]

===<tt>visible</tt> - не показывать горизонтальный индикатор===
Можно задать значение <tt>False</tt>. Тогда индикатор обратного отсчёта времени не будет отображён. Аналогично, можно просто не указывать индикатор в главном файле темы.

<br>

=='''<tt>circular_progress</tt> - Круговой индикатор обратного отсчёта времени'''==
[[Тема Grub2 / синтаксис#Круговой индикатор обратного отсчёта времени (circular_progress) | краткое описание]]

Круговой индикатор обратного отсчёта времени позволяет отобразить графически время, оставшееся до загрузки пункта по умолчанию.

Отображение оставшегося времени идёт путём прорисовки "тактов".

Если не установлена опция <tt>ticks_disappear</tt>, то такты появляются (по кругу, по часовой стрелке), пока не замкнут круг.

Если установлена опция <tt>ticks_disappear</tt>, то такты исчезают.

Всегда рисуется на один такт меньше ожидаемого. Изначально часть тактов может быть прорисована (круговой индикатор начинает заполняться не с нуля).

===<tt>left, top, width, height</tt> - координаты прямоугольника===
Стандартные параметры, не забудьте их задать. Рекомендуются придать ширине и высоте равные значения. Подробнее об особенностях координат прямоугольника смотрите [[#center_bitmap, tick_bitmap - изображения для кругового индикатора | далее]].

===<tt>id</tt> - идентификатор===
Чтобы происходило отображение обратного отсчёта времени, необходимо задать значение для <tt>id</tt>.
 id = "__timeout__"

===<tt>center_bitmap, tick_bitmap</tt> - изображения для кругового индикатора===

Центральное изображение не масштабируется и не поворачивается. Рисуется в центре указанного прямоугольника. Если изображение меньше прямоугольника, то часть изображения не будет отображена.

Изображение для тактов не масштабируется и не поворачивается. Рисуется многократно по окружности, вписанной в указанный прямоугольник.

Рекомендуются квадратные изображения (ширина и высота совпадают).

Вычисления ведутся по ширине элемента и по ширине такта.

Если ширина элемента больше высоты, то часть тактов не будет прорисована.

[[Image:grub-guide-circular-wrongwidth.png]]

Если высота такта будет больше ширины, то такты будут прорисованы некорректно.

[[Image:grub-guide-circular-wrongtickheight.png]]

Рекомендуется сделать ширину такта такой же чётности, как чётность ширины элемента. (только в таком случае можно добиться корректного симметричного отображения)

===<tt>num_ticks, start_angle, ticks_disappear</tt> - параметры кругового индикатора===

<tt>num_ticks</tt> - количество тактов

<tt>start_angle</tt> - стартовый угол (относительно оси <tt>"x"</tt>). Измеряется в "попугаях". Один "попугай" - <tt>1/256</tt> круга. Таким образом, <tt>-90</tt> градусов (или <tt>-&pi;/2</tt>), в "попугаях", будет <tt>-64</tt>.

По причине того, что <tt>tick_bitmap</tt> прорисовается без изменений (не поворачивается, не масштабируется, не изменяется), и в силу того, что углы измеряются в оговоренных "попугаях", рекомендуется задавать для <tt>num_ticks</tt> значения, равные степеням двойки. Таким образом, мы получим более гладкую и симметричную картину.

<tt>ticks_disappear</tt> - по умолчанию такты появляются, пока не замкнут окружность.

[[Image:grub-guide-ticks-appear.png]]

Можно задать для величины <tt>ticks_disappear</tt> значение <tt>True</tt>. Тогда такты будут исчезать, пока не исчезнет последний.

 ticks_disappear = "True"

[[Image:grub-guide-ticks-disappear.png]]

Обратите внимание, что на каждом шаге рисуется на один такт меньше ожидаемого количества.

===Пример===
 + circular_progress {
         left = 50%-450
         top = 50%+310
         id = "__timeout__"
         width = 51
         height = 51
         center_bitmap = "center.png"
         tick_bitmap = "tick.png"
         num_ticks = 8
 }

[[Image:grub-guide-circular.png]]

<br>

=='''<tt>label</tt> - текстовая строка'''==
[[Тема Grub2 / синтаксис#Строка (label) | краткое описание]]

Мы можем отобразить текст с помощью элемента <tt>label</tt>.
Также, задав определённым образом <tt>id</tt> и <tt>text</tt>, мы можем отобразить время, оставшееся до автоматической загрузки пункта по умолчанию.

Обратите внимание, что строки не переносятся. Если текст не помещается в заданный прямоугольник, он пишется правее до конца экрана.

===<tt>left, top, width, height</tt> - координаты прямоугольника===
Стандартные параметры, не забудьте их задать.

Обратите внимание, что <tt>width</tt> используется только для оценки смещения текста, если задан параметр <tt>align</tt> со значениями <tt>"center"</tt> или <tt>"right"</tt>.

Также обратите внимание, что <tt>height</tt> не используется.

===<tt>font, color</tt> - шрифт и цвет шрифта===
Цвет шрифта и шрифт для выводимого на элементе текста.

Подробнее о создании шрифтов в [[#Руководство по созданию шрифтов|разделе о шрифтах]].

===<tt>align</tt> - выравнивание===
Доступны три значения:
* left - выровнять текст по левому краю элемента
* center - выровнять текст по центру элемента
* right - выровнять текст по правому краю элемента

===Отобразить время до автоматической загрузки===
Чтобы происходило отображение обратного отсчёта времени, необходимо задать значение для <tt>id</tt>. И не должен быть указан параметр <tt>text</tt>.
 + label {
         left = 50%-350
         top = 50%+260
         height = 30
         width = 30
        
         id = "__timeout__"
        
         color = "white"
 }

[[Image:grub-guide-label-timeout.png]]

===<tt>text</tt> - отображаемый текст===
Мы можем отобразить любое текстовое сообщение.
Есть несколько особенных значений.
* @KEYMAP_SHORT@ для отображения "«enter»: загрузка, «e»: параметры, «c»: командная строка"
* @KEYMAP_MIDDLE@ для отображения "Нажмите «enter» для загрузки выбранной ОС, «e» для редактирования команд до загрузки или «c» для получения командной строки."
* @KEYMAP_LONG@ для отображения "Нажмите «enter» для загрузки выбранной ОС, «e» для редактирования команд до загрузки или «c» для получения командной строки. По ESC осуществляется возврат в предыдущее меню."

Особенные значения переводятся на выставленный язык.

Обратите внимание, что текст не переносится построчно и не обрезается по ширине.

===Пример с обычным значением параметра <tt>text</tt>===
 + label {
         left = 50%-300
         top = 50%+220
         height = 30
         width = 600
        
         color = "white"
        
         align = "right"
        
         text = "Some text."
 }

[[Image:grub-guide-label-text.png]]

===Пример с особым значением параметра <tt>text</tt>===
 + label {
         left = 50%-300
         top = 50%+220
         height = 30
         width = 600
        
         color = "cyan"
        
         align = "center"
        
         text = "@KEYMAP_SHORT@"
 }

[[Image:grub-guide-label-special.png]]

<br>

=='''<tt>image</tt> - изображение'''==
[[Тема Grub2 / синтаксис#Изображение (image) | краткое описание]]

Мы можем вывести изображение на экран.

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

Если высота или ширина больше реальной высоты или ширины, соответственно, то изображение будет растянуто до указанных размеров.

===<tt>left, top, width, height</tt> - координаты прямоугольника===
Стандартные параметры, не забудьте их задать.

Если мы хотим отобразить изображение не растянутым, мы можем не задавать <tt>width</tt> и <tt>height</tt> - они будут заданы автоматически.

===<tt>file</tt> - путь к файлу===
Полный путь к файлу изображения.

<br>

=='''<tt>vbox</tt> - вертикальный контейнер'''==
[[Тема Grub2 / синтаксис#Вертикальный контейнер (vbox) | краткое описание]]

Контейнер. Элемент, который содержит другие элементы.

===<tt>left, top, width, height</tt> - координаты прямоугольника===
Не забудьте указать <tt>left</tt> и <tt>top</tt>. <tt>height</tt> и <tt>width</tt> указывать не нужно - они всё равно будут переопределены.

===Расположение элементов===

Элементы, содержащиеся в вертикальном контейнере, выводятся последовательно сверху вниз.

Для дочерних элементов не нужно указывать <tt>left</tt> и <tt>top</tt> - эти значения не берутся в расчёт.

Подсчитывается максимум из ширин элементов, содержащихся в вертикальном контейнере, затем всем ширинам элементов и ширине вертикального контейнера задаётся значение этого максимума.

Значения высот дочерних компонентов сохраняются.

 + vbox {
         left = 50%+310
         top = 50%-50
         width = 20
         height = 100
        
 #D1
         + image { left = 50 top = 10 width = 60 height = 60 file = "center.png" }
 #D2
         + image { left = 40 top = 20 width = 70 height = 70 file = "button_n.png" }
 }

[[Image:grub-guide-vbox-layout.png]]

<br>

=='''<tt>hbox</tt> - Горизонтальный контейнер'''==
[[Тема Grub2 / синтаксис#Горизонтальный контейнер (hbox) | краткое описание]]

Контейнер. Элемент, который содержит другие элементы.

===<tt>left, top, width, height</tt> - координаты прямоугольника===
Не забудьте указать <tt>left</tt> и <tt>top</tt>. <tt>height</tt> и <tt>width</tt> указывать не нужно - они всё равно будут переопределены.

===Расположение элементов===

Элементы, содержащиеся в горизонтальном контейнере, выводятся последовательно слева направо.

Для дочерних элементов не нужно указывать <tt>left</tt> и <tt>top</tt> - эти значения не берутся в расчёт.

Подсчитывается максимум из высот элементов, содержащихся в горизонтальном контейнере, затем всем высотам элементов и высоте горизонтального контейнера задаётся значение этого максимума.

Значения ширин дочерних компонентов сохраняются.

===Пример===

 + hbox {
         left = 300
         top = 50%+310
         width = 20
         height = 100
        
 #D1
         + image { left = 50 top = 10 width = 60 height = 60 file = "center.png" }
 #D2
         + image { left = 40 top = 20 width = 70 height = 70 file = "button_n.png" }
 }


[[Image:grub-guide-hbox-layout.png]]

<br>

=='''<tt>canvas</tt> - Канва'''==
[[Тема Grub2 / синтаксис#Канва (canvas) | краткое описание]]

Контейнер. Элемент, который содержит другие элементы. Координаты элементов, содержащихся в контейнере, являются относительными. Таким образом, (0,0) для содержимого контейнера - это координаты верхнего левого угла контейнера.

Корневой элемент является канвой.

===<tt>left, top, width, height</tt> - координаты прямоугольника===
Стандартные параметры, не забудьте их задать.

<br>

='''Особенности'''=

Общие особенности, не относящиеся к конкретному пункту.

=='''Порядок прорисовки элементов'''==

В вертикальном контейнере элементы рисуются сверху вниз, по порядку.

В горизонтально контейнере элементы рисуются слева направо, по порядку.

Элементы, содержащиеся в канве, рисуются в обратном порядке относительно указанного в файле темы. Таким образом, тот элемент который описан в начале файла темы, будет нарисован поверх другого элемента, описанного в конце файла темы.

=='''Область прорисовки элемента'''==

Для каждого элемента определена область прорисовки - с помощью параметров <tt>left</tt>, <tt>top</tt>, <tt>width</tt>, <tt>height</tt>.

Всё, что выходит за рамки области прорисовки - не будет прорисовано.

=='''Минимальный размер элемента'''==

Для каждого элемента подсчитывается минимально допустимая ширина и минимально допустимая высота. Если указанная в файле темы ширина или высота меньше минимальной ширины или высоты (соответственно), то ширина или высота переопределяются.

=='''Если числовые значения принимают недопустимые значение'''==
[[Тема Grub2 / синтаксис#Числовое значение | Описание числовых значений.]]

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

Для удобства назовём ширину и высоту родительского контейнера, соответственно, <tt>parent_width</tt> и <tt>parent_height</tt>.

Если <tt>left</tt> или <tt>top</tt> оказались отрицательными, они приравниваются к 0.

Если <tt>left</tt> + <tt>width</tt> оказывается больше, чем <tt>parent_width</tt>, то <tt>width</tt> приравнивается к <tt>parent_width - left</tt>. Таким образом, правый край будет совпадать с правым краем родительского контейнера.

Если <tt>top</tt> + <tt>height</tt> оказывается больше, чем <tt>parent_height</tt>, то <tt>height</tt> приравнивается к <tt>parent_height - top</tt>. Таким образом, нижний край будет совпадать с нижним краем родительского контейнера.

Эти особенности мы можем использовать для того, чтобы при разных разрешениях у нас было разное взаиморасположение элементов интерфейса.

=='''Подбор символа'''==

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

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

<br>

='''Руководство по созданию шрифтов'''=
[[Тема Grub2 / синтаксис#Шрифт | краткое описание]]

GRUB использует свой собственный формат шрифтов. Эти шрифты можно получить с помощью утилиты <tt>grub2-mkfont</tt>.

После создания шрифта и помещения его в директорию темы, необходимо перезапустить утилиту <tt>grub2-update</tt>, чтобы изменения были приняты.

=='''Создание шрифта c помощью <tt>grub2-mkfont</tt>'''==

GRUB не использует кернинг (изменение межсимвольного расстояния при определённых сочетаниях символов).

Полученный в результате действия утилиты файл обязательно должен иметь расширение <tt>.pf2</tt>

Синтаксис:

<tt>grub2-mkfont INPUT_FONT [дополнительные параметры] -o OUTPUT_FONT</tt>

Полученный файл нужно положить в директорию с главным файлом темы.

=='''Параметры утилиты <tt>grub2-mkfont</tt>'''==

===<tt>--output, -o</tt>===

Обязательный параметр. Имя полученного файла. Должно иметь расширение <tt>.pf2</tt>, чтобы шрифт мог быть прочитан GRUB.

===<tt>--verbose, -v</tt>===

grub2-mkfont DroidSansMono.ttf -o tmp.pf2 -v
 Font name: Droid Sans Mono Regular 16
 Max width: 13
 Max height: 17
 Font ascent: 17
 Font descent: 5
 Number of glyph: 591

Отобразить информацию о созданном шрифте.

Отображает имя, максимальную ширину и высоту, подъём и спуск шрифта, количество символов.

===<tt>--name, -n</tt>===

Задать имя шрифта.

По умолчанию, имя шрифта формируется следующим образом: ИМЯ_ШРИФТА ТИП РАЗМЕР

===<tt>--size, -s</tt>===

Задать размер шрифта в пикселях.

По умолчанию 16.

===<tt>--bold, -b</tt>===

Отображить жирный шрифт.

По умолчанию формируется обычный шрифт.

===<tt>ascent</tt>, <tt>descent</tt> или подъём и спусе шрифта===
[[Image:grub-guide-font-scheme.png]]

 --asce, -c
ascent или подъём шрифта (см схему)

 --desc, -d
descent или спуск шрифта (см схему)

Можно задать эти параметры, если мы хотим получить меньшее \ большее межстрочное расстояние, выровнять базовую линию (baseline на чертеже). Если мы указываем эти параметры вручную, необходимо проследить, чтобы нужные нам символы были отображены полностью.

===Выбрать символы для перекодировки===
Мы можем выбрать только определённую группу символов для перекодировки.

 --ascii-bitmaps
чтобы перекодировать только ascii символы

 --range, -r
чтобы перекодировать выбранный диапазон символов

<br>

='''Параметры, изменяемые вне <tt>theme.txt</tt>'''=

Настройки, прописанные вне главного файла темы.

=='''Файл <tt>/etc/default/grub</tt>'''==

===GRUB_THEME===

Полный путь главного файла темы.

===GRUB_BACKGROUND===

Полный путь фонового изображения консоли. Данный файл должен быть строго непрозразным. Растягивается до размеров консоли (с учётом 3 пикселей рамки)

===LANG и LANGUAGE===

Чтобы задать используемый в GRUB язык, нужно указать оба этих параметра. Значения должны совпадать.

Можно использовать различный синтаксис: <tt>ru</tt>, <tt>ru_RU</tt>, <tt>ru_RU.UTF-8</tt>.

<br>



<br><br>
Владимир Тестов, ROSA, 2013.
[[ru:Grub2 (руководство по созданию темы)]]
[[en:Grub2 theme tutorial]]
[[Категория:Документация]]
[[Категория:Руководства]]