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