Редактирование: РуСказки:Пределы шаблонов (раздел)

== Справка ==

=== Что это? ===
Движок [[MediaWiki]], который генерирует итоговый [[HTML]]-код страницы на базе вики-текста, использует [[Синтаксический анализ|парсер]] для анализа включенных данных. Всё это происходит в «препроцессоре», который конвертирует вики-текст в структуру данных, подобную [[XML]]-дереву, а затем использует эту структуру для генерирования «[[m:Help:Expansion|раскрытого]]» вики-текста, в котором структуры из двойных и тройных скобок заменяются их результатом.

В процессе преобразования движок использует несколько счётчиков, которые анализируют сложность генерирования страницы. Когда начинается [[синтаксический анализ]] (парсинг) страницы, эти счётчики устанавливаются в нуль, но в процессе анализа постепенно повышают свои значения, как это описано ниже. Каждый счётчик имеет верхний предел, при достижении которого парсер перестаёт обрабатывать тот тип данных, для которого предел превышен.

=== Зачем нужны эти пределы? ===
Слишком длинные и сложные страницы могут генерироваться значительное время. Кроме того, что этот недостаток может доставлять неудобства для пользователей, его можно использовать в качестве инструмента для [[DoS-атака|DoS-атак]] на серверы, в ходе которых  запросы к сложным страницам заставляют движок MediaWiki обрабатывать несоразмерно огромное количество данных. Эти пределы помогают предотвратить DoS-атаки и уменьшить время генерирования запрошенных страниц.

=== Что делать, если пределы всё-таки превышены? ===
Если страница всё-таки достигла пределов для шаблонов, наиболее приемлемым выходом является упрощение самих шаблонов, которого можно добиться используя изложенные ниже методы. Если это невозможно, альтернативным решением проблемы может быть внесение информации прямо в текст страницы, вместо включения этой информации из шаблона. С другой стороны, шаблоны могут, наоборот, избежать повторения парсером однообразных задач, об этом ниже.

=== Когда проблема может возникнуть? ===
Превышение пределов возможно на тех страницах, в которых многократно используются одни и те же шаблоны, например, по одному включению на каждую строку длинной таблицы. Несмотря на то, что сам шаблон может вносить в итоговую страницу незначительный объем данных, весь объём данных, используемый шаблоном, будет считаться при каждом его включении и, таким образом, предел счётчика может быть превышен ранее, чем можно ожидать. Страницы, которые включают лишь незначительное количество шаблонов, практически никогда не превышают эти пределы, исключением могут быть случаи, когда сами шаблоны содержат огромное количество данных.

=== Как узнать, превышены ли пределы? ===
При обработке страницы движком в HTML-код после основного содержимого страницы добавляется тег комментария [[:mw:NewPP parser report]], содержащий итоговые значения счетчиков. Например, статья [[Кошка]] (на момент 19 апреля 2011 года) содержит следующий комментарий в сгенерированном HTML-коде:

<source lang="html4strict">
<!-- 
NewPP limit report
Preprocessor node count: 68502/1000000
Post-expand include size: 431392/2048000 bytes
Template argument size: 210835/2048000 bytes
Expensive parser function count: 89/500
--> 
</source>

Первые три счётчика обычно не превышают пределов. Когда значение счётчика близко к пределу, некоторые шаблоны могут быть проигнорированы парсером. Каждое вхождение нераскрытого шаблона отмечается в теле страницы как HTML-комментарий, содержащий сообщение об ошибке, например:

<source lang="html4strict">
<a href="/wiki/Шаблон:Foo" title="Шаблон:Foo">Шаблон:Foo</a><!-- WARNING: template omitted, post-expand include size too large -->
</source>