Пользовательский макет!
+ + +Пользовательский макет!
+ +Пользовательский макет!
+ +Пользовательский макет!
+ +{{ data }}
+```
+
+Результат:
+
+```json
+{
+ "hello": "мир"
+}
+```
+
+Вы заметите, что сам загрузчик данных не экспортирует `data`. Это VitePress вызывает метод `load()` за кулисами и неявно раскрывает результат через именованный экспорт `data`.
+
+Это работает, даже если загрузчик асинхронный:
+
+```js
+export default {
+ async load() {
+ // получение удалённых данных
+ return (await fetch('...')).json()
+ }
+}
+```
+
+## Данные из локальных файлов {#data-from-local-files}
+
+Если вам нужно генерировать данные на основе локальных файлов, используйте опцию `watch` в загрузчике данных, чтобы изменения, внесённые в эти файлы, вызывали горячие обновления.
+
+Опция `watch` удобна ещё и тем, что вы можете использовать [шаблоны glob](https://github.com/mrmlnc/fast-glob#pattern-syntax) для соответствия нескольким файлам. Шаблоны могут быть относительными к самому файлу загрузчика, а функция `load()` будет получать совпадающие файлы в виде абсолютных путей.
+
+В следующем примере показана загрузка CSV-файлов и их преобразование в JSON с помощью [csv-parse](https://github.com/adaltas/node-csv/tree/master/packages/csv-parse/). Поскольку этот файл выполняется только во время сборки, вы не будете передавать CSV-парсер клиенту!
+
+```js
+import fs from 'node:fs'
+import { parse } from 'csv-parse/sync'
+
+export default {
+ watch: ['./data/*.csv'],
+ load(watchedFiles) {
+ // watchedFiles будет представлять собой массив абсолютных путей к найденным файлам.
+ // Формируем массив метаданных записи блога, которые можно использовать для визуализации списка в макете темы
+ return watchedFiles.map((file) => {
+ return parse(fs.readFileSync(file, 'utf-8'), {
+ columns: true,
+ skip_empty_lines: true
+ })
+ })
+ }
+}
+```
+
+## `createContentLoader` {#createcontentloader}
+
+При создании сайта, ориентированного на контент, нам часто приходится создавать страницы типа «архив», или «индекс», на которых мы перечисляем все доступные записи в нашей коллекции контента. Например, записи в блоге или страницы API. Мы **можем** реализовать это напрямую с помощью API загрузчика данных, но поскольку это очень распространённый случай использования, VitePress также предоставляет функцию `createContentLoader`, чтобы упростить эту задачу:
+
+```js
+// posts.data.js
+import { createContentLoader } from 'vitepress'
+
+export default createContentLoader('posts/*.md' /* параметры */)
+```
+
+Эта функция принимает шаблон glob относительно [исходного каталога](./routing#source-directory) и возвращает объект `{ watch, load }` загрузчика данных, который может быть использован в качестве экспорта по умолчанию в файле загрузчика данных. В нем также реализовано кэширование на основе временных меток изменения файлов для повышения производительности dev.
+
+Обратите внимание, что загрузчик работает только с файлами Markdown — совпадающие файлы, не относящиеся к Markdown, будут пропущены.
+
+Загруженные данные будут представлять собой массив с типом `ContentData[]`:
+
+```ts
+interface ContentData {
+ // отображаемый URL-адрес страницы, например: /posts/hello.html (не включает `base`)
+ // выполните итерацию вручную или используйте пользовательскую `трансформацию` для нормализации путей
+ url: string
+ // метаданные страницы
+ frontmatter: RecordВсе записи блога
+-
+
- + {{ post.frontmatter.title }} + by {{ post.frontmatter.author }} + +
Демонстрация
+ + + +-
+
- + {{ todo.text }} + +
-
+
- {{ todo.text }} +
` до ``.
+ *
+ * @default 2
+ */
+ level?: number | [number, number] | 'deep'
+
+ /**
+ * Заголовок, который будет отображаться в оглавлении.
+ *
+ * @default 'На этой странице'
+ */
+ label?: string
+}
+```
+
+## socialLinks {#sociallinks}
+
+- Тип: `SocialLink[]`
+
+Вы можете задать эту опцию, чтобы показывать ссылки на ваши социальные аккаунты с помощью иконок в панели навигации.
+
+```ts
+export default {
+ themeConfig: {
+ socialLinks: [
+ { icon: 'github', link: 'https://github.com/vuejs/vitepress' },
+ { icon: 'twitter', link: '...' },
+ // Вы также можете добавить пользовательские иконки, передав SVG в виде строки:
+ {
+ icon: {
+ svg: ''
+ },
+ link: '...',
+ // Вы также можете включить пользовательский ярлык для доступности (необязательно, но рекомендуется):
+ ariaLabel: 'классная ссылка'
+ }
+ ]
+ }
+}
+```
+
+```ts
+interface SocialLink {
+ icon: SocialLinkIcon
+ link: string
+ ariaLabel?: string
+}
+
+type SocialLinkIcon =
+ | 'discord'
+ | 'facebook'
+ | 'github'
+ | 'instagram'
+ | 'linkedin'
+ | 'mastodon'
+ | 'npm'
+ | 'slack'
+ | 'twitter'
+ | 'x'
+ | 'youtube'
+ | { svg: string }
+```
+
+## footer {#footer}
+
+- Тип: `Footer`
+- Можно переопределить для каждой страницы с помощью [метаданных](./frontmatter-config#footer)
+
+Настройка подвала. Вы можете разместить в подвале сообщение или текст об авторских правах, однако он будет отображаться только в том случае, если страница не содержит боковой панели. Это объясняется соображениями дизайна.
+
+```ts
+export default {
+ themeConfig: {
+ footer: {
+ message: 'Опубликовано под лицензией MIT.',
+ copyright: '© 2019 – настоящее время, Эван Ю'
+ }
+ }
+}
+```
+
+```ts
+export interface Footer {
+ message?: string
+ copyright?: string
+}
+```
+
+## editLink {#editlink}
+
+- Тип: `EditLink`
+- Можно переопределить для каждой страницы с помощью [метаданных](./frontmatter-config#editlink)
+
+Ссылка для редактирования позволяет отобразить ссылку для редактирования страницы на сервисах управления Git, таких как GitHub или GitLab. См. секцию [Тема по умолчанию: Ссылка для редактирования](./default-theme-edit-link) для получения более подробной информации.
+
+```ts
+export default {
+ themeConfig: {
+ editLink: {
+ pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
+ text: 'Редактировать эту страницу на GitHub'
+ }
+ }
+}
+```
+
+```ts
+export interface EditLink {
+ pattern: string
+ text?: string
+}
+```
+
+## lastUpdated {#lastupdated}
+
+- Тип: `LastUpdatedOptions`
+
+Позволяет настраивать текст и формат даты последнего обновления.
+
+```ts
+export default {
+ themeConfig: {
+ lastUpdated: {
+ text: 'Обновлено',
+ formatOptions: {
+ dateStyle: 'full',
+ timeStyle: 'medium'
+ }
+ }
+ }
+}
+```
+
+```ts
+export interface LastUpdatedOptions {
+ /**
+ * @default 'Last updated'
+ */
+ text?: string
+
+ /**
+ * @default
+ * { dateStyle: 'short', timeStyle: 'short' }
+ */
+ formatOptions?: Intl.DateTimeFormatOptions & { forceLocale?: boolean }
+}
+```
+
+## algolia {#algolia}
+
+- Тип: `AlgoliaSearch`
+
+Опция для поддержки поиска на вашем сайте документации с помощью [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch). Подробнее в главе [Тема по умолчанию: Поиск](./default-theme-search)
+
+```ts
+export interface AlgoliaSearchOptions extends DocSearchProps {
+ locales?: Record>
+}
+```
+
+Посмотреть все доступные опции можно [здесь](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts).
+
+## carbonAds {#carbon-ads}
+
+- Тип: `CarbonAdsOptions`
+
+Возможность отображения [Carbon Ads](https://www.carbonads.net/).
+
+```ts
+export default {
+ themeConfig: {
+ carbonAds: {
+ code: 'код-рекламы',
+ placement: 'место-размещения-рекламы'
+ }
+ }
+}
+```
+
+```ts
+export interface CarbonAdsOptions {
+ code: string
+ placement: string
+}
+```
+
+Подробнее в главе [Тема по умолчанию: Carbon Ads](./default-theme-carbon-ads)
+
+## docFooter {#docfooter}
+
+- Тип: `DocFooter`
+
+Можно использовать для настройки текста, отображаемого над ссылками на предыдущую и следующую страницы. Полезно, если вы не пишете документы только на английском языке. Также можно использовать для глобального отключения подобных ссылок. Если вы хотите выборочно включить/выключить эти ссылки на отдельной странице, воспользуйтесь [метаданными](./default-theme-prev-next-links).
+
+```ts
+export default {
+ themeConfig: {
+ docFooter: {
+ prev: 'Предыдущая страница',
+ next: 'Следующая страница'
+ }
+ }
+}
+```
+
+```ts
+export interface DocFooter {
+ prev?: string | false
+ next?: string | false
+}
+```
+
+## darkModeSwitchLabel {#darkmodeswitchlabel}
+
+- Тип: `string`
+- По умолчанию: `Appearance`
+
+Можно использовать для настройки надписи переключателя тёмного режима. Этот ярлык отображается только в мобильном представлении.
+
+## lightModeSwitchTitle {#lightmodeswitchtitle}
+
+- Тип: `string`
+- По умолчанию: `Switch to light theme`
+
+Может использоваться для настройки заголовка переключателя светлого режима, который появляется при наведении курсора.
+
+## darkModeSwitchTitle {#darkmodeswitchtitle}
+
+- Тип: `string`
+- По умолчанию: `Switch to dark theme`
+
+Можно использовать для настройки заголовка переключателя тёмного режима, который появляется при наведении курсора.
+
+## sidebarMenuLabel {#sidebarmenulabel}
+
+- Тип: `string`
+- По умолчанию: `Menu`
+
+Может использоваться для настройки метки бокового меню. Эта метка отображается только в мобильном представлении.
+
+## returnToTopLabel {#returntotoplabel}
+
+- Тип: `string`
+- По умолчанию: `Return to top`
+
+Может использоваться для настройки метки кнопки возврата наверх. Эта метка отображается только в мобильном представлении.
+
+## langMenuLabel {#langmenulabel}
+
+- Тип: `string`
+- По умолчанию: `Change language`
+
+Можно использовать для настройки aria-метки кнопки переключения языка в панели навигации. Это используется только в том случае, если вы используете [i18n](../guide/i18n).
+
+## externalLinkIcon {#externallinkicon}
+
+- Тип: `boolean`
+- По умолчанию: `false`
+
+Отображать ли значок внешней ссылки рядом с внешними ссылками в Markdown.
diff --git a/docs/ru/reference/default-theme-edit-link.md b/docs/ru/reference/default-theme-edit-link.md
new file mode 100644
index 00000000..a2cd6b00
--- /dev/null
+++ b/docs/ru/reference/default-theme-edit-link.md
@@ -0,0 +1,60 @@
+# Ссылка для редактирования {#edit-link}
+
+## Настройка в файле конфигурации {#site-level-config}
+
+Ссылка на редактирование позволяет отобразить ссылку для редактирования страницы на сервисах управления Git, таких как GitHub или GitLab. Чтобы включить её, добавьте опции `themeConfig.editLink` в свой конфиг:
+
+```js
+export default {
+ themeConfig: {
+ editLink: {
+ pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path'
+ }
+ }
+}
+```
+
+Параметр `pattern` задает структуру URL для ссылки, а `:path` будет заменён на путь к странице.
+
+Вы также можете поместить чистую функцию, которая принимает [`PageData`](./runtime-api#usedata) в качестве аргумента и возвращает строку URL.
+
+```js
+export default {
+ themeConfig: {
+ editLink: {
+ pattern: ({ filePath }) => {
+ if (filePath.startsWith('packages/')) {
+ return `https://github.com/acme/monorepo/edit/main/${filePath}`
+ } else {
+ return `https://github.com/acme/monorepo/edit/main/docs/${filePath}`
+ }
+ }
+ }
+ }
+}
+```
+
+Она не должна иметь побочных эффектов или доступа к чему-либо за пределами своей области, поскольку будет сериализована и выполнена в браузере.
+
+По умолчанию это добавит текст ссылки «Редактировать страницу» в нижней части документа. Вы можете настроить этот текст, определив опцию `text`.
+
+```js
+export default {
+ themeConfig: {
+ editLink: {
+ pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
+ text: 'Редактировать эту страницу на GitHub'
+ }
+ }
+}
+```
+
+## Настройка в метаданных {#frontmatter-config}
+
+Эту ссылку можно отключить на конкретной странице с помощью опции `editLink` в метаданных:
+
+```yaml
+---
+editLink: false
+---
+```
diff --git a/docs/ru/reference/default-theme-footer.md b/docs/ru/reference/default-theme-footer.md
new file mode 100644
index 00000000..9481996e
--- /dev/null
+++ b/docs/ru/reference/default-theme-footer.md
@@ -0,0 +1,55 @@
+# Подвал {#footer}
+
+VitePress будет отображать блок подвала внизу страницы, если присутствует объект `themeConfig.footer`.
+
+```ts
+export default {
+ themeConfig: {
+ footer: {
+ message: 'Опубликовано под лицензией MIT.',
+ copyright: '© 2019 – настоящее время, Эван Ю'
+ }
+ }
+}
+```
+
+```ts
+export interface Footer {
+ // Сообщение, отображаемое прямо перед копирайтом.
+ message?: string
+
+ // Уведомление об авторских правах.
+ copyright?: string
+}
+```
+
+Приведённая выше конфигурация также поддерживает строки HTML. Так, например, если вы хотите разместить в подвале несколько ссылок, можно настроить конфигурацию следующим образом:
+
+```ts
+export default {
+ themeConfig: {
+ footer: {
+ message:
+ 'Опубликовано под лицензией MIT.',
+ copyright:
+ '© 2019 – настоящее время, Эван Ю'
+ }
+ }
+}
+```
+
+::: warning Предупреждение
+В `message` и `copyright` можно использовать только встроенные элементы, поскольку они отображаются внутри элемента ``. Если вы хотите добавить блочные элементы, рассмотрите возможность использования слота [`layout-bottom`](../guide/extending-default-theme#layout-slots).
+:::
+
+Обратите внимание, что подвал не будет отображаться, если виден [Сайдбар](./default-theme-sidebar).
+
+## Настройка в метаданных {#frontmatter-config}
+
+Отображение подвала можно отключить на конкретной странице с помощью опции `footer` в метаданных:
+
+```yaml
+---
+footer: false
+---
+```
diff --git a/docs/ru/reference/default-theme-home-page.md b/docs/ru/reference/default-theme-home-page.md
new file mode 100644
index 00000000..a526496f
--- /dev/null
+++ b/docs/ru/reference/default-theme-home-page.md
@@ -0,0 +1,196 @@
+# Главная страница {#home-page}
+
+Тема VitePress по умолчанию предоставляет макет главной страницы, который вы также можете увидеть на [главной странице этого сайта](../). Вы можете использовать его на любой из своих страниц, указав `layout: home` в [метаданных](./frontmatter-config) страницы.
+
+```yaml
+---
+layout: home
+---
+```
+
+Однако сам по себе этот вариант мало что даст. Вы можете добавить несколько различных готовых «секций» на главную страницу, установив дополнительные опции, такие как `hero` и `features`.
+
+## Секция `hero` {#hero-section}
+
+Секция `hero` находится в верхней части главной страницы. Вот как можно её настроить:
+
+```yaml
+---
+layout: home
+
+hero:
+ name: VitePress
+ text: Генератор статических сайтов на основе Vite и Vue.
+ tagline: Lorem ipsum...
+ image:
+ src: /logo.png
+ alt: VitePress
+ actions:
+ - theme: brand
+ text: Начать
+ link: /guide/what-is-vitepress
+ - theme: alt
+ text: Посмотреть на GitHub
+ link: https://github.com/vuejs/vitepress
+---
+```
+
+```ts
+interface Hero {
+ // Строка, отображаемая поверх `text`. Поставляется в фирменном цвете и,
+ // как ожидается, будет короткой — например, название продукта
+ name?: string
+
+ // Основной текст секции. Будет использоваться внутри тега `h1`
+ text: string
+
+ // Заголовок, отображаемый под `text`
+ tagline?: string
+
+ // Изображение отображается рядом с `text` и `tagline`
+ image?: ThemeableImage
+
+ // Кнопки действий для отображения в секции
+ actions?: HeroAction[]
+}
+
+type ThemeableImage =
+ | string
+ | { src: string; alt?: string }
+ | { light: string; dark: string; alt?: string }
+
+interface HeroAction {
+ // Цветовая тема кнопки. По умолчанию принимает значение `brand`.
+ theme?: 'brand' | 'alt'
+
+ // Метка кнопки.
+ text: string
+
+ // Ссылка назначения кнопки.
+ link: string
+
+ // Атрибут цели ссылки.
+ target?: string
+
+ // Атрибут rel ссылки.
+ rel?: string
+}
+```
+
+### Настройка цвета заголовка секции {#customizing-the-name-color}
+
+VitePress использует фирменный цвет (`--vp-c-brand-1`) для атрибута `name` в секции `hero`. Однако вы можете настроить этот цвет, переопределив переменную `--vp-home-hero-name-color`.
+
+```css
+:root {
+ --vp-home-hero-name-color: blue;
+}
+```
+
+Также вы можете настроить его ещё больше, комбинируя `--vp-home-hero-name-background`, чтобы придать `name` градиентный цвет.
+
+```css
+:root {
+ --vp-home-hero-name-color: transparent;
+ --vp-home-hero-name-background: -webkit-linear-gradient(
+ 120deg,
+ #bd34fe,
+ #41d1ff
+ );
+}
+```
+
+## Секция `features` {#features-section}
+
+В секции `features` можно перечислить любое количество функций, которые вы хотели бы показать сразу после секции `hero`. Чтобы настроить её, передайте опцию `features` в метаданных страницы.
+
+Для каждой функции можно указать иконку, который может быть эмодзи или любым другим изображением. Если настраиваемая иконка представляет собой изображение (svg, png, jpeg...), вы должны предоставить ей соответствующую ширину и высоту. При необходимости можно указать описание, собственный размер, а также варианты для тёмной и светлой темы.
+
+```yaml
+---
+layout: home
+
+features:
+ - icon: 🛠️
+ title: Просто и минималистично, всегда
+ details: Lorem ipsum...
+ - icon:
+ src: /cool-feature-icon.svg
+ title: Ещё одна интересная функция
+ details: Lorem ipsum...
+ - icon:
+ dark: /dark-feature-icon.svg
+ light: /light-feature-icon.svg
+ title: Ещё одна интересная функция
+ details: Lorem ipsum...
+---
+```
+
+```ts
+interface Feature {
+ // Иконка
+ icon?: FeatureIcon
+
+ // Заголовок фичи
+ title: string
+
+ // Описание фичи
+ details: string
+
+ // Ссылка при нажатии на компонент функции. Ссылка может быть как внутренней, так и внешней.
+ //
+ // например, `guide/reference/default-theme-home-page` или `https://example.com`
+ link?: string
+
+ // Текст ссылки, который будет отображаться внутри компонента функции. Лучше всего использовать с опцией `link`.
+ //
+ // например, `Узнать подробнее`, `Посетить страницу` и т. д.
+ linkText?: string
+
+ // Атрибут rel для опции `link`
+ //
+ // например, `external`
+ rel?: string
+
+ // Атрибут target для опции `link`
+ target?: string
+}
+
+type FeatureIcon =
+ | string
+ | { src: string; alt?: string; width?: string; height: string }
+ | {
+ light: string
+ dark: string
+ alt?: string
+ width?: string
+ height: string
+ }
+```
+
+## Содержимое Markdown {#markdown-content}
+
+Вы можете добавить дополнительный контент на главную страницу вашего сайта, просто добавив Markdown под разделителем `---`.
+
+````md
+---
+layout: home
+
+hero:
+ name: VitePress
+ text: Генератор статических сайтов на основе Vite и Vue.
+---
+
+## Начало работы
+
+Вы можете начать использовать VitePress прямо сейчас, используя `npx`!
+
+```sh
+npm init
+npx vitepress init
+```
+````
+
+::: info Примечание
+VitePress не всегда автоматически стилизовал дополнительный контент страницы с макетом `layout: home`. Чтобы вернуться к старому поведению, добавьте `markdownStyles: false` в метаданных.
+:::
diff --git a/docs/ru/reference/default-theme-last-updated.md b/docs/ru/reference/default-theme-last-updated.md
new file mode 100644
index 00000000..7d926dc5
--- /dev/null
+++ b/docs/ru/reference/default-theme-last-updated.md
@@ -0,0 +1,27 @@
+# Последнее обновление {#last-updated}
+
+Время последнего обновления содержимого будет отображаться в правом нижнем углу страницы. Чтобы включить его, добавьте опцию `lastUpdated` в свой конфиг.
+
+::: tip Совет
+Чтобы увидеть обновленное время, необходимо зафиксировать файл Markdown.
+:::
+
+## Настройка в файле конфигурации {#site-level-config}
+
+```js
+export default {
+ lastUpdated: true
+}
+```
+
+## Настройка в метаданных {#frontmatter-config}
+
+Эту информацию можно отключить на конкретной странице с помощью опции `lastUpdated` в метаданных:
+
+```yaml
+---
+lastUpdated: false
+---
+```
+
+Также смотрите [Тема по умолчанию: `lastUpdated`](./default-theme-config#lastupdated) для получения более подробной информации. Любое истинное значение на уровне темы также включит функцию, если только она не будет явно отключена на уровне сайта или страницы.
diff --git a/docs/ru/reference/default-theme-layout.md b/docs/ru/reference/default-theme-layout.md
new file mode 100644
index 00000000..f02af7d5
--- /dev/null
+++ b/docs/ru/reference/default-theme-layout.md
@@ -0,0 +1,62 @@
+# Макет {#layout}
+
+Вы можете выбрать макет страницы, установив опцию `layout` в [метаданных](./frontmatter-config). Изначально есть 3 макета: `doc`, `page` и `home`. Если ничего не указано, то страница будет использовать макет `doc`.
+
+```yaml
+---
+layout: doc
+---
+```
+
+## Макет `doc` {#doc-layout}
+
+Вариант `doc` — это макет по умолчанию, который стилизует всё содержимое Markdown в виде «документации». Он работает, оборачивая весь контент в CSS-класс `vp-doc` и применяя стили к вложенным элементам.
+
+Почти все общие элементы, такие как `p` или `h2`, получают специальную стилизацию. Поэтому имейте в виду, что если вы добавите какой-либо пользовательский HTML внутри Markdown-контента, то он также будет подвержен влиянию этих стилей.
+
+Кроме того, в нём предусмотрены специальные функции, перечисленные ниже. Эти функции включены только в данном макете.
+
+- Ссылка «Редактировать»
+- Ссылки предыдущая/следующая
+- Оглавление
+- Реклама [Carbon Ads](./default-theme-carbon-ads)
+
+## Макет `page` {#page-layout}
+
+Вариант `page` сгенерирует «пустую страницу». Markdown всё равно будет разобран, и все [расширения Markdown](../guide/markdown) будут работать так же, как и с макетом `doc`, но никаких стилей по умолчанию применено не будет.
+
+Макет `page` позволит вам оформить всё самостоятельно, без влияния темы VitePress на разметку. Это удобно, когда вы хотите создать свою собственную страницу.
+
+Обратите внимание, что даже при таком раскладе сайдбар всё равно будет отображаться, если у страницы есть соответствующая конфигурация сайдбара.
+
+## Макет `home` {#home-layout}
+
+Вариант `home` сгенерирует шаблонную «домашнюю страницу». В этом макете вы можете установить дополнительные параметры, такие как `hero` и `features`, для дальнейшей настройки контента. Посетите секцию [Тема по умолчанию: Домашняя страница](./default-theme-home-page) для получения более подробной информации.
+
+## Без макета {#no-layout}
+
+Если вам не нужен макет, вы можете указать `layout: false` в метаданных. Этот параметр полезен, если вам нужна полностью настраиваемая целевая страница (по умолчанию без сайдбара, панели навигации или подвала).
+
+## Свой макет {#custom-layout}
+
+Вы также можете использовать собственный макет:
+
+```md
+---
+layout: foo
+---
+```
+
+Будет выполнен поиск компонента с именем `foo`, зарегистрированного в контексте. Например, вы можете зарегистрировать свой компонент глобально в `.vitepress/theme/index.ts`:
+
+```ts
+import DefaultTheme from 'vitepress/theme'
+import Foo from './Foo.vue'
+
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('foo', Foo)
+ }
+}
+```
diff --git a/docs/ru/reference/default-theme-nav.md b/docs/ru/reference/default-theme-nav.md
new file mode 100644
index 00000000..4448af5b
--- /dev/null
+++ b/docs/ru/reference/default-theme-nav.md
@@ -0,0 +1,162 @@
+# Навигация {#nav}
+
+Ключ `nav` в конфигурации — это панель навигации, отображаемая в верхней части страницы. Она содержит заголовок сайта, ссылки глобального меню и т. д.
+
+## Название и логотип сайта {#site-title-and-logo}
+
+По умолчанию навигация отображает название сайта, ссылаясь на значение [`config.title`](./site-config#title). Если вы хотите изменить то, что отображается в панели навигации, задайте пользовательский текст в опции `themeConfig.siteTitle`.
+
+```js
+export default {
+ themeConfig: {
+ siteTitle: 'Мой заголовок'
+ }
+}
+```
+
+Если у вас есть логотип для вашего сайта, вы можете отобразить его, передав путь к изображению. Вы должны поместить логотип непосредственно в директорию `public` и указать абсолютный путь к нему.
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg'
+ }
+}
+```
+
+При добавлении логотипа он отображается вместе с названием сайта. Если вам нужен только логотип и вы хотите скрыть текст заголовка сайта, установите `false` для параметра `SiteTitle`.
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg',
+ siteTitle: false
+ }
+}
+```
+
+Вы также можете передать объект в качестве логотипа, если хотите добавить атрибут `alt` или настроить его в зависимости от тёмного/светлого режима. Подробности смотрите в [`themeConfig.logo`](./default-theme-config#logo).
+
+## Навигационные ссылки {#navigation-links}
+
+Вы можете определить опцию `themeConfig.nav`, чтобы добавить ссылки в панель навигации:
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Руководство', link: '/guide' },
+ { text: 'Настройка', link: '/config' },
+ { text: 'Изменения', link: 'https://github.com/...' }
+ ]
+ }
+}
+```
+
+`text` — это текст, отображаемый в навигации, а `link` — это ссылка, на которую будет осуществлён переход при нажатии на текст. Для ссылки задайте путь к фактическому файлу без префикса `.md` и всегда начинайте с `/`.
+
+Навигационные ссылки также могут быть выпадающими меню. Для этого установите ключ `items` вместо ключа `link`:
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Руководство', link: '/guide' },
+ {
+ text: 'Выпадающее меню',
+ items: [
+ { text: 'Пункт A', link: '/item-1' },
+ { text: 'Пункт B', link: '/item-2' },
+ { text: 'Пункт C', link: '/item-3' }
+ ]
+ }
+ ]
+ }
+}
+```
+
+Обратите внимание, что заголовок выпадающего меню (`Выпадающее меню` в примере выше) не может иметь свойство `link`, так как он становится кнопкой для открытия выпадающего диалога.
+
+Вы можете добавить «секции» в пункты выпадающего меню, передавая больше вложенных элементов:
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Руководство', link: '/guide' },
+ {
+ text: 'Выпадающее меню',
+ items: [
+ {
+ // Заголовок секции
+ text: 'Секция A',
+ items: [
+ { text: 'Пункт A в секции A', link: '...' },
+ { text: 'Пункт B в секции A', link: '...' }
+ ]
+ }
+ ]
+ },
+ {
+ text: 'Выпадающее меню',
+ items: [
+ {
+ // Заголовок можно опустить
+ items: [
+ { text: 'Пункт A в секции A', link: '...' },
+ { text: 'Пункт B в секции A', link: '...' }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+### Настройка «активного» состояния ссылки {#customize-link-s-active-state}
+
+Пункты меню навигации будут выделены, если текущая страница находится под соответствующим путём. Если вы хотите настроить сопоставление путей, определите свойство `activeMatch` и регулярное выражение в качестве строкового значения.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ // Эта ссылка получает активное состояние, когда пользователь
+ // переходит по пути `/config/`.
+ {
+ text: 'Руководство',
+ link: '/guide',
+ activeMatch: '/config/'
+ }
+ ]
+ }
+}
+```
+
+::: warning Предупреждение
+Ожидается, что `activeMatch` будет регулярным выражением, но вы должны определить его как строку. Мы не можем использовать здесь реальный объект RegExp, потому что он не сериализуется во время сборки.
+:::
+
+### Настройка атрибутов «target» и «rel» {#customize-link-s-target-and-rel-attributes}
+
+По умолчанию VitePress автоматически определяет атрибуты `target` и `rel` в зависимости от того, является ли ссылка внешней. Но при желании их можно настроить и вручную.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'Товары',
+ link: 'https://www.thegithubshop.com/',
+ target: '_self',
+ rel: 'sponsored'
+ }
+ ]
+ }
+}
+```
+
+## Социальные ссылки {#social-links}
+
+См. [`socialLinks`](./default-theme-config#sociallinks).
diff --git a/docs/ru/reference/default-theme-prev-next-links.md b/docs/ru/reference/default-theme-prev-next-links.md
new file mode 100644
index 00000000..e2da9501
--- /dev/null
+++ b/docs/ru/reference/default-theme-prev-next-links.md
@@ -0,0 +1,43 @@
+# Предыдущая и следующая страницы {#prev-next-links}
+
+Вы можете настроить текст и ссылку для предыдущей и следующей страниц (отображаются в нижней части страницы). Это полезно, если вы хотите, чтобы текст отличался от того, что находится в сайдбаре. Кроме того, вы можете счесть полезным отключить подвал или ссылку на страницу, которая не включена в сайдбар.
+
+## prev {#prev}
+
+- Тип: `string | false | { text?: string; link?: string }`
+
+- Подробности:
+
+ Указывает текст/ссылку, который должен отображаться при переходе на предыдущую страницу. Если вы не зададите это в метаданных, текст/ссылка будет определяться из конфигурации сайдбара.
+
+- Примеры:
+
+ - Для настройки только текста:
+
+ ```yaml
+ ---
+ prev: 'Начать | Markdown'
+ ---
+ ```
+
+ - Для настройки текста и ссылки:
+
+ ```yaml
+ ---
+ prev:
+ text: 'Markdown'
+ link: '/guide/markdown'
+ ---
+ ```
+
+ - Для скрытия предыдущей страницы:
+
+ ```yaml
+ ---
+ prev: false
+ ---
+ ```
+
+## next {#next}
+
+Аналогично параметру `prev`, но для следующей страницы.
diff --git a/docs/ru/reference/default-theme-search.md b/docs/ru/reference/default-theme-search.md
new file mode 100644
index 00000000..6bbce96e
--- /dev/null
+++ b/docs/ru/reference/default-theme-search.md
@@ -0,0 +1,382 @@
+---
+outline: deep
+---
+
+# Поиск {#search}
+
+## Локальный поиск {#local-search}
+
+VitePress поддерживает нечёткий полнотекстовый поиск с использованием внутрибраузерного индекса благодаря [MiniSearch](https://github.com/lucaong/minisearch/). Чтобы включить эту функцию, просто установите значение `'local'` для опции `themeConfig.search.provider` в файле `.vitepress/config.ts`:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local'
+ }
+ }
+})
+```
+
+Пример результата:
+
+
+
+В качестве альтернативы можно использовать [Algolia DocSearch](#algolia-search) или некоторые плагины сообщества, например или .
+
+### i18n {#local-search-i18n}
+
+Вы можете использовать подобную конфигурацию для использования многоязычного поиска:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ locales: {
+ ru: {
+ translations: {
+ button: {
+ buttonText: 'Поиск',
+ buttonAriaLabel: 'Поиск'
+ },
+ modal: {
+ noResultsText: 'Нет результатов для',
+ resetButtonTitle: 'Сбросить поиск',
+ footer: {
+ selectText: 'выбрать',
+ navigateText: 'перейти'
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+})
+```
+
+### Параметры MiniSearch {#minisearch-options}
+
+Вы можете настроить MiniSearch следующим образом:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ miniSearch: {
+ /**
+ * @type {Pick}
+ */
+ options: {
+ /* ... */
+ },
+ /**
+ * @type {import('minisearch').SearchOptions}
+ * @default
+ * { fuzzy: 0.2, prefix: true, boost: { title: 4, text: 2, titles: 1 } }
+ */
+ searchOptions: {
+ /* ... */
+ }
+ }
+ }
+ }
+ }
+})
+```
+
+Подробнее в [документации MiniSearch](https://lucaong.github.io/minisearch/classes/MiniSearch.MiniSearch.html).
+
+### Пользовательский рендерер содержимого {#custom-content-renderer}
+
+Вы можете настроить функцию, используемую для отображения содержимого в формате Markdown перед его индексацией:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ /**
+ * @param {string} src
+ * @param {import('vitepress').MarkdownEnv} env
+ * @param {import('markdown-it')} md
+ */
+ _render(src, env, md) {
+ // возвращаем html
+ }
+ }
+ }
+ }
+})
+```
+
+Эта функция будет очищена от данных сайта на стороне клиента, поэтому вы можете использовать в ней API Node.js.
+
+#### Пример: Исключение страниц из поиска {#example-excluding-pages-from-search}
+
+Вы можете исключить страницы из поиска, добавив `search: false` в блок метаданных страницы. Альтернативный вариант:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ _render(src, env, md) {
+ const html = md.render(src, env)
+ if (env.frontmatter?.search === false) return ''
+ if (env.relativePath.startsWith('some/path')) return ''
+ return html
+ }
+ }
+ }
+ }
+})
+```
+
+::: warning Примечание
+В случае, если предоставляется пользовательская функция `_render`, вам нужно самостоятельно обработать заголовок `search: false`. Кроме того, объект `env` не будет полностью заполнен до вызова `md.render`, поэтому любые проверки необязательных свойств `env`, таких как `frontmatter`, должны быть выполнены после этого.
+:::
+
+#### Пример: Преобразование содержимого - добавление якорей {#example-transforming-content-adding-anchors}
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local',
+ options: {
+ _render(src, env, md) {
+ const html = md.render(src, env)
+ if (env.frontmatter?.title)
+ return md.render(`# ${env.frontmatter.title}`) + html
+ return html
+ }
+ }
+ }
+ }
+})
+```
+
+## Поиск Algolia {#algolia-search}
+
+VitePress поддерживает поиск в вашей документации с помощью [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch). Обратитесь к руководству по началу работы. В файле `.vitepress/config.ts` вам нужно будет указать, по крайней мере, следующее, чтобы всё работало:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'algolia',
+ options: {
+ appId: '...',
+ apiKey: '...',
+ indexName: '...'
+ }
+ }
+ }
+})
+```
+
+### i18n {#algolia-search-i18n}
+
+Вы можете использовать подобную конфигурацию для использования многоязычного поиска:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'algolia',
+ options: {
+ appId: '...',
+ apiKey: '...',
+ indexName: '...',
+ locales: {
+ ru: {
+ placeholder: 'Поиск в документации',
+ translations: {
+ button: {
+ buttonText: 'Поиск',
+ buttonAriaLabel: 'Поиск'
+ },
+ modal: {
+ searchBox: {
+ resetButtonTitle: 'Сбросить поиск',
+ resetButtonAriaLabel: 'Сбросить поиск',
+ cancelButtonText: 'Отменить поиск',
+ cancelButtonAriaLabel: 'Отменить поиск'
+ },
+ startScreen: {
+ recentSearchesTitle: 'История поиска',
+ noRecentSearchesText: 'Нет истории поиска',
+ saveRecentSearchButtonTitle: 'Сохранить в истории поиска',
+ removeRecentSearchButtonTitle: 'Удалить из истории поиска',
+ favoriteSearchesTitle: 'Избранное',
+ removeFavoriteSearchButtonTitle: 'Удалить из избранного'
+ },
+ errorScreen: {
+ titleText: 'Невозможно получить результаты',
+ helpText:
+ 'Вам может потребоваться проверить подключение к Интернету'
+ },
+ footer: {
+ selectText: 'выбрать',
+ navigateText: 'перейти',
+ closeText: 'закрыть',
+ searchByText: 'поставщик поиска'
+ },
+ noResultsScreen: {
+ noResultsText: 'Нет результатов для',
+ suggestedQueryText: 'Вы можете попытаться узнать',
+ reportMissingResultsText:
+ 'Считаете, что поиск даёт ложные результаты？',
+ reportMissingResultsLinkText:
+ 'Нажмите на кнопку «Обратная связь»'
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+})
+```
+
+[Эти параметры](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts) можно переопределить. Чтобы узнать о них больше, обратитесь к официальной документации Algolia.
+
+### Конфигурация поискового робота {#crawler-config}
+
+Вот пример конфигурации, основанной на той, что используется на этом сайте:
+
+```ts
+new Crawler({
+ appId: '...',
+ apiKey: '...',
+ rateLimit: 8,
+ startUrls: ['https://vitepress.dev/'],
+ renderJavaScript: false,
+ sitemaps: [],
+ exclusionPatterns: [],
+ ignoreCanonicalTo: false,
+ discoveryPatterns: ['https://vitepress.dev/**'],
+ schedule: 'at 05:10 on Saturday',
+ actions: [
+ {
+ indexName: 'vitepress',
+ pathsToMatch: ['https://vitepress.dev/**'],
+ recordExtractor: ({ $, helpers }) => {
+ return helpers.docsearch({
+ recordProps: {
+ lvl1: '.content h1',
+ content: '.content p, .content li',
+ lvl0: {
+ selectors: '',
+ defaultValue: 'Documentation'
+ },
+ lvl2: '.content h2',
+ lvl3: '.content h3',
+ lvl4: '.content h4',
+ lvl5: '.content h5'
+ },
+ indexHeadings: true
+ })
+ }
+ }
+ ],
+ initialIndexSettings: {
+ vitepress: {
+ attributesForFaceting: ['type', 'lang'],
+ attributesToRetrieve: ['hierarchy', 'content', 'anchor', 'url'],
+ attributesToHighlight: ['hierarchy', 'hierarchy_camel', 'content'],
+ attributesToSnippet: ['content:10'],
+ camelCaseAttributes: ['hierarchy', 'hierarchy_radio', 'content'],
+ searchableAttributes: [
+ 'unordered(hierarchy_radio_camel.lvl0)',
+ 'unordered(hierarchy_radio.lvl0)',
+ 'unordered(hierarchy_radio_camel.lvl1)',
+ 'unordered(hierarchy_radio.lvl1)',
+ 'unordered(hierarchy_radio_camel.lvl2)',
+ 'unordered(hierarchy_radio.lvl2)',
+ 'unordered(hierarchy_radio_camel.lvl3)',
+ 'unordered(hierarchy_radio.lvl3)',
+ 'unordered(hierarchy_radio_camel.lvl4)',
+ 'unordered(hierarchy_radio.lvl4)',
+ 'unordered(hierarchy_radio_camel.lvl5)',
+ 'unordered(hierarchy_radio.lvl5)',
+ 'unordered(hierarchy_radio_camel.lvl6)',
+ 'unordered(hierarchy_radio.lvl6)',
+ 'unordered(hierarchy_camel.lvl0)',
+ 'unordered(hierarchy.lvl0)',
+ 'unordered(hierarchy_camel.lvl1)',
+ 'unordered(hierarchy.lvl1)',
+ 'unordered(hierarchy_camel.lvl2)',
+ 'unordered(hierarchy.lvl2)',
+ 'unordered(hierarchy_camel.lvl3)',
+ 'unordered(hierarchy.lvl3)',
+ 'unordered(hierarchy_camel.lvl4)',
+ 'unordered(hierarchy.lvl4)',
+ 'unordered(hierarchy_camel.lvl5)',
+ 'unordered(hierarchy.lvl5)',
+ 'unordered(hierarchy_camel.lvl6)',
+ 'unordered(hierarchy.lvl6)',
+ 'content'
+ ],
+ distinct: true,
+ attributeForDistinct: 'url',
+ customRanking: [
+ 'desc(weight.pageRank)',
+ 'desc(weight.level)',
+ 'asc(weight.position)'
+ ],
+ ranking: [
+ 'words',
+ 'filters',
+ 'typo',
+ 'attribute',
+ 'proximity',
+ 'exact',
+ 'custom'
+ ],
+ highlightPreTag: '',
+ highlightPostTag: '',
+ minWordSizefor1Typo: 3,
+ minWordSizefor2Typos: 7,
+ allowTyposOnNumericTokens: false,
+ minProximity: 1,
+ ignorePlurals: true,
+ advancedSyntax: true,
+ attributeCriteriaComputedByMinProximity: true,
+ removeWordsIfNoResults: 'allOptional'
+ }
+ }
+})
+```
+
+
diff --git a/docs/ru/reference/default-theme-sidebar.md b/docs/ru/reference/default-theme-sidebar.md
new file mode 100644
index 00000000..92fd89c1
--- /dev/null
+++ b/docs/ru/reference/default-theme-sidebar.md
@@ -0,0 +1,213 @@
+# Сайдбар {#sidebar}
+
+Сайдбар (боковая панель) — основной навигационный блок вашей документации. Меню боковой панели можно настроить в секции [`themeConfig.sidebar`](./default-theme-config#sidebar).
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Руководство',
+ items: [
+ { text: 'Введение', link: '/ru/introduction' },
+ { text: 'Первые шаги', link: '/ru/getting-started' },
+ ...
+ ]
+ }
+ ]
+ }
+}
+```
+
+## Основы {#the-basics}
+
+Простейшая форма сайдбара — это передача массива ссылок. Элемент первого уровня определяет «секцию» сайдбара. Он должен содержать `text`, который является заголовком секции, и `items`, которые являются фактическими навигационными ссылками.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Заголовок секции A',
+ items: [
+ { text: 'Пункт A', link: '/item-a' },
+ { text: 'Пункт B', link: '/item-b' },
+ ...
+ ]
+ },
+ {
+ text: 'Заголовок секции B',
+ items: [
+ { text: 'Пункт C', link: '/item-c' },
+ { text: 'Пункт D', link: '/item-d' },
+ ...
+ ]
+ }
+ ]
+ }
+}
+```
+
+Каждый элемент `link` должен указывать путь к фактическому файлу, начинающийся с `/`. Если добавить в конец ссылки косую черту, то будет показан `index.md` соответствующего каталога.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Руководство',
+ items: [
+ // Ссылка на страницу `/ru/guide/index.md`
+ { text: 'Введение', link: '/ru/guide/' }
+ ]
+ }
+ ]
+ }
+}
+```
+
+Вы можете вложить элементы боковой панели на 6 уровней вглубь, считая от корневого уровня. Обратите внимание, что более 6 уровней вложенных элементов будут игнорироваться и не отображаться на боковой панели.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Уровень 1',
+ items: [
+ {
+ text: 'Уровень 2',
+ items: [
+ {
+ text: 'Уровень 3',
+ items: [
+ ...
+ ]
+ }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+## Несколько сайдбаров {#multiple-sidebars}
+
+Вы можете показывать разные боковые панели в зависимости от текущего маршрута. Например, как показано на этом сайте, вы можете создать в документации отдельные разделы, например, «Руководство» и «Настройка».
+
+Для этого сначала организуйте страницы в каталоги для каждого нужного раздела:
+
+```
+.
+├─ guide/
+│ ├─ index.md
+│ ├─ one.md
+│ └─ two.md
+└─ config/
+ ├─ index.md
+ ├─ three.md
+ └─ four.md
+```
+
+Затем обновите конфигурацию, чтобы определить боковую панель для каждого раздела. На этот раз вместо массива нужно передать объект.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: {
+ // Эта боковая панель отображается, когда пользователь находится в директории `guide`
+ '/guide/': [
+ {
+ text: 'Руководство',
+ items: [
+ { text: 'Index', link: '/guide/' },
+ { text: 'One', link: '/guide/one' },
+ { text: 'Two', link: '/guide/two' }
+ ]
+ }
+ ],
+
+ // Эта боковая панель отображается, когда пользователь находится в директории `config`
+ '/config/': [
+ {
+ text: 'Настройка',
+ items: [
+ { text: 'Index', link: '/config/' },
+ { text: 'Three', link: '/config/three' },
+ { text: 'Four', link: '/config/four' }
+ ]
+ }
+ ]
+ }
+ }
+}
+```
+
+## Сворачиваемые группы {#collapsible-sidebar-groups}
+
+Добавив опцию `collapsed` внутри группы `sidebar`, вы увидите кнопку переключения для скрытия/показа каждой секции.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Заголовок секции A',
+ collapsed: false,
+ items: [...]
+ }
+ ]
+ }
+}
+```
+
+Все секции «развёрнуты» по умолчанию. Если вы хотите, чтобы они были «свёрнуты» при первоначальной загрузке страницы, установите для опции `collapsed` значение `true`.
+
+```js
+export default {
+ themeConfig: {
+ sidebar: [
+ {
+ text: 'Заголовок секции A',
+ collapsed: true,
+ items: [...]
+ }
+ ]
+ }
+}
+```
+
+## `useSidebar`
+ sidebar: ComputedRef
+ sidebarGroups: ComputedRef
+ hasSidebar: ComputedRef
+ hasAside: ComputedRef
+ leftAside: ComputedRef
+ isSidebarEnabled: ComputedRef
+ open: () => void
+ close: () => void
+ toggle: () => void
+}
+```
+
+**Пример:**
+
+```vue
+
+
+
+ Показывать только при наличии сайдбара
+
+```
diff --git a/docs/ru/reference/default-theme-team-page.md b/docs/ru/reference/default-theme-team-page.md
new file mode 100644
index 00000000..0eebaa24
--- /dev/null
+++ b/docs/ru/reference/default-theme-team-page.md
@@ -0,0 +1,252 @@
+
+
+# Страница команды {#team-page}
+
+Если вы хотите представить свою команду, вы можете использовать компоненты Team для создания страницы команды. Есть два варианта использования этих компонентов. Один из вариантов — встроить их в страницу с макетом `doc`, а другой — создать полноценную страницу команды.
+
+## Отображение членов команды на странице {#show-team-members-in-a-page}
+
+Вы можете использовать компонент ``, доступный из `vitepress/theme`, для отображения списка членов команды на любой странице.
+
+```html
+
+
+# Поприветствуйте нашу замечательную команду
+
+` поставляется в двух различных размерах, `small` и `medium`. Хотя это зависит от ваших предпочтений, обычно размер `small` лучше подходит для использования на странице с макетом `doc`. Кроме того, вы можете добавить дополнительные свойства для карточки члена команды, например, добавить «описание» или кнопку «спонсировать». Подробнее об этом в секции [``](#vpteammembers).
+
+Встраивание членов команды в страницу документа хорошо подходит для небольших команд, где наличие полной страницы команды может быть слишком большим, или для представления частичных членов команды в качестве ссылки на контекст документации.
+
+Если у вас большое количество участников или вы просто хотите иметь больше места для отображения членов команды, подумайте о [создании отдельной страницы команды](#create-a-full-team-page).
+
+## Создание отдельной страницы команды {#create-a-full-team-page}
+
+Вместо того чтобы добавлять членов команды на страницу с макетом `doc`, вы можете создать полноценную страницу команды, подобно созданию пользовательской [главной страницы](./default-theme-home-page).
+
+Чтобы создать страницу команды, сначала создайте новый md-файл. Имя файла не имеет значения, но здесь мы назовем его `team.md`. В этом файле установите в блоке метаданных параметр `layout: page`, а затем вы можете организовать структуру страницы, используя компоненты `TeamPage`.
+
+```html
+---
+layout: page
+---
+
+
+
+
+
+ Наша команда
+
+ Разработкой VitePress руководит международная команда, некоторые члены
+ которой представлены ниже.
+
+
+
+```
+
+При создании полной страницы команды не забудьте обернуть все компоненты компонентом ``. Этот компонент обеспечит всем вложенным компонентам, связанным с командой, правильную структуру макета, например, расстояние между ними.
+
+Компонент `` добавляет блок заголовка страницы. Заголовок — это тег ``. Используйте слоты `#title` и `#lead`, чтобы рассказать о своей команде.
+
+`` работает так же, как и при использовании в doc-странице. Отобразится список участников.
+
+### Добавление секций для разделения членов команды {#add-sections-to-divide-team-members}
+
+Вы можете добавить «секции» на страницу команды. Например, у вас могут быть разные типы членов команды, такие как члены основной команды и партнёры сообщества. Вы можете разделить этих членов на секции, чтобы лучше объяснить роли каждой группы.
+
+Для этого добавьте компонент `` в файл `team.md`, который мы создали ранее.
+
+```html
+---
+layout: page
+---
+
+
+
+
+
+ Наша команда
+ ...
+
+
+ Партнёры
+ ...
+
+
+
+```
+
+Компонент `` может иметь слоты `#title` и `#lead`, аналогичные компоненту `VPTeamPageTitle`, а также слот `#members` для отображения членов команды.
+
+Не забудьте поместить компонент `` в слот `#members`.
+
+## `` {#vpteammembers}
+
+Компонент `` отображает заданный список членов команды.
+
+```html
+` {#vpteampage}
+
+Корневой компонент при создании отдельной страницы команды. Принимает только один слот. Он будет стилизовать все передаваемые компоненты, связанные с командой.
+
+## `` {#vpteampagetitle}
+
+Добавляет блок «заголовка» страницы. Лучше всего использовать в самом начале внутри ``. Принимает слоты `#title` и `#lead`.
+
+```html
+
+
+ Наша команда
+
+ Разработкой VitePress руководит международная команда, некоторые члены
+ которой представлены ниже.
+
+
+
+```
+
+## `` {#vpteampagesection}
+
+Создает «секцию» на странице команды. Принимает слоты `#title`, `#lead` и `#members`. Внутри `` вы можете добавить столько секций, сколько захотите.
+
+```html
+
+ ...
+
+ Партнёры
+ Lorem ipsum...
+
+
+
+```
diff --git a/docs/ru/reference/frontmatter-config.md b/docs/ru/reference/frontmatter-config.md
new file mode 100644
index 00000000..5c4b3a93
--- /dev/null
+++ b/docs/ru/reference/frontmatter-config.md
@@ -0,0 +1,221 @@
+---
+outline: deep
+---
+
+# Конфигурация метаданных {#frontmatter-config}
+
+Метаданные обеспечивают настройку отдельных страниц. В каждом файле Markdown можно использовать метаданные, чтобы переопределить параметры конфигурации сайта или темы. Кроме того, есть параметры конфигурации, которые можно задать только через метаданные.
+
+Пример использования:
+
+```md
+---
+title: Документация с VitePress
+editLink: true
+---
+```
+
+Вы можете получить доступ к метаданным через глобальный объект `$frontmatter` в выражениях Vue:
+
+```md
+{{ $frontmatter.title }}
+```
+
+## title {#title}
+
+- Тип: `string`
+
+Заголовок страницы. Это то же самое, что [config.title](./site-config#title), и оно переопределяет конфигурацию сайта.
+
+```yaml
+---
+title: VitePress
+---
+```
+
+## titleTemplate {#titletemplate}
+
+- Тип: `string | boolean`
+
+Суффикс для названия. Это то же самое, что и [config.titleTemplate](./site-config#titletemplate), и оно переопределяет конфигурацию сайта.
+
+```yaml
+---
+title: VitePress
+titleTemplate: Генератор статических сайтов на основе Vite и Vue
+---
+```
+
+## description {#description}
+
+- Тип: `string`
+
+Описание для страницы. Это то же самое, что и [config.description](./site-config#description), и оно переопределяет конфигурацию сайта.
+
+```yaml
+---
+description: VitePress
+---
+```
+
+## head {#head}
+
+- Тип: `HeadConfig[]`
+
+Укажите дополнительные теги, которые будут выводиться для текущей страницы. Они будут добавляться после других тегов внутри блока head, введённых в конфигурации сайта.
+
+```yaml
+---
+head:
+ - - meta
+ - name: description
+ content: привет
+ - - meta
+ - name: keywords
+ content: супер-пупер SEO
+---
+```
+
+```ts
+type HeadConfig =
+ | [string, Record]
+ | [string, Record, string]
+```
+
+## Только для темы по умолчанию {#default-theme-only}
+
+Следующие параметры метаданных применимы только при использовании темы по умолчанию.
+
+### layout {#layout}
+
+- Тип: `doc | home | page`
+- По умолчанию: `doc`
+
+Определяет макет страницы.
+
+- `doc` - Применяет стили документации по умолчанию к содержимому Markdown.
+- `home` - Вы можете добавить дополнительные параметры, такие как `hero` и `features`, чтобы быстро создать красивую целевую страницу.
+- `page` - Ведет себя аналогично `doc`, но не применяет стили к содержимому. Полезно, если вы хотите создать полностью настраиваемую страницу.
+
+```yaml
+---
+layout: doc
+---
+```
+
+### hero {{ theme.footer.copyright }}
+
+```
+
+## `useRoute`
+ /**
+ * Вызывается перед изменением маршрута. Верните `false`, чтобы отменить навигацию.
+ */
+ onBeforeRouteChange?: (to: string) => Awaitable
+ /**
+ * Вызывается перед загрузкой компонента страницы (после того, как состояние истории
+ * обновлено). Верните `false`, чтобы отменить навигацию.
+ */
+ onBeforePageLoad?: (to: string) => Awaitable
+ /**
+ * Вызывается после изменения маршрута.
+ */
+ onAfterRouteChanged?: (to: string) => Awaitable
+}
+```
+
+## `withBase` Пользовательский макет!
+
+
+```
+
+- См. также: [Совместимость с SSR](../guide/ssr-compat)
+
+## `$frontmatter` /.vitepress/config.[ext]`, где `` — это корень вашего [проекта](../guide/routing#root-and-source-directory) VitePress, а `[ext]` — одно из поддерживаемых расширений файла. TypeScript поддерживается из коробки. Поддерживаемые расширения включают `.js`, `.ts`, `.mjs` и `.mts`.
+
+В файлах конфигурации рекомендуется использовать синтаксис ES-модулей. Файл конфигурации должен по умолчанию экспортировать объект:
+
+```ts
+export default {
+ // параметры конфигурации на уровне приложения
+ lang: 'ru-RU',
+ title: 'VitePress',
+ description: 'Генератор статических сайтов на основе Vite и Vue.',
+ ...
+}
+```
+
+:::details Динамическая (асинхронная) конфигурация
+
+Если вам нужно генерировать конфигурацию динамически, вы также можете экспортировать функцию по умолчанию. Например:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default async () => {
+ const posts = await (await fetch('https://my-cms.com/blog-posts')).json()
+
+ return defineConfig({
+ // параметры конфигурации на уровне приложения
+ lang: 'ru-RU',
+ title: 'VitePress',
+ description: 'Генератор статических сайтов на основе Vite и Vue.',
+
+ // параметры конфигурации на уровне темы
+ themeConfig: {
+ sidebar: [
+ ...posts.map((post) => ({
+ text: post.name,
+ link: `/posts/${post.name}`
+ }))
+ ]
+ }
+ })
+}
+```
+
+Вы также можете использовать `await` верхнего уровня. Например:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+const posts = await (await fetch('https://my-cms.com/blog-posts')).json()
+
+export default defineConfig({
+ // параметры конфигурации на уровне приложения
+ lang: 'ru-RU',
+ title: 'VitePress',
+ description: 'Генератор статических сайтов на основе Vite и Vue.',
+
+ // параметры конфигурации на уровне темы
+ themeConfig: {
+ sidebar: [
+ ...posts.map((post) => ({
+ text: post.name,
+ link: `/posts/${post.name}`
+ }))
+ ]
+ }
+})
+```
+
+:::
+
+### Интеллектуальная настройка {#config-intellisense}
+
+Использование помощника `defineConfig` обеспечит интеллектуальный анализ опций конфигурации на основе TypeScript. Если ваша IDE поддерживает эту функцию, она должна работать как в JavaScript, так и в TypeScript.
+
+```js
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ // ...
+})
+```
+
+### Типизированная конфигурация темы {#typed-theme-config}
+
+По умолчанию помощник `defineConfig` ожидает тип конфигурации темы из темы по умолчанию:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ // Тип `DefaultTheme.Config`
+ }
+})
+```
+
+Если вы используете пользовательскую тему и хотите проверять типы для конфигурации темы, вам нужно использовать `defineConfigWithTheme`, и передавать тип конфигурации для вашей пользовательской темы через общий аргумент:
+
+```ts
+import { defineConfigWithTheme } from 'vitepress'
+import type { ThemeConfig } from 'your-theme'
+
+export default defineConfigWithTheme({
+ themeConfig: {
+ // Tип `ThemeConfig`
+ }
+})
+```
+
+### Настройка Vite, Vue и Markdown {#vite-vue-markdown-config}
+
+- **Vite**
+
+ Вы можете настроить базовый экземпляр Vite с помощью опции [vite](#vite) в конфигурации VitePress. Нет необходимости создавать отдельный файл конфигурации Vite.
+
+- **Vue**
+
+ VitePress уже включает в себя официальный плагин Vue для Vite ([@vitejs/plugin-vue](https://github.com/vitejs/vite-plugin-vue)). Вы можете настроить его параметры с помощью опции [vue](#vue) в конфигурации VitePress.
+
+- **Markdown**
+
+ Вы можете настроить базовый экземпляр [Markdown-It](https://github.com/markdown-it/markdown-it) с помощью опции [markdown](#markdown) в конфигурации VitePress.
+
+## Метаданные сайта {#site-metadata}
+
+### title {#title}
+
+- Тип: `string`
+- По умолчанию: `VitePress`
+- Можно переопределить для каждой страницы с помощью [метаданных](./frontmatter-config#title)
+
+Название для сайта. При использовании темы по умолчанию оно будет отображаться в панели навигации.
+
+Оно также будет использоваться в качестве суффикса по умолчанию для всех заголовков отдельных страниц, если не определен [`titleTemplate`](#titletemplate). Окончательный заголовок отдельной страницы будет представлять собой текстовое содержимое её первого заголовка ``, объединённое с глобальным `title` в качестве суффикса. Например, со следующей конфигурацией и содержимым страницы:
+
+```ts
+export default {
+ title: 'Мой замечательный сайт'
+}
+```
+
+```md
+# Привет
+```
+
+Заголовок страницы будет таким: `Привет | Мой замечательный сайт`.
+
+### titleTemplate {##titletemplate}
+
+- Тип: `string | boolean`
+- Можно переопределить для каждой страницы с помощью [метаданных](./frontmatter-config#titletemplate)
+
+Позволяет настраивать суффикс заголовка каждой страницы или весь заголовок. Например:
+
+```ts
+export default {
+ title: 'Мой замечательный сайт',
+ titleTemplate: 'Пользовательский суффикс'
+}
+```
+
+```md
+# Привет
+```
+
+Заголовок страницы будет таким: `Привет | Пользовательский суффикс`.
+
+Чтобы полностью настроить отображение заголовка, вы можете использовать символ `:title` в `titleTemplate`:
+
+```ts
+export default {
+ titleTemplate: ':title - Пользовательский суффикс'
+}
+```
+
+Здесь `:title` будет заменён текстом, выведенным из первого заголовка страницы ``. Заголовок страницы предыдущего примера будет `Привет - Пользовательский суффикс`.
+
+Опция может быть установлена в значение `false`, чтобы отключить суффиксы заголовков.
+
+### description {#description}
+
+- Тип: `string`
+- По умолчанию: `A VitePress site`
+- Можно переопределить для каждой страницы с помощью [метаданных](./frontmatter-config#description)
+
+Описание для сайта. Это будет отображаться как тег `` в HTML-странице.
+
+```ts
+export default {
+ description: 'A VitePress site'
+}
+```
+
+### head {#head}
+
+- Тип: `HeadConfig[]`
+- По умолчанию: `[]`
+- Можно добавлять на страницу через [метаданные](./frontmatter-config#head)
+
+Дополнительные элементы для отображения в теге `` в HTML-странице. Добавленные пользователем теги выводятся перед закрывающим тегом `head`, после тегов VitePress.
+
+```ts
+type HeadConfig =
+ | [string, Record]
+ | [string, Record, string]
+```
+
+#### Пример: Добавление значка сайта {#example-adding-a-favicon}
+
+```ts
+export default {
+ head: [['link', { rel: 'icon', href: '/favicon.ico' }]]
+} // поместите favicon.ico в публичную директорию; если установлен параметр base, используйте /base/favicon.ico
+
+/* Отрисуется так:
+
+*/
+```
+
+#### Пример: Добавление шрифтов Google {#example-adding-google-fonts}
+
+```ts
+export default {
+ head: [
+ ['link', { rel: 'preconnect', href: 'https://fonts.googleapis.com' }],
+ [
+ 'link',
+ { rel: 'preconnect', href: 'https://fonts.gstatic.com', crossorigin: '' }
+ ],
+ [
+ 'link',
+ {
+ href: 'https://fonts.googleapis.com/css2?family=Roboto&display=swap',
+ rel: 'stylesheet'
+ }
+ ]
+ ]
+}
+
+/* Отрисуется так:
+
+
+
+*/
+```
+
+#### Пример: Регистрация сервис-воркера {#example-registering-a-service-worker}
+
+```ts
+export default {
+ head: [
+ [
+ 'script',
+ { id: 'register-sw' },
+ `;(() => {
+ if ('serviceWorker' in navigator) {
+ navigator.serviceWorker.register('/sw.js')
+ }
+ })()`
+ ]
+ ]
+}
+
+/* Отрисуется так:
+
+*/
+```
+
+#### Пример: Использование Google Analytics {#example-using-google-analytics}
+
+```ts
+export default {
+ head: [
+ [
+ 'script',
+ { async: '', src: 'https://www.googletagmanager.com/gtag/js?id=TAG_ID' }
+ ],
+ [
+ 'script',
+ {},
+ `window.dataLayer = window.dataLayer || [];
+ function gtag(){dataLayer.push(arguments);}
+ gtag('js', new Date());
+ gtag('config', 'TAG_ID');`
+ ]
+ ]
+}
+
+/* Отрисуется так:
+
+
+*/
+```
+
+### lang {#lang}
+
+- Тип: `string`
+- По умолчанию: `en-US`
+
+Атрибут lang для сайта. Будет выглядеть как тег `` в HTML-странице.
+
+```ts
+export default {
+ lang: 'en-US'
+}
+```
+
+### base {#base}
+
+- Тип: `string`
+- По умолчанию: `/`
+
+Базовый URL-адрес, по которому будет развёрнут сайт. Этот параметр необходимо задать, если вы планируете развернуть свой сайт по подпути, например, для страниц GitHub. Если вы планируете развернуть свой сайт на `https://foo.github.io/bar/`, то вам следует установить base на `'/bar/'`. Он всегда должен начинаться и заканчиваться косой чертой.
+
+Параметр `base` автоматически добавляется ко всем URL, которые начинаются с `/` в других опциях, поэтому вам нужно указать его только один раз.
+
+```ts
+export default {
+ base: '/base/'
+}
+```
+
+## Маршрутизация {#routing}
+
+### cleanUrls {#cleanurls}
+
+- Тип: `boolean`
+- По умолчанию: `false`
+
+Если установить значение `true`, VitePress будет удалять из URL-адресов завершающий `.html`. Также смотрите [Создание чистого URL-адреса](../guide/routing#generating-clean-url).
+
+::: warning Требуется поддержка сервера
+Для включения этой функции может потребоваться дополнительная настройка на вашей хостинговой платформе. Чтобы это сработало, ваш сервер должен быть способен обслуживать `/foo.html` при посещении `/foo` **без редиректа**.
+:::
+
+### rewrites {#rewrites}
+
+- Тип: `Record`
+
+Определяет сопоставление пользовательских каталогов с URL-адресами. Дополнительную информацию см. в секции [Маршрутизация: перезапись маршрутов](../guide/routing#route-rewrites).
+
+```ts
+export default {
+ rewrites: {
+ 'source/:page': 'destination/:page'
+ }
+}
+```
+
+## Сборка {#build}
+
+### srcDir {#srcdir}
+
+- Тип: `string`
+- По умолчанию: `.`
+
+Каталог, в котором хранятся ваши страницы в формате Markdown, относительно корня проекта. Также смотрите [Корневая директория и директория с исходными файлами](../guide/routing#root-and-source-directory).
+
+```ts
+export default {
+ srcDir: './src'
+}
+```
+
+### srcExclude {#srcexclude}
+
+- Тип: `string`
+- По умолчанию: `undefined`
+
+[Шаблон](https://github.com/mrmlnc/fast-glob#pattern-syntax) для поиска файлов, которые должны быть исключены из исходного содержимого.
+
+```ts
+export default {
+ srcExclude: ['**/README.md', '**/TODO.md']
+}
+```
+
+### outDir {#outdir}
+
+- Тип: `string`
+- По умолчанию: `./.vitepress/dist`
+
+Расположение вывода сборки для сайта, относительно [корня проекта](../guide/routing#root-and-source-directory).
+
+```ts
+export default {
+ outDir: '../public'
+}
+```
+
+### assetsDir {#assetsdir}
+
+- Тип: `string`
+- По умолчанию: `assets`
+
+Укажите каталог, в котором будут храниться сгенерированные ресурсы. Путь должен находиться внутри [`outDir`](#outdir) и разрешается относительно него.
+
+```ts
+export default {
+ assetsDir: 'static'
+}
+```
+
+### cacheDir {#cachedir}
+
+- Тип: `string`
+- По умолчанию: `./.vitepress/cache`
+
+Каталог для файлов кэша, относительно [корня проекта](../guide/routing#root-and-source-directory). См. также: [cacheDir](https://vitejs.dev/config/shared-options.html#cachedir).
+
+```ts
+export default {
+ cacheDir: './.vitepress/.vite'
+}
+```
+
+### ignoreDeadLinks {#ignoredeadlinks}
+
+- Тип: `boolean | 'localhostLinks' | (string | RegExp | ((link: string) => boolean))[]`
+- По умолчанию: `false`
+
+Если установлено значение `true`, VitePress не будет завершать сборку из-за неработающих ссылок.
+
+Если установить значение `'localhostLinks'`, сборка будет завершаться при наличии неработающих ссылок, но не будет проверять ссылки `localhost`.
+
+```ts
+export default {
+ ignoreDeadLinks: true
+}
+```
+
+Это также может быть массив точных строк url, шаблонов regex или пользовательских функций фильтрации.
+
+```ts
+export default {
+ ignoreDeadLinks: [
+ // игнорировать url "/playground"
+ '/playground',
+ // игнорировать все ссылки на localhost
+ /^https?:\/\/localhost/,
+ // игнорировать все ссылки, включающие "/repl/""
+ /\/repl\//,
+ // пользовательская функция, игнорирует все ссылки, включающие "ignore"
+ (url) => {
+ return url.toLowerCase().includes('ignore')
+ }
+ ]
+}
+```
+
+### metaChunk `
+
+`buildEnd` — это хук CLI сборки, который будет запущен после завершения сборки (SSG), но до выхода из процесса VitePress CLI.
+
+```ts
+export default {
+ async buildEnd(siteConfig) {
+ // ...
+ }
+}
+```
+
+### postRender {#postrender}
+
+- Тип: `(context: SSGContext) => Awaitable`
+
+`postRender` — это хук сборки, вызываемый после завершения рендеринга SSG. Это позволит вам обрабатывать содержимое телепортов во время SSG.
+
+```ts
+export default {
+ async postRender(context) {
+ // ...
+ }
+}
+```
+
+```ts
+interface SSGContext {
+ content: string
+ teleports?: Record
+ [key: string]: any
+}
+```
+
+### transformHead {#transformhead}
+
+- Тип: `(context: TransformContext) => Awaitable`
+
+`transformHead` — это хук сборки для преобразования заголовка перед генерацией каждой страницы. Это позволит вам добавить в конфигурацию VitePress записи, которые не могут быть добавлены статически. Вам нужно только вернуть дополнительные записи, они будут автоматически объединены с существующими.
+
+::: warning Предупреждение
+Не мутируйте ничего внутри `context`.
+:::
+
+```ts
+export default {
+ async transformHead(context) {
+ // ...
+ }
+}
+```
+
+```ts
+interface TransformContext {
+ page: string // например, index.md (относительно srcDir)
+ assets: string[] // все ресурсы, не относящиеся к js/css, в виде полностью разрешённых публичных URL-адресов
+ siteConfig: SiteConfig
+ siteData: SiteData
+ pageData: PageData
+ title: string
+ description: string
+ head: HeadConfig[]
+ content: string
+}
+```
+
+Обратите внимание, что этот хук вызывается только при статической генерации сайта. Он не вызывается во время разработки. Если вам нужно добавить динамические записи в голову во время разработки, вместо этого вы можете использовать хук [`transformPageData`](#transformpagedata):
+
+```ts
+export default {
+ transformPageData(pageData) {
+ pageData.frontmatter.head ??= []
+ pageData.frontmatter.head.push([
+ 'meta',
+ {
+ name: 'og:title',
+ content:
+ pageData.frontmatter.layout === 'home'
+ ? `VitePress`
+ : `${pageData.title} | VitePress`
+ }
+ ])
+ }
+}
+```
+
+#### Пример: Добавление канонического URL-адреса `` {#example-adding-a-canonical-url-link}
+
+```ts
+export default {
+ transformPageData(pageData) {
+ const canonicalUrl = `https://example.com/${pageData.relativePath}`
+ .replace(/index\.md$/, '')
+ .replace(/\.md$/, '.html')
+
+ pageData.frontmatter.head ??= []
+ pageData.frontmatter.head.push([
+ 'link',
+ { rel: 'canonical', href: canonicalUrl }
+ ])
+ }
+}
+```
+
+### transformHtml {#transformhtml}
+
+- Тип: `(code: string, id: string, context: TransformContext) => Awaitable`
+
+`transformHtml` — это хук сборки для преобразования содержимого каждой страницы перед сохранением на диск.
+
+::: warning Предупреждение
+Не мутируйте ничего внутри `контекста`. Кроме того, изменение html-содержимого может вызвать проблемы с гидратацией во время выполнения.
+:::
+
+```ts
+export default {
+ async transformHtml(code, id, context) {
+ // ...
+ }
+}
+```
+
+### transformPageData {#transformpagedata}
+
+- Тип: `(pageData: PageData, context: TransformPageContext) => Awaitable | { [key: string]: any } | void>`
+
+`transformPageData` — это хук для преобразования `pageData` каждой страницы. Вы можете напрямую изменять `pageData` или возвращать изменённые значения, которые будут объединены с данными страницы.
+
+::: warning Предупреждение
+Не мутируйте ничего внутри `context` и будьте осторожны, это может повлиять на производительность dev-сервера, особенно если у вас есть некоторые сетевые запросы или тяжёлые вычисления (например, генерация изображений) в хуке. Вы можете проверить `process.env.NODE_ENV === 'production'` для условной логики.
+:::
+
+```ts
+export default {
+ async transformPageData(pageData, { siteConfig }) {
+ pageData.contributors = await getPageContributors(pageData.relativePath)
+ }
+
+ // или возвращаем данные для объединения
+ async transformPageData(pageData, { siteConfig }) {
+ return {
+ contributors: await getPageContributors(pageData.relativePath)
+ }
+ }
+}
+```
+
+```ts
+interface TransformPageContext {
+ siteConfig: SiteConfig
+}
+```
`. Если вы хотите добавить блочные элементы, рассмотрите возможность использования слота [`layout-bottom`](../guide/extending-default-theme#layout-slots).
+:::
+
+Обратите внимание, что подвал не будет отображаться, если виден [Сайдбар](./default-theme-sidebar).
+
+## Настройка в метаданных {#frontmatter-config}
+
+Отображение подвала можно отключить на конкретной странице с помощью опции `footer` в метаданных:
+
+```yaml
+---
+footer: false
+---
+```
diff --git a/docs/ru/reference/default-theme-home-page.md b/docs/ru/reference/default-theme-home-page.md
new file mode 100644
index 00000000..a526496f
--- /dev/null
+++ b/docs/ru/reference/default-theme-home-page.md
@@ -0,0 +1,196 @@
+# Главная страница {#home-page}
+
+Тема VitePress по умолчанию предоставляет макет главной страницы, который вы также можете увидеть на [главной странице этого сайта](../). Вы можете использовать его на любой из своих страниц, указав `layout: home` в [метаданных](./frontmatter-config) страницы.
+
+```yaml
+---
+layout: home
+---
+```
+
+Однако сам по себе этот вариант мало что даст. Вы можете добавить несколько различных готовых «секций» на главную страницу, установив дополнительные опции, такие как `hero` и `features`.
+
+## Секция `hero` {#hero-section}
+
+Секция `hero` находится в верхней части главной страницы. Вот как можно её настроить:
+
+```yaml
+---
+layout: home
+
+hero:
+ name: VitePress
+ text: Генератор статических сайтов на основе Vite и Vue.
+ tagline: Lorem ipsum...
+ image:
+ src: /logo.png
+ alt: VitePress
+ actions:
+ - theme: brand
+ text: Начать
+ link: /guide/what-is-vitepress
+ - theme: alt
+ text: Посмотреть на GitHub
+ link: https://github.com/vuejs/vitepress
+---
+```
+
+```ts
+interface Hero {
+ // Строка, отображаемая поверх `text`. Поставляется в фирменном цвете и,
+ // как ожидается, будет короткой — например, название продукта
+ name?: string
+
+ // Основной текст секции. Будет использоваться внутри тега `h1`
+ text: string
+
+ // Заголовок, отображаемый под `text`
+ tagline?: string
+
+ // Изображение отображается рядом с `text` и `tagline`
+ image?: ThemeableImage
+
+ // Кнопки действий для отображения в секции
+ actions?: HeroAction[]
+}
+
+type ThemeableImage =
+ | string
+ | { src: string; alt?: string }
+ | { light: string; dark: string; alt?: string }
+
+interface HeroAction {
+ // Цветовая тема кнопки. По умолчанию принимает значение `brand`.
+ theme?: 'brand' | 'alt'
+
+ // Метка кнопки.
+ text: string
+
+ // Ссылка назначения кнопки.
+ link: string
+
+ // Атрибут цели ссылки.
+ target?: string
+
+ // Атрибут rel ссылки.
+ rel?: string
+}
+```
+
+### Настройка цвета заголовка секции {#customizing-the-name-color}
+
+VitePress использует фирменный цвет (`--vp-c-brand-1`) для атрибута `name` в секции `hero`. Однако вы можете настроить этот цвет, переопределив переменную `--vp-home-hero-name-color`.
+
+```css
+:root {
+ --vp-home-hero-name-color: blue;
+}
+```
+
+Также вы можете настроить его ещё больше, комбинируя `--vp-home-hero-name-background`, чтобы придать `name` градиентный цвет.
+
+```css
+:root {
+ --vp-home-hero-name-color: transparent;
+ --vp-home-hero-name-background: -webkit-linear-gradient(
+ 120deg,
+ #bd34fe,
+ #41d1ff
+ );
+}
+```
+
+## Секция `features` {#features-section}
+
+В секции `features` можно перечислить любое количество функций, которые вы хотели бы показать сразу после секции `hero`. Чтобы настроить её, передайте опцию `features` в метаданных страницы.
+
+Для каждой функции можно указать иконку, который может быть эмодзи или любым другим изображением. Если настраиваемая иконка представляет собой изображение (svg, png, jpeg...), вы должны предоставить ей соответствующую ширину и высоту. При необходимости можно указать описание, собственный размер, а также варианты для тёмной и светлой темы.
+
+```yaml
+---
+layout: home
+
+features:
+ - icon: 🛠️
+ title: Просто и минималистично, всегда
+ details: Lorem ipsum...
+ - icon:
+ src: /cool-feature-icon.svg
+ title: Ещё одна интересная функция
+ details: Lorem ipsum...
+ - icon:
+ dark: /dark-feature-icon.svg
+ light: /light-feature-icon.svg
+ title: Ещё одна интересная функция
+ details: Lorem ipsum...
+---
+```
+
+```ts
+interface Feature {
+ // Иконка
+ icon?: FeatureIcon
+
+ // Заголовок фичи
+ title: string
+
+ // Описание фичи
+ details: string
+
+ // Ссылка при нажатии на компонент функции. Ссылка может быть как внутренней, так и внешней.
+ //
+ // например, `guide/reference/default-theme-home-page` или `https://example.com`
+ link?: string
+
+ // Текст ссылки, который будет отображаться внутри компонента функции. Лучше всего использовать с опцией `link`.
+ //
+ // например, `Узнать подробнее`, `Посетить страницу` и т. д.
+ linkText?: string
+
+ // Атрибут rel для опции `link`
+ //
+ // например, `external`
+ rel?: string
+
+ // Атрибут target для опции `link`
+ target?: string
+}
+
+type FeatureIcon =
+ | string
+ | { src: string; alt?: string; width?: string; height: string }
+ | {
+ light: string
+ dark: string
+ alt?: string
+ width?: string
+ height: string
+ }
+```
+
+## Содержимое Markdown {#markdown-content}
+
+Вы можете добавить дополнительный контент на главную страницу вашего сайта, просто добавив Markdown под разделителем `---`.
+
+````md
+---
+layout: home
+
+hero:
+ name: VitePress
+ text: Генератор статических сайтов на основе Vite и Vue.
+---
+
+## Начало работы
+
+Вы можете начать использовать VitePress прямо сейчас, используя `npx`!
+
+```sh
+npm init
+npx vitepress init
+```
+````
+
+::: info Примечание
+VitePress не всегда автоматически стилизовал дополнительный контент страницы с макетом `layout: home`. Чтобы вернуться к старому поведению, добавьте `markdownStyles: false` в метаданных.
+:::
diff --git a/docs/ru/reference/default-theme-last-updated.md b/docs/ru/reference/default-theme-last-updated.md
new file mode 100644
index 00000000..7d926dc5
--- /dev/null
+++ b/docs/ru/reference/default-theme-last-updated.md
@@ -0,0 +1,27 @@
+# Последнее обновление {#last-updated}
+
+Время последнего обновления содержимого будет отображаться в правом нижнем углу страницы. Чтобы включить его, добавьте опцию `lastUpdated` в свой конфиг.
+
+::: tip Совет
+Чтобы увидеть обновленное время, необходимо зафиксировать файл Markdown.
+:::
+
+## Настройка в файле конфигурации {#site-level-config}
+
+```js
+export default {
+ lastUpdated: true
+}
+```
+
+## Настройка в метаданных {#frontmatter-config}
+
+Эту информацию можно отключить на конкретной странице с помощью опции `lastUpdated` в метаданных:
+
+```yaml
+---
+lastUpdated: false
+---
+```
+
+Также смотрите [Тема по умолчанию: `lastUpdated`](./default-theme-config#lastupdated) для получения более подробной информации. Любое истинное значение на уровне темы также включит функцию, если только она не будет явно отключена на уровне сайта или страницы.
diff --git a/docs/ru/reference/default-theme-layout.md b/docs/ru/reference/default-theme-layout.md
new file mode 100644
index 00000000..f02af7d5
--- /dev/null
+++ b/docs/ru/reference/default-theme-layout.md
@@ -0,0 +1,62 @@
+# Макет {#layout}
+
+Вы можете выбрать макет страницы, установив опцию `layout` в [метаданных](./frontmatter-config). Изначально есть 3 макета: `doc`, `page` и `home`. Если ничего не указано, то страница будет использовать макет `doc`.
+
+```yaml
+---
+layout: doc
+---
+```
+
+## Макет `doc` {#doc-layout}
+
+Вариант `doc` — это макет по умолчанию, который стилизует всё содержимое Markdown в виде «документации». Он работает, оборачивая весь контент в CSS-класс `vp-doc` и применяя стили к вложенным элементам.
+
+Почти все общие элементы, такие как `p` или `h2`, получают специальную стилизацию. Поэтому имейте в виду, что если вы добавите какой-либо пользовательский HTML внутри Markdown-контента, то он также будет подвержен влиянию этих стилей.
+
+Кроме того, в нём предусмотрены специальные функции, перечисленные ниже. Эти функции включены только в данном макете.
+
+- Ссылка «Редактировать»
+- Ссылки предыдущая/следующая
+- Оглавление
+- Реклама [Carbon Ads](./default-theme-carbon-ads)
+
+## Макет `page` {#page-layout}
+
+Вариант `page` сгенерирует «пустую страницу». Markdown всё равно будет разобран, и все [расширения Markdown](../guide/markdown) будут работать так же, как и с макетом `doc`, но никаких стилей по умолчанию применено не будет.
+
+Макет `page` позволит вам оформить всё самостоятельно, без влияния темы VitePress на разметку. Это удобно, когда вы хотите создать свою собственную страницу.
+
+Обратите внимание, что даже при таком раскладе сайдбар всё равно будет отображаться, если у страницы есть соответствующая конфигурация сайдбара.
+
+## Макет `home` {#home-layout}
+
+Вариант `home` сгенерирует шаблонную «домашнюю страницу». В этом макете вы можете установить дополнительные параметры, такие как `hero` и `features`, для дальнейшей настройки контента. Посетите секцию [Тема по умолчанию: Домашняя страница](./default-theme-home-page) для получения более подробной информации.
+
+## Без макета {#no-layout}
+
+Если вам не нужен макет, вы можете указать `layout: false` в метаданных. Этот параметр полезен, если вам нужна полностью настраиваемая целевая страница (по умолчанию без сайдбара, панели навигации или подвала).
+
+## Свой макет {#custom-layout}
+
+Вы также можете использовать собственный макет:
+
+```md
+---
+layout: foo
+---
+```
+
+Будет выполнен поиск компонента с именем `foo`, зарегистрированного в контексте. Например, вы можете зарегистрировать свой компонент глобально в `.vitepress/theme/index.ts`:
+
+```ts
+import DefaultTheme from 'vitepress/theme'
+import Foo from './Foo.vue'
+
+export default {
+ extends: DefaultTheme,
+ enhanceApp({ app }) {
+ app.component('foo', Foo)
+ }
+}
+```
diff --git a/docs/ru/reference/default-theme-nav.md b/docs/ru/reference/default-theme-nav.md
new file mode 100644
index 00000000..4448af5b
--- /dev/null
+++ b/docs/ru/reference/default-theme-nav.md
@@ -0,0 +1,162 @@
+# Навигация {#nav}
+
+Ключ `nav` в конфигурации — это панель навигации, отображаемая в верхней части страницы. Она содержит заголовок сайта, ссылки глобального меню и т. д.
+
+## Название и логотип сайта {#site-title-and-logo}
+
+По умолчанию навигация отображает название сайта, ссылаясь на значение [`config.title`](./site-config#title). Если вы хотите изменить то, что отображается в панели навигации, задайте пользовательский текст в опции `themeConfig.siteTitle`.
+
+```js
+export default {
+ themeConfig: {
+ siteTitle: 'Мой заголовок'
+ }
+}
+```
+
+Если у вас есть логотип для вашего сайта, вы можете отобразить его, передав путь к изображению. Вы должны поместить логотип непосредственно в директорию `public` и указать абсолютный путь к нему.
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg'
+ }
+}
+```
+
+При добавлении логотипа он отображается вместе с названием сайта. Если вам нужен только логотип и вы хотите скрыть текст заголовка сайта, установите `false` для параметра `SiteTitle`.
+
+```js
+export default {
+ themeConfig: {
+ logo: '/my-logo.svg',
+ siteTitle: false
+ }
+}
+```
+
+Вы также можете передать объект в качестве логотипа, если хотите добавить атрибут `alt` или настроить его в зависимости от тёмного/светлого режима. Подробности смотрите в [`themeConfig.logo`](./default-theme-config#logo).
+
+## Навигационные ссылки {#navigation-links}
+
+Вы можете определить опцию `themeConfig.nav`, чтобы добавить ссылки в панель навигации:
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Руководство', link: '/guide' },
+ { text: 'Настройка', link: '/config' },
+ { text: 'Изменения', link: 'https://github.com/...' }
+ ]
+ }
+}
+```
+
+`text` — это текст, отображаемый в навигации, а `link` — это ссылка, на которую будет осуществлён переход при нажатии на текст. Для ссылки задайте путь к фактическому файлу без префикса `.md` и всегда начинайте с `/`.
+
+Навигационные ссылки также могут быть выпадающими меню. Для этого установите ключ `items` вместо ключа `link`:
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Руководство', link: '/guide' },
+ {
+ text: 'Выпадающее меню',
+ items: [
+ { text: 'Пункт A', link: '/item-1' },
+ { text: 'Пункт B', link: '/item-2' },
+ { text: 'Пункт C', link: '/item-3' }
+ ]
+ }
+ ]
+ }
+}
+```
+
+Обратите внимание, что заголовок выпадающего меню (`Выпадающее меню` в примере выше) не может иметь свойство `link`, так как он становится кнопкой для открытия выпадающего диалога.
+
+Вы можете добавить «секции» в пункты выпадающего меню, передавая больше вложенных элементов:
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ { text: 'Руководство', link: '/guide' },
+ {
+ text: 'Выпадающее меню',
+ items: [
+ {
+ // Заголовок секции
+ text: 'Секция A',
+ items: [
+ { text: 'Пункт A в секции A', link: '...' },
+ { text: 'Пункт B в секции A', link: '...' }
+ ]
+ }
+ ]
+ },
+ {
+ text: 'Выпадающее меню',
+ items: [
+ {
+ // Заголовок можно опустить
+ items: [
+ { text: 'Пункт A в секции A', link: '...' },
+ { text: 'Пункт B в секции A', link: '...' }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+### Настройка «активного» состояния ссылки {#customize-link-s-active-state}
+
+Пункты меню навигации будут выделены, если текущая страница находится под соответствующим путём. Если вы хотите настроить сопоставление путей, определите свойство `activeMatch` и регулярное выражение в качестве строкового значения.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ // Эта ссылка получает активное состояние, когда пользователь
+ // переходит по пути `/config/`.
+ {
+ text: 'Руководство',
+ link: '/guide',
+ activeMatch: '/config/'
+ }
+ ]
+ }
+}
+```
+
+::: warning Предупреждение
+Ожидается, что `activeMatch` будет регулярным выражением, но вы должны определить его как строку. Мы не можем использовать здесь реальный объект RegExp, потому что он не сериализуется во время сборки.
+:::
+
+### Настройка атрибутов «target» и «rel» {#customize-link-s-target-and-rel-attributes}
+
+По умолчанию VitePress автоматически определяет атрибуты `target` и `rel` в зависимости от того, является ли ссылка внешней. Но при желании их можно настроить и вручную.
+
+```js
+export default {
+ themeConfig: {
+ nav: [
+ {
+ text: 'Товары',
+ link: 'https://www.thegithubshop.com/',
+ target: '_self',
+ rel: 'sponsored'
+ }
+ ]
+ }
+}
+```
+
+## Социальные ссылки {#social-links}
+
+См. [`socialLinks`](./default-theme-config#sociallinks).
diff --git a/docs/ru/reference/default-theme-prev-next-links.md b/docs/ru/reference/default-theme-prev-next-links.md
new file mode 100644
index 00000000..e2da9501
--- /dev/null
+++ b/docs/ru/reference/default-theme-prev-next-links.md
@@ -0,0 +1,43 @@
+# Предыдущая и следующая страницы {#prev-next-links}
+
+Вы можете настроить текст и ссылку для предыдущей и следующей страниц (отображаются в нижней части страницы). Это полезно, если вы хотите, чтобы текст отличался от того, что находится в сайдбаре. Кроме того, вы можете счесть полезным отключить подвал или ссылку на страницу, которая не включена в сайдбар.
+
+## prev {#prev}
+
+- Тип: `string | false | { text?: string; link?: string }`
+
+- Подробности:
+
+ Указывает текст/ссылку, который должен отображаться при переходе на предыдущую страницу. Если вы не зададите это в метаданных, текст/ссылка будет определяться из конфигурации сайдбара.
+
+- Примеры:
+
+ - Для настройки только текста:
+
+ ```yaml
+ ---
+ prev: 'Начать | Markdown'
+ ---
+ ```
+
+ - Для настройки текста и ссылки:
+
+ ```yaml
+ ---
+ prev:
+ text: 'Markdown'
+ link: '/guide/markdown'
+ ---
+ ```
+
+ - Для скрытия предыдущей страницы:
+
+ ```yaml
+ ---
+ prev: false
+ ---
+ ```
+
+## next {#next}
+
+Аналогично параметру `prev`, но для следующей страницы.
diff --git a/docs/ru/reference/default-theme-search.md b/docs/ru/reference/default-theme-search.md
new file mode 100644
index 00000000..6bbce96e
--- /dev/null
+++ b/docs/ru/reference/default-theme-search.md
@@ -0,0 +1,382 @@
+---
+outline: deep
+---
+
+# Поиск {#search}
+
+## Локальный поиск {#local-search}
+
+VitePress поддерживает нечёткий полнотекстовый поиск с использованием внутрибраузерного индекса благодаря [MiniSearch](https://github.com/lucaong/minisearch/). Чтобы включить эту функцию, просто установите значение `'local'` для опции `themeConfig.search.provider` в файле `.vitepress/config.ts`:
+
+```ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+ themeConfig: {
+ search: {
+ provider: 'local'
+ }
+ }
+})
+```
+
+Пример результата:
+
+
+
+В качестве альтернативы можно использовать [Algolia DocSearch](#algolia-search) или некоторые плагины сообщества, например `. Используйте слоты `#title` и `#lead`, чтобы рассказать о своей команде.
+
+`
{{ theme.footer.copyright }}
+
+```
+
+## `useRoute` Пользовательский макет!
+ `, объединённое с глобальным `title` в качестве суффикса. Например, со следующей конфигурацией и содержимым страницы:
+
+```ts
+export default {
+ title: 'Мой замечательный сайт'
+}
+```
+
+```md
+# Привет
+```
+
+Заголовок страницы будет таким: `Привет | Мой замечательный сайт`.
+
+### titleTemplate {##titletemplate}
+
+- Тип: `string | boolean`
+- Можно переопределить для каждой страницы с помощью [метаданных](./frontmatter-config#titletemplate)
+
+Позволяет настраивать суффикс заголовка каждой страницы или весь заголовок. Например:
+
+```ts
+export default {
+ title: 'Мой замечательный сайт',
+ titleTemplate: 'Пользовательский суффикс'
+}
+```
+
+```md
+# Привет
+```
+
+Заголовок страницы будет таким: `Привет | Пользовательский суффикс`.
+
+Чтобы полностью настроить отображение заголовка, вы можете использовать символ `:title` в `titleTemplate`:
+
+```ts
+export default {
+ titleTemplate: ':title - Пользовательский суффикс'
+}
+```
+
+Здесь `:title` будет заменён текстом, выведенным из первого заголовка страницы `
`. Заголовок страницы предыдущего примера будет `Привет - Пользовательский суффикс`.
+
+Опция может быть установлена в значение `false`, чтобы отключить суффиксы заголовков.
+
+### description {#description}
+
+- Тип: `string`
+- По умолчанию: `A VitePress site`
+- Можно переопределить для каждой страницы с помощью [метаданных](./frontmatter-config#description)
+
+Описание для сайта. Это будет отображаться как тег `` в HTML-странице.
+
+```ts
+export default {
+ description: 'A VitePress site'
+}
+```
+
+### head {#head}
+
+- Тип: `HeadConfig[]`
+- По умолчанию: `[]`
+- Можно добавлять на страницу через [метаданные](./frontmatter-config#head)
+
+Дополнительные элементы для отображения в теге `` в HTML-странице. Добавленные пользователем теги выводятся перед закрывающим тегом `head`, после тегов VitePress.
+
+```ts
+type HeadConfig =
+ | [string, Record