unslug ru: move

4 files changed, 166 insertions, 50 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..dfbe9868eb
--- /dev/null
+++ b/files/ru/mdn/tools/kumascript/troubleshooting/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>&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>
diff --git a/files/ru/mdn/tools/page_watching/index.html b/files/ru/mdn/tools/page_watching/index.html
deleted file mode 100644
index 04b9dc05ad..0000000000
--- a/files/ru/mdn/tools/page_watching/index.html
+++ /dev/null
@@ -1,50 +0,0 @@
----
-title: Подписка на страницы
-slug: MDN/Tools/Page_watching
-tags:
-  - MDN Meta
-  - Подписка
-  - Руководство
-  - Страница уровня
-  - инструменты
-translation_of: MDN/Tools/Page_watching
----
-<div>{{MDNSidebar}}</div><p>Ok</p>
-
-<p class="seoSummary">Подписка на страницу в MDN позволяет вам получать уведомление по электронной почте всякий раз, когда она обновляется или изменяется. Кнопка «Смотреть» <kbd>{{FontAwesomeIcon("icon-eye")}}</kbd> расположена в верхнем правом углу каждой страницы MDN. Чтобы получить доступ к параметрам подписки, наведите курсор на кнопку «Смотреть», чтобы открыть меню «Смотреть»: </p>
-
-<p><img alt="Screenshot of MDN Watch menu" src="https://mdn.mozillademos.org/files/12551/MDN_-_Watch_Menu.png" style="height: 298px; width: 463px;"></p>
-
-<p>Выберите вариант просмотра только одной страницы или этой страницы и ее подстраниц.</p>
-
-<h2 id="Подписаться_на_страницу">Подписаться на страницу</h2>
-
-<p>Нажмите первый вариант <em>«Подписаться на название страницы»</em>, чтобы получать уведомление по электронной почте каждый раз, когда пользователь редактирует только одну страницу.</p>
-
-<h2 id="Подпишитесь_на_страницу_и_все_ее_подзаголовки">Подпишитесь на страницу и все ее подзаголовки</h2>
-
-<p>Нажмите второй вариант <em>«Подписаться на название страницы и все её под-статьи»</em>, чтобы получать уведомление по электронной почте каждый раз, когда пользователь редактирует эту страницу, а также любую её подстраницу. Это включает в себя дополнительные страницы, добавленные после того, как вы запросили подписку, поэтому, если в будущем будет создано больше подстраниц, вы также получите уведомления для них.</p>
-
-<h2 id="Отменить_подписку_на_страницу">Отменить подписку на страницу</h2>
-
-<p>Чтобы отказаться от подписки и прекратить просмотр страницы, откройте меню «Смотреть» еще раз и нажмите <em>«Отменить подписку на название страницы»</em>. Если вы подписаны на страницу, вы увидите только <em>«Отказаться от названия страницы»</em>. Вы больше не будете получать электронное письмо при каждом изменении страницы.</p>
-
-<h2 id="Электронные_письма_с_изменением_страницы">Электронные письма с изменением страницы</h2>
-
-<p>Если вы подписаны на страницу, каждый раз при сохранении изменений вы получите электронное письмо. Эти письма поступают с notifications@developer.mozilla.org и отправляются на адрес электронной почты, зарегистрированный на вашей учетной записи MDN. Каждое сообщение имеет заголовок формы:</p>
-
-<pre class="notranslate">[MDN] Page "<em>Page title</em>" changed by <em>username</em></pre>
-
-<p>Сообщение начинается с повторения информации в заголовке, а затем представляет стандартный разброс содержимого, показывающий точно, что изменилось. Изменения отображаются как исходный HTML-код, который может быть немного странным для чтения, если вы не используете его в контексте MDN.</p>
-
-<p>Ниже diff есть список полезных ссылок, которые вы можете использовать для изменения, включая:</p>
-
-<ul>
- <li>Просмотр профиля MDN пользователя, внесшего изменения</li>
- <li>Сравнение предыдущих и новых версий страницы с использованием функции истории событий на MDN</li>
- <li>Просмотр статьи в своем браузере</li>
- <li>Редактирование статьи</li>
- <li>Просмотр истории статьи</li>
-</ul>
-
-<p>В нижней части письма есть уведомление о том, какая подписка сгенерировала электронное письмо, например «Вы подписаны на изменения: ссылка на элемент HTML и все его подтемы», а также ссылку на отмену подписки. Если вы нажмете ссылку, чтобы отказаться от подписки, вы больше не будете получать сообщения для этого запроса на просмотр.</p>
diff --git a/files/ru/mdn/tools/search/index.html b/files/ru/mdn/tools/search/index.html
new file mode 100644
index 0000000000..08ba78607f
--- /dev/null
+++ b/files/ru/mdn/tools/search/index.html
@@ -0,0 +1,104 @@
+---
+title: Использование продвинутого поиска
+slug: MDN/User_guide/Advanced_search
+tags:
+  - Guide
+  - MDN
+translation_of: MDN/Tools/Search
+---
+<div>{{MDNSidebar}}</div><p><span class="seoSummary">В качестве дополнительной возможности внесения для вкладчиков в MDN у нас есть продвинутый механизм поиска, который позволяется вам искать по исходному коду страницы — то есть, по сырому HTML сайта, с макросами вместо их вывода — что позволяет искать использования определённых макросов, атрибутов HTML и тому подобное.</span></p>
+<p>На текущий момент для использования продвинутого механизма поиска нет пользовательского интерфейса, но вы можете получить к нему доступ посредством специально сформированных URL. Вы можете получить вывод либо на стандартную страницу с результатами поиска по MDN, либо в формате JSON (последнее означает, что вы можете использовать этот механизм, например, из кода на KumaScript). <span class="seoSummary">Эта статья описывает, как всем этим пользоваться.</span></p>
+<div class="note">
+ <p><strong>Примечание:</strong> эти поисковые запросы не предназначены для конструирования распространяемых URL; а предназначены для использования во вспомогательных инструментах и утилитах. В будущем они могут измениться, также не обязательно, что эти запросы самые эффективные.</p>
+</div>
+
+<h2 id="Search_query_format" name="Search_query_format">Формат поискового запроса</h2>
+<p>Продвинутые поисковые запросы позволяются конструировать URL с соответствующими параметрами. Базовый URL может быть одним из следующих:</p>
+<dl>
+ <dt><code>https://developer.mozilla.org/en-US/search</code></dt>
+ <dd>Используйте этот базовый URL для получения стандартной страницы с результатами поиска по MDN.</dd>
+ <dt><code>https://developer.mozilla.org/en-US/search.json</code></dt>
+ <dd>Используйте этот базовый URL для получения результатов в формате JSON. О формате результата смотрите раздел {{anch("JSON_result_format", "формат JSON для результата")}}.</dd>
+</dl>
+<p>Кроме того, вам нужно добавить соответствующие параметры для получения желаемого результата. Вы можете использовать любую комбинацию следующих параметров:</p>
+<dl>
+ <dt><code>locale=</code></dt>
+ <dd>Рассматриваемая локаль. По умолчанию рассматриваются все локали. Также вы можете явно указать «все локали» при помощи шаблона <code>"*"</code>. Например, вы можете определить <code>locale=en-US</code> для ограничения поиска только по англоязычным страницам.</dd>
+ <dt><code>css_classnames=</code></dt>
+ <dd>Классы CSS для сопоставления. Этот параметр ограничивает результат поиска страницами, чей HTML-код включает в сеся как минимум одно использование указанных классов.</dd>
+ <dt><code>html_attributes=</code></dt>
+ <dd>Текст атрибутов HTML для сопоставления. Поиск ведётся по началу текста; то есть, если указаный текст появляется в начале строки атрибута HTML, он будет считаться совпавшим. Подробности смотрите ниже.</dd>
+ <dt><code>kumascript_macros=</code></dt>
+ <dd>Список искомых макросов KumaScript. Этот параметр позволяет вам находить статьи, использующие определённый макрос; это может быть полезно в тех случаях, если, к примеру, макрос устарел или его параметры поменялись и вам нужно обновить существующие варианты его использования.</dd>
+</dl>
+
+<h2 id="Examples" name="Examples">Примеры</h2>
+<p>Здесь приведено несколько примеров поисковых запросов.</p>
+
+<h3 id="Searching_by_locale" name="Searching_by_locale">Поиск по локали</h3>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US</pre>
+<p>В этом примере возвращается список всех англоязычных статей без каких-либо иных ограничений. На момент написания этой статьи их было 12865 (к тому времени, как вы прочитаете эту статью, их, конечно же, станет больше, поскольку мы постоянно растём)!</p>
+
+<h3 id="Searching_by_CSS_class_name" name="Searching_by_CSS_class_name">Поиск по имени CSS-класса</h3>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US&amp;css_classnames=smaller</pre>
+<p>В этом примере мы добавили к поисковому условию использование CSS-класса <code>"smaller"</code>; на момент написания этой статьи количество результатов снизилось всего до 6 страниц.</p>
+
+<h3 id="Searching_by_HTML_attribute_string" name="Searching_by_HTML_attribute_string">Поиск по строке атрибута HTML</h3>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US&amp;html_attributes=style</pre>
+<p>Здесь мы ищем использования атрибута <code>"style"</code> на элементах HTML. На момент написания этой статьи мы нашли 4935 таких страниц. Это плохо и это нужно искоренять; мы собираемся заменить все такие вхождения на наши стандартные классы.</p>
+<p>Также вы можете включать в поисковый запрос значение атрибута, но помните, что если вы захотите включить символы вроде <code>"="</code> или <code>"/"</code> в ваш поисковый запрос, вы должны их закодировать для использования в URL. Например, чтобы найти страницы, ссылающиеся на www.mozilla.org, вы можете сделать так:</p>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US&amp;html_attributes=href%3D%22https%3A%2F%2Fwww.mozilla.org</pre>
+<p>Этот поиск вернул 29 результатов. Это удивительно малое количество ссылок на сайт www.mozilla.org!</p>
+
+<h3 id="Searching_for_KumaScript_macro_usage" name="Searching_for_KumaScript_macro_usage">Поиск по используемому макросу KumaScript</h3>
+<pre>https://developer.mozilla.org/en-US/search?locale=en-US&amp;kumascript_macros=unimplemented_header</pre>
+<p>Этот поисковый запрос ищет использования макроса {{TemplateLink("unimplemented_header")}}. На момент написания этой статьи было найдено шесть страниц. Он позволяет нам искать макросы, чьи параметры были изменены, либо те, которые мы хотим прекратить использовать (последний случай как раз относится к рассматриваемому макросу).</p>
+
+<h2 id="JSON_result_format" name="JSON_result_format">Формат JSON для результата</h2>
+<p>Когда вы запрашиваете результат в формате JSON, вы по прежнему получаете результаты по одной странице за раз. Каждая страница является объектом KumaScript, который состоит из нескольких частей с метаданными о результатах, плюс массив стандартных объектов страницы с одним дополнительным полем: URL-адресом для начала редактирования страницы.</p>
+<p>В результирующем объекте содержатся следующие данные:</p>
+<dl>
+ <dt><code>count</code></dt>
+ <dd>Общее количество найденных результатов.</dd>
+ <dt><code>next</code></dt>
+ <dd>URL, по которому можно перейти на следующую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для последней страницы).</dd>
+ <dt><code>previous</code></dt>
+ <dd>URL, по которому можно перейти на предыдущую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для первой страницы).</dd>
+ <dt><code>query</code></dt>
+ <dd>???</dd>
+ <dt><code>page</code></dt>
+ <dd>Номер страницы с результатами, описываемой этим объектом.</dd>
+ <dt><code>pages</code></dt>
+ <dd>Общее количество страниц с результатами.</dd>
+ <dt><code>start</code></dt>
+ <dd>Номер первого элемента на этой странице с результатами.</dd>
+ <dt><code>end</code></dt>
+ <dd>Номер последнего элемента на этой странице с результатами.</dd>
+ <dt><code>filters</code></dt>
+ <dd>Массив конфигураций расличных поисковых фильтров. Эти фильтры доступны в стандартном поиске.</dd>
+ <dt><code>documents</code></dt>
+ <dd>Массив {{anch("Page_objects", "объектов страницы")}}, описывающих каждую совпавшую страницу.</dd>
+</dl>
+
+<h3 id="Page_objects" name="Page_objects">Объекты страницы</h3>
+<p>Каждый объект страницы содержит следующие поля:</p>
+<dl>
+ <dt><code>title</code></dt>
+ <dd>Заголовок статьи.</dd>
+ <dt><code>slug</code></dt>
+ <dd>Идентификатор статьи. Это вся часть URL страницы, следующая за локалью и последующим символом слеша.</dd>
+ <dt><code>locale</code></dt>
+ <dd>Локаль страницы.</dd>
+ <dt><code>excerpt</code></dt>
+ <dd>Фрагмент содержания страницы; это либо первый блок обычного текста статьи, либо содержимое, отмеченное классом "SEO Summary".</dd>
+ <dt><code>url</code></dt>
+ <dd>Полный URL страницы.</dd>
+ <dt><code>edit_url</code></dt>
+ <dd>Полный URL страницы в режиме редактирования.</dd>
+ <dt><code>tags</code></dt>
+ <dd>Массив меток страницы.</dd>
+ <dt><code>score</code></dt>
+ <dd>Значение очков, присвоенное странице поисковым движком.</dd>
+ <dt><code>explanation</code></dt>
+ <dd>Различная информация от поискового движка о том, почему страница соответствует вашему запросу. Описание этого содержимого выходит за рамки данного документа.</dd>
+</dl>
diff --git a/files/ru/mdn/tools/url-suffix/index.html b/files/ru/mdn/tools/unsupported_get_api/index.html
index d42d9c436e..d42d9c436e 100644
--- a/files/ru/mdn/tools/url-suffix/index.html
+++ b/files/ru/mdn/tools/unsupported_get_api/index.html