Импортёр: 1 версия импортирована

2024-05-01T10:39:22Z

1 версия импортирована

← Предыдущая версия	Версия от 13:39, 1 мая 2024
(нет различий)

ru>Andras в 17:17, 20 октября 2023

2023-10-20T17:17:27Z

Новая страница

<noinclude>{{К улучшению|2023-10-20}}</noinclude>
[[РуСказки:Шаблоны|Шаблоны]] являются мощным средством движка 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;"><noinclude><br><nowiki>{{Песочница шаблона}}</nowiki><br></noinclude></code>
# Скопируйте несколько случаев использования шаблона ({{Tc|Х| ....  }}) со страниц статей, его включающих, на страницу <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}}]]

РуСказки:Правка и тестирование шаблонов в песочнице - История изменений

Импортёр: 1 версия импортирована

ru>Andras в 17:17, 20 октября 2023