Это пошаговое руководство по быстрому и простому преобразованию классических инфобоксов на вики-разметке в портативные инфобоксы. Некоторые виды классических инфобоксов могут быть слишком экзотичными, чтобы свободно применять к ним эти инструкции, однако эти советы помогут справиться с большинством ситуаций.
Шаг 1. Осмотр[]
Для начала необходимо просмотреть статьи, в которых используется взятый для переноса шаблон. Это можно сделать с помощью страницы Служебная:Ссылки_сюда/Название_шаблона. Изучите внешний вид шаблона в статьях и выясните, выглядит ли он везде одинаково, или его внешний вид разнится от страницы к странице. Отметьте, какие свойства стиля присутствуют на всех страницах (например закруглённые углы, фон или рамка), чтобы в будущем применить их к общему классу всех портативных инфобоксов.
В исходном коде статьи вы можете найти параметры, которые могут задавать шаблону свойства, отличающиеся на разных страницах. Например bgcolor или width. Эти свойства потенциально перейдут в разные темы для инфобокса.
Шаг 2. Копирование дополнительного кода[]
В исходном коде самого шаблона вы найдёте таблицу, до или после которой могут находиться дополнительные теги </noinclude> или </onlyinclude>. Это будет выглядеть так:
{| class="infobox"
… код таблицы
|}
<noinclude>{{documentation}}[[Категория:Инфобоксы]]</noinclude>
Такие теги используются для категоризации шаблонов, не задевая страницы, на которых шаблон используется, или для включения документации. Всё, что находится до и после таблицы, необходимо скопировать в код нового шаблона.
Шаг 3. Перенос макета[]
Из-за разметки классических инфобоксов некоторые параметры могут стоять не по порядку или вовсе быть не предназначенными для отображения. Лучшим решением будет начать двигаться сверху вниз и размещать код в правильном порядке.
Параметры портативных инфобоксов автоматически скрываются, если значение не указано, поэтому дополнительный код для скрытия этих параметров не нужен. Также, если заголовок <header> расположен внутри тега <group> и ни один из параметров группы не заполнен, то заголовок не будет отображаться.
Типы данных[]
- Название объекта, которое может быть записано как {{{имя}}} или {{{name}}} в классическом инфобоксе, должно быть перенесено в тег <title>. Например <title source="имя"></title>. Для стилизации заголовка через CSS можно использовать класс .pi-title.
- Изображение объекта, обычно задаваемое через параметры {{{изображение}}} или {{{image}}}, нужно поместить в тег <image>. У изображения также может быть подпись, которую можно создать через тег . Например: <image source="изображение"><caption source="подпись"></caption></image>.
- Остальные параметры прописываются в тегах <data>.
Видимые названия параметров[]
Названия параметров, которые будут видны в самой статье, задаются через тег <label> внутри <data>. Отображаемые названия параметров необходимо подбирать с учетом ширины отведённого им места: слишком длинные названия могут быть плохо читаемы, а короткие могут оставлять после себя свободное место, сильно отделяющее их от прилагаемого значения.
Шаг 4. Значения по умолчанию и форматирование[]
Обычно рекомендуется использовать простые данные, посылаемые в шаблон, например число, строка или ссылка. Тег <format> поможет отформатировать входящее значение. Например, для параметра «стоимость» можно ввести 10 и использовать <format>{{{стоимость}}} золота</format>. Этот тег может располагаться внутри тега <data> или <title>.
Тег <default> поможет задать значение по умолчанию в том случае, если оно не указано через параметр, прописанный в source. Однако значение по умолчанию не должно содержать в себе прочерк или «неизвестно», если того не требует макет шаблона, так как портативные инфобоксы настроены на сокрытие незаполненных строк.
Шаг 5. Стилизация[]
Стилизация в портативных инфобоксах осуществляется с помощью CSS вики. Встроенные стили по возможности удаляются из кода шаблона при его переносе.
- Если инфобокс имеет какие-то одинаковые свойства на всех страницах, где он используется, их необходимо применить к классу .portable-infobox.
- Если значение имеет стиль, отличный от других значений этого типа, например курсив или жирный текст, его необходимо настроить через <format>.
- Если вам необходимо изменить один и тот же инфобокс в зависимости от того, в каких статьях он используется, вы можете использовать атрибут theme и соответствующий класс.
- Подробнее о стилизации портативных инфобоксов можно прочитать в этой справке.
Примеры[]
Так может выглядеть классический инфобокс, написанный с использованием вики-текста:
{| class="infobox"
|-
|colspan="2"|{{{название|}}}
|-
|colspan="2"|[[Файл:{{{изображение|}}}|150px]]
|-
|Появление
|{{{появление|}}}
|-
|Статус
|{{{статус|}}}
|}
Так этот шаблон будет выглядеть на разметке портативных инфобокосов:
<infobox>
<title source="название"></title>
<image source="изображение"></image>
<data source="появление">
<label>'''Появление'''</label>
</data>
<data source="статус">
<label>'''Статус'''</label>
</data>
</infobox>
Заключение[]
Перенос классических инфобоксов на новую разметку может заметно облегчить их дальнейшее обслуживание, редактирование и стилизацию. Если у вас возникнут проблемы с переносом инфобоксов, обращайтесь за помощью к членам Vanguard.