View source for ЭнциклопедияАкриции:Правка и тестирование шаблонов в песочнице

{{shortcut|РВ:ТЕСТЫ}} [[Рувики:Шаблоны|Шаблоны]] являются мощным средством [[MediaWiki]], но даже опытные участники могут совершать ошибки как в [[Рувики:Механизм шаблонов|разметке шаблона]], так и при использовании [[Рувики:Функции парсера|функций парсера]]. Поэтому, чтобы избежать ошибок, повреждения использующих шаблон страниц и больших нагрузок на серверы Рувики, сложные шаблоны могут сопровождаться [[Рувики:Песочница|песочницей]] и [[Вариант тестирования|контрольными примерами]].

== Когда желательно применять метод ==
В целом песочница и тесты могут быть использованы при разработке любого шаблона, но особо рекомендуется их применять в следующих случаях:

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

== Как создать подстраницы /песочница и /тесты ==
Существует два способа создать песочницу и страницу тестов:

* Если у шаблона есть документация, включенная через шаблон {{tl|doc}}, то нижний колонтитул документации будет содержать вспомогательные ссылки для создания песочницы и тестов; при этом создание подстраницы песочницы через вспомогательные ссылки автоматически скопирует содержимое шаблона в страницу редактирования песочницы, а для подстраницы тестов — добавит шаблон сообщения {{tl|тесты шаблона}};
* Если вы хотите создать страницы самостоятельно, то рассмотрим, например, шаблон <code>Шаблон:Х</code>:

# Необходимо создать подстраницы с именами <code>Шаблон:Х/песочница</code> и <code>Шаблон:Х/тесты</code>, обращая внимание, что имена подстраниц записываются целиком строчными буквами;
# Скопируйте код из шаблона <code>Шаблон:Х</code> на страницу <code>Шаблон:Х/песочница</code>;
# Если в коде шаблона тегом <code><nowiki><noinclude></nowiki></code> окружено лишь включение шаблона {{tl|doc}}, то скопируйте код целиком, иначе — только лишь код, не окружённый тегом <code><nowiki><noinclude></nowiki></code>, добавив следующий код в конец: <code style="display:table; line-height:1.2em;">&#x3C;noinclude></code> <code style="display:table; line-height:1.2em;"><nowiki>{{песочница шаблона}}</nowiki></code> <code style="display:table; line-height:1.2em;">&#x3C;/noinclude></code>
# Скопируйте несколько случаев использования шаблона  ({{tc|Х|....&#32;}}) со страниц статей, его включающих, на страницу <code>Шаблон:Х/тесты</code>;
# На странице <code>Шаблон:Х/тесты</code> продублируйте каждый случай использования шаблона, заменив вызов шаблона <code>Х</code> на <code>Х/песочница</code>, чтобы можно было сравнить результат работы старого и обновлённого шаблонов;
# Добавьте также шаблон сообщения тестовой страницы на подстраницу <code>Шаблон:Х/тесты</code>:<code style="display:table; line-height:1.2em;"><nowiki>{{тесты шаблона}}</nowiki></code>

== Как использовать в дальнейшем ==

* Скопируйте текущую версию шаблона в песочницу (см. пункты 2—3 выше).
* Проделайте изменения в песочнице.
* Проверьте результаты на странице тестов.
* Если всё в порядке, скопируйте новый код из песочницы обратно в шаблон.

== См. также ==

* [[Рувики:Правила защиты страниц#Критические шаблоны и модули|Правила защиты критических шаблонов]]
* {{tl|песочница шаблона}} — сообщение песочницы
* {{tl|тесты шаблона}} — сообщение подстраницы тестов
* {{tl|TestCase}} — для упрощения тестирования функциональных шаблонов
* {{tl|Тесты шаблона таблицей}} — особенно для карточек