` — нет:
+
+```md title="src/content/docs/partially-indexed.md" ins="data-pagefind-ignore"
+---
+title: Частично проиндексированная страница
+---
+
+Этот текст можно будет найти с помощью поиска.
+
+
+
+Этот текст будет скрыт от поиска.
+
+
+```
+
+## Альтернативные поставщики услуг поиска
+
+### Algolia DocSearch
+
+Если у вас есть доступ к [программе DocSearch от Algolia](https://docsearch.algolia.com/) и вы хотите использовать её вместо Pagefind, вы можете воспользоваться официальным плагином Starlight DocSearch.
+
+
+
+1. Установите `@astrojs/starlight-docsearch`:
+
+
+
+
+
+ ```sh
+ npm install @astrojs/starlight-docsearch
+ ```
+
+
+
+
+
+ ```sh
+ pnpm add @astrojs/starlight-docsearch
+ ```
+
+
+
+
+
+ ```sh
+ yarn add @astrojs/starlight-docsearch
+ ```
+
+
+
+
+
+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',
+ }),
+ ],
+ }),
+ ],
+ });
+ ```
+
+
+
+С этой обновлённой конфигурацией строка поиска на вашем сайте теперь будет открывать модальное окно Algolia вместо стандартного модального окна поиска.
+
+#### Перевод пользовательского интерфейса DocSearch
+
+По умолчанию DocSearch предоставляет только английские строки пользовательского интерфейса.
+Добавьте перевод модального пользовательского интерфейса для вашего языка, используя встроенную [систему интернационализации](/ru/guides/i18n/#перевод-интерфейса-starlight) Starlight.
+
+
+
+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."
+ }
+ ```
+
+
\ 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 8d449cdd7f4..acabea05e6d 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';
Включает в себя: навигацию по сайту, поиск, интернационализацию, оптимизацию
- для поисковых систем (SEO), удобную типографику, подсветку кода, ночной
+ для поисковых систем (SEO), удобную типографику, подсветку кода, тёмный
режим и многое другое.
Воспользуйтесь всей мощью и производительностью Astro. Расширьте Starlight с
вашими любимыми интеграциями и библиотеками Astro.
-
+
Используйте свой любимый язык разметки. Starlight предоставляет встроенную
проверку метаданных с поддержкой TypeScript для обеспечения
типобезопасности.
@@ -46,10 +48,112 @@ import AboutAstro from '~/components/about-astro.astro';
+
+
+ Команда Astro РАЗВИВАЛА способы создания документации, и вы можете получить всё это прямо из коробки с их проектом Starlight.
+
+
+ Официальный стартовый комплект Astro Starlight — поистине невероятный инструмент для создания веб-сайта документации.
+
+
+ Starlight — наш лучший пример отличного DX: скорость, удобство и
+ внимание к деталям вдохновляет. Он заботится о технологиях и внешнем виде,
+ чтобы вы могли сосредоточиться на своем контенте 👏
+
+ Команде StackBlitz это очень нравится!
+
+
+ Starlight изменил правила игры для меня, позволив мне сосредоточиться на создании контента.
+
+ Его интуитивно понятный дизайн не только оптимизирует мой рабочий процесс, но и сокращает время адаптации для разработчиков ПО с открытым исходным кодом.
+
+
+ Потратил ещё немного времени на Starlight для документации Course Builder, и до сих пор всё было отлично. Множество приятных мелочей и возможность сосредоточиться на написании в Markdown, а не на возне с сайтом.
+
+
+ Начал играть со Starlight. Должен сказать, что я очень впечатлен производительностью «из коробки».
+
+ 💯💯💯💯
+
+
+ Starlight — лучший способ начать работу с документацией:
+ мощь и скорость Astro и инструменты Starlight — это идеальное сочетание.
+
+ Я уже давно это делаю и продолжаю любить!
+
+
+ Я использовала Starlight на своей последней работе, и мне он понравился. Отличные компоненты, интуитивно понятный
+ дизайн и сверхотзывчивое сообщество (всякий раз, когда кому-то что-то нужно,
+ они очень быстро направят его в нужном направлении или подскажут обходной путь). Очень приятный опыт.
+
+
+ Документы на моем сайте монорепозитория выглядят лучше, чем когда-либо, благодаря Starlight. Его чрезвычайно легко использовать, не теряя при этом всей мощи Astro. Спасибо за работу над этим!
+
+
+ Starlight — мой любимый инструмент для документирования. Благодаря этому стало очень легко добавлять документы на мой существующий веб-сайт продукта Astro, вместо того, чтобы использовать поддомен с другим инструментом.
+
+
+ Я перестраивал документацию платформы WPEngine Atlas. Поверьте мне, когда я говорю, что у Starlight есть всё необходимое для создания платформы документации A+ 🙌
+
+
+ Попробуйте Starlight!
+
+ Я использую его для нескольких своих сайтов, и это здорово.
+
+
+
-Astro - это универсальный веб-фреймворк, разработанный для максимальной производительности.
-Используйте контент из любых источников и развертывайте его везде, используя ваши любимые UI компоненты и библиотеки.
+Astro — универсальный веб-фреймворк, разработанный для максимальной производительности.
+Используйте контент из любых источников и развёртывайте его везде, используя ваши любимые UI компоненты и библиотеки.
-[Узнать больше о Astro](https://astro.build/)
+[Узнать больше об Astro](https://astro.build/)
diff --git a/docs/src/content/docs/ru/manual-setup.mdx b/docs/src/content/docs/ru/manual-setup.mdx
index f4214a7d6b2..7a393b02f4b 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` в корневой директории вашего проекта:
@@ -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 00000000000..e957b073349
--- /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`
+
+Задайте описание для вашего сайта. Используется в метаданных, передаваемых поисковым системам, в теге ``, если `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; }`
+
+Настройте оглавление, отображаемое справа на каждой странице. По умолчанию в оглавление будут включены заголовки `` и ``.
+
+### `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;
+ badge?: string | BadgeConfig;
+} & (
+ | {
+ link: string;
+ attrs?: Record;
+ }
+ | { 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`
+
+**тип:** \{ \[dir: string\]: [LocaleConfig](#localeconfig) \}
+
+[Настройте интернационализацию (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';
+
+**тип:**
+
+Дополнительные сведения об аккаунтах в социальных сетях для этого сайта. При добавлении любого из них они будут отображаться в виде ссылок-иконок в шапке сайта.
+
+```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`
+**по умолчанию:** `['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)
+
+Добавьте пользовательские теги в `` вашего сайта 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;
+ 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>` вида `Заголовок страницы | Заголовок сайта`.
+Например, эта страница называется «Конфигурация», а этот сайт — «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 00000000000..f61b1232378
--- /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 00000000000..a68a2d35ee6
--- /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 00000000000..4b95c3bef98
--- /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 00000000000..fb89db8c432
--- /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 00000000000..92c26d24d56
--- /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 00000000000..5d0327cde0c
--- /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 345ed7bc636..6fbc96c2cde 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": "Директория"
}