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

Материал из Wiren Board
(Отмена правки 56114, сделанной A.Degtyarev (обсуждение))
Метка: отмена
(Заменил на новый шаблон)
Строка 1: Строка 1:
<includeonly>
{{
{{note|{{#if:{{{nobanner|}}}| nobanner | note}}
<!-- Указать имя следующего релиза -->
|{{#switch: {{{release}}}
#vardefine:NextRelease
| wb-2110 = Доступно в текущем [[testing]].
|wb-2110
| wb-2108
| wb-2104 = Доступно в стабильном дистрибутиве с версии [[Wiren Board Firmware Update|{{{release}}}]].
| '''Указан несуществующий номер релиза: {{{release}}}'''
}}
}}
{{
<includeonly>{{
#if:{{{deb|}}}
<!-- Заголовок блока -->
| {{#if:{{{nobanner|}}}| | <br>}}{{{deb}}} ≥ {{{version}}}
#vardefine:HeaderString
| }}{{
|Скоро в стабильном релизе, а пока доступно в [[testing]]
#if:{{{custom_string|}}}
}}{{
| {{#if:{{{nobanner|}}}| | <br>}}{{{custom_string}}}
<!-- Описание -->
| }}
#vardefine:CaptionString
|{{#if:{{{deb|}}}
    | {{{deb}}} ≥ {{{version}}}
    }}
{{#if:{{{custom_string|}}}
    | {{{custom_string}}}}}
}}{{
<!-- Формируем тело блока -->
#vardefine:TestingDiv
|<div class="testing">
        <div class="testing-label">
            <span class="testing-header">
                {{#var:HeaderString}}
            </span><br>
            <span class="testing-caption">
            {{#var:CaptionString}} </span>
        </div>
        {{#if:{{{content|}}}
        |{{{content}}}
        }}
    </div> 
}}{{
<!-- Вывод -->
#ifeq: {{{release}}}|{{#var:NextRelease}}  
    | {{#if:{{{nobanner|}}}
        |{{#var:HeaderString}}
        |{{#var:TestingDiv}}
        }}
    | {{#if:{{{content|}}}
        |{{{content}}}
        }}
}}</includeonly><noinclude>
}}</includeonly><noinclude>
<h2> Журнал релизов </h2>
<h2> Журнал релизов </h2>
{{Wbincludes:Release Log}}
{{Wbincludes:Release Log}}
Следующий релиз wb-2110
Следующий релиз {{#var:NextRelease}}
<h2> Описание </h2>
<h2> Описание </h2>
[[Image: SupportedSinceRelease.png |600px|thumb|right| Редактирование после перехода testing в stable]]
[[Image: SupportedSinceRelease.png |400px|thumb|right| Переменная, в которой нужно заменить имя следующего релиза]]
С помощью этого шаблона мы говорим пользователю, когда появилась нужная ему функция. Чаще всего это будет в устройствах, но может быть и в описании какой-то новой фичи.
С помощью этого шаблона мы говорим пользователю, когда появилась нужная ему функция. Чаще всего это будет в устройствах, но может быть и в описании какой-то новой фичи.
<h3> Как это работает </h3>
В теле шаблона есть список релизов wb-2104, wb-2108 и т.п. Релизы после строчки про текущую версию — это стабильные релизы. Первый всегда будет testing.


<h3> Как пользоваться </h3>
<h3> Как пользоваться </h3>
Когда мы выпускаем новый релиз, то нужно зайти в тело шаблона и «сдвинуть» фразу про текущий релиз на одну позицию вверх и добавить в начало новый релиз, который станет testing. Также укажите имя нового релиза в [[Wbincludes:Release Log | Журнале изменений в релизах]].
Когда мы выпустили новый релиз, то нужно зайти в тело шаблона и в переменную <code>NextRelease</code> нужно вписать имя следующего релиза. Также впишите это имя в [[Wbincludes:Release Log | Журнале изменений в релизах]].


Когда мы запустили новую фичу — вставьте этот шаблон в описание фичи и укажите релиз, в котором эта фича появилась. Остальное произойдет автоматически после правки этого шаблона.
Когда мы запустили новую фичу — вставьте этот шаблон в описание фичи и укажите релиз, в котором эта фича появилась. Остальное произойдет автоматически после смены имени будущего релиза. Подробнее смотрите в примерах.


<h3> Когда фичи нет в серии </h3>
<h3> Когда фичи нет в серии </h3>
Строка 34: Строка 58:


<h2> Примеры </h2>
<h2> Примеры </h2>
<h3> Релиз </h3>
<syntaxhighlight lang="wiki">
<syntaxhighlight lang="wiki">
{{SupportedSinceRelease  
{{SupportedSinceRelease
| release= wb-2108
| release = {{#var:NextRelease}}
|content=
Описание новой фичи. Можно вставлять картинки, таблицы и так далее.
}}
}}
</syntaxhighlight>
</syntaxhighlight>
{{SupportedSinceRelease
[[Image: SupportedSinceRelease_release.png |800px|thumb|none| Пример блока без версии пакета ]]
| release= wb-2108
}}
<h3> Релиз + версия пакета </h3>
<syntaxhighlight lang="wiki">
<syntaxhighlight lang="wiki">
{{SupportedSinceRelease  
{{SupportedSinceRelease
| release= wb-2108
| release = wb-2110
| deb= wb-mqtt-serial  
| deb = wb-mqtt-serial
| version= 2.16.6
| version = 2.3.0
|content=
Описание новой фичи. Можно вставлять картинки, таблицы и так далее.
}}
}}
</syntaxhighlight>
</syntaxhighlight>
{{SupportedSinceRelease
[[Image: SupportedSinceRelease_release+deb+version.png |800px|thumb|none| Пример блока с версией пакета]]
| release= wb-2108
| deb= wb-mqtt-serial
| version= 2.16.6
}}
 
<h3> Релиз + произвольная строка </h3>
<syntaxhighlight lang="wiki">
<syntaxhighlight lang="wiki">
{{SupportedSinceRelease  
{{SupportedSinceRelease
| release= wb-2110
| release = wb-2110
| custom_string= wb-mqtt-serial ≥ 2.17.0 и wb-hwconf-manager ≥ 1.40.0.
| custom_string = Произвольная строка
|content=
Описание новой фичи. Можно вставлять картинки, таблицы и так далее.
}}
}}
</syntaxhighlight>
</syntaxhighlight>
[[Image: SupportedSinceRelease_release+custom_string.png |800px|thumb|none| Пример блока с произвольной подписью под заголовком]]
<syntaxhighlight lang="wiki">
{{SupportedSinceRelease  
{{SupportedSinceRelease  
| release= wb-2110
| release= wb-2110
| custom_string= wb-mqtt-serial ≥ 2.17.0 и wb-hwconf-manager ≥ 1.40.0.
}}
<h3> Ошибка, когда указан несуществующий релиз </h3>
<syntaxhighlight>
{{SupportedSinceRelease
| release= wb-2001
}}
</syntaxhighlight>
{{SupportedSinceRelease
| release= wb-2001
}}
<h3>Без баннера</h3>
<pre>
{{SupportedSinceRelease
| release= wb-2108
| deb= wb-mqtt-serial
| version= 2.16.6
| nobanner= true
}}
</pre>
{{SupportedSinceRelease
| release= wb-2108
| deb= wb-mqtt-serial  
| deb= wb-mqtt-serial  
| version= 2.16.6
| version= 2.16.6
| nobanner= true
| nobanner= true
}}
}}
</syntaxhighlight>
[[Image: SupportedSinceRelease_release+deb+version+nobanner.png |800px|thumb|none| Пример подписи без блока]]
</noinclude>
</noinclude>

Версия 15:33, 26 октября 2021


Журнал релизов

Журналы изменений в релизах
Ветка Имя
stable wb-2404 •wb-2401 • wb-2310 • wb-2307 • wb-2304 • wb-2207 • wb-2204 • wb-2201 • wb-2110 • wb-2108 • wb-2104
testing скользящий релиз, изменения

Следующий релиз wb-2110

Описание

Переменная, в которой нужно заменить имя следующего релиза

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

Как пользоваться

Когда мы выпустили новый релиз, то нужно зайти в тело шаблона и в переменную NextRelease нужно вписать имя следующего релиза. Также впишите это имя в Журнале изменений в релизах.

Когда мы запустили новую фичу — вставьте этот шаблон в описание фичи и укажите релиз, в котором эта фича появилась. Остальное произойдет автоматически после смены имени будущего релиза. Подробнее смотрите в примерах.

Когда фичи нет в серии

Иногда страница устройства создаётся раньше, чем его поддержка появляется в серийном wb-mqtt-serial, в таких случаях вставляйте шаблон InternalTestingTemplate. Так мы сможем отследить такие страницы и исправить их после появления поддержки в одном из релизов.

Примеры 

{{SupportedSinceRelease
| release = {{#var:NextRelease}}
|content=
Описание новой фичи. Можно вставлять картинки, таблицы и так далее.
}}
Пример блока без версии пакета
{{SupportedSinceRelease
| release = wb-2110
| deb = wb-mqtt-serial
| version = 2.3.0
|content=
Описание новой фичи. Можно вставлять картинки, таблицы и так далее.
}}
Пример блока с версией пакета
{{SupportedSinceRelease
| release = wb-2110
| custom_string = Произвольная строка
|content=
Описание новой фичи. Можно вставлять картинки, таблицы и так далее.
}}
Пример блока с произвольной подписью под заголовком
{{SupportedSinceRelease 
| release= wb-2110
| deb= wb-mqtt-serial 
| version= 2.16.6
| nobanner= true
}}
Пример подписи без блока
Источник — https://wirenboard.com/wiki/index.php?title=Шаблон:SupportedSinceRelease&oldid=56117