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

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 по-горе).
• Направете промени в пясъчника.
• Проверете резултатите на страницата с тестове.
• Ако всичко е наред, копирайте новия код на пясъчника обратно в шаблона.

Вижте също

• Критични правила за защита на шаблони
• {{ template sandbox }} - съобщение в тестовата среда
• {{ template tests }} - съобщение за тестова подстраница
• {{ TestCase }} - за опростяване на тестването на функционални шаблони
• {{ Шаблонни тестове по таблица }} - особено за карти