В целом песочница и тесты могут быть использованы при разработке любого шаблона, но особо рекомендуется их применять в следующих случаях:
когда шаблон включен в тысячи страниц;
когда шаблон вызывает функции парсера, видоизменяя результат работы шаблона в зависимости от множества параметров и используя условные операторы и операторы ветвления.
Как создать подстраницы /песочница и /тесты
Существует два способа создать песочницу и страницу тестов:
Если у шаблона есть документация, включенная через шаблон
{{
doc
}}
, то нижний колонтитул документации будет содержать вспомогательные ссылки для создания песочницы и тестов; при этом создание подстраницы песочницы через вспомогательные ссылки автоматически скопирует содержимое шаблона в страницу редактирования песочницы, а для подстраницы тестов — добавит шаблон сообщения
{{
тесты шаблона
}}
;
Если вы хотите создать страницы самостоятельно, то рассмотрим, например, шаблон
Шаблон:Х
:
Необходимо создать подстраницы с именами
Шаблон:Х/песочница
и
Шаблон:Х/тесты
, обращая внимание, что имена подстраниц записываются целиком строчными буквами;
Скопируйте код из шаблона
Шаблон:Х
на страницу
Шаблон:Х/песочница
;
Если в коде шаблона тегом
<noinclude>
окружено лишь включение шаблона
{{
doc
}}
, то скопируйте код целиком, иначе — только лишь код, не окружённый тегом
<noinclude>
, добавив следующий код в конец:
<noinclude>
{{песочница шаблона}}
</noinclude>
Скопируйте несколько случаев использования шаблона (
{{
Х
|
....
}}
) со страниц статей, его включающих, на страницу
Шаблон:Х/тесты
;
На странице
Шаблон:Х/тесты
продублируйте каждый случай использования шаблона, заменив вызов шаблона
Х
на
Х/песочница
, чтобы можно было сравнить результат работы старого и обновлённого шаблонов;
Добавьте также шаблон сообщения тестовой страницы на подстраницу
Шаблон:Х/тесты
:
{{тесты шаблона}}
Как использовать в дальнейшем
Скопируйте текущую версию шаблона в песочницу (см. пункты 2—3 выше).
Проделайте изменения в песочнице.
Проверьте результаты на странице тестов.
Если всё в порядке, скопируйте новый код из песочницы обратно в шаблон.