diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
commit | 074785cea106179cb3305637055ab0a009ca74f2 (patch) | |
tree | e6ae371cccd642aa2b67f39752a2cdf1fd4eb040 /files/ru/mdn/kuma | |
parent | da78a9e329e272dedb2400b79a3bdeebff387d47 (diff) | |
download | translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.gz translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.bz2 translated-content-074785cea106179cb3305637055ab0a009ca74f2.zip |
initial commit
Diffstat (limited to 'files/ru/mdn/kuma')
-rw-r--r-- | files/ru/mdn/kuma/index.html | 25 | ||||
-rw-r--r-- | files/ru/mdn/kuma/troubleshooting_kumascript_errors/index.html | 62 |
2 files changed, 87 insertions, 0 deletions
diff --git a/files/ru/mdn/kuma/index.html b/files/ru/mdn/kuma/index.html new file mode 100644 index 0000000000..ee8105bf08 --- /dev/null +++ b/files/ru/mdn/kuma/index.html @@ -0,0 +1,25 @@ +--- +title: 'Kuma: вики-платформа MDN' +slug: MDN/Kuma +tags: + - Kuma + - Главная +translation_of: MDN/Kuma +--- +<div>{{MDNSidebar}}</div> + +<div>{{IncludeSubnav("/ru/docs/MDN")}}</div> + +<p>Kuma - код на Django, который обслуживает Mozilla Developer Network.</p> + +<p>{{SubpagesWithSummaries}}</p> + +<h2 id="Начинаем_работу_с_Kuma">Начинаем работу с Kuma</h2> + +<p>Чтобы поучаствовать в Kuma:</p> + +<ul> + <li>Посетите <a href="https://github.com/mozilla/kuma">проект Kuma на Github</a>.</li> + <li>Посмотрите <a href="https://github.com/mozilla/kuma/blob/master/CONTRIBUTING.md">Руководство помощника.</a></li> + <li>Если нужно, погрузитесь в <a href="http://kuma.readthedocs.org/en/latest/">полную документацию по Kuma</a>.</li> +</ul> diff --git a/files/ru/mdn/kuma/troubleshooting_kumascript_errors/index.html b/files/ru/mdn/kuma/troubleshooting_kumascript_errors/index.html new file mode 100644 index 0000000000..dfbe9868eb --- /dev/null +++ b/files/ru/mdn/kuma/troubleshooting_kumascript_errors/index.html @@ -0,0 +1,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></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> |