docs(ru): update translations (#4024)

docs/ru/guide/markdown.md

@@ -233,7 +233,7 @@ export default defineConfig({
 
 Это специальный контейнер, который можно использовать для предотвращения конфликтов стилей и маршрутизаторов с VitePress. Это особенно полезно при документировании библиотек компонентов. Вы также можете посмотреть [whyframe](https://whyframe.dev/docs/integrations/vitepress) для лучшей изоляции.
 
-**Syntax**
+**Синтаксис**
 
 ```md
 ::: raw
@@ -836,6 +836,43 @@ export default config
 
 Формат выбранного диапазона строк может быть следующим: `{3,}`, `{,10}`, `{1,10}`
 
+Вы также можете использовать [блоки кода VS Code](https://code.visualstudio.com/docs/editor/codebasics#_folding), чтобы включить только соответствующую часть файла. Можно указать пользовательское имя блока после `#`, следующего за путём к файлу:
+
+**Разметка**
+
+```md
+# Документация
+
+## Основы
+
+<!--@include: ./parts/basics.md#basic-usage{,2}-->
+<!--@include: ./parts/basics.md#basic-usage{5,}-->
+```
+
+**Часть файла** (`parts/basics.md`)
+
+```md
+<!-- #region basic-usage -->
+## Используемая строка 1
+
+## Используемая строка 2
+
+## Используемая строка 3
+<!-- #endregion basic-usage -->
+```
+
+**Эквивалентный код**
+
+```md
+# Документация
+
+## Основы
+
+## Используемая строка 1
+
+## Используемая строка 3
+```
+
 ::: warning ПРЕДУПРЕЖДЕНИЕ
 Обратите внимание, что это не приводит к ошибкам, если ваш файл отсутствует. Поэтому при использовании этой функции убедитесь, что содержимое отображается так, как ожидается.
 :::

docs/ru/reference/default-theme-nav.md

@@ -160,3 +160,57 @@ export default {
 ## Социальные ссылки {#social-links}
 
 См. [`socialLinks`](./default-theme-config#sociallinks).
+
+## Пользовательские компоненты
+
+Вы можете добавить пользовательские компоненты в панель навигации с помощью опции `component`. Ключ `component` должен быть именем компонента Vue и должен быть зарегистрирован глобально с помощью [Theme.enhanceApp](../guide/custom-theme#theme-interface).
+
+```js
+// .vitepress/config.js
+export default {
+  themeConfig: {
+    nav: [
+      {
+        text: 'Мое меню',
+        items: [
+          {
+            component: 'MyCustomComponent',
+            // Необязательные параметры для передачи компоненту
+            props: {
+              title: 'Мой пользовательский компонент'
+            }
+          }
+        ]
+      },
+      {
+        component: 'AnotherCustomComponent'
+      }
+    ]
+  }
+}
+```
+
+Затем необходимо зарегистрировать компонент глобально:
+
+```js
+// .vitepress/theme/index.js
+import DefaultTheme from 'vitepress/theme'
+
+import MyCustomComponent from './components/MyCustomComponent.vue'
+import AnotherCustomComponent from './components/AnotherCustomComponent.vue'
+
+/** @type {import('vitepress').Theme} */
+export default {
+  extends: DefaultTheme,
+  enhanceApp({ app }) {
+    app.component('MyCustomComponent', MyCustomComponent)
+    app.component('AnotherCustomComponent', AnotherCustomComponent)
+  }
+}
+```
+
+Ваш компонент будет отображаться на панели навигации. VitePress предоставляет следующие дополнительные параметры компонента:
+
+- `screenMenu`: необязательное булево значение, указывающее, находится ли компонент внутри мобильного навигационного меню
+
+Пример можно посмотреть в тестах e2e [здесь](https://github.com/vuejs/vitepress/tree/main/__tests__/e2e/.vitepress).

docs/ru/reference/default-theme-search.md

@@ -39,18 +39,25 @@ export default defineConfig({
       provider: 'local',
       options: {
         locales: {
-          ru: {
+          ru: { // используйте ключ `root`, если хотите перевести локаль по умолчанию
             translations: {
               button: {
                 buttonText: 'Поиск',
                 buttonAriaLabel: 'Поиск'
               },
               modal: {
-                noResultsText: 'Нет результатов для',
+                displayDetails: 'Отобразить подробный список',
                 resetButtonTitle: 'Сбросить поиск',
+                backButtonTitle: 'Закрыть поиск',
+                noResultsText: 'Нет результатов по запросу',
                 footer: {
                   selectText: 'выбрать',
-                  navigateText: 'перейти'
+                  selectKeyAriaLabel: 'выбрать',
+                  navigateText: 'перейти',
+                  navigateUpKeyAriaLabel: 'стрелка вверх',
+                  navigateDownKeyAriaLabel: 'стрелка вниз',
+                  closeText: 'закрыть',
+                  closeKeyAriaLabel: 'esc'
                 }
               }
             }

docs/ru/reference/site-config.md

@@ -489,14 +489,16 @@ export default {
 
 ### appearance {#appearance}
 
-- Тип: `boolean | 'dark' | 'force-dark' | import('@vueuse/core').UseDarkOptions`
+- Тип: `boolean | 'dark' | 'force-dark' | 'force-auto' | import('@vueuse/core').UseDarkOptions`
 - По умолчанию: `true`
 
 Включать ли тёмный режим (путём добавления класса `.dark` к элементу `<html>`).
 
 - Если опция имеет значение `true`, тема по умолчанию будет определяться цветовой гаммой, предпочитаемой пользователем.
 - Если опция имеет значение `dark`, тема по умолчанию будет тёмной, если пользователь не переключит её вручную.
 - Если установить значение `false`, пользователи не смогут переключать тему.
+- Если для опции установлено значение `force-dark`, тема всегда будет темной, и пользователи не смогут её переключать.
+- Если для опции установлено значение `force-auto`, тема всегда будет определяться предпочитаемой пользователем цветовой схемой, и пользователи не смогут её переключать.
 
 Эта опция вставляет встроенный скрипт, который восстанавливает настройки пользователей из локального хранилища с помощью ключа `vitepress-theme-appearance`. Это гарантирует, что класс `.dark` будет применён до отрисовки страницы, чтобы избежать мерцания.