chore(ru): content clean up for markdown-lint-cli bump (#17196)

* chore(ru): content clean up for markdown-lint-cli bump * move the examples to example section * [ru] add code highlighting to 'tabindex' attribute * [ru] imrpve translation of term 'alpha blend' * [ru] use 'const' and 'let' instead of 'var' as more modern approach * [ru] improe indents --------- Co-authored-by: Leonid Vinogradov <[email protected]>
mdn · Dec 1, 2023 · d53b657 · d53b657
1 parent 31dbe80
commit d53b657
Show file tree

Hide file tree

Showing 18 changed files with 170 additions and 183 deletions.
diff --git a/files/ru/learn/tools_and_testing/cross_browser_testing/introduction/index.md b/files/ru/learn/tools_and_testing/cross_browser_testing/introduction/index.md
@@ -53,7 +53,7 @@ slug: Learn/Tools_and_testing/Cross_browser_testing/Introduction
 
 Рабочий процесс над тестированием и исправлением ошибок может быть разбит на следующие четыре фазы (очень грубое разделение - у разных людей этот процесс может очень сильно отличаться):
 
-**Начальное планирование > Разработка > Тестирование > Исправление ошибок**
+**Начальное планирование** > **Разработка** > **Тестирование** > **Исправление ошибок**
 
 Шаги 2-4 будут повторяться до тех пор, пока не будут реализованы все возможности. Мы рассмотрим различные элементы процесса тестирования более детально в следующих статьях, но пока давайте соберём то, что может происходить на каждом этапе.
 

diff --git a/files/ru/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md b/files/ru/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md
@@ -47,7 +47,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension
 
 Вместо указания несколько фоновых сценариев вы можете указать фоновую страницу, которая так же преимущества поддержки ES6 модулей:
 
-**manifest.json**
+**manifest.json:**
 
 ```json
 // manifest.json
@@ -57,7 +57,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension
 }
 ```
 
-**background-page.html**
+**background-page.html:**
 
 ```html
 <!doctype html>

diff --git a/files/ru/web/accessibility/keyboard-navigable_javascript_widgets/index.md b/files/ru/web/accessibility/keyboard-navigable_javascript_widgets/index.md
@@ -56,7 +56,7 @@ _Пример 1: Простой виджет, эмулирующий работ
 
 Ниже приведён пример, который демонстрирует использование этой техники для реализации вложенного меню. После того, как в фокус попадает основной элемент меню ({{HTMLElement("ul")}}), разработчик должен программно управлять фокусом, реагируя на нажатия клавиш со стрелочками. Для описания техники управления фокусом внутри виджета смотрите раздел «Управление фокусом внутри виджета» ниже в данной статье.
 
-_Пример 2: Меню, использующее атрибут tabindex для осуществления доступа с клавиатуры_
+_Пример 2: Меню, использующее атрибут `tabindex` для осуществления доступа с клавиатуры._
 
 ```html
 <ul id="mb1" tabindex="0">

diff --git a/files/ru/web/api/history/pushstate/index.md b/files/ru/web/api/history/pushstate/index.md
@@ -15,14 +15,13 @@ history.pushState(state, title[, url])
 
 ### Параметры
 
-**state object**
+- `state`
 
-- Объект состояния – это JavaScript-объект, связанный с новой записью в истории, созданной `pushState()`. Всякий раз, когда пользователь переходит к новому состоянию, происходит событие `popstate`, а свойство `state` этого события содержит копию объекта состояния с записями истории.
-- Объект состояния может быть чем угодно, что может быть сериализовано. Поскольку Firefox сохраняет объекты состояния на диске пользователя, чтобы их можно было восстановить после перезапуска браузера, мы накладываем ограничение в 640 тысяч символов на сериализованное представление объекта состояния. Если вы передаёте объект состояния, чьё сериализованное представление больше этого значения, метод `pushState()` выдаст исключение. Если вам нужно хранилище большего размера, следует рассмотреть использование `sessionStorage` и/или `localStorage`.
+  - : Объект состояния – это JavaScript-объект, связанный с новой записью в истории, созданной `pushState()`. Всякий раз, когда пользователь переходит к новому состоянию, происходит событие `popstate`, а свойство `state` этого события содержит копию объекта состояния с записями истории.
 
-<!---->
+    Объект состояния может быть чем угодно, что может быть сериализовано. Поскольку Firefox сохраняет объекты состояния на диске пользователя, чтобы их можно было восстановить после перезапуска браузера, мы накладываем ограничение в 640 тысяч символов на сериализованное представление объекта состояния. Если вы передаёте объект состояния, чьё сериализованное представление больше этого значения, метод `pushState()` выдаст исключение. Если вам нужно хранилище большего размера, следует рассмотреть использование `sessionStorage` и/или `localStorage`.
 
-- **title**
+- `title`
   - : Заголовок - [все браузеры, кроме Safari, на данный момент игнорируют этот параметр](https://github.com/whatwg/html/issues/2174), но могут начать использовать в будущем. Ввиду будущих изменений метода, безопасным решением является передача пустой строки. В качестве альтернативы вы можете передать короткий заголовок для состояния, в которое переходите.
 - `url` {{optional_inline}}
   - : Через этот параметр передаётся URL-адрес новой записи в истории. Обратите внимание, что браузер не будет пытаться загрузить данный URL сразу после вызова `pushState()`, но может попытаться сделать это позже, например, после того, как пользователь перезапустит браузер. Новый URL-адрес не обязан быть абсолютным; если он относительный, то определяется относительно текущего URL. Новый URL должен вести на тот же домен, протокол и порт, иначе `pushState()` выдаст исключение. Данный параметр не является обязательным; если он не указан, будет использоваться URL текущего документа.

diff --git a/files/ru/web/api/svgtextcontentelement/index.md b/files/ru/web/api/svgtextcontentelement/index.md
@@ -29,7 +29,7 @@ _Этот интерфейс также наследует свойства от
 
 ## Методы
 
-_Этот интерфейс также наследует методы от его родителя, {{domxref("SVGGraphicsElement")}}_
+_Этот интерфейс также наследует методы от его родителя, {{domxref("SVGGraphicsElement")}}._
 
 - {{domxref("SVGTextContentElement.getNumberOfChars()")}}
   - : Возвращает длину, представляющую общее количество адресуемых символов, доступных для рендеринга в текущем элементе, независимо от того, будут ли они отображаться.

diff --git a/files/ru/web/api/touch/index.md b/files/ru/web/api/touch/index.md
@@ -18,7 +18,7 @@ slug: Web/API/Touch
 
 ## Свойства
 
-_Данный интерфейс не имеет предков, не наследует и не реализует другие свойства_
+_Данный интерфейс не имеет предков, не наследует и не реализует другие свойства._
 
 ### Основные свойства
 

diff --git a/files/ru/web/api/urlsearchparams/index.md b/files/ru/web/api/urlsearchparams/index.md
@@ -27,7 +27,7 @@ _Наследование свойств отсутствует._
 
 ## Методы
 
-_Отсутствует наследование методов_
+_Отсутствует наследование методов._
 
 - {{domxref("URLSearchParams.append()")}}
   - : Добавляет указанную пару key/value в качестве нового параметра поиска.

diff --git a/files/ru/web/api/webglrenderingcontext/index.md b/files/ru/web/api/webglrenderingcontext/index.md
@@ -54,11 +54,8 @@ var gl = canvas.getContext("webgl");
   - : Устанавливает параметры смешивания источника и назначения
 - {{domxref("WebGLRenderingContext.blendEquation()")}}
   - : Уравнение смешивания RGB и уравнение альфа-смешивания сводит к одному уравнению.
-
-**{{domxref("WebGLRenderingContext.blendEquationSeparate()")}}**
-
-Устанавливает уравнение смешивания RGB и уравнение alpha смешивания отдельно.
-
+- {{domxref("WebGLRenderingContext.blendEquationSeparate()")}}
+  - : Устанавливает уравнение смешивания RGB и уравнение альфа-смешивания отдельно.
 - {{domxref("WebGLRenderingContext.blendFunc()")}}
   - : Определяет, какая арифметическая функция используется для смешивания пикселей.
 - {{domxref("WebGLRenderingContext.blendFuncSeparate()")}}

diff --git a/files/ru/web/api/webrtc_api/using_data_channels/index.md b/files/ru/web/api/webrtc_api/using_data_channels/index.md
@@ -56,10 +56,6 @@ requestRemoteChannel(dataChannel.id);
 
 Каналы данных WebRTC поддерживают буферизацию исходящих данных. Это работает автоматически. Несмотря на то, что нет способа контролировать размер буфера, вы можете узнать, сколько данных в настоящее время буферизуется, и вы можете выбрать уведомление о событии, когда в буфере начинают заканчиваться данные в очереди. Это облегчает написание эффективных подпрограмм, которые гарантируют, что всегда есть данные, готовые к отправке, без чрезмерного использования памяти или полного переполнения канала.
 
-**<<\<write more about using bufferedAmount, bufferedAmountLowThreshold, onbufferedamountlow, and bufferedamountlow here>>>**
-
-...
-
 ## Ограничения размеров сообщений
 
 Для любых данных, передаваемых по сети, существуют ограничения по размеру. На фундаментальном уровне отдельные сетевые пакеты не могут быть больше определённого значения (точное число зависит от сети и используемого транспортного уровня). На уровне приложения, то есть в пределах {{Glossary("user agent", "user agent's")}} реализация WebRTC, в которой работает ваш код, реализует функции поддержки сообщений, размер которых превышает максимальный размер пакета на транспортном уровне сети.

diff --git a/files/ru/web/css/all/index.md b/files/ru/web/css/all/index.md
@@ -45,7 +45,7 @@ all: revert;
 
 ## Примеры
 
-**HTML**
+### HTML
 
 ```html
 <blockquote id="quote">
@@ -54,7 +54,7 @@ all: revert;
 Phasellus eget velit sagittis.
 ```
 
-**CSS**
+### CSS
 
 ```css
 html {

diff --git a/files/ru/web/css/specificity/index.md b/files/ru/web/css/specificity/index.md
@@ -88,7 +88,7 @@ p.awesome {
 
 Как сделать цвет текста в абзацах `awesome` красным всегда, даже если они расположены внутри `#someElement`? Без `!important` у первого правила специфичность больше и оно имеет преимущество перед вторым.
 
-**Как преодолеть !important**
+**Как преодолеть !important:**
 
 A) Просто добавьте ещё одно правило с модификатором `!important`, у которого селектор имеет большую специфичность (благодаря добавлению типа элемента (тэга), идентификатора (атрибута id) или класса к селектору).
 

diff --git a/files/ru/web/javascript/reference/functions/set/index.md b/files/ru/web/javascript/reference/functions/set/index.md
@@ -102,7 +102,7 @@ console.log(obj.baz); // "baz"
 
 {{Specifications}}
 
-**Совместимость с браузерами**
+## Совместимость с браузерами
 
 {{Compat}}