diff options
Diffstat (limited to 'files/ru/mdn/tools/kumascript/troubleshooting/index.html')
| -rw-r--r-- | files/ru/mdn/tools/kumascript/troubleshooting/index.html | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/files/ru/mdn/tools/kumascript/troubleshooting/index.html b/files/ru/mdn/tools/kumascript/troubleshooting/index.html new file mode 100644 index 0000000000..0e0b91324b --- /dev/null +++ b/files/ru/mdn/tools/kumascript/troubleshooting/index.html @@ -0,0 +1,63 @@ +--- +title: Решение проблем с ошибками в KumaScript +slug: MDN/Tools/KumaScript/Troubleshooting +tags: + - Errors + - KumaScript + - MDN Meta + - Tools + - Ошибки + - Руководство + - инструменты +translation_of: MDN/Tools/KumaScript/Troubleshooting +original_slug: MDN/Kuma/Troubleshooting_KumaScript_errors +--- +<div>{{MDNSidebar}}</div> + +<p>Oшибки <a href="/ru/docs/MDN/Kuma/Introduction_to_KumaScript">KumaScript</a>, появляющиеся на странице, могут быть очень неудобными для читателей, из-за больших страшных красных ящиков, но, к счастью, любой человек с учетной записью MDN может отредактировать документ, чтобы исправить эту ошибку. При возникновении ошибки страница добавляется в список <a href="/ru/docs/with-errors">документов с ошибками</a>. Редакторы сайта регулярно просматривают этот список, чтобы находить и исправлять ошибки. В этой статье подробно описываются четыре типа ошибок KumaScript и некоторые шаги, которые можно предпринять для их исправления.</p> + +<h2 id="DocumentParsingError">DocumentParsingError</h2> + +<p><code>DocumentParsingError</code> ошибки появляются, когда у KumaScript есть проблемы с пониманием чего-либо в самом документе. Наиболее распространенной причиной является синтаксическая ошибка в <a href="/ru/docs/MDN/Contribute/Structures/Macros">макросе</a>.</p> + +<p>Необходимо проверить:</p> + +<dl> + <dt>Использование фигурных скобок без намерения вызвать макрос.</dt> + <dd>Если вам нужно написать <strong>\{</strong> в документе, не вызывая макрос, вы можете экранировать его используя <em>\</em> таким образом <code>\\{</code></dd> + <dt>Использование специального символа в параметрах макроса.</dt> + <dd>Если вам нужно использовать<strong> "</strong> или <strong>\</strong><strong> </strong>внутри параметра макроса, они могут быть экранированы с помощью <code>\\</code> или <code>\"</code></dd> + <dt>Отсутствие запятых между параметрами макроса.</dt> + <dd>Параметры макроса должны быть разделены запятой (,) но не в конце списка параметров, например: <code>\{\{anch("top", "Back to top")}}</code>.</dd> + <dt>HTML тег появляется внутри вызова макроса.</dt> + <dd>Если вы применяете стили к макросу, это будет часто приводить к ошибками, например, тег <code></code></code> мог появится внутри кода макроса в исходном коде. Для проверки нажмите просмотр исходника (<em>Source</em>), чтобы увидеть где, и удалить ненужные стили.</dd> +</dl> + +<h2 id="TemplateLoadingError">TemplateLoadingError</h2> + +<p><code>TemplateLoadingError</code> ошибка появляется когда KumaScript не может найти <a href="/ru/docs/MDN/Contribute/Structures/Macros">макрос</a> для добавления на страницу.</p> + +<p>Необходимо проверить:</p> + +<dl> + <dt>Опечатка в имени макроса или он был переименован.</dt> + <dd>Вы можете взглянуть на список известных макросов в <a href="https://github.com/mdn/kumascript/tree/master/macros">GitHub репозитории</a>.</dd> +</dl> + +<div class="note"> +<p><strong>Совет:</strong> Вы можете легко и быстро перейти к определённому макросу, используя <a href="http://kb.mozillazine.org/Using_keyword_searches">поиск по ключевым словам</a> в Firefox. Смотрите {{SectionOnPage("/ru/docs/MDN/Contribute/Tools/KumaScript", "Использование поиска по ключевым словам для открытия шаблона страницы")}} для пошагового справочника по созданию поиска по ключевым словам.</p> +</div> + +<h2 id="TemplateExecutionError">TemplateExecutionError</h2> + +<p><code>TemplateExecutionError</code> ошибки появляются, когда KumaScript встречается с ошибкой в макросе. Эти ошибки могут быть исправлены только администраторами и вам нужно сообщить об этом с помощью багрепорта.</p> + +<p>Перед отчётом об ошибке, проверьте что она уже не была исправлена. Мы можете заставить KumaScript дать вам свежую версию страницы удерживая нажатой <kbd>Shift</kbd> пока вы обновляете (<kbd>F5</kbd>) страницу (<em><kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>R</kbd></em> on Windows/Linux, <em><kbd>Shift</kbd> + <kbd>Cmd</kbd> + <kbd>R</kbd></em> on Mac).</p> + +<p>Если ошибка сохраняется, <a href="https://bugzilla.mozilla.org/form.doc">заведите багрепорт</a>. Включите URL страницы и текст ошибки в сообщение.</p> + +<h2 id="Error_Unknown">Error & Unknown</h2> + +<p>В этой категории оказываются ошибки, если они не являются никакими другими типами ошибок.</p> + +<p>Проверьте исправлено ли, и если ошибка сохраняется заведите багрепорт как описано в <a href="/ru/docs/MDN/Kuma/Troubleshooting_KumaScript_errors#TemplateExecutionError">TemplateExecutionError</a>.</p> |