Oшибки KumaScript, появляющиеся на странице, могут быть очень неудобными для читателей, из-за больших страшных красных ящиков, но, к счастью, любой человек с учетной записью MDN может отредактировать документ, чтобы исправить эту ошибку. При возникновении ошибки страница добавляется в список документов с ошибками. Редакторы сайта регулярно просматривают этот список, чтобы находить и исправлять ошибки. В этой статье подробно описываются четыре типа ошибок KumaScript и некоторые шаги, которые можно предпринять для их исправления.

DocumentParsingError

DocumentParsingError ошибки появляются, когда у KumaScript есть проблемы с пониманием чего-либо в самом документе. Наиболее распространенной причиной является синтаксическая ошибка в макросе.

Необходимо проверить:

Использование фигурных скобок без намерения вызвать макрос.
Если вам нужно написать { в документе, не вызывая макрос, вы можете экранировать его используя \ таким образом \{
Использование специального символа в параметрах макроса.
Если вам нужно использовать " или \ внутри параметра макроса, они могут быть экранированы с помощью \\ или \"
Отсутствие запятых между параметрами макроса.
Параметры макроса должны быть разделены запятой (,) но не в конце списка параметров, например: {{anch("top", "Back to top")}}.
HTML тег появляется внутри вызова макроса.
Если вы применяете стили к макросу, это будет часто приводить к ошибками, например, тег </code> мог появится внутри кода макроса в исходном коде. Для проверки нажмите просмотр исходника (Source), чтобы увидеть где, и удалить ненужные стили.

TemplateLoadingError

TemplateLoadingError ошибка появляется когда KumaScript не может найти макрос для добавления на страницу.

Необходимо проверить:

Опечатка в имени макроса или он был переименован.
Вы можете взглянуть на список известных макросов в GitHub репозитории.

Совет: Вы можете легко и быстро перейти к определённому макросу, используя поиск по ключевым словам в Firefox. Смотрите Использование поиска по ключевым словам для открытия шаблона страницы в [Page not yet written] для пошагового справочника по созданию поиска по ключевым словам.

TemplateExecutionError

TemplateExecutionError ошибки появляются, когда KumaScript встречается с ошибкой в макросе. Эти ошибки могут быть исправлены только администраторами и вам нужно сообщить об этом с помощью багрепорта.

Перед отчётом об ошибке, проверьте что она уже не была исправлена. Мы можете заставить KumaScript дать вам свежую версию страницы удерживая нажатой Shift пока вы обновляете (F5) страницу (Shift + Ctrl + R on Windows/Linux, Shift + Cmd + R on Mac).

Если ошибка сохраняется, заведите багрепорт. Включите URL страницы и текст ошибки в сообщение.

Error & Unknown

В этой категории оказываются ошибки, если они не являются никакими другими типами ошибок.

Проверьте исправлено ли, и если ошибка сохраняется заведите багрепорт как описано в TemplateExecutionError.

Метки документа и участники

Внесли вклад в эту страницу: fuggy, wbamberg, MariyaSka, cpigat
Обновлялась последний раз: fuggy,