Просмотр кода страницы Тептар:Правка и тестирование шаблонов в песочнице

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

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

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

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

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

[[Категория:Тептар:Справка по шаблонам|{{PAGENAME}}]]