Update Russian translation (#1616)

Co-authored-by: Loot Nurakhmetov <16526639+Lootjs@users.noreply.github.com> Co-authored-by: Chris Swithinbank <357379+delucis@users.noreply.github.com> Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
author: Bugo 2024-04-01 17:24:46 +0500
committer: GitHub 2024-04-01 14:24:46 +0200
commit: a86f9b71b795fb6dcd0409ca568e43d25525b964 (patch)
tree: 0cf56f878fd238325be01ef349482625194c6307
parent: 953c56ed3f920de920ac2708e12f7f98409910f5 (diff)
download: IT.starlight-a86f9b71b795fb6dcd0409ca568e43d25525b964.tar.gz
IT.starlight-a86f9b71b795fb6dcd0409ca568e43d25525b964.tar.bz2
IT.starlight-a86f9b71b795fb6dcd0409ca568e43d25525b964.zip
24 files changed, 3097 insertions, 433 deletions
diff --git a/.changeset/lemon-months-carry.md b/.changeset/lemon-months-carry.md
new file mode 100644
index 00000000..5ba205f8
--- /dev/null
+++ b/.changeset/lemon-months-carry.md
@@ -0,0 +1,5 @@
+---
+"@astrojs/starlight": patch
+---
+
+Updates Russian UI strings
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index b79cf4ba..bdf80614 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -82,7 +82,7 @@ export default defineConfig({
 						'pt-PT': 'Comece Aqui',
 						ko: '여기서부터',
 						tr: 'Buradan Başlayın',
-						ru: 'Начать отсюда',
+						ru: 'Первые шаги',
 						hi: 'यहाँ से शुरू करे',
 						uk: 'Почніть звідси',
 					},
@@ -195,6 +195,7 @@ export default defineConfig({
 						fr: 'Ressources',
 						'pt-BR': 'Recursos',
 						ja: 'リソース',
+						ru: 'Ресурсы',
 					},
 					autogenerate: { directory: 'resources' },
 				},
diff --git a/docs/src/content/docs/ru/environmental-impact.md b/docs/src/content/docs/ru/environmental-impact.md
index 85453305..b8108a53 100644
--- a/docs/src/content/docs/ru/environmental-impact.md
+++ b/docs/src/content/docs/ru/environmental-impact.md
@@ -8,7 +8,7 @@ description: Узнайте, как Starlight может помочь созда
 Расчет экологического воздействия веб-сайта включает в себя множество сложных факторов,
 но в данном руководстве перечислены несколько советов по снижению экологического следа вашего сайта с документацией.
 
-Хорошая новость в том, что выбор Starlight - отличное начало.
+Хорошая новость в том, что выбор Starlight — отличное начало.
 Согласно Website Carbon Calculator, этот сайт [чище, чем 99% протестированных веб-страниц][sl-carbon],
 производя 0,01 г CO₂ за каждое посещение страницы.
 
@@ -17,13 +17,13 @@ description: Узнайте, как Starlight может помочь созда
 Чем больше данных передает веб-страница, тем больше энергетических ресурсов она требует.
 В апреле 2023 года, медианная веб-страница требовала от пользователя скачать более 2 000 КБ данных, согласно [данным из HTTP Archive][http].
 
-Starlight создает страницы легкими, настолько, насколько это возможно
+Starlight создает страницы лёгкими, настолько, насколько это возможно
 Например, при первом посещении пользователь загрузит менее 50 КБ сжатых данных, что составляет всего 2,5% от медианного значения HTTP архива.
 При хорошей стратегии кэширования последующие навигации могут загружать всего 10 КБ.
 
 ### Изображения
 
-Хоть Starlight и предлагает легкие страницы по-умолчанию, изображения, которые вы добавляете на страницы документации, могут быстро увеличивать вес вашей страницы.
+Хоть Starlight и предлагает лёгкие страницы по умолчанию, изображения, которые вы добавляете на страницы документации, могут быстро увеличивать вес вашей страницы.
 Starlight использует [оптимизировацию ресурсов][assets] Astro для оптимизации локальных изображений в ваших файлах Markdown и MDX.
 
 ### UI компоненты
@@ -31,13 +31,13 @@ Starlight использует [оптимизировацию ресурсов]
 Компоненты, на UI фреймворках, как React или Vue, могут легко добавлять большие объемы JavaScript на страницу.
 Поскольку Starlight основан на Astro, эти компоненты, по умолчанию **не загружают клиентский JavaScript** благодаря [Astro Островам][islands].
 
-### Кеширование
+### Кэширование
 
 Кэширование управляет тем, как долго браузер хранит и повторно использует данные, которые он уже загрузил.
 Хорошая стратегия кэширования гарантирует, что пользователь получает новое содержание как можно быстрее,
 когда оно меняется, но также избегает бесполезной повторной загрузки одного и того же содержания снова и снова, когда оно не изменилось.
 
-Самым распространенным способом настройки кэширования является использование [HTTP-заголовка `Cache-Control`][cache].
+Самым распространённым способом настройки кэширования является использование [HTTP-заголовка `Cache-Control`][cache].
 При использовании Starlight вы можете установить длительное время кэширования для всего, что находится в каталоге `/_astro/`.
 Этот каталог содержит CSS, JavaScript и другие ресурсы, которые можно безопасно кэшировать навсегда, что позволяет снизить избыточные загрузки:
 
@@ -60,7 +60,7 @@ Cache-Control: public, max-age=604800, immutable
 
 ## Потребление энергии
 
-То, как реализована веб-страница может влиять на потребление энергии при ее запуске на устройстве пользователя.
+То, как реализована веб-страница может влиять на потребление энергии при её запуске на устройстве пользователя.
 За счет минимального использования JavaScript, Starlight снижает объем вычислительных ресурсов, необходимых телефону,
 планшету или компьютеру пользователя для загрузки и отображения страниц.
 
@@ -111,7 +111,7 @@ Cache-Control: public, max-age=604800, immutable
 | [Read the Docs][rtd-carbon] | 0.24g                        |
 | [GitBook][gb-carbon]        | 0.71g                        |
 
-<small>Данные собраны 14 мая 2023 года. Чтобы увидеть актуальные цифры, перейдите по ссылке..</small>
+<small>Данные собраны 14 мая 2023 года. Чтобы увидеть актуальные цифры, перейдите по ссылке.</small>
 
 [sl-carbon]: https://www.websitecarbon.com/website/starlight-astro-build-getting-started/
 [vp-carbon]: https://www.websitecarbon.com/website/vitepress-dev-guide-what-is-vitepress/
@@ -136,10 +136,10 @@ Cache-Control: public, max-age=604800, immutable
 
 ### Статьи и выступления
 
-- ["Построение более экологичного веба"](https://youtu.be/EfPoOt7T5lg), выступление Мишель Баркер
-- ["Стратегии экологически устойчивый веб-разработки в организации"](https://www.smashingmagazine.com/2022/10/sustainable-web-development-strategies-organization/), статья Мишель Баркер
-- ["Экологически устойчивый веб для каждого"](https://2021.stateofthebrowser.com/speakers/tom-greenwood/), выступление Тома Гринвуда
-- ["Как веб-контент может влиять на энергопотребление"](https://webkit.org/blog/8970/how-web-content-can-affect-power-usage/), статья Бенджамина Пулена и Саймона Фрейзера.
+- [Построение более экологичного веба](https://youtu.be/EfPoOt7T5lg), выступление Мишель Баркер
+- [Стратегии устойчивого веб-развития в организации](https://www.smashingmagazine.com/2022/10/sustainable-web-development-strategies-organization/), статья Мишель Баркер
+- [Экологически устойчивый веб для каждого](https://2021.stateofthebrowser.com/speakers/tom-greenwood/), выступление Тома Гринвуда
+- [Как веб-контент может влиять на энергопотребление](https://webkit.org/blog/8970/how-web-content-can-affect-power-usage/), статья Бенджамина Пулена и Саймона Фрейзера.
 
 [sf]: https://www.sciencefocus.com/science/what-is-the-carbon-footprint-of-the-internet/
 [bbc]: https://www.bbc.com/future/article/20200305-why-your-internet-habits-are-not-as-clean-as-you-think
diff --git a/docs/src/content/docs/ru/getting-started.mdx b/docs/src/content/docs/ru/getting-started.mdx
index 4338f271..8276d15b 100644
--- a/docs/src/content/docs/ru/getting-started.mdx
+++ b/docs/src/content/docs/ru/getting-started.mdx
@@ -1,13 +1,17 @@
 ---
 title: Введение
-description: Узнайте, как начать создание вашего следующего сайта с документацией с помощью Starlight от Astro
+description: Узнайте, как начать создание вашего следующего сайта с документацией с помощью Starlight от Astro.
 ---
 
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 
-## Создание нового проекта
-
 Starlight — это полнофункциональная тема для документации, созданная на основе фреймворка [Astro](https://astro.build).
+Это руководство поможет вам начать работу над новым проектом.
+См. [инструкции по ручной настройке](/ru/manual-setup/), чтобы добавить Starlight в существующий проект Astro.
+
+## Быстрый старт
+
+### Создание нового проекта
 
 Вы можете создать новый проект на базе Astro + Starlight, используя следующую команду:
 
@@ -15,7 +19,6 @@ Starlight — это полнофункциональная тема для до
 <TabItem label="npm">
 
 ```sh
-# создать новый проект с помощью npm
 npm create astro@latest -- --template starlight
 ```
 
@@ -23,7 +26,6 @@ npm create astro@latest -- --template starlight
 <TabItem label="pnpm">
 
 ```sh
-# создать новый проект с помощью pnpm
 pnpm create astro --template starlight
 ```
 
@@ -31,7 +33,6 @@ pnpm create astro --template starlight
 <TabItem label="Yarn">
 
 ```sh
-# создать новый проект с помощью yarn
 yarn create astro --template starlight
 ```
 
@@ -45,48 +46,58 @@ yarn create astro --template starlight
 [откройте шаблон на StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics).
 :::
 
-## Создание контента с Starlight
+### Запуск сервера разработки
 
-Starlight готов к созданию нового контента или к интеграции уже существующих файлов!
+При локальной работе [сервер разработки Astro](https://docs.astro.build/ru/reference/cli-reference/#astro-dev) позволяет предварительно просмотреть вашу работу и автоматически обновляет ваш браузер при внесении изменений.
 
-### Форматы файлов
+Внутри каталога вашего проекта выполните следующую команду, чтобы запустить сервер разработки:
 
-Starlight поддерживает создание контента в форматах Markdown и MDX. (Вы можете добавить поддержку Markdoc, установив экспериментальную [интеграцию Astro Markdoc](https://docs.astro.build/ru/guides/integrations-guide/markdoc/).)
+<Tabs>
+<TabItem label="npm">
 
-### Добавить страницы
+```sh
+npm run dev
+```
 
-Автоматически добавляйте новые страницы на ваш сайт, создавая файлы `.md` или `.mdx` в директории `src/content/docs/`.
-Добавляйте подпапки для организации ваших файлов и создания множественных сегментов пути:
+</TabItem>
+<TabItem label="pnpm">
 
+```sh
+pnpm dev
 ```
-src/content/docs/hello-world.md => ваш-сайт.com/hello-world
-src/content/docs/guides/faq.md => ваш-сайт.com/guides/faq
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn dev
 ```
 
-### Типобезопасные метаданные
+</TabItem>
+</Tabs>
+
+На ваш терминал будет отправлено сообщение с URL-адресом вашего локального предварительного просмотра.
+Откройте этот URL-адрес, чтобы начать просмотр вашего сайта.
 
-Все страницы Starlight используют настраиваемый [общий набор свойств метаданных](/ru/reference/frontmatter/) для контроля отображения страницы:
+### Добавление контента
 
-```md
----
-title: Привет, мир!
-description: Это страница на моем сайте, работающем на Starlight
----
-```
+Starlight готов к созданию нового контента или к интеграции уже существующих файлов!
 
-Если вы что-то забудете, Starlight сообщит вам об этом
+Добавляйте новые страницы на свой сайт, создавая файлы Markdown в каталоге `src/content/docs/`.
 
-## Развертывание вашего сайта на Starlight
+Подробнее о файловой маршрутизации и поддержке файлов MDX и Markdoc читайте в руководстве [Страницы](/ru/guides/pages/).
 
-После того как вы создали и настроили свой сайт на Starlight, вы можете развернуть его на веб-сервере или
-платформе хостинга по вашему выбору, включая Netlify, Vercel, GitHub Pages и так далее.
+### Следующие шаги
 
-[Узнайте о развертывании сайта на Astro из документации Astro.](https://docs.astro.build/ru/guides/deploy/)
+- **Настройка:** Узнайте об общих опциях в главе [Настройка Starlight](/ru/guides/customization/).
+- **Навигация.** Настройте боковую панель с помощью руководства [Навигация по боковой панели](/ru/guides/sidebar/).
+- **Компоненты.** Узнайте о встроенных карточках, вкладках и многом другом в руководстве [Компоненты](/ru/guides/components/).
+- **Развёртывание.** Опубликуйте свою работу с помощью руководства [Развёртывание вашего сайта](https://docs.astro.build/ru/guides/deploy/) в документации Astro.
 
 ## Обновление Starlight
 
 :::tip
-Поскольку Starlight еще в beta, будут частые обновления и улучшения.
+Поскольку Starlight ещё в статусе beta, будут частые обновления и улучшения.
 Не забывайте регулярно обновлять Starlight!
 :::
 
@@ -96,24 +107,21 @@ Starlight является интеграцией Astro и обновляетс�
 <TabItem label="npm">
 
 ```sh
-# Обновление Starlight с npm
-npm install @astrojs/starlight@latest
+npx @astrojs/upgrade
 ```
 
 </TabItem>
 <TabItem label="pnpm">
 
 ```sh
-# Обновление Starlight с pnpm
-pnpm upgrade @astrojs/starlight --latest
+pnpm dlx @astrojs/upgrade
 ```
 
 </TabItem>
 <TabItem label="Yarn">
 
 ```sh
-# Обновление Starlight с yarn
-yarn upgrade @astrojs/starlight --latest
+yarn dlx @astrojs/upgrade
 ```
 
 </TabItem>
@@ -124,14 +132,11 @@ yarn upgrade @astrojs/starlight --latest
 
 ## Устранение проблем с Starlight
 
-Информация о [конфигурации проекта Starlight](/ru/reference/configuration/)
-и [конфигурации метаданных отдельной страницы](/ru/reference/frontmatter/) доступна в разделе Справочник этого сайта.
-Используйте эти страницы, чтобы убедиться, что ваш сайт на Starlight настроен и работает корректно.
-
-Смотрите пополняющийся список руководств в боковой панели для помощи в добавлении контента и настройке вашего сайта на Starlight.
+Используйте справочные страницы [конфигурация проекта](/ru/reference/configuration/) и [конфигурация метаданных отдельной страницы](/ru/reference/frontmatter/), чтобы убедиться, что ваш сайт Starlight настроен и работает правильно.
+См. руководства на боковой панели, чтобы получить помощь в добавлении контента и настройке вашего сайта Starlight.
 
 Если вы не можете найти ответ в этой документации, пожалуйста, посетите [полную документацию Astro](https://docs.astro.build/ru/).
-Ваш вопрос может быть решен узнав как в целом работает Astro под темой Starlight.
+На ваш вопрос можно ответить, если вы поймете, как работает Astro в целом в рамках темы Starlight.
 
 Вы также можете узнать про любые известные [проблемы Starlight на GitHub](https://github.com/withastro/starlight/issues) и получить помощь в
 [Discord Astro](https://astro.build/chat/) от нашего активного, дружелюбного сообщества!
diff --git a/docs/src/content/docs/ru/guides/authoring-content.md b/docs/src/content/docs/ru/guides/authoring-content.md
index 3d700ae2..a389ef63 100644
--- a/docs/src/content/docs/ru/guides/authoring-content.md
+++ b/docs/src/content/docs/ru/guides/authoring-content.md
@@ -1,20 +1,34 @@
 ---
 title: Создание контента в Markdown
-description: Синтаксис Markdown, поддерживаемого Starlight.
+description: Обзор синтаксиса Markdown, который поддерживается в Starlight.
 ---
 
-Starlight поддерживает весь синтаксис [Markdown](https://daringfireball.net/projects/markdown/) в файлах с расширением `.md`,
-а также синтаксис [YAML](https://dev.to/paulasantamaria/introduction-to-yaml-125f) для определения метаданных, таких как заголовок и описание.
+Starlight поддерживает весь синтаксис [Markdown](https://daringfireball.net/projects/markdown/) в файлах с расширением `.md`, а также синтаксис [YAML](https://dev.to/paulasantamaria/introduction-to-yaml-125f) для определения метаданных, таких как заголовок и описание.
 
-Пожалуйста, обратитесь к [документации MDX](https://mdxjs.com/docs/what-is-mdx/#markdown) или [документации Markdoc](https://markdoc.dev/docs/syntax),
-если вы используете эти форматы файлов, так как синтаксисы могут различаться от Markdown.
+Пожалуйста, обратитесь к [документации MDX](https://mdxjs.com/docs/what-is-mdx/#markdown) или [документации Markdoc](https://markdoc.dev/docs/syntax), если вы используете эти форматы файлов, поскольку поддержка и использование Markdown могут отличаться.
 
-## Форматирование текста
+## Метаданные
+
+Вы можете настроить отдельные страницы в Starlight, установив значения в их заглавной части.
+Метаданные устанавливаются в верхней части ваших файлов между разделителями `---`:
+
+```md title="src/content/docs/example.md"
+---
+title: Заголовок страницы
+---
+
+Содержимое страницы следует за вторым `---`.
+```
 
-Текст может быть **жирным**, _курсивом_ или ~~зачеркнутым~~.
+Каждая страница должна включать хотя бы заголовок.
+См. [ссылку на метаданные](/ru/reference/frontmatter/) для получения информации обо всех доступных полях и о том, как добавлять настраиваемые поля.
+
+## Встроенные стили
+
+Текст может быть **жирным**, _курсивом_ или ~~зачёркнутым~~.
 
 ```md
-Текст может быть **жирным**, _курсивом_ или ~~зачеркнутым~~.
+Текст может быть **жирным**, _курсивом_ или ~~зачёркнутым~~.
 ```
 
 Вы можете [ссылаться на другую страницу](/ru/getting-started/).
@@ -31,18 +45,17 @@ Starlight поддерживает весь синтаксис [Markdown](https:
 
 ## Изображения
 
-Изображения в Starlight используют [встроенную оптимизацию ресурсов в Astro](https://docs.astro.build/ru/guides/assets/).
+Изображения в Starlight используют [встроенную оптимизацию ресурсов Astro](https://docs.astro.build/ru/guides/assets/).
 
-Markdown и MDX поддерживают синтаксис Markdown для отображения изображений,
-который включает альтернативный текст для экранных читателей и вспомогательных технологий.
+Markdown и MDX поддерживают синтаксис Markdown для отображения изображений, который включает альтернативный текст для экранных читателей и вспомогательных технологий.
 
-![Иллюстрация планет и звезд с надписью "astro"](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
+![Иллюстрация планет и звёзд с надписью "astro"](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
 
 ```md
-![Иллюстрация планет и звезд с надписью "astro"](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
+![Иллюстрация планет и звёзд с надписью "astro"](https://raw.githubusercontent.com/withastro/docs/main/public/default-og-image.png)
 ```
 
-Также поддерживаются относительные пути к изображениям, хранящиеся локально в вашем проекте.
+Относительные пути к изображениям также поддерживаются для изображений, хранящихся локально в вашем проекте.
 
 ```md
 // src/content/docs/page-1.md
@@ -52,14 +65,11 @@ Markdown и MDX поддерживают синтаксис Markdown для от
 
 ## Заголовки
 
-Вы можете структурировать контент, используя заголовки.
-Заголовки в Markdown обозначаются количеством символов `#` в начале строки.
+Вы можете структурировать контент, используя заголовки. Заголовки в Markdown обозначаются количеством символов `#` в начале строки.
 
 ### Как структурировать контент страницы
 
-Starlight настроен так, чтобы автоматически использовать заголовок вашей страницы в качестве заголовка верхнего
-уровня и включать заголовок "Обзор" в начале оглавления каждой страницы. Мы рекомендуем начинать каждую страницу
-с обычного текстового содержания абзаца и использовать заголовки на странице от `<h2>` и ниже:
+Starlight настроен так, чтобы автоматически использовать заголовок вашей страницы в качестве заголовка верхнего уровня и включать заголовок «Обзор» в начале оглавления каждой страницы. Мы рекомендуем начинать каждую страницу с обычного текстового содержания абзаца и использовать заголовки на странице от `<h2>` и ниже:
 
 ```md
 ---
@@ -76,8 +86,7 @@ description: Как использовать Markdown в Starlight
 
 ### Автоматические якорные ссылки для заголовков
 
-Использование заголовков в Markdown автоматически создает якорные ссылки,
-позволяя вам ссылаться на определенные разделы вашей страницы:
+Использование заголовков в Markdown автоматически создает якорные ссылки, позволяя вам ссылаться на определённые разделы вашей страницы:
 
 ```md
 ---
@@ -87,29 +96,29 @@ description: Как использовать встроенные в Starlight �
 
 ## Введение
 
-Я могу создать ссылку на [заключение](#conclusion) ниже на этой же странице.
+Я могу создать ссылку на [заключение](#заключение) ниже на этой же странице.
 
 ## Заключение
 
-`https://my-site.com/page1/#introduction` навигирует непосредственно к разделу "Введение" на моей странице.
+`https://my-site.com/page1/#введение` переходит непосредственно к моему Введению.
 ```
 
 Заголовки уровня 2 (`<h2>`) и уровня 3 (`<h3>`) автоматически появятся в оглавлении страницы.
 
+Узнайте больше о том, как Astro обрабатывает идентификаторы заголовков, в [документации Astro](https://docs.astro.build/ru/guides/markdown-content/#%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D1%8B-%D0%B7%D0%B0%D0%B3%D0%BE%D0%BB%D0%BE%D0%B2%D0%BA%D0%BE%D0%B2)
+
 ## Вставки
 
-Вставки, либо "предостережения" или "вызовы", полезны для отображения дополнительной информации рядом с основным контентом страницы.
+Вставки полезны для отображения дополнительной информации рядом с основным контентом страницы.
 
-Starlight предоставляет специальный синтаксис Markdown для отображения вставок.
-Вставки должны быть обернуты парой тройных двоеточий `:::` и могут иметь тип `note`, `tip`, `caution` или `danger`.
+Starlight предоставляет специальный синтаксис Markdown для отображения вставок. Вставки должны быть обернуты парой тройных двоеточий `:::` и могут иметь тип `note`, `tip`, `caution` или `danger`.
 
 Вы можете указывать любые типы контента Markdown внутри вставок, но вставки лучше всего подходят для коротких и лаконичных блоков информации.
 
-### Вставка "Заметка"
+### Вставка «Заметка»
 
 :::note
-Starlight - это инструмент для создания сайтов с документацией,
-построенный с использованием [Astro](https://astro.build/). Вы можете начать создавать запустив команду:
+Starlight — это инструмент для создания сайтов с документацией, построенный с использованием [Astro](https://astro.build/ru/). Вы можете начать с этой команды:
 
 ```sh
 npm create astro@latest -- --template starlight
@@ -119,8 +128,7 @@ npm create astro@latest -- --template starlight
 
 ````md
 :::note
-Starlight - это инструмент для создания сайтов с документацией,
-построенный с использованием [Astro](https://astro.build/). Вы можете начать создавать запустив команду:
+Starlight — это инструмент для создания сайтов с документацией, построенный с использованием [Astro](https://astro.build/ru/). Вы можете начать с этой команды:
 
 ```sh
 npm create astro@latest -- --template starlight
@@ -131,21 +139,21 @@ npm create astro@latest -- --template starlight
 
 ### Настраиваемые заголовки вставок
 
-Вы можете указать свой заголовок вставки в квадратных скобках после типа вставки, например, `:::tip[Знали ли вы?]`.
+Вы можете указать свой заголовок вставки в квадратных скобках после типа вставки, например, `:::tip[Небольшой совет]`.
 
-:::tip
-Astro позволяет создавать быстрые сайты с помощью ["архитектуры островов"](https://docs.astro.build/ru/concepts/islands/)
+:::tip[Небольшой совет]
+Astro позволяет создавать быстрые сайты с помощью [архитектуры островов](https://docs.astro.build/ru/concepts/islands/)
 :::
 
 ```md
-:::tip
-Astro позволяет создавать быстрые сайты с помощью ["архитектуры островов"](https://docs.astro.build/ru/concepts/islands/)
+:::tip[Небольшой совет]
+Astro позволяет создавать быстрые сайты с помощью [архитектуры островов](https://docs.astro.build/ru/concepts/islands/)
 :::
 ```
 
-### Больше типов вставок
+### Другие типы вставок
 
-Вставки "Caution" и "danger" полезны для привлечения внимания пользователя к деталям, которые могут сбивать с толку.
+Вставки «Caution» и «danger» полезны для привлечения внимания пользователя к деталям, которые могут сбивать с толку.
 Если вы часто используете их, это может быть признаком того, что может быть нужно пересмотреть то, что вы документируете.
 
 :::caution
@@ -155,7 +163,7 @@ Astro позволяет создавать быстрые сайты с пом�
 :::danger
 Ваши пользователи могут быть более продуктивными и находить ваш продукт более простым в использовании благодаря полезным функциям Starlight.
 
-- Четкая навигация
+- Чёткая навигация
 - Цветовая тема, настраиваемая пользователем
 - [Поддержка i18n](/ru/guides/i18n)
 
@@ -169,7 +177,7 @@ Astro позволяет создавать быстрые сайты с пом�
 :::danger
 Ваши пользователи могут быть более продуктивными и находить ваш продукт более простым в использовании благодаря полезным функциям Starlight.
 
-- Четкая навигация
+- Чёткая навигация
 - Цветовая тема, настраиваемая пользователем
 - [Поддержка i18n](/ru/guides/i18n)
 
@@ -190,8 +198,7 @@ Astro позволяет создавать быстрые сайты с пом�
 
 ## Блоки кода
 
-Блок кода обозначается блоком с тремя обратными апострофами <code>```</code> в начале и в конце.
-Вы можете указать язык программирования после открывающих апострофов.
+Блок кода обозначается блоком с тремя обратными апострофами <code>```</code> в начале и в конце. Вы можете указать язык программирования после открывающих апострофов.
 
 ```js
 // Javascript код с подсветкой синтаксиса.
@@ -211,11 +218,153 @@ var fun = function lang(l) {
 ```
 ````
 
-```md
-Длинные блоки кода в одну строку не должны переноситься. Они должны прокручиваться горизонтально, если они слишком длинные. Эта строка должна быть достаточно длинной, чтобы продемонстрировать это.
-```
+### Возможности Expressive Code
+
+Starlight использует [Expressive Code](https://github.com/expressive-code/expressive-code/tree/main/packages/astro-expressive-code) для расширения возможностей форматирования блоков кода.
+Текстовые маркеры и плагины оконных рамок Expressive Code включены по умолчанию.
+Рендеринг блоков кода можно настроить с помощью [параметра конфигурации `expressiveCode`](/ru/reference/configuration/#expressivecode) Starlight.
+
+#### Текстовые маркеры
+
+Вы можете выделить определённые строки или части блоков кода с помощью [текстовых маркеров Expressive Code](https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-text-markers/README.md#usage-in-markdown--mdx-documents) в первой строке вашего блока кода.
+Используйте фигурные скобки (`{ }`), чтобы выделить целые строки, и кавычки, чтобы выделить строки текста.
+
+Существует три стиля выделения: нейтральный для привлечения внимания к коду, зелёный для обозначения вставленного кода и красный для обозначения удалённого кода.
+И текст, и целые строки можно пометить с помощью маркера по умолчанию или в сочетании с `ins=` и `del=` для получения желаемого выделения.
+
+Expressive Code предоставляет несколько вариантов настройки внешнего вида примеров кода.
+Многие из них можно комбинировать для получения наглядных примеров кода.
+Ознакомьтесь с [документацией Expressive Code](https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-text-markers/README.md), чтобы узнать о расширенных возможностях. доступный.
+Некоторые из наиболее распространённых примеров показаны ниже:
+
+- [Пометка целых строк и диапазонов строк с помощью маркера `{ }`](https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-text-markers/README.md#marking-entire-lines--line-ranges):
+
+  ```js {2-3}
+  function demo() {
+    // Эта строка (#2) и следующая выделены
+    return 'Это строка №3 этого фрагмента.';
+  }
+  ```
+
+  ````md
+  ```js {2-3}
+  function demo() {
+    // Эта строка (#2) и следующая выделены
+    return 'Это строка №3 этого фрагмента.';
+  }
+  ```
+  ````
+
+- [Пометка выделенного текста с помощью маркера `" "` или регулярных выражений](https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-text-markers/README.md#marking-individual-text-inside-lines):
+
+  ```js "Отдельные термины" /даже.*выражения/
+  // Отдельные термины также могут быть выделены
+  function demo() {
+    return 'Поддерживаются даже регулярные выражения';
+  }
+  ```
+
+  ````md
+  ```js "Отдельные термины" /даже.*выражения/
+  // Отдельные термины также могут быть выделены
+  function demo() {
+    return 'Поддерживаются даже регулярные выражения';
+  }
+  ```
+  ````
+
+- [Пометка текста или строк как вставленных или удалённых с помощью `ins` или `del`](https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-text-markers/README.md#selecting-marker-types-mark-ins-del):
+
+  ```js "return true;" ins="вставленные" del="удалённые"
+  function demo() {
+    console.log('Это вставленные и удалённые типы маркеров');
+    // Оператор return использует тип маркера по умолчанию
+    return true;
+  }
+  ```
+
+  ````md
+  ```js "return true;" ins="вставленные" del="удалённые"
+  function demo() {
+    console.log('Это вставленные и удалённые типы маркеров');
+    // Оператор return использует тип маркера по умолчанию
+    return true;
+  }
+  ```
+  ````
+
+- [Объединение подсветки синтаксиса с синтаксисом типа `diff`](https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-text-markers/README.md#combining-syntax-highlighting-with-diff-like-syntax):
+
+  ```diff lang="js"
+    function thisIsJavaScript() {
+      // Весь этот блок выделяется как JavaScript,
+      // и мы можем добавить к нему маркеры различий!
+  -   console.log('Старый код, который нужно удалить')
+  +   console.log('Новый и блестящий код!')
+    }
+  ```
+
+  ````md
+  ```diff lang="js"
+    function thisIsJavaScript() {
+      // Весь этот блок выделяется как JavaScript,
+      // и мы можем добавить к нему маркеры различий!
+  -   console.log('Старый код, который нужно удалить')
+  +   console.log('Новый и блестящий код!')
+    }
+  ```
+  ````
+
+#### Рамки и заголовки
+
+Блоки кода могут отображаться внутри оконного фрейма.
+Рамка, похожая на окно терминала, будет использоваться для языков сценариев оболочки (например, `bash` или `sh`).
+Другие языки отображаются внутри рамки в стиле редактора кода, если они включают заголовок.
+
+Необязательный заголовок блока кода может быть установлен либо с помощью атрибута `title="..."` после открывающих обратных кавычек блока кода и идентификатора языка, либо с помощью комментария к имени файла в первых строках кода.
+
+- [Добавление вкладки имени файла с помощью комментария](https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-frames/README.md#adding-titles-open-file-tab-or-terminal-window-title)
+
+  ```js
+  // my-test-file.js
+  console.log('Привет, мир!');
+  ```
+
+  ````md
+  ```js
+  // my-test-file.js
+  console.log('Привет, мир!');
+  ```
+  ````
+
+- [Добавление заголовка в окне терминала](https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-frames/README.md#adding-titles-open-file-tab-or-terminal-window-title)
+
+  ```bash title="Установка зависимостей…"
+  npm install
+  ```
+
+  ````md
+  ```bash title="Установка зависимостей…"
+  npm install
+  ```
+  ````
+
+- [Отключение оконных рамок с помощью `frame="none"`](https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-frames/README.md#overriding-frame-types)
+
+  ```bash frame="none"
+  echo "Это не отображается как терминал, несмотря на использование языка bash"
+  ```
+
+  ````md
+  ```bash frame="none"
+  echo "Это не отображается как терминал, несмотря на использование языка bash"
+  ```
+  ````
 
 ## Другие возможности Markdown
 
-Starlight поддерживает все синтаксические возможности Markdown, такие как списки и таблицы.
-Посмотрите [шпаргалку по Markdown от The Markdown Guide](https://www.markdownguide.org/cheat-sheet/) для изучения всех возможностей синтаксиса Markdown.
+Starlight поддерживает все синтаксические возможности Markdown, такие как списки и таблицы. Посмотрите [шпаргалку по Markdown от The Markdown Guide](https://www.markdownguide.org/cheat-sheet/) для изучения всех возможностей синтаксиса Markdown.
+
+## Расширенная конфигурация Markdown и MDX
+
+Starlight использует Markdown и рендерер MDX от Astro, основанный на `remark` и `rehype`. Вы можете добавить поддержку пользовательского синтаксиса и поведения, добавив `remarkPlugins` или `rehypePlugins` в свой файл конфигурации Astro. Дополнительную информацию см. в разделе [Настройка Markdown и MDX](https://docs.astro.build/ru/guides/markdown-content/#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-markdown-%D0%B8-mdx) в документации Astro.
diff --git a/docs/src/content/docs/ru/guides/components.mdx b/docs/src/content/docs/ru/guides/components.mdx
index 249e1485..cb841c5c 100644
--- a/docs/src/content/docs/ru/guides/components.mdx
+++ b/docs/src/content/docs/ru/guides/components.mdx
@@ -3,21 +3,21 @@ title: Компоненты
 description: Использование компонентов в MDX со Starlight.
 ---
 
-Компоненты позволяют вам легко повторно использовать фрагменты UI или стилизации.
+Компоненты позволяют легко и последовательно переиспользовать часть пользовательского интерфейса или стиля.
 Примерами могут служить ссылочные карточки или встроенные видео YouTube.
 Starlight поддерживает использование компонентов в файлах [MDX](https://mdxjs.com/) и предоставляет некоторые общие компоненты для вашего использования.
 
 [Узнайте больше о создании компонентов в документации Astro](https://docs.astro.build/ru/core-concepts/astro-components/).
 
-## Использование компонент
+## Использование компонента
 
 Вы можете использовать компонент, импортировав его в ваш файл MDX, а затем отобразив его как тег JSX.
 Они выглядят как HTML-теги, но начинаются с заглавной буквы, соответствующей имени в вашем операторе `import`:
 
 ```mdx
 ---
-# src/content/docs/index.mdx
-title: Добро пожаловать на мою документацию
+# src/content/docs/example.mdx
+title: Добро пожаловать в мою документацию
 ---
 
 import SomeComponent from '../../components/SomeComponent.astro';
@@ -26,21 +26,19 @@ import AnotherComponent from '../../components/AnotherComponent.astro';
 <SomeComponent prop="something" />
 
 <AnotherComponent>
-	Компоненты могут содержать **вложенный контент**.
+	Компоненты могут содержать **вложенное содержимое**.
 </AnotherComponent>
 ```
 
-Поскольку Starlight работает на базе Astro, вы можете использовать компоненты,
-созданные на любом [поддерживаемом UI-фреймворке (React, Preact, Svelte, Vue, Solid, Lit и Alpine)](https://docs.astro.build/en/core-concepts/framework-components/)
-в ваших файлах MDX.
-Узнайте больше о [использовании компонентов в MDX](https://docs.astro.build/ru/guides/markdown-content/#using-components-in-mdx) в документации Astro.
+Поскольку Starlight работает на базе Astro, вы можете использовать в своих файлах MDX любые компоненты, созданные на [поддерживаемом UI-фреймворке (React, Preact, Svelte, Vue, Solid, Lit и Alpine)](https://docs.astro.build/ru/core-concepts/framework-components/).
+Узнайте больше об [использовании компонентов в MDX](https://docs.astro.build/ru/guides/markdown-content/#использование-компонентов-в-mdx) в документации Astro.
 
 ### Совместимость со стилями Starlight
 
 Starlight применяет стандартные стили к вашему содержимому в формате Markdown, например, добавляет отступ между элементами.
 Если эти стили конфликтуют с внешним видом вашего компонента, установите класс `not-content` для вашего компонента, чтобы отключить их.
 
-```astro
+```astro 'class="not-content"'
 ---
 // src/components/Example.astro
 ---
@@ -61,21 +59,32 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
 
 Вы можете отобразить интерфейс с вкладками, используя компоненты `<Tabs>` и `<TabItem>`.
 Каждый компонент `<TabItem>` должен иметь `label` для отображения пользователям.
+Используйте дополнительный атрибут `icon`, чтобы включить один из [встроенных значков Starlight](#все-иконки) рядом с меткой.
 
 ```mdx
+# src/content/docs/example.mdx
+
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 
 <Tabs>
-	<TabItem label="Звезды">Сириус, Вега, Бетельгейзе</TabItem>
-	<TabItem label="Луны">Ио, Европа, Ганимед</TabItem>
+	<TabItem label="Звёзды" icon="star">
+		Сириус, Вега, Бетельгейзе
+	</TabItem>
+	<TabItem label="Луны" icon="moon">
+		Ио, Европа, Ганимед
+	</TabItem>
 </Tabs>
 ```
 
-Вышеуказанный код генерирует следующие вкладки на странице:
+Вышеуказанный код сформирует следующие вкладки:
 
 <Tabs>
-	<TabItem label="Звезды">Сириус, Вега, Бетельгейзе</TabItem>
-	<TabItem label="Луны">Ио, Европа, Ганимед</TabItem>
+	<TabItem label="Звёзды" icon="star">
+		Сириус, Вега, Бетельгейзе
+	</TabItem>
+	<TabItem label="Луны" icon="moon">
+		Ио, Европа, Ганимед
+	</TabItem>
 </Tabs>
 
 ### Карточки
@@ -85,15 +94,17 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
 Вы можете отображать контент в блоке, со стилями Starlight, используя компонент `<Card>`.
 Оберните несколько карточек в компонент `<CardGrid>`, чтобы отображать карточки рядом, когда есть достаточно места.
 
-`<Card>` требует `title` и может дополнительно включать атрибут `icon`, установленный как название [одного из встроенных иконок Starlight](#все-иконки).
+`<Card>` требует `title` и может дополнительно включать атрибут `icon`, установленный как название [одной из встроенных иконок Starlight](#все-иконки).
 
 ```mdx
+# src/content/docs/example.mdx
+
 import { Card, CardGrid } from '@astrojs/starlight/components';
 
 <Card title="Зацени">Интересный контент, который вы хотите подсветить.</Card>
 
 <CardGrid>
-	<Card title="Звезды" icon="star">
+	<Card title="Звёзды" icon="star">
 		Сириус, Вега, Бетельгейзе
 	</Card>
 	<Card title="Луны" icon="moon">
@@ -102,12 +113,12 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
 </CardGrid>
 ```
 
-Вышеуказанный код генерирует следующее на странице:
+Вышеуказанный код сформирует следующий HTML:
 
 <Card title="Зацени">Интересный контент, который вы хотите подсветить.</Card>
 
 <CardGrid>
-	<Card title="Звезды" icon="star">
+	<Card title="Звёзды" icon="star">
 		Сириус, Вега, Бетельгейзе
 	</Card>
 	<Card title="Луны" icon="moon">
@@ -117,7 +128,7 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
 
 :::tip
 Используйте сетку карточек на вашей домашней странице для отображения ключевых функций вашего проекта.
-Добавьте атрибут `stagger`, чтобы сдвинуть вторую колонку карточек по вертикали и добавить визуальный интерес:
+Добавьте атрибут `stagger`, чтобы сместить вторую колонку карточек по вертикали и добавить визуальный интерес:
 
 ```astro
 <CardGrid stagger>
@@ -131,12 +142,13 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
 
 Используйте компонент `<LinkCard>` для создания заметных ссылок на разные страницы.
 
-`<LinkCard>` требует атрибута `title` и атрибута [`href`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#href).
-По желанию вы можете добавить краткое `description` или другие атрибуты ссылки, такие как `target`.
+`<LinkCard>` требует атрибута `title` и атрибута [`href`](https://developer.mozilla.org/ru/docs/Web/HTML/Element/a#href). По желанию вы можете добавить краткое `description` или другие атрибуты ссылки, такие как `target`.
 
 Группируйте несколько компонентов `<LinkCard>` в `<CardGrid>`, чтобы отображать карточки рядом, когда есть достаточно места.
 
 ```mdx
+# src/content/docs/example.mdx
+
 import { LinkCard, CardGrid } from '@astrojs/starlight/components';
 
 <LinkCard
@@ -146,15 +158,12 @@ import { LinkCard, CardGrid } from '@astrojs/starlight/components';
 />
 
 <CardGrid>
-	<LinkCard
-		title="Создание контента в Markdown"
-		href="/ru/guides/authoring-content/"
-	/>
+	<LinkCard title="Создание контента в Markdown" href="/ru/guides/authoring-content/" />
 	<LinkCard title="Компоненты" href="/ru/guides/components/" />
 </CardGrid>
 ```
 
-Вышеуказанный код генерирует следующее на странице:
+Вышеуказанный код сформирует следующий HTML:
 
 import { LinkCard } from '@astrojs/starlight/components';
 
@@ -165,13 +174,200 @@ import { LinkCard } from '@astrojs/starlight/components';
 />
 
 <CardGrid>
-	<LinkCard
-		title="Создание контента в Markdown"
-		href="/ru/guides/authoring-content/"
-	/>
+	<LinkCard title="Создание контента в Markdown" href="/ru/guides/authoring-content/" />
 	<LinkCard title="Компоненты" href="/ru/guides/components/" />
 </CardGrid>
 
+### Вставки
+
+Вставки полезны для отображения второстепенной информации рядом с основным содержанием страницы.
+
+У `<Aside>` может быть необязательный атрибут `type` со значением `note`, `tip`, `caution`, или `danger` (по умолчанию — `note`). Установка атрибута `title` отменяет заголовок, установленный по умолчанию.
+
+````mdx
+# src/content/docs/example.mdx
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>Стандартная вставка без пользовательского заголовка.</Aside>
+
+<Aside type="caution" title="Осторожно!">
+	Вставка предупреждения *с* пользовательским заголовком.
+</Aside>
+
+<Aside type="tip" title="Совет">
+
+Другой контент также поддерживается.
+
+```js
+// Например, фрагмент кода.
+```
+
+</Aside>
+
+<Aside type="danger">Никому не сообщайте свой пароль.</Aside>
+````
+
+Вышеуказанный код сформирует следующий HTML:
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>Стандартная вставка без пользовательского заголовка.</Aside>
+
+<Aside type="caution" title="Осторожно!">
+	Вставка предупреждения *с* пользовательским заголовком.
+</Aside>
+
+<Aside type="tip" title="Совет">
+
+Другой контент также поддерживается.
+
+```js
+// Например, фрагмент кода.
+```
+
+</Aside>
+
+<Aside type="danger">Никому не сообщайте свой пароль.</Aside>
+
+Starlight также предоставляет собственный синтаксис для рендеринга в Markdown и MDX в качестве альтернативы компоненту `<Aside>`.
+Подробную информацию о пользовательском синтаксисе см. в руководстве [Создание контента в Markdown](/ru/guides/authoring-content/#вставки).
+
+### Код
+
+Используйте компонент `<Code>` для рендеринга выделенного синтаксиса кода, когда использование [блока кода Markdown](/ru/guides/authoring-content/#блоки-кода) невозможно, например, для рендеринга данных, поступающих из внешних источников: файлов, баз данных или API.
+
+См. главу [Компонент кода](https://expressive-code.com/key-features/code-component/) в документации Expressive Code для получения полной информации о параметрах, которые поддерживает `<Code>`.
+
+```mdx
+# src/content/docs/example.mdx
+
+import { Code } from '@astrojs/starlight/components';
+
+export const exampleCode = `console.log('Это может быть файл или CMS.!');`;
+export const fileName = 'example.js';
+export const highlights = ['файл', 'CMS'];
+
+<Code code={exampleCode} lang="js" title={fileName} mark={highlights} />
+```
+
+Вышеуказанный код сформирует следующий HTML:
+
+import { Code } from '@astrojs/starlight/components';
+
+export const exampleCode = `console.log('Это может быть файл или CMS.!');`;
+export const fileName = 'example.js';
+export const highlights = ['файл', 'CMS'];
+
+<Code code={exampleCode} lang="js" title={fileName} mark={highlights} />
+
+#### Импортированный код
+
+Используйте [суффикс импорта Vite `?raw`](https://vitejs.dev/guide/assets#importing-asset-as-string), чтобы импортировать любой файл кода в виде строки.
+Затем вы можете передать эту импортированную строку компоненту `<Code>`, чтобы включить её на свою страницу.
+
+```mdx title="src/content/docs/example.mdx" "?raw"
+import { Code } from '@astrojs/starlight/components';
+import importedCode from '/src/env.d.ts?raw';
+
+<Code code={importedCode} lang="ts" title="src/env.d.ts" />
+```
+
+Вышеуказанный код сформирует следующий HTML:
+
+import importedCode from '/src/env.d.ts?raw';
+
+<Code code={importedCode} lang="ts" title="src/env.d.ts" />
+
+### Дерево файлов
+
+Используйте компонент `<FileTree>` для отображения структуры каталога с иконками файлов и сворачиваемыми подкаталогами.
+
+Укажите структуру ваших файлов и каталогов с помощью [неупорядоченного списка Markdown](https://www.markdownguide.org/basic-syntax/#unordered-lists) внутри `<FileTree>`.
+Создайте подкаталог с помощью вложенного списка или добавьте `/` в конец элемента списка, чтобы отобразить его как каталог без определённого содержимого.
+
+Для настройки внешнего вида дерева файлов можно использовать следующий синтаксис:
+
+- Выделите файл или каталог, сделав его имя жирным, например: `**README.md**`.
+- Добавьте комментарий к файлу или каталогу, добавив дополнительный текст после имени.
+- Добавьте заглушки файлов и каталогов, используя в качестве имени либо `...`, либо `…`.
+
+```mdx
+# src/content/docs/example.mdx
+
+import { FileTree } from '@astrojs/starlight/components';
+
+<FileTree>
+
+- astro.config.mjs — **важный** файл
+- package.json
+- README.md
+- src
+  - components
+    - **Header.astro**
+  - …
+- pages/
+
+</FileTree>
+```
+
+Вышеуказанный код сформирует следующий HTML:
+
+import { FileTree } from '@astrojs/starlight/components';
+
+<FileTree>
+
+- astro.config.mjs — **важный** файл
+- package.json
+- README.md
+- src
+  - components
+    - **Header.astro**
+  - …
+- pages/
+
+</FileTree>
+
+### Шаги
+
+Используйте компонент `<Steps>` для стилизации нумерованных списков задач.
+Это удобно для сложных пошаговых руководств, где каждый шаг должен быть чётко выделен.
+
+Оберните `<Steps>` вокруг стандартного упорядоченного списка Markdown.
+Внутри `<Steps>` применим весь обычный синтаксис Markdown.
+
+````mdx title="src/content/docs/example.mdx"
+import { Steps } from '@astrojs/starlight/components';
+
+<Steps>
+
+1. Импортируйте компонент в свой MDX-файл:
+
+   ```js
+   import { Steps } from '@astrojs/starlight/components';
+   ```
+
+2. Оберните `<Steps>` вокруг элементов упорядоченного списка.
+
+</Steps>
+````
+
+Вышеуказанный код сформирует следующий HTML:
+
+import { Steps } from '@astrojs/starlight/components';
+
+<Steps>
+
+1. Импортируйте компонент в свой MDX-файл:
+
+   ```js
+   import { Steps } from '@astrojs/starlight/components';
+   ```
+
+2. Оберните `<Steps>` вокруг элементов упорядоченного списка.
+
+</Steps>
+
 ### Иконки
 
 import { Icon } from '@astrojs/starlight/components';
@@ -182,12 +378,14 @@ Starlight предоставляет набор общих иконок, кот�
 Каждый `<Icon>` требует атрибут [`name`](#все-иконки) и по желанию может включать атрибуты `label`, `size` и `color`.
 
 ```mdx
+# src/content/docs/example.mdx
+
 import { Icon } from '@astrojs/starlight/components';
 
 <Icon name="star" color="goldenrod" size="2rem" />
 ```
 
-Вышеуказанный код генерирует следующее на странице:
+Вышеуказанный код сформирует следующий HTML:
 
 <Icon name="star" color="goldenrod" size="2rem" />
 
diff --git a/docs/src/content/docs/ru/guides/css-and-tailwind.mdx b/docs/src/content/docs/ru/guides/css-and-tailwind.mdx
index c58c4c3c..170843b6 100644
--- a/docs/src/content/docs/ru/guides/css-and-tailwind.mdx
+++ b/docs/src/content/docs/ru/guides/css-and-tailwind.mdx
@@ -1,13 +1,17 @@
 ---
-title: CSS & стилизация
+title: CSS и стилизация
 description: Узнайте, как стилизовать ваш сайт Starlight с помощью CSS-файлов или интегрировать с Tailwind CSS.
 ---
 
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+
 Вы можете стилизовать ваш сайт Starlight с помощью CSS-файлов или использовать плагин Starlight Tailwind.
 
 ## Ваши CSS стили
 
-Настройте стили, для вашего сайта Starlight, указав дополнительные CSS-файлы для изменения или расширения стандартных стилей Starlight.
+Настройте стили, применяемые к вашему сайту Starlight, предоставив дополнительные CSS-файлы для изменения или расширения стандартных стилей Starlight.
+
+<Steps>
 
 1. Добавьте CSS-файл в ваш каталог `src/`.
    Например, вы можете установить большую ширину колонки по умолчанию и бóльший размер текста для заголовков страниц:
@@ -30,7 +34,7 @@ description: Узнайте, как стилизовать ваш сайт Starl
    export default defineConfig({
    	integrations: [
    		starlight({
-   			title: 'Docs With Custom CSS',
+   			title: 'Документация с изменёнными CSS-стилями',
    			customCss: [
    				// Относительный путь к вашему CSS файлу
    				'./src/styles/custom.css',
@@ -40,8 +44,9 @@ description: Узнайте, как стилизовать ваш сайт Starl
    });
    ```
 
-Вы можете увидеть все кастомные свойства CSS, используемые Starlight, которые вы можете установить для настройки вашего сайта,
-в [файле `props.css` на GitHub](https://github.com/withastro/starlight/blob/main/packages/starlight/style/props.css).
+</Steps>
+
+Вы можете увидеть все кастомные свойства CSS, используемые Starlight, которые вы можете установить для настройки вашего сайта, в [файле `props.css` на GitHub](https://github.com/withastro/starlight/blob/main/packages/starlight/style/props.css).
 
 ## Tailwind CSS
 
@@ -50,14 +55,12 @@ Starlight предоставляет дополнительный плагин T
 
 Плагин Tailwind для Starlight применяет следующую конфигурацию:
 
-- Настраивает `dark:` варианты Tailwind для работы с темным режимом Starlight.
+- Настраивает `dark:` варианты Tailwind для работы с тёмным режимом Starlight.
 - Использует [цвета и шрифты темы Tailwind](#стилизация-starlight-с-использованием-tailwind) в пользовательском интерфейсе Starlight.
-- Отключает стили сброса [Preflight](https://tailwindcss.com/docs/preflight) Tailwind, восстанавливая выборочно существенные части Preflight, необходимых для утилитных border классов Tailwind.
+- Отключает стили сброса [Preflight](https://tailwindcss.ru/docs/preflight/) Tailwind при выборочном восстановлении основных частей Preflight, необходимых для служебных `border`-классов Tailwind.
 
 ### Создание нового проекта с Tailwind
 
-import { Tabs, TabItem } from '@astrojs/starlight/components';
-
 Создайте новый проект Starlight с предварительно настроенным Tailwind CSS, используя `create astro`:
 
 <Tabs>
@@ -88,6 +91,8 @@ yarn create astro --template starlight/tailwind
 
 Если у вас уже есть сайт на Starlight и вы хотите добавить Tailwind CSS, следуйте этим шагам.
 
+<Steps>
+
 1.  Добавьте интеграцию Tailwind от Astro:
 
     <Tabs>
@@ -182,11 +187,11 @@ yarn create astro --template starlight/tailwind
     });
     ```
 
-5.  Добавьте плагин Starlight Tailwind в `tailwind.config.cjs`:
+5.  Добавьте плагин Starlight Tailwind в `tailwind.config.mjs`:
 
     ```js ins={2,7}
-    // tailwind.config.cjs
-    const starlightPlugin = require('@astrojs/starlight-tailwind');
+    // tailwind.config.mjs
+    import starlightPlugin from '@astrojs/starlight-tailwind';
 
     /** @type {import('tailwindcss').Config} */
     module.exports = {
@@ -195,9 +200,11 @@ yarn create astro --template starlight/tailwind
     };
     ```
 
+</Steps>
+
 ### Стилизация Starlight с использованием Tailwind
 
-Starlight будет использовать значения из вашей [конфигурации темы Tailwind](https://tailwindcss.com/docs/theme) в его UI.
+Starlight будет использовать значения из вашей [конфигурации темы Tailwind](https://tailwindcss.ru/docs/theme) в его UI.
 
 Если установлены, следующие параметры переопределят стили Starlight по умолчанию:
 
@@ -207,9 +214,9 @@ Starlight будет использовать значения из вашей [
 - `fontFamily.mono` — используется для примеров кода.
 
 ```js {12,14,18,20}
-// tailwind.config.cjs
-const starlightPlugin = require('@astrojs/starlight-tailwind');
-const colors = require('tailwindcss/colors');
+// tailwind.config.mjs
+import starlightPlugin from '@astrojs/starlight-tailwind';
+import colors from 'tailwindcss/colors';
 
 /** @type {import('tailwindcss').Config} */
 module.exports = {
@@ -217,9 +224,9 @@ module.exports = {
 	theme: {
 		extend: {
 			colors: {
-				// Ваш предпочтительный акцентный цвет. Индиго наиболее близок к стандартным настройкам Starlight.
+				// Ваш предпочтительный акцентный цвет. Indigo наиболее близок к стандартным настройкам Starlight.
 				accent: colors.indigo,
-				// Ваш предпочтительный оттенок серого. Цинк наиболее близок к стандартным настройкам Starlight.
+				// Ваш предпочтительный оттенок серого. Zinc наиболее близок к стандартным настройкам Starlight.
 				gray: colors.zinc,
 			},
 			fontFamily: {
@@ -237,15 +244,14 @@ module.exports = {
 ## Темизация
 
 Цветовая тема Starlight может быть настроена путем переопределения её стандартных кастомных свойств.
-Эти переменные используются по всему UI, причём различные оттенки серого используются для текста и цветов фона,
-а акцентный цвет используется для ссылок и выделения текущих элементов в навигации.
+Эти переменные используются по всему UI, причём различные оттенки серого используются для текста и цветов фона, а акцентный цвет используется для ссылок и выделения текущих элементов в навигации.
 
 ### Редактор цветовой темы
 
 Используйте ползунки ниже, чтобы изменить палитры акцентного и серого цветов Starlight.
 Темные и светлые области предпросмотра будут показывать результирующие цвета, и вся страница также обновится, чтобы показать ваши изменения.
 
-Когда вы довольны внесенными изменениями, скопируйте CSS или код Tailwind ниже и используйте его в вашем проекте.
+Когда вы будете довольны внесёнными изменениями, скопируйте приведённый ниже код CSS или Tailwind и используйте его в своем проекте.
 
 import ThemeDesigner from '~/components/theme-designer.astro';
 
@@ -257,7 +263,7 @@ import ThemeDesigner from '~/components/theme-designer.astro';
 			forest: 'Лес',
 			oxide: 'Оксид',
 			nebula: 'Туман',
-			default: 'По-умолчанию',
+			default: 'По умолчанию',
 			random: 'Случайно',
 		},
 		editor: {
@@ -268,7 +274,7 @@ import ThemeDesigner from '~/components/theme-designer.astro';
 			pickColor: 'Выбор цвета',
 		},
 		preview: {
-			darkMode: 'Темный режим',
+			darkMode: 'Тёмный режим',
 			lightMode: 'Светлый режим',
 			bodyText:
 				'Текст тела отображается в оттенке серого с высоким контрастом по отношению к фону.',
@@ -283,9 +289,8 @@ import ThemeDesigner from '~/components/theme-designer.astro';
 		CSS-файле](#ваши-css-стили), чтобы применить эту тему к вашему сайту.
 	</Fragment>
 	<Fragment slot="tailwind-docs">
-		Приведенный ниже пример [файла конфигурации
-		Tailwind](#стилизация-starlight-с-использованием-tailwind) включает
-		сгенерированные палитры цветов `accent` и `gray` для использования в объекте
+		Приведённый ниже пример [файла конфигурации
+		Tailwind](#стилизация-starlight-с-использованием-tailwind) включает сгенерированные палитры цветов `accent` и `gray` для использования в объекте
 		конфигурации `theme.extend.colors`.
 	</Fragment>
 </ThemeDesigner>
diff --git a/docs/src/content/docs/ru/guides/customization.mdx b/docs/src/content/docs/ru/guides/customization.mdx
index e27c6209..50a5b0de 100644
--- a/docs/src/content/docs/ru/guides/customization.mdx
+++ b/docs/src/content/docs/ru/guides/customization.mdx
@@ -3,16 +3,17 @@ title: Кастомизация Starlight
 description: Узнайте, как сделать ваш сайт на Starlight уникальным с вашим логотипом, шрифтами, дизайном главной страницы и многим другим.
 ---
 
-import { Tabs, TabItem } from '@astrojs/starlight/components';
-import { FileTree } from '@astrojs/starlight/components';
+import { Tabs, TabItem, FileTree, Steps } from '@astrojs/starlight/components';
 
 Starlight предоставляет осмысленные стили и функции по умолчанию, так что вы можете быстро начать работу без необходимости конфигурации.
-Когда вы захотите начать настройку внешнего вида вашего сайта на Starlight, этот руководство поможет вам в этом.
+Когда вы захотите начать настройку внешнего вида вашего сайта на Starlight, это руководство поможет вам в этом.
 
-## Добавьте свой логотип
+## Добавление своего логотипа
 
 Добавление логотипа в заголовок сайта - это быстрый способ добавить индивидуальность на ваш сайт Starlight.
 
+<Steps>
+
 1. Добавьте изображение вашего логотипа в директорию `src/assets/`:
 
    <FileTree>
@@ -27,7 +28,7 @@ Starlight предоставляет осмысленные стили и фун
 
 2. Укажите путь к вашему логотипу у параметра [`logo.src`](/ru/reference/configuration/#logo) в `astro.config.mjs`:
 
-   ```js
+   ```diff lang="js"
    // astro.config.mjs
    import { defineConfig } from 'astro/config';
    import starlight from '@astrojs/starlight';
@@ -35,22 +36,24 @@ Starlight предоставляет осмысленные стили и фун
    export default defineConfig({
    	integrations: [
    		starlight({
-   			title: 'Docs With My Logo',
+   			title: 'Документация с моим логотипом',
    			logo: {
-   				src: './src/assets/my-logo.svg',
+   +				src: './src/assets/my-logo.svg',
    			},
    		}),
    	],
    });
    ```
 
+</Steps>
+
 По умолчанию логотип будет отображаться рядом с `title` вашего сайта.
 Если ваше изображение логотипа уже включает в себя название сайта, вы можете визуально скрыть текст заголовка, через параметр `replacesTitle`.
-Текст `title` все равно будет доступен для экранных читалок, чтобы заголовок оставался доступным.
+Текст `title` всё равно будет доступен для экранных читалок, чтобы заголовок оставался доступным.
 
-```js
+```js {5}
 starlight({
-  title: 'Docs With My Logo',
+  title: 'Документация с моим логотипом',
   logo: {
     src: './src/assets/my-logo.svg',
     replacesTitle: true,
@@ -58,9 +61,11 @@ starlight({
 }),
 ```
 
-### Варианты логотипа для светлой и темной темы.
+### Варианты логотипа для светлой и тёмной темы
+
+Вы можете отображать разные версии вашего логотипа в светлом и тёмном режимах.
 
-Вы можете отображать разные версии вашего логотипа в светлом и темном режимах.
+<Steps>
 
 1. Добавьте изображения для каждого варианта в директорию `src/assets/`:
 
@@ -77,26 +82,28 @@ starlight({
 
 2. Укажите путь к вариантам вашего логотипа в параметрах `light` и `dark` вместо `src` в `astro.config.mjs`:
 
-   ```js
+   ```diff lang="js"
    starlight({
-     title: 'Docs With My Logo',
+     title: 'Документация с моим логотипом',
      logo: {
-       light: './src/assets/light-logo.svg',
-       dark: './src/assets/dark-logo.svg',
+   +    light: './src/assets/light-logo.svg',
+   +    dark: './src/assets/dark-logo.svg',
      },
    }),
    ```
 
-## Включить карту сайта
+</Steps>
+
+## Включение карты сайта
 
 У Starlight есть встроенная поддержка создания карты сайта. Чтобы включить генерацию карты сайта, укажите ваш URL в качестве `site` в `astro.config.mjs`:
 
-```js
+```js {4}
 // astro.config.mjs
 
 export default defineConfig({
 	site: 'https://stargazers.club',
-	integrations: [starlight({ title: 'Site with sitemap' })],
+	integrations: [starlight({ title: 'Документация с картой сайта' })],
 });
 ```
 
@@ -105,9 +112,9 @@ export default defineConfig({
 По умолчанию страницы Starlight используют макет с боковой панелью и оглавлением, которое показывает заголовки текущей страницы.
 
 Вы можете применить более широкий макет страницы без боковых панелей, установив [`template: splash`](/ru/reference/frontmatter/#template) в метаданных страницы.
-Это хорошо подходит для главных страниц, вы можете увидеть это в действии на [главной странице этого сайта](/ru/).
+Это хорошо подходит для лендингов, вы можете увидеть живой пример на [главной странице этого сайта](/ru/).
 
-```md
+```md {5}
 ---
 # src/content/docs/index.md
 
@@ -121,18 +128,15 @@ template: splash
 Starlight отображает оглавление на каждой странице, чтобы читателям было проще перейти к интересующему их заголовку.
 Вы можете настроить или даже отключить оглавление полностью в интеграции Starlight или отдельно для каждой страницы в метаданных.
 
-По умолчанию заголовки `<h2>` и `<h3>` включены в оглавление.
-Укажите уровни заголовков, которые нужно включить на всем сайте,
-с помощью параметров `minHeadingLevel` и `maxHeadingLevel`, в [`tableOfContents`](/ru/reference/configuration/#tableofcontents).
-Переопределите эти значения для отдельных страниц, добавив свойства в [метаданные `tableOfContents`](/ru/reference/frontmatter/#tableofcontents):
+По умолчанию заголовки `<h2>` и `<h3>` включены в оглавление. Укажите уровни заголовков, которые нужно включить на всем сайте, с помощью параметров `minHeadingLevel` и `maxHeadingLevel`, в [`tableOfContents`](/ru/reference/configuration/#tableofcontents). Переопределите эти значения для отдельных страниц, добавив свойства в [метаданные `tableOfContents`](/ru/reference/frontmatter/#tableofcontents):
 
 <Tabs>
   <TabItem label="Метаданные">
 
-```md
+```md {4-6}
 ---
 # src/content/docs/example.md
-title: Страница только с заголовками H2 в оглавлении.
+title: Страница только с заголовками H2 в оглавлении
 tableOfContents:
   minHeadingLevel: 2
   maxHeadingLevel: 2
@@ -142,13 +146,13 @@ tableOfContents:
   </TabItem>
   <TabItem label="Глобальный конфиг">
 
-```js
+```js {7}
 // astro.config.mjs
 
 defineConfig({
 	integrations: [
 		starlight({
-			title: '',
+			title: 'Документация с изменённой конфигурацией оглавления',
 			tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 2 },
 		}),
 	],
@@ -163,7 +167,7 @@ defineConfig({
 <Tabs>
   <TabItem label="Метаданные">
 
-```md
+```md {4}
 ---
 # src/content/docs/example.md
 title: Страница без оглавления
@@ -174,7 +178,7 @@ tableOfContents: false
   </TabItem>
   <TabItem label="Глобальный конфиг">
 
-```js
+```js {7}
 // astro.config.mjs
 
 defineConfig({
@@ -192,13 +196,12 @@ defineConfig({
 
 ## Ссылки на социальные сети
 
-Starlight имеет встроенную поддержку для добавления ссылок на ваши аккаунты в социальных сетях в заголовок сайта
-через параметр [`social`](/ru/reference/configuration/#social) в интеграции Starlight.
+Starlight имеет встроенную поддержку для добавления ссылок на ваши аккаунты в социальных сетях в заголовок сайта через параметр [`social`](/ru/reference/configuration/#social) в интеграции Starlight.
 
 Вы можете найти полный список поддерживаемых иконок для ссылок в [Справочнике по конфигурации](/ru/reference/configuration/#social).
 Дайте нам знать на GitHub или Discord, если вам нужна поддержка для другого сервиса!
 
-```js
+```js {9-12}
 // astro.config.mjs
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
@@ -218,12 +221,11 @@ export default defineConfig({
 
 ## Ссылки редактирования
 
-Starlight может отображать ссылку "Редактировать страницу" в нижней части каждой страницы.
+Starlight может отображать ссылку «Редактировать страницу» в нижней части каждой страницы.
 Это упрощает для читателя поиск файла, который можно редактировать, чтобы улучшить документацию.
 Особенно это может помочь open-source проектам, упрощая процесс внесения вклада от сообщества.
 
-Чтобы включить ссылки редактирования, установите URL в параметре [`editLink.baseUrl`](/ru/reference/configuration/#editlink),
-для редактирования репозитория.
+Чтобы включить ссылки редактирования, установите URL в параметре [`editLink.baseUrl`](/ru/reference/configuration/#editlink), для редактирования репозитория.
 Значение `editLink.baseUrl` будет добавлено в начало пути текущей страницы, чтобы сформировать полную ссылку для редактирования.
 
 Примеры:
@@ -233,10 +235,9 @@ Starlight может отображать ссылку "Редактироват
 
 Если ваш проект Starlight не находится в корне вашего репозитория, включите путь к проекту в конце базового URL.
 
-В этом примере показана настройка ссылки для редактирования документации Starlight,
-которая находится в подкаталоге `docs/` в ветке `main` репозитория `withastro/starlight` на GitHub:
+В этом примере показана настройка ссылки для редактирования документации Starlight, которая находится в подкаталоге `docs/` в ветке `main` репозитория `withastro/starlight` на GitHub:
 
-```js
+```js {9-11}
 // astro.config.mjs
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
@@ -272,25 +273,42 @@ export default defineConfig({
 Вы можете использовать другие макеты и настройки страниц Starlight в вашей странице 404.
 Например, страница 404 по умолчанию использует макет [`splash`](#макеты-страниц) и компонент [`hero`](/ru/reference/frontmatter/#hero) в метаданных.
 
-```md
+```md {4,6-8}
 ---
 title: '404'
 template: splash
 editUrl: false
 hero:
   title: '404'
-  tagline: Мы не смогли найти эту страницу. Проверьте URL или попробуйте использовать поиск.
+  tagline: Страница не найдена. Проверьте URL или попробуйте использовать поиск.
 ---
 ```
 
+### Отключение стандартной страницы 404
+
+Если вашему проекту требуется полностью настроенный макет 404, вы можете создать маршрут `src/pages/404.astro` и установить параметр конфигурации [`disable404Route`](/ru/reference/configuration/#disable404route), чтобы отключить маршрут Starlight по умолчанию:
+
+```js {9}
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+export default defineConfig({
+	integrations: [
+		starlight({
+			title: 'Документация с пользовательской страницей 404',
+			disable404Route: true,
+		}),
+	],
+});
+```
+
 ## Пользовательские шрифты
 
-По умолчанию Starlight использует sans-serif шрифты, доступные на устройстве пользователя, для всего текста.
-Это обеспечивает быструю загрузку документации с использованием шрифта, знакомого каждому пользователю,
-и не требует скачивания больших файлов шрифтов.
+По умолчанию Starlight использует шрифты семейства Sans-Serif, доступные на устройстве пользователя, для всего текста.
+Это обеспечивает быструю загрузку документации с использованием шрифта, знакомого каждому пользователю, и не требует скачивания больших файлов шрифтов.
 
-Если вам необходимо добавить пользовательский шрифт на ваш сайт Starlight,
-вы можете настроить шрифты в CSS-файлах или с помощью любой другой [техники оформления Astro](https://docs.astro.build/ru/guides/styling/).
+Если вам необходимо добавить пользовательский шрифт на ваш сайт Starlight, вы можете настроить шрифты в CSS-файлах или с помощью любой другой [техники оформления Astro](https://docs.astro.build/ru/guides/styling/).
 
 ### Настройка шрифтов
 
@@ -299,6 +317,8 @@ hero:
 
 #### Настройка локальных шрифтов
 
+<Steps>
+
 1. Добавьте ваши шрифты в директорию `src/fonts/` и создайте пустой файл `font-face.css`:
 
    <FileTree>
@@ -312,7 +332,7 @@ hero:
 
    </FileTree>
 
-2. Добавьте объявление [`@font-face`](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face) для каждого из ваших шрифтов в файл `src/fonts/font-face.css`.
+2. Добавьте объявление [`@font-face`](https://developer.mozilla.org/ru/docs/Web/CSS/@font-face) для каждого из ваших шрифтов в файл `src/fonts/font-face.css`.
    Используйте относительный путь к шрифту в функции `url()`.
 
    ```css
@@ -330,7 +350,7 @@ hero:
 
 3. Добавьте путь к вашему файлу `font-face.css` в массив `customCss` в `astro.config.mjs`:
 
-   ```js
+   ```diff lang="js"
    // astro.config.mjs
    import { defineConfig } from 'astro/config';
    import starlight from '@astrojs/starlight';
@@ -338,26 +358,30 @@ hero:
    export default defineConfig({
    	integrations: [
    		starlight({
-   			title: 'Документация с типографическим оформлением',
+   			title: 'Документация с пользовательским шрифтом',
    			customCss: [
-   				// Относительный путь к вашему CSS-файлу с @font-face.
-   				'./src/fonts/font-face.css',
+   +				// Относительный путь к вашему CSS-файлу с @font-face.
+   +				'./src/fonts/font-face.css',
    			],
    		}),
    	],
    });
    ```
 
+</Steps>
+
 #### Настройка шрифта из Fontsource
 
 Проект [Fontsource](https://fontsource.org/) упрощает использование шрифтов Google Fonts и других open-source шрифтов.
 Проект предоставляет npm-пакеты, для использования шрифтов, которые вас интересуют, и включает готовые CSS-файлы, которые можно добавить в ваш проект.
 
+<Steps>
+
 1.  Найдите шрифт, который вы хотите использовать, в [каталоге Fontsource](https://fontsource.org/).
     В данном примере будет использоваться шрифт [IBM Plex Serif](https://fontsource.org/fonts/ibm-plex-serif).
 
 2.  Установите пакет для выбранного вами шрифта.
-    Вы можете найти имя пакета, нажав "Install" на странице шрифта Fontsource.
+    Вы можете найти имя пакета, нажав «Install» на странице шрифта Fontsource.
 
          <Tabs>
 
@@ -389,7 +413,7 @@ hero:
 
 3.  Добавьте CSS-файлы Fontsource в массив `customCss` в `astro.config.mjs`:
 
-    ```js
+    ```diff lang="js"
     // astro.config.mjs
     import { defineConfig } from 'astro/config';
     import starlight from '@astrojs/starlight';
@@ -399,17 +423,18 @@ hero:
     		starlight({
     			title: 'Документация с пользовательским шрифтом',
     			customCss: [
-    				// Файлы Fontsource для regular и semi-bold шрифтов.
-    				'@fontsource/ibm-plex-serif/400.css',
-    				'@fontsource/ibm-plex-serif/600.css',
+    +				// Файлы Fontsource для regular и semi-bold шрифтов.
+    +				'@fontsource/ibm-plex-serif/400.css',
+    +				'@fontsource/ibm-plex-serif/600.css',
     			],
     		}),
     	],
     });
     ```
 
-    Fontsource предоставляет несколько CSS-файлов для каждого шрифта.
-    См. [документацию Fontsource](https://fontsource.org/docs/getting-started/install#4-weights-and-styles) по включению различных начертаний и стилей, чтобы понять, какие использовать.
+    Fontsource предоставляет несколько CSS-файлов для каждого шрифта. См. [документацию Fontsource](https://fontsource.org/docs/getting-started/install#4-weights-and-styles) по включению различных начертаний и стилей, чтобы понять, какие использовать.
+
+</Steps>
 
 ### Использование шрифтов
 
diff --git a/docs/src/content/docs/ru/guides/i18n.mdx b/docs/src/content/docs/ru/guides/i18n.mdx
index b4d4c077..0ec1e6b5 100644
--- a/docs/src/content/docs/ru/guides/i18n.mdx
+++ b/docs/src/content/docs/ru/guides/i18n.mdx
@@ -3,45 +3,52 @@ title: Интернационализация (i18n)
 description: Узнайте, как настроить ваш сайт на Starlight для поддержки нескольких языков.
 ---
 
-import { FileTree } from '@astrojs/starlight/components';
-
-Starlight предоставляет встроенную поддержку для многоязычных сайтов, включая маршрутизацию, резервной контен и полную поддержку языков RTL.
-
-## Настройте i18n
-
-1. Сообщите Starlight о поддерживаемых вами языках, передав [`locales`](/ru/reference/configuration/#locales) и [`defaultLocale`](/ru/reference/configuration/#defaultlocale) в интеграцию Starlight:
-
-   ```js
-   // astro.config.mjs
-   import { defineConfig } from 'astro/config';
-   import starlight from '@astrojs/starlight';
-
-   export default defineConfig({
-   	integrations: [
-   		starlight({
-   			title: 'My Docs',
-   			// Установите английский как язык по умолчанию для этого сайта.
-   			defaultLocale: 'en',
-   			locales: {
-   				// Документация на английском в `src/content/docs/en/`
-   				en: {
-   					label: 'English',
-   				},
-   				// Документация на упрощенном китайском в `src/content/docs/zh-cn/`.
-   				'zh-cn': {
-   					label: '简体中文',
-   					lang: 'zh-CN',
-   				},
-   				// Документация на арабском `src/content/docs/ar/`
-   				ar: {
-   					label: 'العربية',
-   					dir: 'rtl',
-   				},
-   			},
-   		}),
-   	],
-   });
-   ```
+import { FileTree, Steps } from '@astrojs/starlight/components';
+
+Starlight обеспечивает встроенную поддержку многоязычных сайтов, включая маршрутизацию, резервный контент и полную поддержку языков с письмом справа налево (RTL).
+
+## Настройка i18n
+
+<Steps>
+
+1. Сообщите Starlight о поддерживаемых вами языках, передав свойства [`locales`](/ru/reference/configuration/#locales) и [`defaultLocale`](/ru/reference/configuration/#defaultlocale) в интеграцию Starlight:
+
+    ```js {9-31}
+    // astro.config.mjs
+    import { defineConfig } from 'astro/config';
+    import starlight from '@astrojs/starlight';
+
+    export default defineConfig({
+      integrations: [
+        starlight({
+          title: 'Моя документация',
+          // Устанавливаем «Русский» как язык по умолчанию для этого сайта
+          defaultLocale: 'ru',
+          locales: {
+            // Документация на английском в `src/content/docs/en/`
+            en: {
+              label: 'English',
+            },
+            // Документация на китайском в `src/content/docs/zh-cn/`
+            'zh-cn': {
+              label: '简体中文',
+              lang: 'zh-CN',
+            },
+            // Документация на арабском в `src/content/docs/ar/`
+            ar: {
+              label: 'العربية',
+              dir: 'rtl',
+            },
+            // Документация на русском в `src/content/docs/ru/`
+            ru: {
+              label: 'Русский',
+              lang: 'ru',
+            },
+          },
+        }),
+      ],
+    });
+    ```
 
    `defaultLocale` будет использоваться для резервного контента и текста UI, поэтому выберите язык, на котором вы скорее всего начнете писать контент или для которого у вас уже есть материалы.
 
@@ -55,23 +62,23 @@ Starlight предоставляет встроенную поддержку д�
        - docs/
          - ar/
          - en/
-         - zh-cn/
+         - ru/
 
    </FileTree>
 
-3. Теперь вы можете добавлять контент в ваши языковые каталоги. Используйте одно и то же имя файла, чтобы связать страницы на разных языках и использовать все функции i18n Starlight, включая резервной контент, уведомления о переводах и многое другое.
+3. Теперь вы можете добавлять контент в свои языковые каталоги. Используйте одно и то же имя файла для связывания страниц на разных языках и воспользуйтесь полным набором функций i18n Starlight, включая резервный контент, уведомления о переводе и многое другое.
 
    Например, создайте `ar/index.md` и `en/index.md` для отображения главной страницы на арабском и английском языках.
 
+</Steps>
+
 ### Использование корневой локали
 
-Вы можете использовать "корневую" локаль для отображения языка без префикса i18n в его пути.
-Например, если английский является вашей корневой локалью, путь к английской странице будет выглядеть как `/about` вместо `/en/about`.
+Вы можете использовать «корневую» локаль для отображения языка без префикса i18n в его пути. Например, если русский является вашей корневой локалью, путь к странице на русском языке будет выглядеть как `/about` вместо `/ru/about`.
 
-Чтобы установить корневую локаль, используйте ключ `root` в вашей конфигурации `locales`.
-Если корневая локаль также является локалью по умолчанию для вашего контента, удалите `defaultLocale` или установите его значение как `'root'`.
+Чтобы установить корневую локаль, используйте ключ `root` в вашей конфигурации `locales`. Если корневая локаль также является локалью по умолчанию для вашего контента, удалите `defaultLocale` или установите его значение как `'root'`.
 
-```js
+```js {9,11-14}
 // astro.config.mjs
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
@@ -83,12 +90,12 @@ export default defineConfig({
 			defaultLocale: 'root', // опционально
 			locales: {
 				root: {
-					label: 'English',
-					lang: 'en', // lang обязателен для корневых локалей.
+					label: 'Русский',
+					lang: 'ru', // lang обязателен для корневых локалей.
 				},
-				'zh-cn': {
-					label: '简体中文',
-					lang: 'zh-CN',
+				en: {
+					label: 'English',
+					lang: 'en',
 				},
 			},
 		}),
@@ -96,8 +103,7 @@ export default defineConfig({
 });
 ```
 
-Когда вы используете `root` локаль, сохраняйте страницы для этого языка непосредственно в `src/content/docs/`,
-а не в выделенной папке для языка. Например, вот файлы главной страницы для английского и китайского языков, используя приведенную выше конфигурацию:
+При использовании локали `root` храните страницы для этого языка непосредственно в `src/content/docs/`, а не в отдельной языковой папке. Например, вот файлы домашней страницы для английского и русского языков при использовании приведённой выше конфигурации:
 
 <FileTree>
 
@@ -105,16 +111,16 @@ export default defineConfig({
   - content/
     - docs/
       - **index.md**
-      - zh-cn/
+      - en/
         - **index.md**
 
 </FileTree>
 
 #### Одноязычные сайты
 
-По умолчанию, Starlight является одноязычным (английским) сайтом. Чтобы создать сайт на другом языке, укажите его как `root` в вашей конфигурации `locales`:
+По умолчанию, Starlight является одноязычным сайтом, с английским языком. Чтобы создать сайт на другом языке, укажите его как `root` в вашей конфигурации `locales`:
 
-```js
+```diff lang="js" {10-13}
 // astro.config.mjs
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
@@ -125,8 +131,8 @@ export default defineConfig({
 			title: 'Моя документация',
 			locales: {
 				root: {
-					label: '简体中文',
-					lang: 'zh-CN',
+					label: 'Русский',
+					lang: 'ru',
 				},
 			},
 		}),
@@ -138,42 +144,39 @@ export default defineConfig({
 
 ## Резервный контент
 
-Starlight предполагает, что вы создадите эквивалентные страницы на всех поддерживаемых языках.
-Например, если у вас есть файл `en/about.md`, создайте файл `about.md` для каждого другого языка, который вы поддерживаете.
-Это позволяет Starlight предоставлять автоматически резервный контент для страниц, которые еще не были переведены.
+Starlight предполагает, что вы создадите эквивалентные страницы на всех поддерживаемых языках. Например, если у вас есть файл `en/about.md`, создайте файл `about.md` для каждого другого языка, который вы поддерживаете. Это позволяет Starlight предоставлять автоматически резервный контент для страниц, которые ещё не были переведены.
 
-Если перевод для языка еще не доступен, Starlight покажет читателям контент этой страницы на языке по умолчанию (установлен через `defaultLocale`).
-Например, если вы еще не создали французскую версию вашей страницы "О нас" и вашим языком по умолчанию является английский,
-посетители `/fr/about` увидят английский контент из `/en/about` с уведомлением о том, что эта страница еще не была переведена.
-Это помогает вам добавлять контент на вашем языке по умолчанию и постепенно переводить его, когда у ваших переводчиков есть время.
+Если перевод для языка ещё не доступен, Starlight покажет читателям контент этой страницы на языке по умолчанию (установленном через `defaultLocale`). Например, если вы ещё не создали французскую версию вашей страницы «О нас» и вашим языком по умолчанию является английский, посетители `/fr/about` увидят английский контент из `/en/about` с уведомлением о том, что эта страница ещё не была переведена. Это помогает вам добавлять контент на вашем языке по умолчанию и постепенно переводить его, когда у ваших переводчиков есть время.
 
-## Перевод UI Starlight
+## Перевод интерфейса Starlight
 
-Кроме размещения переведенных файлов с контентом, Starlight позволяет вам переводить текст UI (например, заголовок "На этой странице" в оглавлении),
-чтобы ваши читатели могли полностью погрузиться в ваш сайт на выбранном языке.
+import LanguagesList from '~/components/languages-list.astro';
+import UIStringsList from '~/components/ui-strings-list.astro';
 
-Переводы строк пользовательского интерфейса на английский, чешский, французский, немецкий, итальянский, японский,
-португальский, голландский, датский, испанский, турецкий, арабский, норвежский, фарси, иврит, упрощенный китайский,
-корейский, индонезийский, русский, шведский, украинский и вьетнамский языки предоставляются "из коробки",
-и мы приветствуем [вклад в добавление языков по умолчанию](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
+Кроме размещения переведённых файлов с контентом, Starlight позволяет вам переводить текст UI (например, заголовок «На этой странице» в оглавлении), чтобы ваши читатели могли полностью погрузиться в ваш сайт на выбранном языке.
 
-Вы можете добавить переводы для дополнительных языков, которые вы поддерживаете — или переопределить наши стандартные текст — через коллекцию данных `i18n`.
+<LanguagesList startsSentence /> — все переведённые строки пользовательского интерфейса на указанных языках предоставляются «из коробки»,
+и мы приветствуем [вклад в добавление дополнительных языков по умолчанию](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
 
-1. Сконфигурируйте коллекцию данных `i18n` в `src/content/config.ts`, если она еще не настроена:
+Вы можете добавить переводы для дополнительных языков, которые вы поддерживаете — или переопределить наши стандартные тексты — через коллекцию данных `i18n`.
 
-   ```js
+<Steps>
+
+1. Сконфигурируйте коллекцию данных `i18n` в `src/content/config.ts`, если она ещё не настроена:
+
+   ```diff lang="js" ins=/, (i18nSchema)/
    // src/content/config.ts
    import { defineCollection } from 'astro:content';
    import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
 
    export const collections = {
    	docs: defineCollection({ schema: docsSchema() }),
-   	i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
+   +	i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
    };
    ```
 
-2. Создайте файл JSON в `src/content/i18n/` для каждой дополнительной локали, для которой вы хотите добавить текста перевода UI.
-   Например, так можно добавить файлы перевода для арабского и упрощенного китайского:
+2. Создайте файл JSON в `src/content/i18n/` для каждой дополнительной локали, для которой вы хотите добавить строки перевода UI.
+   Например, так можно добавить файлы перевода для арабского и русского:
 
    <FileTree>
 
@@ -181,44 +184,28 @@ Starlight предполагает, что вы создадите эквива�
      - content/
        - i18n/
          - ar.json
-         - zh-CN.json
+         - ru.json
 
    </FileTree>
 
-3. Добавьте переводы для ключей, которые вы хотите перевести, в файлы JSON. Переводите только значения, оставляя ключи на английском языке (например, `"search.label": "Buscar"`).
+3. Добавьте переводы для ключей, которые вы хотите перевести, в файлы JSON. Переводите только значения, оставляя ключи на английском языке (например, `"search.label": "Поиск"`).
 
    Это английские значения по умолчанию для существующих строк, с которыми поставляется Starlight:
 
+   <UIStringsList />
+
+   Блоки кода Starlight основаны на библиотеке [Expressive Code](https://github.com/expressive-code/expressive-code).
+   Вы можете установить переводы для строк пользовательского интерфейса в том же файле JSON, используя ключи `expressiveCode`:
+
    ```json
    {
-   	"skipLink.label": "Skip to content",
-   	"search.label": "Search",
-   	"search.shortcutLabel": "(Press / to Search)",
-   	"search.cancelLabel": "Cancel",
-   	"search.devWarning": "Search is only available in production builds. \nTry building and previewing the site to test it out locally.",
-   	"themeSelect.accessibleLabel": "Select theme",
-   	"themeSelect.dark": "Dark",
-   	"themeSelect.light": "Light",
-   	"themeSelect.auto": "Auto",
-   	"languageSelect.accessibleLabel": "Select language",
-   	"menuButton.accessibleLabel": "Menu",
-   	"sidebarNav.accessibleLabel": "Main",
-   	"tableOfContents.onThisPage": "On this page",
-   	"tableOfContents.overview": "Overview",
-   	"i18n.untranslatedContent": "This content is not available in your language yet.",
-   	"page.editLink": "Edit page",
-   	"page.lastUpdated": "Last updated:",
-   	"page.previousLink": "Previous",
-   	"page.nextLink": "Next",
-   	"404.text": "Page not found. Check the URL or try using the search bar.",
-   	"aside.note": "Note",
-   	"aside.tip": "Tip",
-   	"aside.caution": "Caution",
-   	"aside.danger": "Danger"
+   	"expressiveCode.copyButtonCopied": "Copied!",
+    "expressiveCode.copyButtonTooltip": "Copy to clipboard",
+    "expressiveCode.terminalWindowFallbackTitle": "Terminal window"
    }
    ```
 
-   Модальное окно поиска в Starlight работает на библиотеке [Pagefind](https://pagefind.app/).
+   Модальное окно поиска в Starlight работает с помощью библиотеки [Pagefind](https://pagefind.app/).
    Вы можете установить переводы для пользовательского интерфейса Pagefind в том же JSON-файле, используя ключи `pagefind`:
 
    ```json
@@ -235,3 +222,30 @@ Starlight предполагает, что вы создадите эквива�
    	"pagefind.searching": "Searching for [SEARCH_TERM]..."
    }
    ```
+
+</Steps>
+
+### Расширение схемы перевода
+
+Добавьте пользовательские ключи в словари переводов вашего сайта, установив `extend` в опциях `i18nSchema()`.
+В следующем примере к ключам по умолчанию добавляется новый необязательный ключ `custom.label`:
+
+```diff lang="js"
+// src/content/config.ts
+import { defineCollection, z } from 'astro:content';
+import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+	docs: defineCollection({ schema: docsSchema() }),
+	i18n: defineCollection({
+		type: 'data',
+		schema: i18nSchema({
++			extend: z.object({
++				'custom.label': z.string().optional(),
++			}),
+		}),
+	}),
+};
+```
+
+Дополнительную информацию о схемах коллекции контента см. в разделе [Определение схемы коллекции](https://docs.astro.build/ru/guides/content-collections/#defining-a-collection-schema) в документации Astro.
diff --git a/docs/src/content/docs/ru/guides/overriding-components.md b/docs/src/content/docs/ru/guides/overriding-components.mdx
index 9060d0e0..5026c578 100644
--- a/docs/src/content/docs/ru/guides/overriding-components.md
+++ b/docs/src/content/docs/ru/guides/overriding-components.mdx
@@ -1,32 +1,30 @@
 ---
-title: Переопределение Компонентов
+title: Переопределение компонентов
 description: Узнайте, как переопределить встроенные компоненты Starlight, чтобы добавить пользовательские элементы в UI вашего сайта документации.
-sidebar:
-  badge: Новое
 ---
 
-Стандартный UI и параметры конфигурации Starlight разработаны так,
-чтобы быть гибкими и работать с различным контентом.
-Большая часть стандартного внешнего вида Starlight может быть настроена с использованием [CSS](/ru/guides/css-and-tailwind/)
-и [параметров конфигурации](/ru/guides/customization/).
+import { Steps } from '@astrojs/starlight/components';
 
-Когда вам нужно больше, чем то, что возможно из коробки,
-Starlight поддерживает создание собственных компонентов для расширения или переопределения (полная замена) его стандартных компонентов.
+Пользовательский интерфейс и параметры конфигурации Starlight по умолчанию разработаны таким образом, чтобы быть гибкими и работать с разнообразным контентом. Большую часть внешнего вида Starlight по умолчанию можно настроить с помощью [CSS](/ru/guides/css-and-tailwind/) и [параметров конфигурации](/ru/guides/customization/).
+
+Если вам нужно больше, чем возможно из коробки, Starlight поддерживает создание собственных пользовательских компонентов для расширения или переопределения (полной замены) компонентов по умолчанию.
 
 ## Когда переопределять
 
 Переопределение стандартных компонентов Starlight может быть полезно, когда:
 
-- Вы хотите изменить внешний вид UI Starlight так, как это невозможно сделать с использованием [пользовательских CSS](/ru/guides/css-and-tailwind/).
+- Вы хотите изменить внешний вид UI Starlight, если это невозможно сделать с использованием [пользовательских CSS](/ru/guides/css-and-tailwind/).
 - Вы хотите изменить поведение UI Starlight.
 - Вы хотите добавить какой-то дополнительный UI наряду с существующим UI Starlight.
 
 ## Как выполнить переопределение
 
+<Steps>
+
 1. Выберите компонент Starlight, который вы хотите переопределить.
    Вы можете найти полный список компонентов в [Справочнике по переопределениям](/ru/reference/overrides/).
 
-   В этом примере будет переопределен компонент [`SocialIcons`](/ru/reference/overrides/#socialicons) Starlight в навигационной панели страницы.
+   В этом примере будет переопределён компонент [`SocialIcons`](/ru/reference/overrides/#socialicons) в навигационной панели страницы.
 
 2. Создайте компонент Astro для замены компонента Starlight.
    В этом примере отображается ссылка для связи.
@@ -37,10 +35,12 @@ Starlight поддерживает создание собственных ко�
    import type { Props } from '@astrojs/starlight/props';
    ---
 
-   <a href="mailto:houston@example.com">Написать нам на E-mail</a>
+   <a href="mailto:houston@example.com">
+     Связаться с нами по электронной почте
+   </a>
    ```
 
-3. Сообщите Starlight использовать ваш компонент, указав его в параметре конфигурации [`components`](/ru/reference/configuration/#components) в `astro.config.mjs`:
+3. Сообщите Starlight, что нужно использовать ваш компонент, указав его в параметре конфигурации [`components`](/ru/reference/configuration/#components) в `astro.config.mjs`:
 
    ```js {9-12}
    // astro.config.mjs
@@ -50,7 +50,7 @@ Starlight поддерживает создание собственных ко�
    export default defineConfig({
      integrations: [
        starlight({
-         title: 'Моя документация, с переопределением',
+         title: 'Моя документация, с переопределением компонентов',
          components: {
            // Переопределение компонента `SocialIcons`.
            SocialIcons: './src/components/EmailLink.astro',
@@ -60,12 +60,11 @@ Starlight поддерживает создание собственных ко�
    });
    ```
 
+</Steps>
+
 ## Переиспользование встроенного компонента
 
-Вы можете работать со стандартными UI компонентами Starlight так же,
-как и со своими собственными: импортировать их и использовать в своих компонентах.
-Это позволяет вам сохранить весь UI Starlight в рамках вашего дизайна,
-добавляя свой UI рядом с ними.
+Вы можете работать со стандартными UI компонентами Starlight так же, как и со своими собственными: импортировать их и использовать в своих компонентах. Это позволяет вам сохранить весь UI Starlight в рамках вашего дизайна, добавляя свой UI рядом с ними.
 
 Пример ниже показывает компонент, который отображает ссылку на электронную почту наряду со стандартным компонентом `SocialIcons`:
 
@@ -76,7 +75,7 @@ import type { Props } from '@astrojs/starlight/props';
 import Default from '@astrojs/starlight/components/SocialIcons.astro';
 ---
 
-<a href="mailto:houston@example.com">Написать нам на E-mail</a>
+<a href="mailto:houston@example.com"> Связаться с нами по электронной почте </a>
 <Default {...Astro.props}><slot /></Default>
 ```
 
@@ -90,8 +89,7 @@ import Default from '@astrojs/starlight/components/SocialIcons.astro';
 При переопределении компонента Starlight ваша реализация получает стандартный объект `Astro.props`, содержащий все данные для текущей страницы.
 Это позволяет вам использовать эти значения для управления тем, как ваш компонент будет отображаться.
 
-Например, вы можете прочитать метаданные страницы как `Astro.props.entry.data`.
-В следующем примере компонент [`PageTitle`](/ru/reference/overrides/#pagetitle) использует этот объект для отображения текущего заголовка страницы:
+Например, вы можете прочитать метаданные страницы как `Astro.props.entry.data`. В следующем примере компонент [`PageTitle`](/ru/reference/overrides/#pagetitle) использует этот объект для отображения текущего заголовка страницы:
 
 ```astro {5} "{title}"
 ---
@@ -110,16 +108,13 @@ const { title } = Astro.props.entry.data;
 </style>
 ```
 
-Узнайте больше обо всех доступных свойствах в [Справочнике по переопределениям](/ru/reference/overrides/#component-props).
+Узнайте больше обо всех доступных свойствах в [Справочнике по переопределениям](/ru/reference/overrides/#параметры-компонентов).
 
-### Переопределение только на определенных страницах
+### Переопределение только на определённых страницах
 
-Переопределение компонентов применяется ко всем страницам. Тем не менее, вы можете осуществлять условный рендеринг,
-используя значения из `Astro.props`, чтобы определить, когда показывать ваш UI,
-когда показывать UI от Starlight, или даже когда показывать что-то совершенно другое.
+Переопределение компонентов применяется ко всем страницам. Тем не менее, вы можете осуществлять условную отрисовку, используя значения из `Astro.props`, чтобы определить, когда показывать ваш UI, когда показывать UI от Starlight, или даже когда показывать что-то совершенно другое.
 
-В следующем примере компонент, переопределяющий [`Footer`](/ru/reference/overrides/#footer-1) от Starlight,
-отображает "Создано с Starlight 🌟" только на главной странице, а на всех остальных страницах показывает футер по умолчанию:
+В следующем примере компонент, переопределяющий [`Footer`](/ru/reference/overrides/#footer) от Starlight, отображает надпись «Создано с помощью Starlight 🌟» только на главной странице, а на всех остальных страницах показывает футер по умолчанию:
 
 ```astro
 ---
@@ -132,7 +127,7 @@ const isHomepage = Astro.props.slug === '';
 
 {
   isHomepage ? (
-    <footer>Создано с Starlight 🌟</footer>
+    <footer>Создано с помощью Starlight 🌟</footer>
   ) : (
     <Default {...Astro.props}>
       <slot />
@@ -141,4 +136,4 @@ const isHomepage = Astro.props.slug === '';
 }
 ```
 
-Узнайте больше о условной отрисовке в руководстве [Astro’s Template Syntax](https://docs.astro.build/ru/core-concepts/astro-syntax/#dynamic-html).
+Узнайте больше об условной отрисовке в руководстве [Синтаксис Astro](https://docs.astro.build/ru/core-concepts/astro-syntax/#динамический-html).
diff --git a/docs/src/content/docs/ru/guides/pages.mdx b/docs/src/content/docs/ru/guides/pages.mdx
new file mode 100644
index 00000000..30c6b0b2
--- /dev/null
+++ b/docs/src/content/docs/ru/guides/pages.mdx
@@ -0,0 +1,173 @@
+---
+title: Страницы
+description: Узнайте, как создавать страницы вашего сайта документации и управлять ими с помощью Starlight.
+sidebar:
+  order: 1
+---
+
+Starlight генерирует HTML-страницы вашего сайта на основе вашего контента с гибкими опциями, предоставляемыми через интерфейс Markdown.
+Кроме того, проекты Starlight имеют полный доступ к [мощным инструментам создания страниц Astro](https://docs.astro.build/ru/basics/astro-pages/).
+В этом руководстве объясняется, как работает генерация страниц в Starlight.
+
+## Содержимое страниц
+
+### Форматы файлов
+
+Starlight поддерживает создание контента в Markdown и MDX без необходимости настройки.
+Вы можете добавить поддержку Markdoc, установив экспериментальную [интеграцию Astro Markdoc](https://docs.astro.build/ru/guides/integrations-guide/markdoc/).
+
+### Добавление страниц
+
+Добавляйте новые страницы на свой сайт, создавая файлы `.md` или `.mdx` в `src/content/docs/`.
+Используйте подпапки для организации файлов и создания нескольких сегментов пути.
+
+Например, следующая файловая структура будет генерировать страницы `example.com/hello-world` и `example.com/reference/faq`:
+
+import { FileTree } from '@astrojs/starlight/components';
+
+<FileTree>
+
+- src/
+  - content/
+    - docs/
+      - hello-world.md
+      - reference/
+        - faq.md
+
+</FileTree>
+
+### Типобезопасные метаданные
+
+Все страницы Starlight используют настраиваемый [общий набор свойств метаданных](/ru/reference/frontmatter/) для контроля отображения страницы:
+
+```md
+---
+title: Привет, мир!
+description: Это страница на моем сайте, работающем на Starlight
+---
+```
+
+Если вы что-то забудете, Starlight сообщит вам об этом.
+
+## Пользовательские страницы
+
+Для расширенных вариантов использования вы можете добавлять собственные страницы, создав каталог `src/pages/`.
+Каталог `src/pages/` использует [маршрутизацию на основе файлов Astro](https://docs.astro.build/ru/basics/astro-pages/#%D0%BC%D0%B0%D1%80%D1%88%D1%80%D1%83%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D0%BD%D0%B0-%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%B5-%D1%84%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2) и включает поддержку файлов с расширением `.astro` помимо других форматов страниц.
+Это полезно, если вам нужно создать страницу с полностью настраиваемым макетом или создать страницу из альтернативного источника данных.
+
+Например, в этом проекте содержимое Markdown смешивается в `src/content/docs/` с маршрутами Astro и HTML в `src/pages/`:
+
+<FileTree>
+
+- src/
+  - content/
+    - docs/
+      - hello-world.md
+  - pages/
+    - custom.astro
+    - archived.html
+
+</FileTree>
+
+Подробнее читайте в [руководстве «Страницы» в документации Astro](https://docs.astro.build/ru/basics/astro-pages/).
+
+### Использование дизайна Starlight на пользовательских страницах
+
+Чтобы использовать макет Starlight на пользовательских страницах, оберните содержимое страницы компонентом `<StarlightPage />`.
+Это может быть полезно, если вы динамически генерируете контент, но всё же хотите использовать дизайн Starlight.
+
+```astro
+---
+// src/pages/custom-page/example.astro
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+import CustomComponent from './CustomComponent.astro';
+---
+
+<StarlightPage frontmatter={{ title: 'Моя персонализированная страница' }}>
+	<p>Это пользовательская страница с пользовательским компонентом:</p>
+	<CustomComponent />
+</StarlightPage>
+```
+
+#### Параметры
+
+Компонент `<StarlightPage />` принимает следующие параметры.
+
+##### `frontmatter` (обязательно)
+
+**тип:** `StarlightPageFrontmatter`
+
+Установка [метаданных](/ru/reference/frontmatter/) для этой страницы, аналогично метаданным на страницах Markdown.
+Свойство [`title`](/ru/reference/frontmatter/#title-обязательно) является обязательным, а все остальные свойства — нет.
+
+Следующие свойства отличаются от метаданных Markdown:
+
+- Свойство [`slug`](/ru/reference/frontmatter/#slug) не поддерживается и устанавливается автоматически на основе URL-адреса пользовательской страницы.
+- Для свойства [`editUrl`](/ru/reference/frontmatter/#editurl) требуется URL-адрес для отображения ссылки на редактирование.
+- Свойство [`sidebar`](/ru/reference/frontmatter/#sidebar) для настройки отображения страницы в [автогенерируемых группах ссылок](/ru/reference/configuration/#sidebar) недоступно. Страницы, использующие компонент `<StarlightPage />`, не являются частью коллекции и не могут быть добавлены в автоматически созданную группу боковой панели.
+
+##### `sidebar`
+
+**тип:** `SidebarEntry[]`  
+**по умолчанию:** боковая панель, созданная на основе [глобальной конфигурации `sidebar`](/ru/reference/configuration/#sidebar)
+
+Предоставление настраиваемой боковой панели навигации для этой страницы.
+Если этот параметр не установлен, на странице будет использоваться глобальная боковая панель по умолчанию.
+
+Например, следующая страница заменяет боковую панель по умолчанию ссылкой на домашнюю страницу и группой ссылок на различные созвездия.
+Текущая страница на боковой панели устанавливается с помощью свойства `isCurrent`, а к элементу ссылки добавлен дополнительный значок (`badge`).
+
+```astro {3-13}
+<StarlightPage
+	frontmatter={{ title: 'Орион' }}
+	sidebar={[
+		{ label: 'Главная', href: '/' },
+		{
+			label: 'Созвездия',
+			items: [
+				{ label: 'Андромеда', href: '/andromeda/' },
+				{ label: 'Орион', href: '/orion/', isCurrent: true },
+				{ label: 'Малая Медведица', href: '/ursa-minor/', badge: 'Stub' },
+			],
+		},
+	]}
+>
+	Пример контента.
+</StarlightPage>
+```
+
+##### `hasSidebar`
+
+**тип:** `boolean`  
+**по умолчанию:** `false` если [`frontmatter.template`](/ru/reference/frontmatter/#template) имеет значение `'splash'`, в противном случае `true`
+
+Отображение боковой панели на этой странице.
+
+##### `headings`
+
+**тип:** `{ depth: number; slug: string; text: string }[]`  
+**по умолчанию:** `[]`
+
+Предоставление массива всех заголовков на этой странице.
+Starlight сгенерирует оглавление страницы из этих заголовков, если они предусмотрены.
+
+##### `dir`
+
+**тип:** `'ltr' | 'rtl'`  
+**по умолчанию:** направление письма для текущей локали
+
+Установка направления письма для содержимого этой страницы.
+
+##### `lang`
+
+**тип:** `string`  
+**по умолчанию:** язык текущей локали
+
+Установка языкового тега BCP-47 для содержимого этой страницы, например: `en`, `zh-CN` или `pt-BR`.
+
+##### `isFallback`
+
+**тип:** `boolean`  
+**по умолчанию:** `false`
+
+Отображение [резервного контента](/ru/guides/i18n/#резервный-контент), если перевод на текущий язык отсутствует.
diff --git a/docs/src/content/docs/ru/guides/project-structure.mdx b/docs/src/content/docs/ru/guides/project-structure.mdx
index ab97e8cb..1c7d11fd 100644
--- a/docs/src/content/docs/ru/guides/project-structure.mdx
+++ b/docs/src/content/docs/ru/guides/project-structure.mdx
@@ -5,8 +5,7 @@ description: Узнайте, как организовать файлы в ва�
 
 Это руководство покажет вам, как организован проект Starlight и какую роль выполняют различные файлы в вашем проекте.
 
-Проекты Starlight, как правило, следуют той же структуре файлов и каталогов, что и другие проекты Astro.
-Подробнее смотрите в [документации по структуре проекта Astro](https://docs.astro.build/ru/core-concepts/project-structure/).
+Проекты Starlight, как правило, следуют той же структуре файлов и каталогов, что и другие проекты Astro. Подробнее смотрите в [документации по структуре проекта Astro](https://docs.astro.build/ru/core-concepts/project-structure/).
 
 ## Файлы и папки
 
diff --git a/docs/src/content/docs/ru/guides/sidebar.mdx b/docs/src/content/docs/ru/guides/sidebar.mdx
index 5b902f68..ced0cc42 100644
--- a/docs/src/content/docs/ru/guides/sidebar.mdx
+++ b/docs/src/content/docs/ru/guides/sidebar.mdx
@@ -1,19 +1,18 @@
 ---
 title: Боковая панель
-description: Узнайте, как настроить и настроить ссылки боковой панели навигации вашего сайта Starlight.
+description: Узнайте, как установить и настроить навигационные ссылки в боковой панели сайта Starlight.
 ---
 
 import { FileTree } from '@astrojs/starlight/components';
 import SidebarPreview from '~/components/sidebar-preview.astro';
 
-Хорошо организованная боковая панель ключевой параметр хорошей документации, поскольку это один из основных способов,
-которыми пользователи будут перемещаться по вашему сайту. Starlight предоставляет полный набор опций для настройки макета и содержимого вашей боковой панели.
+Хорошо организованная боковая панель — ключ к хорошей документации, поскольку это один из основных способов навигации пользователей по вашему сайту. Starlight предоставляет полный набор опций для настройки макета и содержимого боковой панели.
 
 ## Стандартная боковая панель
 
-По умолчанию, Starlight автоматически создаст боковую панель на основе файловой системы вашей документации, используя свойство `title` каждого файла как элемент боковой панели.
+По умолчанию Starlight автоматически генерирует боковую панель на основе структуры файловой системы вашей документации, используя свойство `title` каждого файла в качестве элемента боковой панели.
 
-Например, учитывая следующую структуру файлов:
+Например, при следующей структуре файлов:
 
 <FileTree>
 
@@ -28,19 +27,19 @@ import SidebarPreview from '~/components/sidebar-preview.astro';
 
 </FileTree>
 
-Следующая боковая панель будет сгенерирована автоматически:
+Будет автоматически сгенерирована следующая боковая панель:
 
 <SidebarPreview
 	config={[
 		{
-			label: 'Руководства',
+			label: 'guides',
 			items: [
 				{ label: 'Компоненты', link: '/ru/guides/components/' },
 				{ label: 'Интернационализация (i18n)', link: '/ru/guides/i18n/' },
 			],
 		},
 		{
-			label: 'Справочник',
+			label: 'reference',
 			items: [
 				{
 					label: 'Справочник по конфигурации',
@@ -51,49 +50,49 @@ import SidebarPreview from '~/components/sidebar-preview.astro';
 	]}
 />
 
-Узнайте больше о автоматически генерируемых боковых панелях в разделе [Автоматически Генерируемые Группы](#автогенерируемые-группы).
+Узнайте больше об автоматически генерируемых боковых панелях в разделе [Автогенерируемые группы](#автогенерируемые-группы).
 
 ## Добавление ссылок и групп ссылок
 
-Чтобы настроить свои [ссылки](#ссылки) и [группы ссылок](#группировка) (внутри сворачиваемого заголовка) в боковой панели,
+Чтобы настроить свои [ссылки](#ссылки) и [группы ссылок](#группы) (внутри сворачиваемого заголовка) в боковой панели,
 используйте свойство [`starlight.sidebar`](/ru/reference/configuration/#sidebar) в `astro.config.mjs`.
 
-Сочетая ссылки и группы, вы можете создавать разнообразные макеты боковой панели.
+Комбинируя ссылки и группы, вы можете создавать разнообразные макеты боковой панели.
 
 ### Ссылки
 
 Добавьте ссылку на внутреннюю или внешнюю страницу, используя объект со свойствами `label` и `link`.
 
-```js
+```js "label:" "link:"
 starlight({
 	sidebar: [
 		// Ссылка на руководство по CSS и стилизации.
-		{ label: 'CSS & стилизация', link: '/ru/guides/css-and-tailwind/' },
+		{ label: 'CSS и стилизация', link: '/ru/guides/css-and-tailwind/' },
 		// Внешняя ссылка на веб-сайт Astro.
 		{ label: 'Astro', link: 'https://astro.build/' },
 	],
 });
 ```
 
-Конфигурация выше создает следующую боковую панель:
+Конфигурация выше создаёт следующую боковую панель:
 
 <SidebarPreview
 	config={[
-		{ label: 'CSS & стилизация', link: '/ru/guides/css-and-tailwind/' },
+		{ label: 'CSS и стилизация', link: '/ru/guides/css-and-tailwind/' },
 		{ label: 'Astro', link: 'https://astro.build/' },
 	]}
 />
 
-### Группировка
+### Группы
 
 Вы можете структурировать вашу боковую панель, группируя связанные ссылки вместе под раскрывающимся заголовком.
 Группы могут содержать как ссылки, так и другие подгруппы.
 
-Добавьте группу, используя объект с свойствами `label` и `items`.
+Добавьте группу, используя объект со свойствами `label` и `items`.
 `label` будет использован как заголовок для группы.
 Добавляйте ссылки или подгруппы в массив `items`.
 
-```js
+```js /^\s*(label:|items:)/
 starlight({
 	sidebar: [
 		// Группа ссылок с названием "Руководства".
@@ -143,18 +142,17 @@ starlight({
 
 Starlight может автоматически генерировать группу в вашей боковой панели, основываясь на директориях в вашей документации.
 Это полезно, когда вы не хотите вручную вводить каждый элемент боковой панели в группе.
-Страницы по умолчанию будут отсортированы по алфавиту по имени файла.
 
-Добавьте автогенерируемую группу, используя объект с свойствами `label` и `autogenerate`.
-Ваша конфигурация `autogenerate` должна указывать `directory`, который будет использоваться для записей боковой панели.
-Например, со следующей конфигурацией:
+По умолчанию страницы сортируются в алфавитном порядке в соответствии со свойством [`slug`](/ru/reference/overrides/#slug) или именем файла.
 
-```js
+Добавьте автогенерируемую группу, используя объект со свойствами `label` и `autogenerate`. Ваша конфигурация `autogenerate` должна указывать `directory`, которая будет использоваться для записей боковой панели. Например, со следующей конфигурацией:
+
+```js "label:" "autogenerate:"
 starlight({
 	sidebar: [
 		{
 			label: 'Руководства',
-			// Автоматически генерировать группу ссылок для директории "руководства".
+			// Автоматически генерировать группу ссылок для директории "guides".
 			autogenerate: { directory: 'guides' },
 		},
 	],
@@ -176,7 +174,7 @@ starlight({
 
 </FileTree>
 
-Следующая боковая панель будет сгенерирована:
+Будет сгенерирована следующая боковая панель:
 
 <SidebarPreview
 	config={[
@@ -186,7 +184,7 @@ starlight({
 				{ label: 'Компоненты', link: '/ru/guides/components/' },
 				{ label: 'Интернационализация (i18n)', link: '/ru/guides/i18n/' },
 				{
-					label: 'дополнительно',
+					label: 'advanced',
 					items: [
 						{
 							label: 'Структура проекта',
@@ -204,11 +202,11 @@ starlight({
 Используйте [поле `sidebar`](/ru/reference/frontmatter/#sidebar) в метаданных страниц для настройки автоматически генерируемых ссылок.
 
 Параметры в метаданных для боковой панели позволяют [установить метку](/ru/reference/frontmatter/#label)
-или добавить [значок](/ru/reference/frontmatter/#badge) к ссылке, [скрыть](/ru/reference/frontmatter/#hidden)
-ссылку из боковой панели или определить [вес сортировки](/ru/reference/frontmatter/#order).
+или добавить [значок](/ru/reference/frontmatter/#badge) к ссылке, [скрыть](/ru/reference/frontmatter/#hidden) ссылку из боковой панели или определить [вес сортировки](/ru/reference/frontmatter/#order).
 
-```md
+```md "sidebar:"
 ---
+# src/content/docs/example.md
 title: Моя страница
 sidebar:
   # Установить текст для ссылки
@@ -242,14 +240,14 @@ sidebar:
 />
 
 :::note
-Конфигурация `sidebar` в метаданных используется только для автоматически генерируемых ссылок и будет проигнорирована для вручную определенных ссылок.
+Конфигурация `sidebar` в метаданных используется только для автоматически генерируемых ссылок и будет проигнорирована для вручную определённых ссылок.
 :::
 
 ## Значки
 
 Ссылки также могут включать свойство `badge` для отображения значка рядом с текстом ссылки.
 
-```js
+```js {10,17}
 starlight({
 	sidebar: [
 		{
@@ -263,6 +261,12 @@ starlight({
 				},
 			],
 		},
+		// Автогенерируемая группа со значком "Устарело".
+		{
+			label: 'Справочник',
+			badge: 'Устарело',
+			autogenerate: { directory: 'reference' },
+		},
 	],
 });
 ```
@@ -281,24 +285,41 @@ starlight({
 				},
 			],
 		},
+		{
+			label: 'Справочник',
+			badge: { text: 'Устарело', variant: 'default' },
+			items: [
+				{
+					label: 'Конфигурация',
+					link: '/ru/reference/configuration/',
+				},
+				{
+					label: 'Метаданные',
+					link: '/ru/reference/frontmatter/',
+				},
+				{
+					label: 'Переопределения',
+					link: '/ru/reference/overrides/',
+				},
+			],
+		},
 	]}
 />
 
 ### Варианты значков
 
-Настройте стиль значка, используя объект с свойствами `text` и `variant`.
+Настройте стиль значка, используя объект со свойствами `text` и `variant`.
 
-`text` представляет содержимое для отображения (например, "Новое").
-Переопределите стиль `default`, который использует акцентный цвет вашего сайта,
-установив свойство `variant` в одно из следующих значений: `note`, `tip`, `danger`, `caution` или `success`.
+`text` представляет содержимое для отображения (например, «Новое»).
+Переопределите стиль `default`, который использует акцентный цвет вашего сайта, установив свойство `variant` в одно из следующих значений: `note`, `tip`, `danger`, `caution` или `success`.
 
-```js
+```js {10}
 starlight({
 	sidebar: [
 		{
 			label: 'Руководства',
 			items: [
-				// Ссылка с желтым значком "Экспериментально".
+				// Ссылка с жёлтым значком "Экспериментально".
 				{
 					label: 'Компоненты',
 					link: '/ru/guides/components/',
@@ -334,7 +355,7 @@ starlight({
 В следующем примере `attrs` используется для добавления атрибута `target="_blank"`, чтобы ссылка открывалась в новой вкладке,
 а также для применения атрибута `style`, чтобы курсивом выделить метку ссылки:
 
-```js
+```js {10}
 starlight({
 	sidebar: [
 		{
@@ -343,7 +364,7 @@ starlight({
 				// Внешняя ссылка на документацию Astro, открывающаяся в новой вкладке.
 				{
 					label: 'Документация Astro',
-					link: 'https://docs.astro.build/',
+					link: 'https://docs.astro.build/ru/',
 					attrs: { target: '_blank', style: 'font-style: italic' },
 				},
 			],
@@ -361,7 +382,7 @@ starlight({
 			items: [
 				{
 					label: 'Документация Astro',
-					link: 'https://docs.astro.build/',
+					link: 'https://docs.astro.build/ru/',
 					attrs: {
 						target: '_blank',
 						style: 'font-style: italic',
@@ -374,12 +395,10 @@ starlight({
 
 ## Интернационализация
 
-Используйте свойство `translations` для ссылок и групп, чтобы перевести текст ссылки или группы на каждый поддерживаемый язык,
-указав языковой тег [BCP-47](https://www.w3.org/International/questions/qa-choosing-language-tags), например,
-`"en"`, `"ar"` или `"zh-CN"`, в качестве ключа и переведенной метки в качестве значения.
-Свойство `label` будет использоваться для языка по умолчанию и для языков без перевода.
+Используйте свойство `translations` для записей ссылок и групп, чтобы перевести метку ссылки или группы для каждого поддерживаемого языка, указав тег языка [BCP-47](https://www.w3.org/International/questions/qa-choosing-language-tags), например, `"en"`, `"ru"` или `"zh-CN"` в качестве ключа, и перевод метки — в качестве значения.
+Свойство `label` будет использоваться для локали по умолчанию и для языков без перевода.
 
-```js
+```js {5-7,11-13,18-20}
 starlight({
 	sidebar: [
 		{
@@ -415,8 +434,8 @@ starlight({
 		{
 			label: 'Guías',
 			items: [
-				{ label: 'Componentes', link: '/es/guides/components/' },
-				{ label: 'Internacionalización (i18n)', link: '/es/guides/i18n/' },
+				{ label: 'Componentes', link: '/pt-br/guides/components/' },
+				{ label: 'Internacionalización (i18n)', link: '/pt-br/guides/i18n/' },
 			],
 		},
 	]}
@@ -424,18 +443,18 @@ starlight({
 
 ## Сворачиваемые группы
 
-Группы ссылок могут быть свернуты по умолчанию, если установить свойство `collapsed` в `true`.
+Группы ссылок могут быть свёрнуты по умолчанию, если установить свойство `collapsed` в `true`.
 
-```js
+```js {5-6}
 starlight({
 	sidebar: [
 		{
 			label: 'Руководства',
-			// Collapse the group by default.
+			// Сворачиваем группу по умолчанию.
 			collapsed: true,
 			items: [
-				{ label: 'Components', link: '/guides/components/' },
-				{ label: 'Internationalization (i18n)', link: '/guides/i18n/' },
+				{ label: 'Компоненты', link: '/ru/guides/components/' },
+				{ label: 'Интернационализация (i18n)', link: '/ru/guides/i18n/' },
 			],
 		},
 	],
@@ -459,12 +478,12 @@ starlight({
 
 [Автогенерируемые группы](#автогенерируемые-группы) учитывают значение `collapsed` родительской группы:
 
-```js
+```js {5-6}
 starlight({
 	sidebar: [
 		{
 			label: 'Руководства',
-			// Свернуть группу и её автогенерируемые подгруппы по умолчанию.
+			// Сворачиваем группу и её автогенерируемые подгруппы по умолчанию.
 			collapsed: true,
 			autogenerate: { directory: 'guides' },
 		},
@@ -497,14 +516,15 @@ starlight({
 	]}
 />
 
-Это поведение может быть переопределено путем установки свойства `autogenerate.collapsed`.
+Это поведение может быть переопределено путём установки свойства `autogenerate.collapsed`.
 
-```js
+```js {5-7} "collapsed: true"
 starlight({
 	sidebar: [
 		{
 			label: 'Руководства',
-			// Не сворачивать группу "Руководства", но свернуть её автоматически сгенерированные подгруппы.
+			// Не сворачивать группу "Руководства", но свернуть её
+			// автоматически сгенерированные подгруппы.
 			collapsed: false,
 			autogenerate: { directory: 'guides', collapsed: true },
 		},
diff --git a/docs/src/content/docs/ru/guides/site-search.mdx b/docs/src/content/docs/ru/guides/site-search.mdx
new file mode 100644
index 00000000..ba01977e
--- /dev/null
+++ b/docs/src/content/docs/ru/guides/site-search.mdx
@@ -0,0 +1,172 @@
+---
+title: Поиск по сайту
+description: Узнайте о встроенных в Starlight функциях поиска по сайту и о том, как их настроить.
+---
+
+import { Tabs, TabItem, Steps } from '@astrojs/starlight/components';
+
+По умолчанию сайты Starlight включают полнотекстовый поиск на основе [Pagefind](https://pagefind.app/), который является быстрым и не требующим большой пропускной способности инструментом поиска для статических сайтов.
+
+Для включения поиска не требуется никакой настройки. Создайте и разверните свой сайт, а затем используйте строку поиска в шапке сайта для поиска контента.
+
+## Скрытие содержимого из результатов поиска
+
+### Исключение страницы
+
+Чтобы исключить страницу из поискового индекса, добавьте [`pagefind: false`](/ru/reference/frontmatter/#pagefind) в метаданных страницы:
+
+```md title="src/content/docs/not-indexed.md" ins={3}
+---
+title: Содержимое, которое нужно скрыть от поиска
+pagefind: false
+---
+```
+
+### Исключение части страницы
+
+Pagefind будет игнорировать содержимое внутри элемента с атрибутом [`data-pagefind-ignore`](https://pagefind.app/docs/indexing/#removing-individual-elements-from-the-index).
+
+В следующем примере первый абзац будет отображаться в результатах поиска, а содержимое `<div>` — нет:
+
+```md title="src/content/docs/partially-indexed.md" ins="data-pagefind-ignore"
+---
+title: Частично проиндексированная страница
+---
+
+Этот текст можно будет найти с помощью поиска.
+
+<div data-pagefind-ignore>
+
+Этот текст будет скрыт от поиска.
+
+</div>
+```
+
+## Альтернативные поставщики услуг поиска
+
+### Algolia DocSearch
+
+Если у вас есть доступ к [программе DocSearch от Algolia](https://docsearch.algolia.com/) и вы хотите использовать её вместо Pagefind, вы можете воспользоваться официальным плагином Starlight DocSearch.
+
+<Steps>
+
+1. Установите `@astrojs/starlight-docsearch`:
+
+   <Tabs>
+
+   <TabItem label="npm">
+
+   ```sh
+   npm install @astrojs/starlight-docsearch
+   ```
+
+   </TabItem>
+
+   <TabItem label="pnpm">
+
+   ```sh
+   pnpm add @astrojs/starlight-docsearch
+   ```
+
+   </TabItem>
+
+   <TabItem label="Yarn">
+
+   ```sh
+   yarn add @astrojs/starlight-docsearch
+   ```
+
+   </TabItem>
+
+   </Tabs>
+
+2. Добавьте DocSearch в конфигурацию Starlight [`plugins`](/ru/reference/configuration/#plugins) в `astro.config.mjs` и передайте ему ваши Algolia `appId`, `apiKey` и `indexName`:
+
+   ```js ins={4,10-16}
+   // astro.config.mjs
+   import { defineConfig } from 'astro/config';
+   import starlight from '@astrojs/starlight';
+   import starlightDocSearch from '@astrojs/starlight-docsearch';
+
+   export default defineConfig({
+   	integrations: [
+   		starlight({
+   			title: 'Сайт с DocSearch',
+   			plugins: [
+   				starlightDocSearch({
+   					appId: 'YOUR_APP_ID',
+   					apiKey: 'YOUR_SEARCH_API_KEY',
+   					indexName: 'YOUR_INDEX_NAME',
+   				}),
+   			],
+   		}),
+   	],
+   });
+   ```
+
+</Steps>
+
+С этой обновлённой конфигурацией строка поиска на вашем сайте теперь будет открывать модальное окно Algolia вместо стандартного модального окна поиска.
+
+#### Перевод пользовательского интерфейса DocSearch
+
+По умолчанию DocSearch предоставляет только английские строки пользовательского интерфейса.
+Добавьте перевод модального пользовательского интерфейса для вашего языка, используя встроенную [систему интернационализации](/ru/guides/i18n/#перевод-интерфейса-starlight) Starlight.
+
+<Steps>
+
+1. Расширьте определение коллекции контента Starlight `i18n` схемой DocSearch в файле `src/content/config.ts`:
+
+   ```js ins={4} ins=/{ extend: .+ }/
+   // src/content/config.ts
+   import { defineCollection } from 'astro:content';
+   import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
+   import { docSearchI18nSchema } from '@astrojs/starlight-docsearch/schema';
+
+   export const collections = {
+   	docs: defineCollection({ schema: docsSchema() }),
+   	i18n: defineCollection({
+   		type: 'data',
+   		schema: i18nSchema({ extend: docSearchI18nSchema() }),
+   	}),
+   };
+   ```
+
+2. Добавьте переводы в JSON-файлы в `src/content/i18n/`.
+
+   Это английские значения по умолчанию, используемые DocSearch:
+
+   ```json title="src/content/i18n/en.json"
+   {
+   	"docsearch.searchBox.resetButtonTitle": "Clear the query",
+   	"docsearch.searchBox.resetButtonAriaLabel": "Clear the query",
+   	"docsearch.searchBox.cancelButtonText": "Cancel",
+   	"docsearch.searchBox.cancelButtonAriaLabel": "Cancel",
+
+   	"docsearch.startScreen.recentSearchesTitle": "Recent",
+   	"docsearch.startScreen.noRecentSearchesText": "No recent searches",
+   	"docsearch.startScreen.saveRecentSearchButtonTitle": "Save this search",
+   	"docsearch.startScreen.removeRecentSearchButtonTitle": "Remove this search from history",
+   	"docsearch.startScreen.favoriteSearchesTitle": "Favorite",
+   	"docsearch.startScreen.removeFavoriteSearchButtonTitle": "Remove this search from favorites",
+
+   	"docsearch.errorScreen.titleText": "Unable to fetch results",
+   	"docsearch.errorScreen.helpText": "You might want to check your network connection.",
+
+   	"docsearch.footer.selectText": "to select",
+   	"docsearch.footer.selectKeyAriaLabel": "Enter key",
+   	"docsearch.footer.navigateText": "to navigate",
+   	"docsearch.footer.navigateUpKeyAriaLabel": "Arrow up",
+   	"docsearch.footer.navigateDownKeyAriaLabel": "Arrow down",
+   	"docsearch.footer.closeText": "to close",
+   	"docsearch.footer.closeKeyAriaLabel": "Escape key",
+   	"docsearch.footer.searchByText": "Search by",
+
+   	"docsearch.noResultsScreen.noResultsText": "No results for",
+   	"docsearch.noResultsScreen.suggestedQueryText": "Try searching for",
+   	"docsearch.noResultsScreen.reportMissingResultsText": "Believe this query should return results?",
+   	"docsearch.noResultsScreen.reportMissingResultsLinkText": "Let us know."
+   }
+   ```
+
+</Steps>
+\ No newline at end of file
diff --git a/docs/src/content/docs/ru/index.mdx b/docs/src/content/docs/ru/index.mdx
index 8d449cdd..acabea05 100644
--- a/docs/src/content/docs/ru/index.mdx
+++ b/docs/src/content/docs/ru/index.mdx
@@ -9,7 +9,7 @@ editUrl: false
 lastUpdated: false
 hero:
   title: Сделайте свою документацию яркой с помощью Starlight
-  tagline: Все, что вам нужно, чтобы создать впечатляющий сайт с документацией. Быстро, доступно и просто в использовании.
+  tagline: Всё, что вам нужно, чтобы создать впечатляющий сайт с документацией. Быстро, доступно и просто в использовании.
   image:
     file: ~/assets/hero-star.webp
   actions:
@@ -24,18 +24,20 @@ hero:
 
 import { CardGrid, Card } from '@astrojs/starlight/components';
 import AboutAstro from '~/components/about-astro.astro';
+import TestimonialGrid from '~/components/testimonial-grid.astro';
+import Testimonial from '~/components/testimonial.astro';
 
 <CardGrid stagger>
 	<Card title="Документация, которая восхищает" icon="open-book">
 		Включает в себя: навигацию по сайту, поиск, интернационализацию, оптимизацию
-		для поисковых систем (SEO), удобную типографику, подсветку кода, ночной
+		для поисковых систем (SEO), удобную типографику, подсветку кода, тёмный
 		режим и многое другое.
 	</Card>
 	<Card title="Работает на Astro" icon="rocket">
 		Воспользуйтесь всей мощью и производительностью Astro. Расширьте Starlight с
 		вашими любимыми интеграциями и библиотеками Astro.
 	</Card>
-	<Card title="Markdown, Markdoc, and MDX" icon="document">
+	<Card title="Markdown, Markdoc и MDX" icon="document">
 		Используйте свой любимый язык разметки. Starlight предоставляет встроенную
 		проверку метаданных с поддержкой TypeScript для обеспечения
 		типобезопасности.
@@ -46,10 +48,112 @@ import AboutAstro from '~/components/about-astro.astro';
 	</Card>
 </CardGrid>
 
+<TestimonialGrid title="Что говорят люди">
+  <Testimonial
+    name="Rachel"
+    handle="rachelnabors"
+    cite="https://twitter.com/astrodotbuild/status/1724934718745915558"
+  >
+    Команда Astro РАЗВИВАЛА способы создания документации, и вы можете получить всё это прямо из коробки с их проектом Starlight.
+  </Testimonial>
+  <Testimonial
+    name="Flavio"
+    handle="flaviocopes"
+    cite="https://twitter.com/flaviocopes/status/1738237658717905108"
+  >
+    Официальный стартовый комплект Astro Starlight — поистине невероятный инструмент для создания веб-сайта документации.
+  </Testimonial>
+  <Testimonial
+    name="Tomek"
+    handle="sulco"
+    cite="https://twitter.com/sulco/status/1735610348730802342"
+  >
+    Starlight — наш лучший пример отличного DX: скорость, удобство и
+    внимание к деталям вдохновляет. Он заботится о технологиях и внешнем виде,
+    чтобы вы могли сосредоточиться на своем контенте 👏
+
+    Команде StackBlitz это очень нравится!
+  </Testimonial>
+  <Testimonial
+    name="Roberto"
+    handle="RmeetsH"
+    cite="https://twitter.com/RmeetsH/status/1735783992018760090"
+  >
+    Starlight изменил правила игры для меня, позволив мне сосредоточиться на создании контента.
+
+    Его интуитивно понятный дизайн не только оптимизирует мой рабочий процесс, но и сокращает время адаптации для разработчиков ПО с открытым исходным кодом.
+  </Testimonial>
+  <Testimonial
+    name="Joel"
+    handle="jhooks"
+    cite="https://twitter.com/jhooks/status/1727405160547418405"
+  >
+    Потратил ещё немного времени на Starlight для документации Course Builder, и до сих пор всё было отлично. Множество приятных мелочей и возможность сосредоточиться на написании в Markdown, а не на возне с сайтом.
+  </Testimonial>
+  <Testimonial
+    name="Rick"
+    handle="rick_viscomi"
+    cite="https://twitter.com/rick_viscomi/status/1665867447910510593"
+  >
+    Начал играть со Starlight. Должен сказать, что я очень впечатлен производительностью «из коробки».
+
+    💯💯💯💯
+  </Testimonial>
+  <Testimonial
+    name="Nicolas"
+    handle="beaussan"
+    cite="https://twitter.com/beaussan/status/1735625189583466893"
+  >
+    Starlight — лучший способ начать работу с документацией:
+	мощь и скорость Astro и инструменты Starlight — это идеальное сочетание.
+
+    Я уже давно это делаю и продолжаю любить!
+  </Testimonial>
+  <Testimonial
+    name="Sylwia"
+    handle="SylwiaVargas"
+    cite="https://x.com/SylwiaVargas/status/1726556825741578286"
+  >
+    Я использовала Starlight на своей последней работе, и мне он понравился. Отличные компоненты, интуитивно понятный
+    дизайн и сверхотзывчивое сообщество (всякий раз, когда кому-то что-то нужно,
+    они очень быстро направят его в нужном направлении или подскажут обходной путь). Очень приятный опыт.
+  </Testimonial>
+  <Testimonial
+    name="Lou Cyx"
+    handle="loucyx"
+    cite="https://elk.zone/m.webtoo.ls/@loucyx@mastodon.social/111587380021362284"
+  >
+    Документы на моем сайте монорепозитория выглядят лучше, чем когда-либо, благодаря Starlight. Его чрезвычайно легко использовать, не теряя при этом всей мощи Astro. Спасибо за работу над этим!
+  </Testimonial>
+  <Testimonial
+    name="BowTiedWebReaper"
+    handle="BowTiedWebReapr"
+    cite="https://twitter.com/BowTiedWebReapr/status/1735633399501697517"
+  >
+    Starlight — мой любимый инструмент для документирования. Благодаря этому стало очень легко добавлять документы на мой существующий веб-сайт продукта Astro, вместо того, чтобы использовать поддомен с другим инструментом.
+  </Testimonial>
+  <Testimonial
+    name="Jeff"
+    handle="J_Everhart383"
+    cite="https://twitter.com/J_Everhart383/status/1691900590048292908"
+  >
+    Я перестраивал документацию платформы WPEngine Atlas. Поверьте мне, когда я говорю, что у Starlight есть всё необходимое для создания платформы документации A+ 🙌
+  </Testimonial>
+  <Testimonial
+    name="Chloe"
+    handle="solelychloe"
+    cite="https://twitter.com/solelychloe/status/1695115277602628082"
+  >
+    Попробуйте Starlight!
+
+    Я использую его для нескольких своих сайтов, и это здорово.
+  </Testimonial>
+</TestimonialGrid>
+
 <AboutAstro title="Предоставлено вам">
-Astro - это универсальный веб-фреймворк, разработанный для максимальной производительности.
-Используйте контент из любых источников и развертывайте его везде, используя ваши любимые UI компоненты и библиотеки.
+Astro — универсальный веб-фреймворк, разработанный для максимальной производительности.
+Используйте контент из любых источников и развёртывайте его везде, используя ваши любимые UI компоненты и библиотеки.
 
-[Узнать больше о Astro](https://astro.build/)
+[Узнать больше об Astro](https://astro.build/)
 
 </AboutAstro>
diff --git a/docs/src/content/docs/ru/manual-setup.mdx b/docs/src/content/docs/ru/manual-setup.mdx
index f4214a7d..7a393b02 100644
--- a/docs/src/content/docs/ru/manual-setup.mdx
+++ b/docs/src/content/docs/ru/manual-setup.mdx
@@ -16,7 +16,7 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
 ### Интеграция Starlight
 
 Starlight является [интеграцией Astro](https://docs.astro.build/ru/guides/integrations-guide/).
-Добавьте его на ваш сайт, запустив команду `astro add` в корневой директории вашего проекта:
+Добавьте её на ваш сайт, запустив команду `astro add` в корневой директории вашего проекта:
 
 <Tabs>
     <TabItem label="npm">
@@ -46,7 +46,7 @@ Starlight является [интеграцией Astro](https://docs.astro.bui
 
 Добавьте `title`, чтобы начать:
 
-```js {7-9}
+```js ins={8}
 // astro.config.mjs
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
@@ -54,7 +54,7 @@ import starlight from '@astrojs/starlight';
 export default defineConfig({
 	integrations: [
 		starlight({
-			title: 'Мой замечательный сайт с документацией.',
+			title: 'Мой замечательный сайт с документацией',
 		}),
 	],
 });
@@ -81,7 +81,7 @@ export const collections = {
 
 ### Добавление контента
 
-Starlight теперь настроен, и пришло время добавить контент!
+Starlight настроен, и пришло время добавить контент!
 
 Создайте директорию `src/content/docs/` и начните с добавления файла `index.md`.
 Это будет главной страницей вашего нового сайта:
@@ -96,8 +96,8 @@ description: Узнайте больше о моем проекте на это�
 Добро пожаловать в мой проект!
 ```
 
-Starlight использует роутинг на основе файлов, что означает, что каждый файл Markdown, MDX или Markdoc в `src/content/docs/`
-становится страницей на вашем сайте. Метаданные в начале файла (например, поля `title` и `description` в приведенном выше примере)
+Starlight использует маршрутизацию на основе файлов, что означает, что каждый файл Markdown, MDX или Markdoc в `src/content/docs/`
+становится страницей на вашем сайте. Метаданные в начале файла (например, поля `title` и `description` в приведённом выше примере)
 могут изменить отображение страниц.
 
 Посмотрите все доступные параметры в [справочнике по метаданным](/ru/reference/frontmatter/).
@@ -106,11 +106,11 @@ Starlight использует роутинг на основе файлов, ч
 
 Если у вас уже есть существующий проект Astro, вы можете использовать Starlight, чтобы быстро добавить раздел с документацией на ваш сайт.
 
-### Starlight на вложенном пути
+### Использование Starlight с подкаталогами
 
-Чтобы добавить все страницы Starlight были доступны по нестандартному пути, поместите весь контент внутрь поддиректории в `src/content/docs/`.
+Чтобы добавить все страницы Starlight по подкаталогу, поместите всё содержимое ваших документов в подкаталог `src/content/docs/`.
 
-Например, если все страницы Starlight должны начинаться с `/guides/`, добавьте свой контент в директорию `src/content/docs/guides/`:
+Например, если все страницы Starlight должны начинаться с `/guides/`, добавьте свой контент в каталог `src/content/docs/guides/`:
 
 import { FileTree } from '@astrojs/starlight/components';
 
@@ -132,5 +132,6 @@ import { FileTree } from '@astrojs/starlight/components';
 
 ### Использование Starlight с SSR
 
-На данный момент Starlight не поддерживает [развертывание с SSR](https://docs.astro.build/ru/guides/server-side-rendering/)
-через серверные адаптеры Astro. Мы надеемся, что сможем реализовать это в ближайшем будущем.
+Вы можете использовать Starlight вместе со страницами, отображаемыми по требованию, в своем проекте, следуя руководству [Адаптеры рендеринга по требованию](https://docs.astro.build/ru/guides/server-side-rendering/) в документации Astro.
+
+В настоящее время страницы документации, созданные Starlight, всегда предварительно обрабатываются независимо от режима вывода вашего проекта. Мы надеемся, что вскоре сможем поддерживать рендеринг по требованию для страниц Starlight.
diff --git a/docs/src/content/docs/ru/reference/configuration.mdx b/docs/src/content/docs/ru/reference/configuration.mdx
new file mode 100644
index 00000000..e957b073
--- /dev/null
+++ b/docs/src/content/docs/ru/reference/configuration.mdx
@@ -0,0 +1,559 @@
+---
+title: Конфигурация
+description: Обзор всех опций конфигурации, поддерживаемых Starlight.
+---
+
+## Настройка интеграции `starlight`
+
+Starlight — это интеграция, построенная на основе веб-фреймворка [Astro](https://astro.build). Вы можете настроить свой проект в файле конфигурации `astro.config.mjs`:
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+export default defineConfig({
+	integrations: [
+		starlight({
+			title: 'Мой восхитительный сайт документации',
+		}),
+	],
+});
+```
+
+Вы можете передать следующие параметры интеграции `starlight`.
+
+### `title` (обязательно)
+
+**тип:** `string`
+
+Задайте название для вашего сайта. Будет использоваться в метаданных и в заголовке вкладки браузера.
+
+### `description`
+
+**тип:** `string`
+
+Задайте описание для вашего сайта. Используется в метаданных, передаваемых поисковым системам, в теге `<meta name="description">`, если `description` не задан в метаданных страницы.
+
+### `logo`
+
+**тип:** [`LogoConfig`](#logoconfig)
+
+Установите изображение логотипа, которое будет отображаться в навигационной панели вместе с заголовком сайта или вместо него. Вы можете задать одно свойство `src` или установить отдельные источники изображения для стилей `light` и `dark`.
+
+```js
+starlight({
+	logo: {
+		src: './src/assets/my-logo.svg',
+	},
+});
+```
+
+#### `LogoConfig`
+
+```ts
+type LogoConfig = { alt?: string; replacesTitle?: boolean } & (
+	| { src: string }
+	| { light: string; dark: string }
+);
+```
+
+### `tableOfContents`
+
+**тип:** `false | { minHeadingLevel?: number; maxHeadingLevel?: number; }`  
+**по умолчанию:** `{ minHeadingLevel: 2; maxHeadingLevel: 3; }`
+
+Настройте оглавление, отображаемое справа на каждой странице. По умолчанию в оглавление будут включены заголовки `<h2>` и `<h3>`.
+
+### `editLink`
+
+**тип:** `{ baseUrl: string }`
+
+Включите ссылки "Редактировать эту страницу", задав базовый URL, который они должны использовать. Конечной ссылкой будет `editLink.baseUrl` + путь к текущей странице. Например, чтобы разрешить редактирование страниц в репозитории `withastro/starlight` на GitHub:
+
+```js
+starlight({
+	editLink: {
+		baseUrl: 'https://github.com/withastro/starlight/edit/main/',
+	},
+});
+```
+
+При такой конфигурации страница `/introduction` будет иметь ссылку редактирования, указывающую на `https://github.com/withastro/starlight/edit/main/src/content/docs/introduction.md`.
+
+### `sidebar`
+
+**тип:** [`SidebarItem[]`](#sidebaritem)
+
+Настройте элементы навигации боковой панели вашего сайта.
+
+Боковая панель — это массив ссылок и групп ссылок.
+Каждый элемент должен иметь метку `label` и одно из следующих свойств:
+
+- `link` - одиночная ссылка на определённый URL, например, `'/home'` или `'https://example.com'`.
+
+- `items` - массив, содержащий дополнительные ссылки и подгруппы боковой панели.
+
+- `autogenerate` - объект, указывающий каталог ваших документов для автоматической генерации группы ссылок.
+
+```js
+starlight({
+	sidebar: [
+		// Одиночный элемент ссылки, помеченный как "Главная".
+		{ label: 'Главная', link: '/' },
+		// Группа с надписью "Первые шаги" содержит две ссылки.
+		{
+			label: 'Первые шаги',
+			items: [
+				{ label: 'Введение', link: '/intro' },
+				{ label: 'Следующие шаги', link: '/next-steps' },
+			],
+		},
+		// Группа, связывающая все страницы директории reference.
+		{
+			label: 'Справочник',
+			autogenerate: { directory: 'reference' },
+		},
+	],
+});
+```
+
+#### Сортировка
+
+Автогенерируемые группы боковых панелей сортируются по имени файла в алфавитном порядке.
+Например, страница, созданная на основе `astro.md`, будет отображаться выше страницы для `starlight.md`.
+
+#### Сворачиваемые группы
+
+Группы ссылок раскрываются по умолчанию. Вы можете изменить это поведение, установив для свойства `collapsed` группы значение `true`.
+
+Автогенерируемые подгруппы по умолчанию уважают свойство `collapsed` своей родительской группы. Установите свойство `autogenerate.collapsed`, чтобы переопределить его.
+
+```js {5,16}
+sidebar: [
+  // Группа свёрнутых ссылок.
+  {
+    label: 'Свёрнутые ссылки',
+    collapsed: true,
+    items: [
+      { label: 'Введение', link: '/intro' },
+      { label: 'Следующие шаги', link: '/next-steps' },
+    ],
+  },
+  // Развёрнутая группа, содержащая свёрнутые автогенерируемые подгруппы.
+  {
+    label: 'Справочник',
+    autogenerate: {
+      directory: 'reference',
+      collapsed: true,
+    },
+  },
+],
+```
+
+#### Перевод меток
+
+Если ваш сайт многоязычный, считается, что `label` каждого элемента соответствует локали по умолчанию. Вы можете установить свойство `translations`, чтобы предоставить метки для других поддерживаемых вами языков:
+
+```js {5,9,14}
+sidebar: [
+  // Пример боковой панели с метками, переведёнными на бразильский португальский язык.
+  {
+    label: 'Первые шаги',
+    translations: { 'pt-BR': 'Comece Aqui' },
+    items: [
+      {
+        label: 'Введение',
+        translations: { 'pt-BR': 'Introdução' },
+        link: '/getting-started',
+      },
+      {
+        label: 'Структура проекта',
+        translations: { 'pt-BR': 'Estrutura de Projetos' },
+        link: '/structure',
+      },
+    ],
+  },
+],
+```
+
+#### `SidebarItem`
+
+```ts
+type SidebarItem = {
+	label: string;
+	translations?: Record<string, string>;
+	badge?: string | BadgeConfig;
+} & (
+	| {
+			link: string;
+			attrs?: Record<string, string | number | boolean | undefined>;
+	  }
+	| { items: SidebarItem[]; collapsed?: boolean }
+	| {
+			autogenerate: { directory: string; collapsed?: boolean };
+			collapsed?: boolean;
+	  }
+);
+```
+
+#### `BadgeConfig`
+
+```ts
+interface BadgeConfig {
+	text: string;
+	variant: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default';
+}
+```
+
+### `locales`
+
+**тип:** <code>\{ \[dir: string\]: [LocaleConfig](#localeconfig) \}</code>
+
+[Настройте интернационализацию (i18n)](/ru/guides/i18n/) для вашего сайта, установив, какие `locales` поддерживаются.
+
+В каждой записи в качестве ключа должен использоваться каталог, в котором хранятся файлы этого языка.
+
+```js
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+export default defineConfig({
+	integrations: [
+		starlight({
+			title: 'Мой сайт',
+			// Устанавливаем русский язык в качестве языка по умолчанию для этого сайта.
+			defaultLocale: 'ru',
+			locales: {
+				// Английская документация в `src/content/docs/en/`
+				en: {
+					label: 'English',
+				},
+				// Китайская документация в `src/content/docs/zh-cn/`
+				'zh-cn': {
+					label: '简体中文',
+					lang: 'zh-CN',
+				},
+				// Арабская документация `src/content/docs/ar/`
+				ar: {
+					label: 'العربية',
+					dir: 'rtl',
+				},
+				// Русская документация в `src/content/docs/ru/`
+				ru: {
+					label: 'Русский',
+				},
+			},
+		}),
+	],
+});
+```
+
+#### `LocaleConfig`
+
+```ts
+interface LocaleConfig {
+	label: string;
+	lang?: string;
+	dir?: 'ltr' | 'rtl';
+}
+```
+
+Для каждой локали можно задать следующие параметры:
+
+##### `label` (required)
+
+**тип:** `string`
+
+Метка для этого языка, которую нужно показывать пользователям, например, в переключателе языков. Чаще всего вы хотите, чтобы это было название языка в том виде, в котором пользователь этого языка ожидал бы его прочитать, например `"English"`, `"العربية"` или `"Русский"`.
+
+##### `lang`
+
+**тип:** `string`
+
+Метка BCP-47 для этого языка, например, `"en"`, `"zh-CN"` или `"ru"`. Если не задано, то по умолчанию будет использоваться имя каталога языка. Языковые теги с региональными подтегами (например, `"pt-BR"` или `"en-US"`) будут использовать встроенные переводы пользовательского интерфейса для своего базового языка, если не будут найдены переводы для конкретного региона.
+
+##### `dir`
+
+**тип:** `'ltr' | 'rtl'`
+
+Направление письма на этом языке; `"ltr"` — слева направо (по умолчанию) или `"rtl"` — справа налево.
+
+#### Корневая локаль
+
+Вы можете использовать язык по умолчанию без каталога `/lang/`, установив локаль `root`:
+
+```js {3-6}
+starlight({
+	locales: {
+		root: {
+			label: 'English',
+			lang: 'en',
+		},
+		ru: {
+			label: 'Русский',
+		},
+	},
+});
+```
+
+Например, это позволит вам обслуживать `/getting-started/` как маршрут по умолчанию и использовать `/ru/getting-started/` как эквивалентную русскую страницу.
+
+### `defaultLocale`
+
+**тип:** `string`
+
+Установите язык, который используется по умолчанию для этого сайта.
+Значение должно соответствовать одному из ключей вашего объекта [`locales`](#locales).
+(Если языком по умолчанию является ваша [корневая локаль](#корневая-локаль), это можно пропустить).
+
+Локаль по умолчанию будет использоваться для предоставления резервного содержимого, если перевод отсутствует.
+
+### `social`
+
+import SocialLinksType from '~/components/social-links-type.astro';
+
+**тип:** <SocialLinksType />
+
+Дополнительные сведения об аккаунтах в социальных сетях для этого сайта. При добавлении любого из них они будут отображаться в виде ссылок-иконок в шапке сайта.
+
+```js
+starlight({
+	social: {
+		codeberg: 'https://codeberg.org/knut/examples',
+		discord: 'https://astro.build/chat',
+		github: 'https://github.com/withastro/starlight',
+		gitlab: 'https://gitlab.com/delucis',
+		linkedin: 'https://www.linkedin.com/company/astroinc',
+		mastodon: 'https://m.webtoo.ls/@astro',
+		threads: 'https://www.threads.net/@nmoodev',
+		twitch: 'https://www.twitch.tv/bholmesdev',
+		twitter: 'https://twitter.com/astrodotbuild',
+		'x.com': 'https://x.com/astrodotbuild',
+		youtube: 'https://youtube.com/@astrodotbuild',
+	},
+});
+```
+
+### `customCss`
+
+**тип:** `string[]`
+
+Предоставьте CSS-файлы для настройки внешнего вида вашего сайта Starlight.
+
+Поддерживаются локальные CSS-файлы относительно корня вашего проекта, например: `'./src/custom.css'`, и CSS, которые вы установили как модуль npm, например: `'@fontsource/roboto'`.
+
+```js
+starlight({
+	customCss: ['./src/custom-styles.css', '@fontsource/roboto'],
+});
+```
+
+### `expressiveCode`
+
+**тип:** `StarlightExpressiveCodeOptions | boolean`  
+**по умолчанию:** `true`
+
+Starlight использует [Expressive Code](https://github.com/expressive-code/expressive-code/tree/main/packages/astro-expressive-code) для визуализации блоков кода и добавляет поддержку выделения частей примеров кода, добавления имён файлов к блокам кода и многое другое.
+Смотрите руководство [Блоки кода](/ru/guides/authoring-content/#блоки-кода), чтобы узнать, как использовать синтаксис выразительного кода в Markdown и MDX-содержимом.
+
+Вы также можете использовать любые стандартные [параметры конфигурации Expressive Code](https://github.com/expressive-code/expressive-code/blob/main/packages/astro-expressive-code/README.md#configuration), как некоторые свойства, специфичные для Starlight, установив их в опции `expressiveCode` Starlight.
+Например, установите опцию `styleOverrides` в Expressive Code, чтобы переопределить CSS по умолчанию. Это позволяет настраивать код, например, сделать блокам кода закругленные углы:
+
+```js ins={2-4}
+starlight({
+	expressiveCode: {
+		styleOverrides: { borderRadius: '0.5rem' },
+	},
+});
+```
+
+Если вы хотите отключить Expressive Code, установите `expressiveCode: false` в конфигурации Starlight:
+
+```js ins={2}
+starlight({
+	expressiveCode: false,
+});
+```
+
+В дополнение к стандартным параметрам Expressive Code вы также можете установить следующие свойства, специфичные для Starlight, в вашей конфигурации `expressiveCode` для дальнейшей настройки поведения темы для ваших блоков кода:
+
+#### `themes`
+
+**тип:** `Array<string | ThemeObject | ExpressiveCodeTheme>`  
+**по умолчанию:** `['starlight-dark', 'starlight-light']`
+
+Установите темы, используемые для оформления блоков кода.
+См. [документацию по темам Expressive Code](https://github.com/expressive-code/expressive-code/blob/main/packages/astro-expressive-code/README.md#themes) для получения подробной информации о поддерживаемых форматах тем.
+
+По умолчанию Starlight использует тёмный и светлый варианты [темы Night Owl](https://github.com/sdras/night-owl-vscode-theme) Сары Драснер.
+
+Если вы предоставите хотя бы одну тёмную и одну светлую тему, Starlight автоматически синхронизирует активную тему блока кода с текущей темой сайта.
+Настройте это поведение с помощью параметра [`useStarlightDarkModeSwitch`](#usestarlightdarkmodeswitch).
+
+#### `useStarlightDarkModeSwitch`
+
+**тип:** `boolean`  
+**по умолчанию:** `true`
+
+Если установлено значение true, блоки кода автоматически переключаются между светлой и тёмной темами при изменении темы сайта.
+Если установлено значение false, вам придется вручную добавить CSS для переключения между несколькими темами.
+
+:::note
+При настройке `themes` вы должны указать хотя бы одну тёмную и одну светлую тему, чтобы переключатель темного режима Starlight работал.
+:::
+
+#### `useStarlightUiThemeColors`
+
+**тип:** `boolean`  
+**по умолчанию:** `true` если `themes` не задано, иначе — `false`
+
+Если `true`, то для цветов элементов пользовательского интерфейса кодового блока (фонов, кнопок, теней и т. д.) используются CSS-переменные Starlight, соответствующие [цветовой теме сайта](/ru/guides/css-and-tailwind/#темизация).
+Если `false`, то для этих элементов используются цвета, предоставляемые активной темой подсветки синтаксиса.
+
+:::note
+При использовании пользовательских тем и установке для этого параметра значения `true` необходимо указать хотя бы одну тёмную и одну светлую тему, чтобы обеспечить правильный цветовой контраст.
+:::
+
+### `pagefind`
+
+**тип:** `boolean`  
+**по умолчанию:** `true`
+
+Определите, включен ли в Starlight поставщик поиска по сайту по умолчанию [Pagefind](https://pagefind.app/).
+
+Установите значение `false`, чтобы отключить индексацию вашего сайта с помощью Pagefind.
+Это также скроет стандартный пользовательский интерфейс поиска, если он используется.
+
+### `head`
+
+**тип:** [`HeadConfig[]`](#headconfig)
+
+Добавьте пользовательские теги в `<head>` вашего сайта Starlight.
+Может пригодиться для добавления аналитики и других сторонних скриптов и ресурсов.
+
+```js
+starlight({
+	head: [
+		// Пример: добавьте тег скрипта аналитики Fathom.
+		{
+			tag: 'script',
+			attrs: {
+				src: 'https://cdn.usefathom.com/script.js',
+				'data-site': 'MY-FATHOM-ID',
+				defer: true,
+			},
+		},
+	],
+});
+```
+
+#### `HeadConfig`
+
+```ts
+interface HeadConfig {
+	tag: string;
+	attrs?: Record<string, string | boolean | undefined>;
+	content?: string;
+}
+```
+
+### `lastUpdated`
+
+**тип:** `boolean`  
+**по умолчанию:** `false`
+
+Укажите, показывать ли в нижнем колонтитуле дату последнего обновления страницы.
+
+По умолчанию эта функция полагается на историю Git вашего репозитория и может быть неточной на некоторых платформах развёртывания, создающих [копии репозитория, включающие только самый последний коммит](https://git-scm.com/docs/git-clone#Documentation/git-clone.txt---depthltdepthgt). Страница может переопределить эту настройку или дату, основанную на Git, с помощью поля [`lastUpdated` frontmatter](/ru/reference/frontmatter/#lastupdated).
+
+### `pagination`
+
+**тип:** `boolean`  
+**по умолчанию:** `true`
+
+Определите, должен ли нижний колонтитул включать ссылки на предыдущую и следующую страницы.
+
+Страница может переопределить эту настройку или текст ссылки и/или URL с помощью полей [`prev`](/ru/reference/frontmatter/#prev) и [`next`](/ru/reference/frontmatter/#next) в метаданных страницы.
+
+### `favicon`
+
+**тип:** `string`  
+**по умолчанию:** `'/favicon.svg'`
+
+Задайте путь к фавиконке по умолчанию для вашего сайта, который должен находиться в директории `public/` и быть валидным (`.ico`, `.gif`, `.jpg`, `.png` или `.svg`) файлом иконок.
+
+```js
+starlight({
+  favicon: '/images/favicon.svg',
+}),
+```
+
+Если вам нужно задать дополнительные варианты или резервные фавиконки, вы можете добавить теги с помощью опции [`head`](#head):
+
+```js
+starlight({
+  favicon: '/images/favicon.svg',
+  head: [
+    // Добавляем резервный значок ICO для Safari
+    {
+      tag: 'link',
+      attrs: {
+        rel: 'icon',
+        href:'/images/favicon.ico',
+        sizes: '32x32',
+      },
+    },
+  ],
+});
+```
+
+### `titleDelimiter`
+
+**тип:** `string`  
+**по умолчанию:** `'|'`
+
+Устанавливает разделитель между заголовком страницы и заголовком сайта в теге `<title>`, который отображается на вкладках браузера.
+
+По умолчанию каждая страница имеет `<title>` вида `Заголовок страницы | Заголовок сайта`.
+Например, эта страница называется «Конфигурация», а этот сайт — «Starlight», поэтому `<title>` для этой страницы будет «Конфигурация | Starlight».
+
+### `disable404Route`
+
+**тип:** `boolean`  
+**по умолчанию:** `false`
+
+Отключает внедрение стандартной [страницы 404](https://docs.astro.build/ru/core-concepts/astro-pages/#custom-404-error-page) Starlight. Чтобы использовать в своем проекте собственный маршрут `src/pages/404.astro`, установите для этого параметра значение `true`.
+
+### `components`
+
+**тип:** `Record<string, string>`
+
+Укажите пути к компонентам для переопределения реализаций Starlight по умолчанию.
+
+```js
+starlight({
+	components: {
+		SocialLinks: './src/components/MySocialLinks.astro',
+	},
+});
+```
+
+См. [Справочник по переопределениям](/ru/reference/overrides/) для получения подробной информации обо всех компонентах, которые можно переопределить.
+
+### `plugins`
+
+**тип:** [`StarlightPlugin[]`](/ru/reference/plugins/#краткая-справка-по-api)
+
+Расширьте Starlight с помощью пользовательских плагинов.
+Плагины вносят изменения в ваш проект, чтобы изменить или добавить функции Starlight.
+
+Посетите [витрину плагинов](/ru/resources/plugins/#плагины), чтобы увидеть список доступных плагинов.
+
+```js
+starlight({
+	plugins: [starlightPlugin()],
+});
+```
+
+См. [Справочник по плагинам](/ru/reference/plugins/) для получения подробной информации о создании собственных плагинов.
diff --git a/docs/src/content/docs/ru/reference/frontmatter.md b/docs/src/content/docs/ru/reference/frontmatter.md
new file mode 100644
index 00000000..f61b1232
--- /dev/null
+++ b/docs/src/content/docs/ru/reference/frontmatter.md
@@ -0,0 +1,449 @@
+---
+title: Метаданные
+description: Обзор полей метаданных, поддерживаемых Starlight по умолчанию.
+---
+
+Вы можете настроить отдельные страницы Markdown и MDX в Starlight, задав значения в их метаданных. Например, на обычной странице можно задать поля `title` и `description`:
+
+```md {3-4}
+---
+# src/content/docs/example.md
+title: Об этом проекте
+description: Узнайте больше о проекте, над которым я работаю.
+---
+
+Добро пожаловать на страницу «О сайте»!
+```
+
+## Поля метаданных
+
+### `title` (обязательно)
+
+**тип:** `string`
+
+Вы должны указать заголовок для каждой страницы. Это будет отображаться в верхней части страницы, на вкладках браузера и в метаданных страницы.
+
+### `description`
+
+**тип:** `string`
+
+Описание страницы используется в качестве метаданных страницы и будет воспринято поисковыми системами и в превью социальных сетей.
+
+### `slug`
+
+**type**: `string`
+
+Переопределите slug страницы. Более подробную информацию вы найдете в разделе [Определение пользовательских слагов](https://docs.astro.build/ru/guides/content-collections/#defining-custom-slugs) в документации Astro.
+
+### `editUrl`
+
+**тип:** `string | boolean`
+
+Переопределяет [глобальную конфигурацию `editLink`](/ru/reference/configuration/#editlink). Установите значение `false`, чтобы отключить ссылку «Редактировать страницу» для конкретной страницы или предоставить альтернативный URL, по которому можно редактировать содержимое этой страницы.
+
+### `head`
+
+**тип:** [`HeadConfig[]`](/ru/reference/configuration/#headconfig)
+
+Вы можете добавить дополнительные теги в `<head>` вашей страницы, используя поле `head` метаданных. Это означает, что вы можете добавлять пользовательские стили, метаданные и другие теги на одну страницу. Аналогично [глобальной опции `head`](/ru/reference/configuration/#head).
+
+```md
+---
+# src/content/docs/example.md
+title: О нас
+head:
+  # Используем свой тег <title>
+  - tag: title
+    content: Пользовательский заголовок
+---
+```
+
+### `tableOfContents`
+
+**тип:** `false | { minHeadingLevel?: number; maxHeadingLevel?: number; }`
+
+Переопределяет [глобальную конфигурацию `tableOfContents`](/ru/reference/configuration/#tableofcontents).
+Настройте уровни заголовков, которые будут включены, или установите значение `false`, чтобы скрыть оглавление на этой странице.
+
+```md
+---
+# src/content/docs/example.md
+title: Страница, содержащая только H2 в оглавлении
+tableOfContents:
+  minHeadingLevel: 2
+  maxHeadingLevel: 2
+---
+```
+
+```md
+---
+# src/content/docs/example.md
+title: Страница без оглавления
+tableOfContents: false
+---
+```
+
+### `template`
+
+**тип:** `'doc' | 'splash'`  
+**по умолчанию:** `'doc'`
+
+Установите шаблон макета для этой страницы.
+Страницы используют макет `'doc'` по умолчанию.
+Установите значение `'splash'`, чтобы использовать более широкий макет без боковых панелей, предназначенный для целевых страниц.
+
+### `hero`
+
+**тип:** [`HeroConfig`](#heroconfig)
+
+Добавьте компонент hero в верхнюю часть этой страницы. Хорошо сочетается с `template: splash`.
+
+Например, в этом конфиге показаны некоторые общие опции, включая загрузку изображения из вашего репозитория.
+
+```md
+---
+# src/content/docs/example.md
+title: Моя домашняя страница
+template: splash
+hero:
+  title: 'Мой проект: Быстрая доставка в космосе'
+  tagline: Доставьте свои вещи на Луну и обратно в мгновение ока.
+  image:
+    alt: Сверкающий, ярко раскрашенный логотип
+    file: ~/assets/logo.png
+  actions:
+    - text: Расскажите мне больше
+      link: /getting-started/
+      icon: right-arrow
+      variant: primary
+    - text: Просмотр на GitHub
+      link: https://github.com/astronaut/my-project
+      icon: external
+      attrs:
+        rel: me
+---
+```
+
+Вы можете отображать разные версии главного изображения в светлом и тёмном режимах.
+
+```md
+---
+# src/content/docs/example.md
+hero:
+  image:
+    alt: Сверкающий, ярко раскрашенный логотип
+    dark: ~/assets/logo-dark.png
+    light: ~/assets/logo-light.png
+---
+```
+
+#### `HeroConfig`
+
+```ts
+interface HeroConfig {
+  title?: string;
+  tagline?: string;
+  image?:
+    | {
+        // Относительный путь к изображению в вашем репозитории.
+        file: string;
+        // Alt-текст, чтобы сделать изображение доступным для вспомогательных технологий
+        alt?: string;
+      }
+    | {
+        // Относительный путь к изображению в вашем репозитории, которое будет использоваться для тёмного режима.
+        dark: string;
+        // Относительный путь к изображению в вашем репозитории, которое будет использоваться для светлого режима.
+        light: string;
+        // Alt-текст, чтобы сделать изображение доступным для вспомогательных технологий
+        alt?: string;
+      }
+    | {
+        // Необработанный HTML для использования в слоте изображения.
+        // Это может быть пользовательский тег `<img>` или встроенный `<svg>`.
+        html: string;
+      };
+  actions?: Array<{
+    text: string;
+    link: string;
+    variant: 'primary' | 'secondary' | 'minimal';
+    icon: string;
+    attrs?: Record<string, string | number | boolean>;
+  }>;
+}
+```
+
+### `banner`
+
+**тип:** `{ content: string }`
+
+Отображает баннер объявления в верхней части этой страницы.
+
+Значение `content` может включать HTML для ссылок или другого содержимого.
+Например, на этой странице отображается баннер со ссылкой на `example.com`.
+
+```md
+---
+# src/content/docs/example.md
+title: Страница с баннером
+banner:
+  content: |
+    Мы только что запустили нечто крутое!
+    <a href="https://example.com">Проверьте</a>
+---
+```
+
+### `lastUpdated`
+
+**тип:** `Date | boolean`
+
+Переопределяет [глобальную опцию `lastUpdated`](/ru/reference/configuration/#lastupdated). Если указана дата, она должна быть действительной [временной меткой YAML](https://yaml.org/type/timestamp.html) и будет переопределять дату, хранящуюся в истории Git для этой страницы.
+
+```md
+---
+# src/content/docs/example.md
+title: Страница с пользовательской датой последнего обновления
+lastUpdated: 2022-08-09
+---
+```
+
+### `prev`
+
+**тип:** `boolean | string | { link?: string; label?: string }`
+
+Переопределяет [глобальную опцию `pagination`](/ru/reference/configuration/#pagination). Если указана строка, будет заменен сгенерированный текст ссылки, а если указан объект, будут переопределены и ссылка, и текст.
+
+```md
+---
+# src/content/docs/example.md
+# Скрываем ссылку на предыдущую страницу
+prev: false
+---
+```
+
+```md
+---
+# src/content/docs/example.md
+# Переопределяем текст ссылки на предыдущую страницу
+prev: Продолжить обучение
+---
+```
+
+```md
+---
+# src/content/docs/example.md
+# Переопределяем ссылку и текст предыдущей страницы
+prev:
+  link: /unrelated-page/
+  label: Загляните на другую страницу
+---
+```
+
+### `next`
+
+**тип:** `boolean | string | { link?: string; label?: string }`
+
+То же самое, что и [`prev`](#prev), но для ссылки на следующую страницу.
+
+```md
+---
+# src/content/docs/example.md
+# Скрываем ссылку на следующую страницу
+next: false
+---
+```
+
+### `pagefind`
+
+**тип:** `boolean`  
+**по умолчанию:** `true`
+
+Установите, должна ли эта страница быть включена в поисковый индекс [Pagefind](https://pagefind.app/). Установите значение `false`, чтобы исключить страницу из результатов поиска:
+
+```md
+---
+# src/content/docs/example.md
+# Скрываем эту страницу из поискового индекса
+pagefind: false
+---
+```
+
+### `sidebar`
+
+**тип:** [`SidebarConfig`](#sidebarconfig)
+
+Управление отображением этой страницы в [боковой панели](/ru/reference/configuration/#sidebar) при использовании автогенерируемой группы ссылок.
+
+#### `SidebarConfig`
+
+```ts
+interface SidebarConfig {
+  label?: string;
+  order?: number;
+  hidden?: boolean;
+  badge?: string | BadgeConfig;
+  attrs?: Record<string, string | number | boolean | undefined>;
+}
+```
+
+#### `label`
+
+**тип:** `string`  
+**по умолчанию:** [`title`](#title-обязательно) страницы
+
+Устанавливает метку для этой страницы в боковой панели при отображении в автогенерируемой группе ссылок.
+
+```md
+---
+# src/content/docs/example.md
+title: Об этом проекте
+sidebar:
+  label: О сайте
+---
+```
+
+#### `order`
+
+**тип:** `number`
+
+Управляйте порядком этой страницы при сортировке автоматически созданной группы ссылок.
+Меньшие числа отображаются выше в группе ссылок.
+
+```md
+---
+# src/content/docs/example.md
+title: Страница, которая будет отображаться первой
+sidebar:
+  order: 1
+---
+```
+
+#### `hidden`
+
+**тип:** `boolean`  
+**по умолчанию:** `false`
+
+Запрещает включать эту страницу в автоматически создаваемую группу боковой панели.
+
+```md
+---
+# src/content/docs/example.md
+title: Страница, которую нужно скрыть из автоматически созданной боковой панели
+sidebar:
+  hidden: true
+---
+```
+
+#### `badge`
+
+**тип:** <code>string | <a href="/ru/reference/configuration/#badgeconfig">BadgeConfig</a></code>
+
+Добавьте значок на страницу в боковой панели, если она отображается в автогенерируемой группе ссылок.
+При использовании строки значок будет отображаться с акцентным цветом по умолчанию.
+В качестве опции передайте объект [`BadgeConfig`](/ru/reference/configuration/#badgeconfig) с полями `text` и `variant` для настройки значка.
+
+```md
+---
+# src/content/docs/example.md
+title: Страница со значком
+sidebar:
+  # Используется вариант по умолчанию, соответствующий акцентному цвету вашего сайта
+  badge: Новое
+---
+```
+
+```md
+---
+# src/content/docs/example.md
+title: Страница со значком
+sidebar:
+  badge:
+    text: Экспериментально
+    variant: caution
+---
+```
+
+#### `attrs`
+
+**тип:** `Record<string, string | number | boolean | undefined>`
+
+Атрибуты HTML для добавления к ссылке на страницу в боковой панели при отображении в автогенерируемой группе ссылок.
+
+```md
+---
+# src/content/docs/example.md
+title: Открытие страницы в новой вкладке
+sidebar:
+  # Открывает страницу в новой вкладке
+  attrs:
+    target: _blank
+---
+```
+
+## Настройка схемы метаданных
+
+Схема метаданных для коллекции контента Starlight `docs` настраивается в файле `src/content/config.ts` с помощью помощника `docsSchema()`:
+
+```ts {3,6}
+// src/content/config.ts
+import { defineCollection } from 'astro:content';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+  docs: defineCollection({ schema: docsSchema() }),
+};
+```
+
+Подробнее о схемах коллекций содержимого читайте в разделе [Определение схемы коллекции](https://docs.astro.build/ru/guides/content-collections/#defining-a-collection-schema) в документации Astro.
+
+`docsSchema()` принимает следующие параметры:
+
+### `extend`
+
+**тип:** Схема Zod или функция, возвращающая схему Zod  
+**по умолчанию:** `z.object({})`
+
+Расширьте схему Starlight дополнительными полями, задав `extend` в опциях `docsSchema()`.
+Значение должно быть [схемой Zod](https://docs.astro.build/ru/guides/content-collections/#defining-datatypes-with-zod).
+
+В следующем примере мы задаем более строгий тип для `description`, чтобы сделать его обязательным, и добавляем новое необязательное поле `category`:
+
+```ts {8-13}
+// src/content/config.ts
+import { defineCollection, z } from 'astro:content';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+  docs: defineCollection({
+    schema: docsSchema({
+      extend: z.object({
+        // Делаем встроенное поле обязательным
+        description: z.string(),
+        // Добавляем новое поле в схему
+        category: z.enum(['tutorial', 'guide', 'reference']).optional(),
+      }),
+    }),
+  }),
+};
+```
+
+Чтобы воспользоваться преимуществами [хелпера `image()`](https://docs.astro.build/ru/guides/images/#images-in-content-collections), используйте функцию, которая возвращает расширение вашей схемы:
+
+```ts {8-13}
+// src/content/config.ts
+import { defineCollection, z } from 'astro:content';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+  docs: defineCollection({
+    schema: docsSchema({
+      extend: ({ image }) => {
+        return z.object({
+          // Добавляем поле, которое должно разрешаться в локальное изображение
+          cover: image(),
+        });
+      },
+    }),
+  }),
+};
+```
diff --git a/docs/src/content/docs/ru/reference/overrides.md b/docs/src/content/docs/ru/reference/overrides.md
new file mode 100644
index 00000000..a68a2d35
--- /dev/null
+++ b/docs/src/content/docs/ru/reference/overrides.md
@@ -0,0 +1,387 @@
+---
+title: Переопределения
+description: Обзор компонентов и параметров компонентов, поддерживаемых переопределениями Starlight.
+tableOfContents:
+  maxHeadingLevel: 4
+---
+
+Вы можете переопределить встроенные компоненты Starlight, указав пути к заменяющим компонентам в опции конфигурации Starlight [`components`](/ru/reference/configuration/#components).
+На этой странице перечислены все компоненты, доступные для переопределения, и даны ссылки на их реализации по умолчанию на GitHub.
+
+Подробнее см. в [Руководстве по переопределению компонентов](/ru/guides/overriding-components/).
+
+## Параметры компонентов
+
+Все компоненты могут обращаться к стандартному объекту `Astro.props`, который содержит информацию о текущей странице.
+
+Для создания пользовательских компонентов импортируйте тип `Props` из Starlight:
+
+```astro
+---
+// src/components/Custom.astro
+import type { Props } from '@astrojs/starlight/props';
+
+const { hasSidebar } = Astro.props;
+//      ^ type: boolean
+---
+```
+
+Это даст вам автозаполнение и типы при обращении к `Astro.props`.
+
+### Параметры
+
+Starlight будет передавать следующие параметры вашим пользовательским компонентам.
+
+#### `dir`
+
+**тип:** `'ltr' | 'rtl'`
+
+Направление написания страницы.
+
+#### `lang`
+
+**тип:** `string`
+
+Языковой тег BCP-47 для локали этой страницы, например. `en`, `ru` или `pt-BR`.
+
+#### `locale`
+
+**тип:** `string | undefined`
+
+Базовый путь, по которому обслуживается язык. `undefined` для слагов корневой локали.
+
+#### `slug`
+
+**тип:** `string`
+
+Слаг для этой страницы, сгенерированный из имени файла содержимого.
+
+#### `id`
+
+**тип:** `string`
+
+Уникальный идентификатор этой страницы, основанный на имени файла содержимого.
+
+#### `isFallback`
+
+**тип:** `true | undefined`
+
+`true`, если эта страница не переведена на текущий язык и использует резервное содержимое из локали по умолчанию.
+Используется только на многоязычных сайтах.
+
+#### `entryMeta`
+
+**тип:** `{ dir: 'ltr' | 'rtl'; lang: string }`
+
+Метаданные локали для содержимого страницы. Может отличаться от значений локали верхнего уровня, если страница использует резервное содержимое.
+
+#### `entry`
+
+Элемент коллекции содержимого Astro для текущей страницы.
+Включает значения метаданных для текущей страницы в `entry.data`.
+
+```ts
+entry: {
+  data: {
+    title: string;
+    description: string | undefined;
+    // и т. д.
+  }
+}
+```
+
+Подробнее о форме этого объекта можно узнать из справочника [Коллекция типов записей Astro](https://docs.astro.build/ru/reference/api-reference/#%D1%82%D0%B8%D0%BF-%D1%8D%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82%D0%B0-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B8).
+
+#### `sidebar`
+
+**тип:** `SidebarEntry[]`
+
+Записи боковой панели навигации сайта для этой страницы.
+
+#### `hasSidebar`
+
+**тип:** `boolean`
+
+Отображать или нет боковую панель на этой странице.
+
+#### `pagination`
+
+**тип:** `{ prev?: Link; next?: Link }`
+
+Ссылки на предыдущую и следующую страницу в боковой панели, если они включены.
+
+#### `toc`
+
+**тип:** `{ minHeadingLevel: number; maxHeadingLevel: number; items: TocItem[] } | undefined`
+
+Оглавление для этой страницы, если оно включено.
+
+#### `headings`
+
+**тип:** `{ depth: number; slug: string; text: string }[]`
+
+Массив всех заголовков в формате Markdown, извлечённых из текущей страницы.
+Используйте [`toc`](#toc) вместо этого, если вы хотите создать компонент оглавления, который уважает параметры конфигурации Starlight.
+
+#### `lastUpdated`
+
+**тип:** `Date | undefined`
+
+Объект JavaScript `Date`, отображающий дату последнего обновления этой страницы, если она включена.
+
+#### `editUrl`
+
+**тип:** `URL | undefined`
+
+Объект `URL` для адреса, по которому можно редактировать данную страницу, если это разрешено.
+
+#### `labels`
+
+**тип:** `Record<string, string>`
+
+Объект, содержащий строки пользовательского интерфейса, локализованные для текущей страницы. Список всех доступных ключей см. в разделе [Перевод интерфейса Starlight](/ru/guides/i18n/#перевод-интерфейса-starlight).
+
+---
+
+## Компоненты
+
+### Элемент `head` страницы
+
+Эти компоненты отображаются внутри элемента `<head>` каждой страницы.
+Они должны включать только [элементы, разрешённые внутри `<head>`](https://developer.mozilla.org/ru/docs/Web/HTML/Element/head#%D1%81%D0%BC%D0%BE%D1%82%D1%80%D0%B8%D1%82%D0%B5_%D1%82%D0%B0%D0%BA%D0%B6%D0%B5).
+
+#### `Head`
+
+**Стандартный компонент:** [`Head.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Head.astro)
+
+Компонент, отображаемый внутри `<head>` каждой страницы.
+Включает важные теги, в том числе `<title>` и `<meta charset="utf-8">`.
+
+В крайнем случае переопределите этот компонент.
+По возможности предпочитайте опцию [`head`](/ru/reference/configuration/#head) в конфигурации Starlight.
+
+#### `ThemeProvider`
+
+**Стандартный компонент:** [`ThemeProvider.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/ThemeProvider.astro)
+
+Компонент, отображаемый внутри `<head>`, который устанавливает поддержку тёмной/светлой темы.
+Реализация по умолчанию включает в себя встроенный скрипт и `<template>`, используемый скриптом в [`<ThemeSelect />`](#themeselect).
+
+---
+
+### Доступность
+
+#### `SkipLink`
+
+**Стандартный компонент:** [`SkipLink.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/SkipLink.astro)
+
+Компонент, отображаемый как первый элемент внутри `<body>`, который ссылается на основное содержимое страницы для обеспечения доступности.
+Реализация по умолчанию скрыта до тех пор, пока пользователь не наведет на нее курсор с помощью табуляции на клавиатуре.
+
+---
+
+### Макет
+
+Эти компоненты отвечают за компоновку компонентов Starlight и управление представлениями в различных точках останова.
+Их переопределение сопряжено со значительными сложностями.
+По возможности предпочитайте переопределять компоненты более низкого уровня.
+
+#### `PageFrame`
+
+**Стандартный компонент:** [`PageFrame.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/PageFrame.astro)
+
+Компонент макета оборачивается вокруг большей части содержимого страницы.
+Реализация по умолчанию устанавливает макет header-sidebar-main и включает в себя именованные слоты `header` и `sidebar`, а также слот по умолчанию для основного содержимого.
+Он также отображает [`<MobileMenuToggle />`](#mobilemenutoggle) для поддержки переключения навигации в боковой панели на маленьких (мобильных) экранах просмотра.
+
+#### `MobileMenuToggle`
+
+**Стандартный компонент:** [`MobileMenuToggle.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/MobileMenuToggle.astro)
+
+Компонент, отображаемый внутри [`<PageFrame>`](#pageframe), который отвечает за переключение навигации боковой панели на маленьких (мобильных) экранах просмотра.
+
+#### `TwoColumnContent`
+
+**Стандартный компонент:** [`TwoColumnContent.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/TwoColumnContent.astro)
+
+Компонент макета оборачивается вокруг колонки с основным содержанием и правой боковой панели (оглавление).
+Реализация по умолчанию управляет переключением между одноколоночным макетом с малой областью просмотра и двухколоночным макетом с большей областью просмотра.
+
+---
+
+### Верхняя панель навигации
+
+Эти компоненты отображают верхнюю навигационную панель Starlight.
+
+#### `Header`
+
+**Стандартный компонент:** [`Header.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Header.astro)
+
+Компонент заголовка отображается в верхней части каждой страницы.
+По умолчанию отображаются [`<SiteTitle />`](#sitetitle), [`<Search />`](#search), [`<SocialIcons />`](#socialicons), [`<ThemeSelect />`](#themeselect), и [`<LanguageSelect />`](#languageselect).
+
+#### `SiteTitle`
+
+**Стандартный компонент:** [`SiteTitle.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/SiteTitle.astro)
+
+Компонент, отображаемый в начале заголовка сайта для отображения заголовка сайта.
+Реализация по умолчанию включает логику для отрисовки логотипов, определённую в конфигурации Starlight.
+
+#### `Search`
+
+**Стандартный компонент:** [`Search.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Search.astro)
+
+Компонент, используемый для отображения пользовательского интерфейса поиска Starlight.
+Реализация по умолчанию включает кнопку в заголовке и код для отображения модального окна поиска при нажатии на нее и загрузки [интерфейса Pagefind](https://pagefind.app/).
+
+Когда [`pagefind`](/ru/reference/configuration/#pagefind) отключен, компонент поиска по умолчанию не будет отображаться.
+Однако если вы переопределите `Search`, ваш пользовательский компонент будет отображаться всегда, даже если параметр конфигурации `pagefind` будет равен `false`.
+Это позволяет добавить пользовательский интерфейс для альтернативных поставщиков поиска при отключении Pagefind.
+
+#### `SocialIcons`
+
+**Стандартный компонент:** [`SocialIcons.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/SocialIcons.astro)
+
+Компонент, отображаемый в шапке сайта, включая ссылки на социальные иконки.
+Реализация по умолчанию использует опцию [`social`](/ru/reference/configuration/#social) в конфигурации Starlight для отображения иконок и ссылок.
+
+#### `ThemeSelect`
+
+**Стандартный компонент:** [`ThemeSelect.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/ThemeSelect.astro)
+
+Компонент, отображаемый в шапке сайта, который позволяет пользователям выбрать желаемую цветовую схему.
+
+#### `LanguageSelect`
+
+**Стандартный компонент:** [`LanguageSelect.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/LanguageSelect.astro)
+
+Компонент, отображаемый в заголовке сайта, который позволяет пользователям переключиться на другой язык.
+
+---
+
+### Глобальная боковая панель
+
+В глобальной боковой панели Starlight находится основная навигация сайта.
+На узких экранах она скрывается за выпадающим меню.
+
+#### `Sidebar`
+
+**Стандартный компонент:** [`Sidebar.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Sidebar.astro)
+
+Компонент, отображаемый перед содержимым страницы, содержащим глобальную навигацию.
+Реализация по умолчанию отображается в виде боковой панели на достаточно широких экранах и в виде выпадающего меню на маленьких (мобильных) экранах.
+Он также отображает [`<MobileMenuFooter />`](#mobilemenufooter), чтобы показать дополнительные пункты внутри мобильного меню.
+
+#### `MobileMenuFooter`
+
+**Стандартный компонент:** [`MobileMenuFooter.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/MobileMenuFooter.astro)
+
+Компонент, отображаемый в нижней части мобильного выпадающего меню.
+Реализация по умолчанию отображает [`<ThemeSelect />`](#themeselect) и [`<LanguageSelect />`](#languageselect).
+
+---
+
+### Боковая панель страницы
+
+Боковая панель страницы Starlight отвечает за отображение оглавления, в котором указаны подзаголовки текущей страницы.
+На узких экранах это сворачивается в липкое выпадающее меню.
+
+#### `PageSidebar`
+
+**Стандартный компонент:** [`PageSidebar.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/PageSidebar.astro)
+
+Компонент, отображаемый перед содержимым главной страницы для вывода оглавления.
+Реализация по умолчанию отображает [`<TableOfContents />`](#tableofcontents) и [`<MobileTableOfContents />`](#mobiletableofcontents).
+
+#### `TableOfContents`
+
+**Стандартный компонент:** [`TableOfContents.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/TableOfContents.astro)
+
+Компонент, который отображает оглавление текущей страницы на широких экранах просмотра.
+
+#### `MobileTableOfContents`
+
+**Стандартный компонент:** [`MobileTableOfContents.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/MobileTableOfContents.astro)
+
+Компонент, который отображает оглавление текущей страницы на маленьких (мобильных) экранах просмотра.
+
+---
+
+### Контент
+
+Эти компоненты отображаются в основной колонке содержимого страницы.
+
+#### `Banner`
+
+**Стандартный компонент:** [`Banner.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Banner.astro)
+
+Баннерный компонент, отображаемый в верхней части каждой страницы.
+Реализация по умолчанию использует значение [`banner`](/ru/reference/frontmatter/#banner) метаданных страницы для принятия решения о необходимости отрисовки.
+
+#### `ContentPanel`
+
+**Стандартный компонент:** [`ContentPanel.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/ContentPanel.astro)
+
+Компонент макета, используемый для обёртывания секций колонки основного содержимого.
+
+#### `PageTitle`
+
+**Стандартный компонент:** [`PageTitle.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/PageTitle.astro)
+
+Компонент, содержащий элемент `<h1>` для текущей страницы.
+
+Реализации должны обеспечить установку `id="_top"` для элемента `<h1>`, как в реализации по умолчанию.
+
+#### `FallbackContentNotice`
+
+**Стандартный компонент:** [`FallbackContentNotice.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/FallbackContentNotice.astro)
+
+Уведомление, отображаемое пользователям на страницах, где перевод на текущий язык недоступен.
+Используется только на многоязычных сайтах.
+
+#### `Hero`
+
+**Стандартный компонент:** [`Hero.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Hero.astro)
+
+Компонент, отображаемый в верхней части страницы, когда в метаданных задан параметр [`hero`](/ru/reference/frontmatter/#hero).
+В стандартном варианте на экране отображается крупный заголовок, теглайн и ссылки, призывающие к действию, а также дополнительное изображение.
+
+#### `MarkdownContent`
+
+**Стандартный компонент:** [`MarkdownContent.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/MarkdownContent.astro)
+
+Компонент отображается вокруг основного содержимого каждой страницы.
+Реализация по умолчанию устанавливает базовые стили для применения к содержимому Markdown.
+
+Стили контента Markdown также представлены в `@astrojs/starlight/style/markdown.css` и ограничены классом CSS `.sl-markdown-content`.
+
+---
+
+### Подвал
+
+Эти компоненты отображаются внизу основного столбца содержимого страницы.
+
+#### `Footer`
+
+**Стандартный компонент:** [`Footer.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Footer.astro)
+
+Компонент нижнего колонтитула отображается внизу каждой страницы.
+Реализация по умолчанию отображает [`<LastUpdated />`](#lastupdated), [`<Pagination />`](#pagination) и [`<EditLink />`](#editlink).
+
+#### `LastUpdated`
+
+**Стандартный компонент:** [`LastUpdated.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/LastUpdated.astro)
+
+Компонент отображается в нижнем колонтитуле страницы для отображения даты последнего обновления.
+
+#### `EditLink`
+
+**Стандартный компонент:** [`EditLink.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/EditLink.astro)
+
+Компонент, отображаемый в нижнем колонтитуле страницы для отображения ссылки на страницу, где её можно редактировать.
+
+#### `Pagination`
+
+**Стандартный компонент:** [`Pagination.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Pagination.astro)
+
+Компонент отображается в нижнем колонтитуле страницы для отображения стрелок навигации между предыдущими и следующими страницами.
diff --git a/docs/src/content/docs/ru/reference/plugins.md b/docs/src/content/docs/ru/reference/plugins.md
new file mode 100644
index 00000000..4b95c3be
--- /dev/null
+++ b/docs/src/content/docs/ru/reference/plugins.md
@@ -0,0 +1,163 @@
+---
+title: Плагины
+description: Обзор API плагинов Starlight.
+tableOfContents:
+  maxHeadingLevel: 4
+---
+
+Плагины Starlight могут настраивать конфигурацию, пользовательский интерфейс и поведение Starlight, а также легко распространяться и использоваться повторно.
+На этой справочной странице описаны API, к которым имеют доступ плагины.
+
+Подробнее об использовании плагинов Starlight можно узнать в разделе [Конфигурация](/ru/reference/configuration/#plugins) или на [Витрине плагинов](/ru/resources/plugins/#плагины), чтобы посмотреть список доступных плагинов.
+
+## Краткая справка по API
+
+Плагин Starlight имеет следующую форму.
+Подробнее о различных свойствах и параметрах хуков см. ниже.
+
+```ts
+interface StarlightPlugin {
+  name: string;
+  hooks: {
+    setup: (options: {
+      config: StarlightUserConfig;
+      updateConfig: (newConfig: StarlightUserConfig) => void;
+      addIntegration: (integration: AstroIntegration) => void;
+      astroConfig: AstroConfig;
+      command: 'dev' | 'build' | 'preview';
+      isRestart: boolean;
+      logger: AstroIntegrationLogger;
+    }) => void | Promise<void>;
+  };
+}
+```
+
+## `name`
+
+**тип:** `string`
+
+Плагин должен иметь уникальное имя, описывающее его. Имя используется при [регистрации сообщений](#logger), связанных с этим плагином, и может использоваться другими плагинами для определения присутствия этого плагина.
+
+## `hooks`
+
+Хуки — это функции, которые Starlight вызывает для запуска кода плагина в определённое время. В настоящее время Starlight поддерживает единственный хук `setup`.
+
+### `hooks.setup`
+
+Функция настройки плагина, вызываемая при инициализации Starlight (во время выполнения хука интеграции [`astro:config:setup`](https://docs.astro.build/ru/reference/integrations-reference/#astroconfigsetup)).
+Хук `setup` можно использовать для обновления конфигурации Starlight или добавления интеграций Astro.
+
+Этот хук вызывается со следующими параметрами:
+
+#### `config`
+
+**тип:** `StarlightUserConfig`
+
+Доступная только для чтения копия предоставленной пользователем [конфигурации Starlight](/ru/reference/configuration).
+Эта конфигурация могла быть обновлена другими плагинами, настроенными до текущего.
+
+#### `updateConfig`
+
+**тип:** `(newConfig: StarlightUserConfig) => void`
+
+Функция обратного вызова для обновления предоставленной пользователем [конфигурации Starlight](/ru/reference/configuration).
+Укажите ключи конфигурации корневого уровня, которые вы хотите отменить.
+Чтобы обновить значения вложенной конфигурации, необходимо предоставить весь вложенный объект.
+
+Чтобы расширить существующий параметр конфигурации, не переопределяя его, добавьте существующее значение в новое.
+В следующем примере к существующей конфигурации добавляется новый медиааккаунт [`social`](/ru/reference/configuration/#social) путём распространения `config.social` на новый объект `social`:
+
+```ts {6-11}
+// plugin.ts
+export default {
+  name: 'add-twitter-plugin',
+  hooks: {
+    setup({ config, updateConfig }) {
+      updateConfig({
+        social: {
+          ...config.social,
+          twitter: 'https://twitter.com/astrodotbuild',
+        },
+      });
+    },
+  },
+};
+```
+
+#### `addIntegration`
+
+**тип:** `(integration: AstroIntegration) => void`
+
+Функция обратного вызова для добавления [Astro integration](https://docs.astro.build/ru/reference/integrations-reference/), необходимой плагину.
+
+В следующем примере плагин сначала проверяет, настроена ли [интеграция Astro с React](https://docs.astro.build/ru/guides/integrations-guide/react/), и, если нет, использует `addIntegration()` для её добавления:
+
+```ts {14} "addIntegration,"
+// plugin.ts
+import react from '@astrojs/react';
+
+export default {
+  name: 'plugin-using-react',
+  hooks: {
+    setup({ addIntegration, astroConfig }) {
+      const isReactLoaded = astroConfig.integrations.find(
+        ({ name }) => name === '@astrojs/react'
+      );
+
+      // Добавляем интеграцию React только в том случае, если она ещё не загружена.
+      if (!isReactLoaded) {
+        addIntegration(react());
+      }
+    },
+  },
+};
+```
+
+#### `astroConfig`
+
+**тип:** `AstroConfig`
+
+Доступная только для чтения копия предоставленной пользователем [конфигурации Astro](https://docs.astro.build/ru/reference/configuration-reference/).
+
+#### `command`
+
+**тип:** `'dev' | 'build' | 'preview'`
+
+Команда, используемая для запуска Starlight:
+
+- `dev` — Проект выполняется с помощью `astro dev`.
+- `build` — Проект выполняется с помощью `astro build`.
+- `preview` — Проект выполняется с `astro preview`.
+
+#### `isRestart`
+
+**тип:** `boolean`
+
+`false` при запуске dev-сервера, `true` при перезагрузке.
+Частыми причинами перезапуска являются редактирование пользователем файла `astro.config.mjs` во время работы dev-сервера.
+
+#### `logger`
+
+**тип:** `AstroIntegrationLogger`
+
+Экземпляр [логгера интеграции Astro](https://docs.astro.build/ru/reference/integrations-reference/#astrointegrationlogger), который можно использовать для записи журналов.
+Все сообщения в журнале будут иметь префикс с названием плагина.
+
+```ts {6}
+// plugin.ts
+export default {
+  name: 'long-process-plugin',
+  hooks: {
+    setup({ logger }) {
+      logger.info('Начало длительного процесса…');
+      // Долгий процесс...
+    },
+  },
+};
+```
+
+В приведённом выше примере в журнал будет выведено сообщение, включающее в себя предоставленное информационное сообщение:
+
+```shell
+[long-process-plugin] Начало длительного процесса...
+```
diff --git a/docs/src/content/docs/ru/resources/community-content.mdx b/docs/src/content/docs/ru/resources/community-content.mdx
new file mode 100644
index 00000000..fb89db8c
--- /dev/null
+++ b/docs/src/content/docs/ru/resources/community-content.mdx
@@ -0,0 +1,124 @@
+---
+title: Контент сообщества
+description: Откройте для себя подготовленные сообществом руководства, статьи и видео, которые помогут вам учиться и строить с помощью Starlight!
+---
+
+:::tip[Добавьте собственную работу!]
+Вы создали какой-то материал о Starlight?
+Откройте PR, добавив ссылку на созданную страницу!
+:::
+
+import { CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+## Статьи и обзоры
+
+Вот подборка постов и статей, в которых вы узнаете больше о Starlight и опыте других людей:
+
+<CardGrid>
+	<LinkCard
+		href="https://devm.io/open-source/starlight-astro"
+		title="Генерация статических сайтов с помощью Starlight"
+		description="«При разработке компонентов ни одна идея не является слишком большой или слишком маленькой» — интервью с Крисом Свитинбанком, руководителем Starlight"
+	/>
+	<LinkCard
+		href="https://frontendatscale.com/blog/hybrid-frontend-architecture/"
+		title="Гибридная архитектура фронтенда с Astro и Starlight"
+		description="Макси Феррейра и Бен Холмс создают сайт документации с помощью Starlight, TinaCMS и интерактивной площадки API Playground с аутентификацией."
+	/>
+	<LinkCard
+		href="https://www.olets.dev/posts/comparing-docs-site-builders-vuepress-vs-starlight/"
+		title="Сравнение конструкторов сайтов документаций: VuePress против Starlight"
+		description="Как соотносятся эти две системы?"
+	/>
+</CardGrid>
+
+## Рецепты и руководства
+
+Рецепты — это, как правило, короткие, целенаправленные руководства, которые помогают читателю выполнить конкретную задачу на рабочем примере. Это отличный способ добавить новые функции или поведение в проект Starlight, следуя пошаговым инструкциям! Другие руководства могут объяснять концепции, связанные с той или иной областью контента, например, использование изображений или работа с MDX.
+
+Изучите контент, созданный пользователями Starlight:
+
+<CardGrid>
+	<LinkCard
+		href="https://www.webpro.nl/scraps/versioned-docs-with-starlight-and-vercel"
+		title="Версионированная документация с помощью Starlight и Vercel"
+		description="Руководство по внедрению отдельных версий документации для каждой основной версии проекта"
+	/>
+	<LinkCard
+		href="https://hideoo.dev/notes/starlight-heading-links"
+		title="Добавление ссылок на рубрики Starlight"
+		description="Руководство по использованию плагина rehype для обмена ссылками на определенные разделы вашей документации"
+	/>
+	<LinkCard
+		href="https://blog.otterlord.dev/posts/starlight-sponsors/"
+		title="Добавление спонсоров на сайт Starlight"
+		description="Руководство по внедрению пользовательского компонента спонсора в боковую панель документации"
+	/>
+	<LinkCard
+		href="https://hideoo.dev/notes/starlight-og-images"
+		title="Добавление изображений Open Graph к Starlight"
+		description="Руководство по созданию социальных изображений и соответствующих метатегов для ваших страниц"
+	/>
+	<LinkCard
+		href="https://hideoo.dev/notes/starlight-third-party-icon-sets"
+		title="Использование сторонних наборов иконок в Starlight"
+		description="Руководство по использованию unplugin-icons для расширения выбора доступных иконок для Starlight"
+	/>
+	<LinkCard
+		href="https://hideoo.dev/notes/starlight-custom-html-head"
+		title="Редактирование HTML-заголовка страниц Starlight"
+		description="Узнайте, как добавлять дополнительные данные в head страницы: веб-аналитику, шрифты и скрипты"
+	/>
+	<LinkCard
+		href="https://dev.to/mrrobot/publishing-documentation-with-astro-starlight-691"
+		title="Публикация документации с помощью Astro Starlight"
+		description="Начало работы с документацией в Starlight"
+	/>
+
+</CardGrid>
+
+## Видеоконтент
+
+Откройте для себя видео и каналы с контентом Starlight, включая прямые трансляции и образовательный контент.
+
+import YouTubeGrid from '~/components/youtube-grid.astro';
+
+### Ролики об Astro
+
+<YouTubeGrid
+	videos={[
+		{
+			href: 'https://www.youtube.com/watch?v=5u0Ds7wzUeI',
+			title: 'Starlight от Astro',
+			description: 'Смотрите официальное видео запуска Starlight',
+		},
+		{
+			href: 'https://www.youtube.com/shorts/zjOWezSzd18',
+			title: '🌟 ЗАПУСК ЗА 1 МИНУТУ',
+			description: 'Посмотрите, как Бен запускает новый сайт Starlight менее чем за минуту!',
+		},
+	]}
+/>
+
+### Видеоролики и стримы сообщества
+
+<YouTubeGrid
+	videos={[
+		{
+			href: 'https://www.youtube.com/watch?v=sF6UcV3moZg',
+			title: 'Создание документов с помощью Starlight и Astro',
+			description:
+				'Посмотрите, как Крис и Алекс погружаются в Starlight с помощью CodingCat.dev',
+		},
+		{
+			href: 'https://www.youtube.com/watch?v=sWkkHbwDeQc',
+			title: 'Astro Starlight',
+			description: 'Знакомство со Starlight за одну минуту',
+		},
+		{
+			href: 'https://www.youtube.com/watch?v=-Ki-1E5gNCk',
+			title: 'Шаблон документации Astro Starlight (создавайте собственные документы для приложений!)',
+			description: 'Запустите новый сайт Starlight примерно за 5 минут',
+		},
+	]}
+/>
diff --git a/docs/src/content/docs/ru/resources/plugins.mdx b/docs/src/content/docs/ru/resources/plugins.mdx
new file mode 100644
index 00000000..92c26d24
--- /dev/null
+++ b/docs/src/content/docs/ru/resources/plugins.mdx
@@ -0,0 +1,95 @@
+---
+title: Плагины и интеграции
+description: Откройте для себя инструменты сообщества, такие как плагины и интеграции, которые расширяют возможности Starlight!
+sidebar:
+  order: 1
+---
+
+:::tip[Добавьте собственную работу!]
+Вы создали плагин или инструмент для Starlight?
+Откройте PR, добавив ссылку на эту страницу!
+:::
+
+## Плагины
+
+[Плагины](/ru/reference/plugins/) могут настраивать конфигурацию, пользовательский интерфейс и поведение Starlight, а также легко распространяться и использоваться повторно.
+Расширяйте свой сайт с помощью официальных плагинов, поддерживаемых командой Starlight, и плагинов сообщества, поддерживаемых пользователями Starlight.
+
+### Официальные плагины
+
+<CardGrid>
+	<LinkCard
+		href="/ru/guides/site-search/#algolia-docsearch"
+		title="Algolia DocSearch"
+		description="Замена Pagefind, провайдера поиска по умолчанию, на Algolia DocSearch."
+	/>
+</CardGrid>
+
+### Плагины сообщества
+
+<CardGrid>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-links-validator"
+		title="starlight-links-validator"
+		description="Поиск нерабочих ссылок на страницах Starlight."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-typedoc"
+		title="starlight-typedoc"
+		description="Генерация страниц Starlight из TypeScript с помощью TypeDoc."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-blog"
+		title="starlight-blog"
+		description="Добавление блога на сайт документации."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-openapi"
+		title="starlight-openapi"
+		description="Создание страниц документации на основе спецификаций OpenAPI/Swagger."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-obsidian"
+		title="starlight-obsidian"
+		description="Публикация хранилищ Obsidian на сайте Starlight."
+	/>
+	<LinkCard
+		href="https://astro-ghostcms.xyz/intro/starlight/install/"
+		title="starlight-ghostcms"
+		description="Добавление записей в блог GhostCMS вместе с документами Starlight."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-image-zoom"
+		title="starlight-image-zoom"
+		description="Добавление возможности масштабирования к изображениям вашей документации."
+	/>
+</CardGrid>
+
+## Инструменты и интеграции от сообщества
+
+import { CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+Эти инструменты и интеграции сообщества можно использовать для добавления функций на ваш сайт Starlight.
+
+<CardGrid>
+	<LinkCard
+		href="https://www.feelback.dev/blog/new-astro-starlight-integration/"
+		title="FeelBack"
+		description="Добавление системы обратной связи с пользователями на страницы ваших документов."
+	/>
+	<LinkCard
+		href="https://github.com/val-town/notion-to-astro"
+		title="notion-to-astro"
+		description="Преобразование экспорта Notion в документы Astro Starlight."
+	/>
+	<LinkCard
+		href="https://github.com/mattjennings/astro-live-code"
+		title="astro-live-code"
+		description="Отображение блоков кода MDX в виде интерактивных компонентов."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-i18n"
+		title="starlight-i18n"
+		description="Расширение Visual Studio Code для перевода страниц Starlight."
+	/>
+</CardGrid>
diff --git a/docs/src/content/docs/ru/resources/showcase.mdx b/docs/src/content/docs/ru/resources/showcase.mdx
new file mode 100644
index 00000000..5d0327cd
--- /dev/null
+++ b/docs/src/content/docs/ru/resources/showcase.mdx
@@ -0,0 +1,21 @@
+---
+title: Витрина Starlight
+description: Откройте для себя сайты, созданные с помощью Starlight!
+sidebar:
+  label: Витрина сайтов
+---
+
+:::tip[Добавьте свой собственный сайт!]
+Вы создали сайт с помощью Starlight?
+[Откройте PR](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md#showcase), добавив ссылку на эту страницу!
+:::
+
+## Сайты
+
+import ShowcaseSites from '~/components/showcase-sites.astro';
+
+Starlight уже используется в производстве. Вот некоторые из сайтов в Интернете:
+
+<ShowcaseSites />
+
+Посмотреть все [публичные репозитории проектов, использующих Starlight, на GitHub](https://github.com/withastro/starlight/network/dependents).
diff --git a/packages/starlight/translations/ru.json b/packages/starlight/translations/ru.json
index 345ed7bc..6fbc96c2 100644
--- a/packages/starlight/translations/ru.json
+++ b/packages/starlight/translations/ru.json
@@ -1,11 +1,11 @@
 {
-  "skipLink.label": "Пропустить до содержимого",
+  "skipLink.label": "Перейти к содержимому",
   "search.label": "Поиск",
-  "search.shortcutLabel": "(Нажмите / для Поиска)",
+  "search.shortcutLabel": "(Нажмите / для поиска)",
   "search.cancelLabel": "Отменить",
   "search.devWarning": "Поиск доступен только в производственных сборках. \nПопробуйте выполнить сборку и просмотреть сайт, чтобы протестировать его локально.",
   "themeSelect.accessibleLabel": "Выберите тему",
-  "themeSelect.dark": "Темная",
+  "themeSelect.dark": "Тёмная",
   "themeSelect.light": "Светлая",
   "themeSelect.auto": "Авто",
   "languageSelect.accessibleLabel": "Выберите язык",
@@ -18,10 +18,10 @@
   "page.lastUpdated": "Последнее обновление:",
   "page.previousLink": "Предыдущая",
   "page.nextLink": "Следующая",
-  "404.text": "Страница не найдена. Проверьтье  URL или используйте поиск по сайту",
+  "404.text": "Страница не найдена. Проверьте URL или используйте поиск по сайту.",
   "aside.note": "Заметка",
   "aside.tip": "Знали ли вы?",
   "aside.caution": "Осторожно",
   "aside.danger": "Опасно",
-  "fileTree.directory": "Directory"
+  "fileTree.directory": "Директория"
 }
author	Bugo	2024-04-01 17:24:46 +0500
committer	GitHub	2024-04-01 14:24:46 +0200
commit	a86f9b71b795fb6dcd0409ca568e43d25525b964 (patch)
tree	0cf56f878fd238325be01ef349482625194c6307
parent	953c56ed3f920de920ac2708e12f7f98409910f5 (diff)
download	IT.starlight-a86f9b71b795fb6dcd0409ca568e43d25525b964.tar.gz IT.starlight-a86f9b71b795fb6dcd0409ca568e43d25525b964.tar.bz2 IT.starlight-a86f9b71b795fb6dcd0409ca568e43d25525b964.zip