Вікіпедыя:Праўка і тэставанне шаблонаў у пясочніцы

Матэрыял з Вікіпедыі - вольнай энцыклапедыі
Перайсці да навігацыі Перайсці да пошуку
↱
  • УП:ТЭСТЫ

Шаблоны з'яўляюцца магутным сродкам MediaWiki , але нават дасведчаныя ўдзельнікі могуць здзяйсняць памылкі як у разметцы шаблону , так і пры выкарыстанні функцый парсера . Таму, каб пазбегнуць памылак, пашкоджанні якія выкарыстоўваюць шаблон старонак і вялікіх нагрузак на серверы Вікіпедыі, складаныя шаблоны могуць суправаджацца пясочніцай і кантрольнымі прыкладамі .

Калі пажадана прымяняць метад

У цэлым пясочніца і тэсты могуць быць скарыстаны пры распрацоўцы любога шаблону, але асоба рэкамендуецца іх ужываць у наступных выпадках:

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

Як стварыць падстаронкі /пясочніца і /тэсты

Існуе два спосабу стварыць пясочніцу і старонку тэстаў:

  • Калі ў цікавага шаблона ёсць дакументацыя, уключаная праз шаблон {{ doc }} , то ніжні калантытулу дакументацыі будзе змяшчаць дапаможныя спасылкі для стварэння пясочніцы і тэстаў; пры гэтым стварэнне падстаронкі пясочніцы праз дапаможныя спасылкі аўтаматычна скапіюе змесціва шаблону ў старонку рэдагавання пясочніцы, а для падстаронкі тэстаў - дадасць шаблон паведамлення {{ тэсты шаблону }} ;
  • Калі вы жадаеце стварыць старонкі самастойна, то разгледзім, напрыклад, шаблон Шаблон:Х :
  1. Неабходна стварыць падстаронкі з імёнамі Шаблон:Х/пясочніца і Шаблон:Х/тэсты , зважаючы, што імёны падстаронак запісваюцца цалкам малымі літарамі;
  2. Скапіюйце код з шаблону Шаблон:Х на старонку Шаблон:Х/пясочніца ;
  3. Калі ў кодзе шаблону тэгам <noinclude> акружана толькі ўключэнне шаблону {{ doc }} , то скапіруйце код цалкам, інакш - толькі толькі код, не акружаны тэгам <noinclude> , дадаўшы наступны код у канец: <noinclude>
    {{песочница шаблона}}
    </noinclude>
  4. Скапіюйце некалькі выпадкаў выкарыстання шаблона ( {{Х | .... }} ) са старонак артыкулаў, якія яго ўключаюць, на старонку Шаблон:Х/тэсты ;
  5. На старонцы Шаблон:Х/тэсты прадублюйце кожны выпадак выкарыстання шаблона, замяніўшы выклік шаблону Х на Х/пясочніца , каб можна было параўнаць вынік працы старога і абноўленага шаблонаў;
  6. Дадайце таксама шаблон паведамлення тэставай старонкі на падстаронку Шаблон:Х/тэсты : {{тесты шаблона}}

Як выкарыстоўваць у далейшым

  • Скапіюйце бягучую версію шаблону ў пясочніцу (гл. пункты 2-3 вышэй).
  • Прарабіце змены ў пясочніцы.
  • Праверце вынікі на старонцы тэстаў.
  • Калі ўсё ў парадку, скапіруйце новы код з пясочніцы назад у шаблон.

Глядзіце таксама