initial commit

3 files changed, 165 insertions, 0 deletions

diff --git a/files/ru/mdn/tools/index.html b/files/ru/mdn/tools/index.html
new file mode 100644
index 0000000000..843f3984f2
--- /dev/null
+++ b/files/ru/mdn/tools/index.html
@@ -0,0 +1,15 @@
+---
+title: MDN tools
+slug: MDN/Tools
+tags:
+  - Landing
+  - MDN Meta
+translation_of: MDN/Tools
+---
+<div>{{MDNSidebar}}</div>
+
+<div>{{IncludeSubnav("/ru/docs/MDN")}}</div>
+
+<p>Чтобы успевать за изменениями на сайте, MDN предлагает ряд функций, облегчающих отслеживание прогресса и управление контентом.</p>
+
+<p>{{LandingPageListSubpages}}</p>
diff --git a/files/ru/mdn/tools/page_watching/index.html b/files/ru/mdn/tools/page_watching/index.html
new file mode 100644
index 0000000000..04b9dc05ad
--- /dev/null
+++ b/files/ru/mdn/tools/page_watching/index.html
@@ -0,0 +1,50 @@
+---
+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/url-suffix/index.html b/files/ru/mdn/tools/url-suffix/index.html
new file mode 100644
index 0000000000..d42d9c436e
--- /dev/null
+++ b/files/ru/mdn/tools/url-suffix/index.html
@@ -0,0 +1,100 @@
+---
+title: URL-суффиксы
+slug: MDN/Tools/URL-suffix
+tags:
+  - HTTP
+  - Kuma
+  - MDN Мета
+  - URL
+  - Параметры URL
+  - инструменты
+translation_of: MDN/Tools/Document_parameters
+---
+<div>{{MDNSidebar}}</div>
+
+<section id="intro">
+<p id="Introduction"><span class="seoSummary">Вики-платформа MDN Kuma не имеет центрального API. Вместо этого наш общий подход заключается в том, чтобы предложить способы превращения доступных для человека ресурсов в удобные для машин данные.</span></p>
+</section>
+
+<section id="params">
+<h2 id="Параметры_URL_GET"><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Параметры URL GET</span></span></span></h2>
+
+<p><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Мы поддерживаем несколько полезных параметров запроса для каждого URL-адреса вики-документа Kuma при получении через HTTP GET или просмотре в браузере.</span></span></span></p>
+
+<p><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Несколько параметров запроса разделяются знаком <kbd>&amp;</kbd> вместо начального <kbd>?</kbd>.</span></span> <span class="ChMk0b JLqJ4b"><span>(См. Примеры макроса.)</span></span></span></p>
+
+<dl>
+ <dt><code>summary</code></dt>
+ <dd>
+ <p><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Указывает Куме возвращать только сводку страницы.</span></span> <span class="ChMk0b JLqJ4b"><span>Если на странице есть контент, помеченный классом «Сводка SEO», этот контент возвращается.</span></span> <span class="ChMk0b JLqJ4b"><span>Если такого содержания нет, возвращается содержание раздела «Сводка».</span></span> <span class="ChMk0b JLqJ4b"><span>В противном случае возвращается содержимое первого блока.</span></span></span></p>
+
+ <div class="note"><strong><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Уведомление об ошибке</span></span></span>:</strong> <span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>В настоящее время существует ошибка, из-за которой сводный параметр возвращает весь документ, если вы также не укажете необработанный параметр.</span></span> <span class="ChMk0b JLqJ4b"><span>Обратите внимание, что вы также можете получить сводку из возвращенного JSON, <a href="/ru/docs/MDN/Tools/URL-suffix#json-view">используя альтернативное представление $ json</a>.</span></span></span></div>
+ </dd>
+ <dt><code>raw</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Указывает Kuma вернуть необработанное содержимое страницы без какого-либо материала обложки, такого как верхние, нижние колонтитулы и т. д.</span></span> <span class="ChMk0b JLqJ4b"><span>При этом не выполняются шаблоны или сценарии, что удобно для редакторов сборки.</span></span></span></dd>
+ <dd><strong>Пример:</strong> <a href="https://wiki.developer.mozilla.org/ru/docs/HTML/HTML5?raw">https://wiki.developer.mozilla.org/ru/docs/HTML/HTML5?raw</a></dd>
+ <dt><code>macros</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Поручает Kuma выполнить все шаблоны на странице.</span></span> <span class="ChMk0b JLqJ4b"><span>В сочетании с <code>?raw</code> это предлагает полностью визуализированный контент MDN без оболочки сайт</span></span></span> . <span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Поручает Kuma выполнить все шаблоны на странице.</span></span> <span class="ChMk0b JLqJ4b"><span>В сочетании с <code>?raw</code> это предлагает полностью визуализированный контент MDN без оболочки сайта.</span></span></span> <span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>По умолчанию включено без  <code>?raw</code> (то есть при обычном просмотре сайта), по умолчанию выключено, когда присутствует <code>?raw</code>.</span></span></span></dd>
+ <dd><strong>Пример:</strong> <a href="https://wiki.developer.mozilla.org/ru/docs/HTML/HTML5?raw&amp;macros">https://wiki.developer.mozilla.org/ru/docs/HTML/HTML5?raw&amp;macros</a></dd>
+ <dt><code>nomacros</code></dt>
+ <dd>
+ <div class="J0lOec"><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Указывает Kuma не выполнять шаблоны KumaScript на странице.</span></span> <span class="ChMk0b JLqJ4b"><span>Поскольку при обычном просмотре сайта для <code>?macros</code> по умолчанию установлено значение «включено», этот параметр отключает его.</span></span></span></div>
+ </dd>
+ <dd><strong>Пример:</strong> <a href="https://wiki.developer.mozilla.org/ru/docs/HTML/HTML5?nomacros">https://wiki.developer.mozilla.org/ru/docs/HTML/HTML5?nomacros</a></dd>
+ <dt><code>include</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Говорит Kuma удалить все блоки, на которых есть класс <code>noinclude</code>.</span></span> <span class="ChMk0b JLqJ4b"><span>Это полезно для получения вывода таким, каким он был бы при включении на другую страницу, а не на отдельной странице.</span></span> <span class="ChMk0b JLqJ4b"><span>Часто это удаляет образец кода и тому подобное (хотя не всегда).</span></span></span></dd>
+ <dd><strong>Пример:</strong> <a href="https://wiki.developer.mozilla.org/ru/docs/Archive/Mozilla/XUL/Attribute/align?raw&amp;macros&amp;include">https://wiki.developer.mozilla.org/ru/docs/Archive/Mozilla/XUL/Attribute/align?raw&amp;macros&amp;include</a></dd>
+ <dt><code>section=id</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Указывает Kuma вернуть содержимое только из раздела с указанным якорем/именем привязки.</span></span></span></dd>
+ <dd><strong>Пример:</strong>
+ <ul>
+  <li><a href="/ru/docs/MDN/Tools/URL-suffix?raw&amp;section=params">https://wiki.developer.mozilla.org/ru/docs/MDN/Tools/URL-suffix?raw&amp;section=params</a><br>
+   (...и больше интересного...)</li>
+  <li><a href="/ru/docs/MDN/Tools/URL-suffix?raw&amp;macros&amp;section=params">https://wiki.developer.mozilla.org/ru/docs/MDN/Tools/URL-suffix?raw&amp;macros&amp;section=params</a></li>
+ </ul>
+
+ <div class="note"><strong><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Уведомление об ошибке</span></span></span>: </strong> <span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>В настоящее время существует ошибка, из-за которой параметр</span></span></span> <code>section</code>  <span class="VIiyi" lang="ru"><span class="C1N51c ChMk0b JLqJ4b"><span>возвращает весь документ, если вы также не укажете параметр</span></span></span> <code>raw</code>.</div>
+ </dd>
+ <dt><code>expand</code></dt>
+ <dd>
+ <p><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>В сочетании с представлением <code>$children</code> расширяет ответ JSON с подробной информацией для каждой подстраницы.</span></span> <span class="ChMk0b JLqJ4b"><span>Он работает как комбинация <code>$children</code> и <code>$json</code> на каждой подстранице.</span></span> <span class="ChMk0b JLqJ4b"><span>Таким образом, можно узнать о тегах для подстраницы.</span></span></span></p>
+
+ <p><strong>Пример:</strong> <a href="/ru/docs/MDN/About$children?expand">https://wiki.developer.mozilla.org/ru/docs/MDN/About$children?expand</a></p>
+ </dd>
+</dl>
+</section>
+
+<section id="metadata">
+<h2 id="Ресурсы_метаданных_документа"><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Ресурсы метаданных документа</span></span></span></h2>
+
+<p>Наряду с параметрами для настройки ответа URL-адреса документа существуют также некоторые альтернативные представления документов, заданные суффиксом URL-адреса:</p>
+
+<dl>
+ <dt><code>$toc</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Указывает Kuma вернуть только оглавление страницы в HTML.</span></span> <span class="ChMk0b JLqJ4b"><span>Он возвращается как упорядоченный список (то есть</span></span></span> , {{HTMLElement("ol")}}).</dd>
+ <dd><strong>Пример:</strong> <a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Tools/URL-suffix$toc">https://wiki.developer.mozilla.org/ru/docs/MDN/Tools/URL-suffix$toc</a></dd>
+ <dt id="json-view"><code>$json</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Сообщает Kuma описать страницу в объекте JSON.</span></span> <span class="ChMk0b JLqJ4b"><span>Этот объект по сути тот же, что и при использовании подпрограммы KumaScript <code>wiki.getPage()</code>.</span></span></span></dd>
+ <dd><strong>Пример:</strong> <a href="/ru/docs/MDN/About$json">https://wiki.developer.mozilla.org/ru/docs/MDN/About$json</a></dd>
+ <dt><code>$children</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Говорит Kuma перечислить дочерние темы страницы в JSON.</span></span> <span class="ChMk0b JLqJ4b"><span>Этот объект по сути тот же, что и при использовании подпрограммы KumaScript</span></span></span> <code>pages.subpages()</code>.</dd>
+ <dd><strong>Пример:</strong> <a href="/ru/docs/MDN/Contribute$children">https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute$children</a></dd>
+ <dd>
+ <div class="J0lOec"><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>(<code>М</code>ожно использовать с параметром <code>?expand</code> для получения более подробного ответа.)</span></span></span></div>
+ </dd>
+ <dt><code>$compare</code></dt>
+ <dd>
+ <p>Представляет различия строк исходного текста между ревизиями, указанными в требуемых параметрах запроса <code>?from</code> и <code>?to</code>.</p>
+ </dd>
+ <dd><strong>Пример:</strong> <a href="/ru/docs/Web/API/KeyboardEvent/key/Key_Values$compare?locale=ru&amp;to=1651013&amp;from=1650680">https://wiki.developer.mozilla.org/ru/docs/Web/API/KeyboardEvent/key/Key_Values$compare?locale=ru&amp;to=1651013&amp;from=1650680</a></dd>
+ <dt><code>$edit</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Редактирует текущую ревизию данного документа вместо его отображения.</span></span></span></dd>
+ <dd><strong>Пример:</strong> <a href="/ru/docs/MDN/Tools/URL-suffix$edit">https://wiki.developer.mozilla.org/ru/docs/MDN/Tools/URL-suffix$edit</a></dd>
+ <dt><code>$history</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Показывает историю последних десяти ревизий данного документа вместо его содержимого.</span></span> <span class="ChMk0b JLqJ4b"><span>Полную историю можно запросить с помощью значения параметра запроса <code>?limit=all</code>.</span></span></span></dd>
+ <dd><strong>Пример:</strong> <a href="/ru/docs/MDN/Tools/URL-suffix$history?limit=all">https://wiki.developer.mozilla.org/ru/docs/MDN/Tools/URL-suffix$history?limit=all</a></dd>
+ <dt><code>$revision</code></dt>
+ <dd><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Отображает номер ревизии документа, который необходимо указать после разделителя «/».</span></span></span></dd>
+ <dd><strong>Пример:</strong> <a href="/ru/docs/MDN/Tools/URL-suffix$revision/1652169">https://wiki.developer.mozilla.org/ru/docs/MDN/Tools/URL-suffix$revision/1652169</a></dd>
+</dl>
+</section>