docs: add Russian translation

packages/plugin-algolia/src/runtime/index.ts

@@ -1,2 +1,2 @@
-export { type Locales, ZH_LOCALES } from './locales';
+export { type Locales, RU_LOCALES, ZH_LOCALES } from './locales';
 export { Search, type SearchProps } from './Search';

website/docs/ru/_nav.json

@@ -0,0 +1,36 @@
+[
+  {
+    "text": "Руководство",
+    "link": "/guide/start/introduction",
+    "activeMatch": "/guide/"
+  },
+  {
+    "text": "Плагины",
+    "link": "/plugin/system/introduction",
+    "activeMatch": "/plugin/"
+  },
+  {
+    "text": "UI",
+    "link": "/ui/vars",
+    "activeMatch": "/ui/",
+    "tag": "новинка"
+  },
+  {
+    "text": "API",
+    "link": "/api/",
+    "activeMatch": "/api/"
+  },
+  {
+    "text": "Версия",
+    "items": [
+      {
+        "text": "Журнал изменений",
+        "link": "https://github.com/web-infra-dev/rspress/releases"
+      },
+      {
+        "text": "Документация Rspress 1.x",
+        "link": "http://rspress.rs/"
+      }
+    ]
+  }
+]

website/docs/ru/api/_meta.json

@@ -0,0 +1,22 @@
+[
+  {
+    "type": "file",
+    "name": "index",
+    "label": "apiOverview"
+  },
+  {
+    "type": "dir",
+    "name": "config",
+    "label": "config"
+  },
+  {
+    "type": "dir",
+    "name": "client-api",
+    "label": "clientApi"
+  },
+  {
+    "type": "file",
+    "name": "commands",
+    "label": "commands"
+  }
+]

website/docs/ru/api/client-api/_meta.json

@@ -0,0 +1 @@
+["api-runtime", "api-components"]

website/docs/ru/api/client-api/api-components.mdx

@@ -0,0 +1,5 @@
+# Встроенные компоненты
+
+import BuiltinComponents from '../../fragments/builtin-components';
+
+<BuiltinComponents />

website/docs/ru/api/client-api/api-runtime.mdx

@@ -0,0 +1,103 @@
+# Runtime API
+
+Rspress предоставляет несколько runtime API, которые удобно использовать для реализации собственной логики.
+
+## usePageData
+
+- **Тип:** `() => PageData`
+
+Получает данные текущей страницы. Возвращает объект, содержащий все данные текущей страницы.
+
+```js
+import { usePageData } from '@rspress/core/runtime';
+
+function MyComponent() {
+  const pageData = usePageData();
+  return <div>{pageData.page.title}</div>;
+}
+```
+
+## useLang
+
+- **Тип:** `() => string`
+
+Получает текущий язык. Возвращает строку — код текущего языка.
+
+```js
+import { useLang } from '@rspress/core/runtime';
+
+function MyComponent() {
+  const lang = useLang();
+  // lang === 'ru-RU'
+  return <div>{lang}</div>;
+}
+```
+
+## useVersion
+
+- **Тип:** `() => string`
+
+Получает текущую версию. Возвращает строку — текущую версию.
+
+```tsx
+import { useVersion } from '@rspress/core/runtime';
+
+export default () => {
+  const version = useVersion();
+  return <div>Текущая версия: {version}</div>;
+};
+```
+
+## useDark
+
+- **Тип:** `() => boolean`
+
+Определяет, включён ли сейчас тёмный режим. Возвращает булево значение.
+
+```js
+import { useDark } from '@rspress/core/runtime';
+
+function MyComponent() {
+  const dark = useDark();
+  return <div>{dark}</div>;
+}
+```
+
+Обратите внимание, что в процессе SSG (статической генерации) хук `useDark` **не может** точно отразить настройку темы браузера пользователя, потому что SSG выполняется на этапе сборки. Только после завершения клиентской гидратации этот хук начнёт возвращать правильное значение темы.
+
+Если вам нужно применить стили тёмной темы уже на этапе SSG, рекомендуется использовать CSS-селектор `.dark`. Rspress добавляет класс `dark` на корневой элемент документа — это работает как при статической генерации, так и на клиенте:
+
+```css
+/* Стиль светлой темы */
+.my-component {
+  color: black;
+  background-color: white;
+}
+
+/* Стиль тёмной темы */
+.dark .my-component {
+  color: white;
+  background-color: #1a1a1a;
+}
+```
+
+## useI18n
+
+import UseI18n from '../../fragments/useI18n';
+
+<UseI18n />
+
+> Подробнее читайте в разделе [Интернационализация](/guide/default-theme/i18n).
+
+## Хуки маршрутизации
+
+Rspress внутренне использует `react-router-dom` и переэкспортирует все его API. Вы можете пользоваться ими так же, как в обычном React-приложении:
+
+```ts
+import { useLocation } from '@rspress/core/runtime';
+
+function MyComponent() {
+  const location = useLocation();
+  return <div>{location.pathname}</div>;
+}
+```

website/docs/ru/api/commands.mdx

@@ -0,0 +1,46 @@
+# Команды
+
+В этой главе вы узнаете о встроенных командах Rspress и о том, как их использовать.
+
+## rspress dev
+
+Команда `rspress dev` используется для запуска локального сервера разработки, который предоставляет среду разработки для предварительного просмотра и отладки документации.
+
+```txt
+Использование: rspress dev [root] [options]
+
+Опции:
+   root                 указать корневую директорию проекта, по умолчанию — `docs` в текущей директории, необязательно
+   -c --config <config> указать путь к файлу конфигурации, может быть относительным или абсолютным
+   --port <port>        указать номер порта
+   --host <host>        указать хост
+   -h, --help           показать справку по команде
+```
+
+## rspress build
+
+Команда `rspress build` используется для сборки сайта документации в продакшен-версии.
+
+```txt
+Использование: rspress build [root] [options]
+
+Опции:
+   root                 указать корневую директорию проекта, по умолчанию — `docs` в текущей директории, необязательно
+   -c --config <config> указать путь к файлу конфигурации, может быть относительным или абсолютным
+   -h, --help           показать справку по команде
+```
+
+## rspress preview
+
+Команда `rspress preview` используется для локального предварительного просмотра файлов, полученных после выполнения команды `rspress build`.
+
+```txt
+Использование: rspress preview [root] [options]
+
+Опции:
+   root                 указать корневую директорию проекта, по умолчанию — `docs` в текущей директории, необязательно
+   -c --config <config> указать путь к файлу конфигурации, может быть относительным или абсолютным
+   --port <port>        указать номер порта
+   --host <host>        указать хост
+   -h, --help           показать справку по команде
+```

website/docs/ru/api/config/_meta.json

@@ -0,0 +1 @@
+["config-basic", "config-theme", "config-frontmatter", "config-build"]