Уикипедия: Редактиране и тестване на шаблони в пясъчна среда

От Уикипедия, свободната енциклопедия
Отидете на навигация Отидете на търсене
↱
  • VP: ТЕСТОВЕ

Шаблоните са мощен инструмент в MediaWiki , но дори опитни потребители могат да направят грешки както в маркирането на шаблона, така и при използване на функциите на анализатора . Ето защо, за да се избегнат грешки, повреда на страниците с шаблони и тежки натоварвания на сървърите на Wikipedia, сложните шаблони могат да бъдат придружени от пясъчни и тестови случаи .

Кога е желателно да се приложи методът

По принцип пясъчната кутия и тестовете могат да се използват при разработването на всеки шаблон, но е особено препоръчително да ги използвате в следните случаи:

  • когато шаблонът е включен в хиляди страници;
  • когато шаблонът извиква функции на анализатора, променяйки изхода на шаблона в зависимост от набора от параметри и използвайки условни и разклоняващи се оператори.

Как да създадете подстраници / пясъчна среда и / тестове

Има два начина да създадете пясъчна кутия и тестова страница:

  • Ако в интересния шаблон има документация, включена чрез шаблона {{ doc }} , тогава долният колонтитул на документацията ще съдържа спомагателни връзки за пясъчна среда и тестови случаи; в същото време, създаването на подстраница в пясъчна среда чрез спомагателни връзки автоматично ще копира съдържанието на шаблона в страницата за редактиране на пясъчна среда, а за подстраницата за тестове ще добави шаблон за съобщение {{ template tests }} ;
  • Ако искате сами да създавате страници, помислете например за Template: X :
  1. Необходимо е да се създадат подстраници с имената Template: X / sandbox и Template: X / tests , като се има предвид, че имената на подстраниците се изписват изцяло с малки букви;
  2. Копирайте кода от Template: X в Template: X / sandbox ;
  3. Ако в кода на шаблона маркерът <noinclude> заобикаля само включването на шаблона {{ doc }} , тогава копирайте целия код, в противен случай - само кода, който не е заобиколен от маркера <noinclude> , добавяйки следния код в края: <noinclude>
    {{песочница шаблона}}
    </noinclude>
  4. Копирайте някои случаи на използване на шаблона ( {{Х | .... }} ) от страниците на статията, които го включват в шаблона: X / tests ;
  5. От Шаблон: страница X / тестове, дублира всеки случай използването на шаблона, като заместите призива на X шаблон с X / пясък, така че можете да сравните резултатите от старите и актуализирани шаблони;
  6. Добавете също шаблона за публикация на тестовата страница към подстраницата Template: X / tests : {{тесты шаблона}}

Как да използвате в бъдеще

  • Копирайте текущата версия на шаблона в пясъчника (вижте стъпки 2-3 по-горе).
  • Направете промени в пясъчника.
  • Проверете резултатите на страницата с тестове.
  • Ако всичко е наред, копирайте новия код на пясъчника обратно в шаблона.

Вижте също