files/ru/mdn/kuma/troubleshooting_kumascript_errors/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

---
title: Решение проблем с ошибками в KumaScript
slug: MDN/Kuma/Troubleshooting_KumaScript_errors
tags:
  - Errors
  - KumaScript
  - MDN Meta
  - Tools
  - Ошибки
  - Руководство
  - инструменты
translation_of: MDN/Tools/KumaScript/Troubleshooting
---
<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>&lt;/code&gt;</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 &amp; Unknown</h2>

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

<p>Проверьте исправлено ли, и если ошибка сохраняется заведите багрепорт как описано в <a href="/ru/docs/MDN/Kuma/Troubleshooting_KumaScript_errors#TemplateExecutionError">TemplateExecutionError</a>.</p>