Текст и значения

Кит.Заголовок()src/Классы/холст/Кит.os

Заголовок первого-шестого уровня. Уровень — не оформление, а место в оглавлении
страницы, поэтому он задаётся числом, а не видом. Вид словом: «имя» (имя объекта в его
карточке) | "" (без оформления).

Параметры:
 Уровень - Число - от 1 до 6.
 Р1…Р8   - ЭлементЭкрана, Строка - (необязательные) текст заголовка; строка — текст.

Возвращаемое значение:
 ЭлементЭкрана

Кит.Надпись()src/Классы/холст/Кит.os

Надпись — кусок строки со своей ролью в ней. Вид словом: «название» | «пояснение»
| «сноска» | «приглушённая» | «ключ» (имя настройки) | «приписка» (мелкая строка под
значением) | «заголовок» и «лид» (две первые строки врезки) | «метка» (подпись поля,
собранного вручную) | «учётка» (имя вошедшего в шапке страницы) | "" (без оформления).

Параметры:
 Р1…Р8 - ЭлементЭкрана, Строка - (необязательные) содержимое; строка — текст.

Возвращаемое значение:
 ЭлементЭкрана

Кит.Примечание()src/Классы/холст/Кит.os

Примечание мелким шрифтом. Холст: примечание бывает и со ссылкой, и с машинным
значением внутри. Без содержимого не печатается вовсе. Вид словом: «описание»
(описание в карточке объекта) | «источник» (откуда взято значение) | «пусто» (список
ничего не нашёл) | "" (приглушённый абзац).

Параметры:
 Р1…Р8 - ЭлементЭкрана, Строка - (необязательные) содержимое; строка — текст.

Возвращаемое значение:
 ЭлементЭкрана

Кит.Ссылка()src/Классы/холст/Кит.os

Ссылка. Холст: внутрь кладут текст, машинное значение или картинку. Адрес недопустимой
схемы ссылкой не станет — содержимое останется видимым, кликабельным оно не будет.
Вид словом: «пилюля» (ссылка-пилюля в ряду взаимоисключающих) | «пилюля-текущая» (она
же, выбранная) | «знак» (ход на главную со знаком инсталляции) | «шапка» (ход в ряду
шапки страницы) | "" (обычная).

Параметры:
 Адрес - Строка - URL.
 Р1…Р8 - ЭлементЭкрана, Строка - (необязательные) содержимое; строка — текст.

Возвращаемое значение:
 ЭлементЭкрана

Кит.Текст()src/Классы/холст/Кит.os

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

Параметры:
 Значение - Произвольный - текст.

Возвращаемое значение:
 ЭлементЭкрана

Кит.Код()src/Классы/холст/Кит.os

Машинное значение моноширинным шрифтом: имя, адрес, ключ. Вид словом: «блочный»
(образец в несколько строк, переносы сохраняются) | «приглушённый» (значение, которое
не спорит с соседним текстом) | "" (значение внутри строки текста).

Параметры:
 Значение   - Произвольный - текст (экранируется).
 Устаревший - Неопределено - не задаётся: вид кода теперь словом Вид(…).

Возвращаемое значение:
 ЭлементЭкрана

Кит.Шаблон()src/Классы/холст/Кит.os

Шаблон — текст с местами %1…%N, которые занимают дети узла в порядке добавления.
Текст экранируется, дети печатаются разметкой: так фраза остаётся цельной строкой
для перевода, а вставки в неё собираются деревом.

Параметры:
 Образец - Строка - текст с местами %1…%N.
 Р1…Р8   - ЭлементЭкрана, Строка - (необязательные) вставки по порядку мест.

Возвращаемое значение:
 ЭлементЭкрана

Кит.Картинка()src/Классы/холст/Кит.os

Картинка. Пустой адрес не даёт битого изображения — узел печатается пустой строкой.
Подпись узла становится alt, подсказка — title: картинка без подписи декоративна.
Вид словом: «значок» (внешняя картинка размером со значок) | «значок-малый» (тот же
значок при строке текста) | «превью» (показ загруженного изображения) | «знак» (знак
инсталляции в шапке) | "" (без оформления).

Параметры:
 Адрес      - Строка - адрес картинки.
 Устаревший - Неопределено - не задаётся: вид картинки теперь словом Вид(…).

Возвращаемое значение:
 ЭлементЭкрана

ЭлементЭкрана.Высота()src/Классы/холст/ЭлементЭкрана.os

Задаёт высоту картинки в пикселях: место под неё занято до того, как приедет лист
стилей, и страница не прыгает.

Параметры:
 Пикселей - Число - высота.

Возвращаемое значение:
 ЭлементЭкрана - этот же элемент.

ЭлементЭкрана.Ширина()src/Классы/холст/ЭлементЭкрана.os

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

Параметры:
 Пикселей - Число - ширина.

Возвращаемое значение:
 ЭлементЭкрана - этот же элемент.

Кит.Проза()src/Классы/холст/Кит.os

Проза — чужой документ, который деревом не собирается никогда: README пакета, справка,
отрисованная из Markdown. Кит сам санитизирует его при печати (html-sanitizer, профиль
markdown-вывода: абзацы, заголовки, списки, ссылки, картинки, код, таблицы, details,
зачёркнутое и галки списка задач GitHub — как профиль oscript-md) —
скрипт, обработчики событий и опасные адреса в страницу не попадут; уже чистый HTML
печатается как есть. Оформление — вид «проза»: блоки кода, таблицы и картинки документа
в цветах кита (дев-сборка 10). Подсветку кода ставят рядом узлом Кит.Скрипт().Модуль(…).

Параметры:
 Html - Строка - HTML документа (недоверенный: санитизирует кит).

Возвращаемое значение:
 ЭлементЭкрана - узел рода «проза».

Кит.Готовое()src/Классы/холст/Кит.os

⚠ Костыль перехода: готовый кусок разметки, собранный не деревом. Существует ради того,
чтобы переводить экраны по одному, и на виду у ревью: узел ничего не экранирует.

Параметры:
 Разметка - Строка - ДОВЕРЕННЫЙ HTML: экранированием занят тот, кто его собрал.

Возвращаемое значение:
 ЭлементЭкрана