Шаблон:ChangelogItem: различия между версиями

Материал из Wiren Board
Строка 57: Строка 57:
</syntaxhighlight>
</syntaxhighlight>
</noinclude><includeonly>{{#vardefine:IsTesting
</noinclude><includeonly>{{#vardefine:IsTesting
|    {{#ifeq: testing | true | — доступно в [[testing]]}}  
|    {{#ifeq: {{{testing}}} | true | — доступно в [[testing]]}}  
}}{{#vardefine:TryResult
}}{{#vardefine:TryResult
| '''{{{version}}} ({{{date}}})''' {{#var:IsTesting}}
| '''{{{version}}} ({{{date}}})''' {{#var:IsTesting}}

Версия 09:07, 10 июня 2022

Описание

Что делает

Шаблон генерирует строку для чейндждога. В content можно вставить форматированный текст, рисунки и галереи рисунков.

Как это работает. Шаблон получает в версию и дату изменения, в models перечень затронутых изменением моделей через запятую, а в content информацию об изменении. В результате генерирутся несколько форматированных строк, которые вставляются в страницу, откуда был вызван шаблон.

Кроме этого, если страницу, куда был вставлен шаблон, вызвать с параметром-моделью, то шаблон ChangelogItem выведет только те изменения, которые затрагивают это устройство. Таким образом формируется список изменений для модели. Можно передать только одну модель.

Проверка ошибок. Так же для каждой линейки есть инклюд с перечнем поделей, который вставлен в общий список изменений, чтобы было удобно копировать названия, а ещё с использованием этого инклюда происходит проверка написания модели. Если модель написана неверно, снизу пункта будет выведено текущее написание, окрашенное в красный цвет. Для проверки используется Шаблон: Check.

Живые примеры использования

Реле:

Инструкции

Для программиста

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

  1. Открыть инклюд общего списка изменения для нужного типа устройств, список инклюдов.
  2. Внести по образцу новый пункт, указать: версию прошивки, дату релиза, наименования затронутых моделей через запятую и заполнить описание в теге content.

Пример записи, параметр {{{1}}} не удалять — это для индивидуального списка:

{{ChangelogItem
| {{{1}}}
| version = 1.18.4
| date = 26.04.2022
| models = WB-MR6C v.2, WB-MR6C v.3, WB-MR6C/NC v.1
| content=
Добработка безопасного режима
}}

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

ChangelogItemModels.png

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

ChangelogItemError.png

Верный пунт списка изменения будет выглядеть примерно так::

ChangelogItemResult.png

Для техписателя

При выходе новой модели устройства:

  1. Добавить название модели в инклюд, по которому происходит проверка правильности написания модели. Список инклюдов.
  2. Создать сраницу изменений в прошивке устройства, в названии указать модель.
    Например, страница WB-MR6C v.3: Changelog выглядит так:
    {{DISPLAYTITLE: Изменения в прошивке WB-MR6C v.3 }}
    == Общее ==
    {{Wbincludes:Changelog Update Devices}}
    
    == Список изменений ==
    {{Wbincludes:WB-MR: Changelog|WB-MR6C v.3}}