withastro · HiDeoo · May 2, 2024 · May 2, 2024 · May 2, 2024 · May 2, 2024
diff --git a/docs/src/content/docs/ru/getting-started.mdx b/docs/src/content/docs/ru/getting-started.mdx
@@ -15,7 +15,7 @@ Starlight — это полнофункциональная тема для до
 
 Вы можете создать новый проект на базе Astro + Starlight, используя следующую команду:
 
-<Tabs>
+<Tabs syncKey="pkg">
 <TabItem label="npm">
 
 ```sh
@@ -52,7 +52,7 @@ yarn create astro --template starlight
 
 Внутри каталога вашего проекта выполните следующую команду, чтобы запустить сервер разработки:
 
-<Tabs>
+<Tabs syncKey="pkg">
 <TabItem label="npm">
 
 ```sh
@@ -103,7 +103,7 @@ Starlight готов к созданию нового контента или к
 
 Starlight является интеграцией Astro и обновляется так же, как любая интеграция @astrojs/\*:
 
-<Tabs>
+<Tabs syncKey="pkg">
 <TabItem label="npm">
 
 ```sh
@@ -127,10 +127,9 @@ yarn dlx @astrojs/upgrade
 </TabItem>
 </Tabs>
 
-Вы можете увидеть полный список изменений, сделанных в каждом релизе,
-в [списке изменений Starlight](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md).
+Вы можете увидеть полный список изменений, сделанных в каждом релизе, в [списке изменений Starlight](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md).
 
-## Устранение проблем с Starlight
+## Устранение проблем со Starlight
 
 Используйте справочные страницы [конфигурация проекта](/ru/reference/configuration/) и [конфигурация метаданных отдельной страницы](/ru/reference/frontmatter/), чтобы убедиться, что ваш сайт Starlight настроен и работает правильно.
 См. руководства на боковой панели, чтобы получить помощь в добавлении контента и настройке вашего сайта Starlight.

diff --git a/docs/src/content/docs/ru/guides/components.mdx b/docs/src/content/docs/ru/guides/components.mdx
@@ -87,6 +87,50 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
 	</TabItem>
 </Tabs>
 
+#### Синхронизированные вкладки
+
+Синхронизируйте несколько групп вкладок, добавив атрибут `syncKey`.
+
+Все `<Tabs>` на странице с одинаковым значением `syncKey` будут отображать одну и ту же активную метку. Это позволяет вашему читателю выбрать один раз (например, операционную систему или менеджер пакетов) и увидеть, как его выбор отражается на всей странице.
+
+Чтобы синхронизировать связанные вкладки, добавьте идентичное свойство `syncKey` к каждому компоненту `<Tabs>` и убедитесь, что все они используют одни и те же метки `<TabItem>`:
+
+```mdx 'syncKey="constellations"'
+# src/content/docs/example.mdx
+
+import { Tabs, TabItem } from '@astrojs/starlight/components';
+
+_Некоторые звёзды:_
+
+<Tabs syncKey="constellations">
+	<TabItem label="Орион">Беллатрикс, Ригель, Бетельгейзе</TabItem>
+	<TabItem label="Близнецы">Поллукс, Кастор А, Кастор Б</TabItem>
+</Tabs>
+
+_Некоторые экзопланеты:_
+
+<Tabs syncKey="constellations">
+	<TabItem label="Орион">HD 34445 b, Gliese 179 b, Wasp-82 b</TabItem>
+	<TabItem label="Близнецы">Поллукс b, HAT-P-24b, HD 50554 b</TabItem>
+</Tabs>
+```
+
+Вышеуказанный код сформирует следующий HTML:
+
+_Некоторые звёзды:_
+
+<Tabs syncKey="constellations">
+	<TabItem label="Орион">Беллатрикс, Ригель, Бетельгейзе</TabItem>
+	<TabItem label="Близнецы">Поллукс, Кастор А, Кастор Б</TabItem>
+</Tabs>
+
+_Некоторые экзопланеты:_
+
+<Tabs syncKey="constellations">
+	<TabItem label="Орион">HD 34445 b, Gliese 179 b, Wasp-82 b</TabItem>
+	<TabItem label="Близнецы">Поллукс b, HAT-P-24b, HD 50554 b</TabItem>
+</Tabs>
+
 ### Карточки
 
 import { Card, CardGrid } from '@astrojs/starlight/components';
@@ -158,10 +202,7 @@ 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>
 ```
@@ -177,10 +218,7 @@ 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>
 

diff --git a/docs/src/content/docs/ru/guides/css-and-tailwind.mdx b/docs/src/content/docs/ru/guides/css-and-tailwind.mdx
@@ -63,7 +63,7 @@ Starlight предоставляет дополнительный плагин T
 
 Создайте новый проект Starlight с предварительно настроенным Tailwind CSS, используя `create astro`:
 
-<Tabs>
+ <Tabs syncKey="pkg">
 <TabItem label="npm">
 
 ```sh
@@ -95,7 +95,7 @@ yarn create astro --template starlight/tailwind
 
 1.  Добавьте интеграцию Tailwind от Astro:
 
-    <Tabs>
+    <Tabs syncKey="pkg">
 
     <TabItem label="npm">
 
@@ -125,7 +125,7 @@ yarn create astro --template starlight/tailwind
 
 2.  Установите плагин Tailwind для Starlight:
 
-    <Tabs>
+    <Tabs syncKey="pkg">
 
     <TabItem label="npm">
 
@@ -289,8 +289,7 @@ import ThemeDesigner from '~/components/theme-designer.astro';
 		CSS-файле](#ваши-css-стили), чтобы применить эту тему к вашему сайту.
 	</Fragment>
 	<Fragment slot="tailwind-docs">
-		Приведённый ниже пример [файла конфигурации
-		Tailwind](#стилизация-starlight-с-использованием-tailwind) включает
+		Приведённый ниже пример [файла конфигурации	Tailwind](#стилизация-starlight-с-использованием-tailwind) включает
 		сгенерированные палитры цветов `accent` и `gray` для использования в объекте
 		конфигурации `theme.extend.colors`.
 	</Fragment>

diff --git a/docs/src/content/docs/ru/guides/customization.mdx b/docs/src/content/docs/ru/guides/customization.mdx
@@ -130,7 +130,7 @@ Starlight отображает оглавление на каждой стран
 
 По умолчанию заголовки `<h2>` и `<h3>` включены в оглавление. Укажите уровни заголовков, которые нужно включить на всем сайте, с помощью параметров `minHeadingLevel` и `maxHeadingLevel`, в [`tableOfContents`](/ru/reference/configuration/#tableofcontents). Переопределите эти значения для отдельных страниц, добавив свойства в [метаданные `tableOfContents`](/ru/reference/frontmatter/#tableofcontents):
 
-<Tabs>
+<Tabs syncKey="config-type">
   <TabItem label="Метаданные">
 
 ```md {4-6}
@@ -164,7 +164,7 @@ defineConfig({
 
 Чтобы полностью отключить оглавление, установите параметр `tableOfContents` в значение `false`:
 
-<Tabs>
+<Tabs syncKey="config-type">
   <TabItem label="Метаданные">
 
 ```md {4}

diff --git a/docs/src/content/docs/ru/guides/i18n.mdx b/docs/src/content/docs/ru/guides/i18n.mdx
@@ -13,7 +13,7 @@ Starlight обеспечивает встроенную поддержку мн
 
 1. Сообщите Starlight о поддерживаемых вами языках, передав свойства [`locales`](/ru/reference/configuration/#locales) и [`defaultLocale`](/ru/reference/configuration/#defaultlocale) в интеграцию Starlight:
 
-   ```js {9-31}
+   ```js {9-26}
    // astro.config.mjs
    import { defineConfig } from 'astro/config';
    import starlight from '@astrojs/starlight';
@@ -34,11 +34,6 @@ Starlight обеспечивает встроенную поддержку мн
    					label: '简体中文',
    					lang: 'zh-CN',
    				},
-   				// Документация на арабском в `src/content/docs/ar/`
-   				ar: {
-   					label: 'العربية',
-   					dir: 'rtl',
-   				},
    				// Документация на русском в `src/content/docs/ru/`
    				ru: {
    					label: 'Русский',
@@ -60,15 +55,15 @@ Starlight обеспечивает встроенную поддержку мн
    - src/
      - content/
        - docs/
-         - ar/
          - en/
          - ru/
+         - zh-cn/
 
    </FileTree>
 
 3. Теперь вы можете добавлять контент в свои языковые каталоги. Используйте одно и то же имя файла для связывания страниц на разных языках и воспользуйтесь полным набором функций i18n Starlight, включая резервный контент, уведомления о переводе и многое другое.
 
-   Например, создайте `ar/index.md` и `en/index.md` для отображения главной страницы на арабском и английском языках.
+   Например, создайте `ru/index.md` и `en/index.md` для отображения главной страницы на русском и английском языках.
 
 </Steps>
 
@@ -91,7 +86,7 @@ export default defineConfig({
 			locales: {
 				root: {
 					label: 'Русский',
-					lang: 'ru', // lang обязателен для корневых локалей.
+					lang: 'ru', // параметр lang обязателен для корневых локалей
 				},
 				en: {
 					label: 'English',
@@ -148,16 +143,42 @@ Starlight предполагает, что вы создадите эквива
 
 Если перевод для языка ещё не доступен, Starlight покажет читателям контент этой страницы на языке по умолчанию (установленном через `defaultLocale`). Например, если вы ещё не создали французскую версию вашей страницы «О нас» и вашим языком по умолчанию является английский, посетители `/fr/about` увидят английский контент из `/en/about` с уведомлением о том, что эта страница ещё не была переведена. Это помогает вам добавлять контент на вашем языке по умолчанию и постепенно переводить его, когда у ваших переводчиков есть время.
 
+## Перевод заголовка сайта
+
+По умолчанию Starlight использует одно и то же название сайта для всех языков.
+Если вам нужно настроить заголовок для каждой локали, вы можете передать объект [`title`](/ru/reference/configuration/#title-обязателен) в опциях Starlight:
+
+```diff lang="js"
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+export default defineConfig({
+  integrations: [
+    starlight({
+-     title: 'Моя документация',
++     title: {
++       ru: "Моя документация",
++       'zh-CN': '我的文档',
++     },
+      defaultLocale: 'ru',
+      locales: {
+        ru: { label: 'Русский' },
+        'zh-cn': { label: '简体中文', lang: 'zh-CN' },
+      },
+    }),
+  ],
+});
+```
+
 ## Перевод интерфейса Starlight
 
 import LanguagesList from '~/components/languages-list.astro';
 import UIStringsList from '~/components/ui-strings-list.astro';
 
 Кроме размещения переведённых файлов с контентом, Starlight позволяет вам переводить текст интерфейсе (например, заголовок «На этой странице» в оглавлении), чтобы ваши читатели могли полностью погрузиться в ваш сайт на выбранном языке.
 
-<LanguagesList startsSentence /> — все переведённые строки пользовательского интерфейса
-на указанных языках предоставляются «из коробки», и мы приветствуем [вклад в добавление
-дополнительных языков по умолчанию](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
+<LanguagesList startsSentence /> — все переведённые строки пользовательского интерфейса на указанных языках предоставляются «из коробки», и мы приветствуем [вклад в добавление дополнительных языков по умолчанию](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
 
 Вы можете добавить переводы для дополнительных языков, которые вы поддерживаете — или переопределить наши стандартные тексты — через коллекцию данных `i18n`.
 

diff --git a/docs/src/content/docs/ru/guides/pages.mdx b/docs/src/content/docs/ru/guides/pages.mdx
@@ -103,8 +103,9 @@ import CustomComponent from './CustomComponent.astro';
 Следующие свойства отличаются от метаданных Markdown:
 
 - Свойство [`slug`](/ru/reference/frontmatter/#slug) не поддерживается и устанавливается автоматически на основе URL-адреса пользовательской страницы.
-- Для свойства [`editUrl`](/ru/reference/frontmatter/#editurl) требуется URL-адрес для отображения ссылки на редактирование.
+- Свойство [`editUrl`](/ru/reference/frontmatter/#editurl) требует указания URL-адреса для отображения ссылки на редактирование.
 - Свойство [`sidebar`](/ru/reference/frontmatter/#sidebar) для настройки отображения страницы в [автогенерируемых группах ссылок](/ru/reference/configuration/#sidebar) недоступно. Страницы, использующие компонент `<StarlightPage />`, не являются частью коллекции и не могут быть добавлены в автоматически созданную группу боковой панели.
+- Свойство [`draft`](/ru/reference/frontmatter/#draft) лишь отображает [уведомление](/ru/reference/overrides/#draftcontentnotice) о том, что страница является черновиком, но не исключает её автоматически из производственных сборок.
 
 ##### `sidebar`
 

diff --git a/docs/src/content/docs/ru/reference/configuration.mdx b/docs/src/content/docs/ru/reference/configuration.mdx
@@ -23,12 +23,24 @@ export default defineConfig({
 
 Вы можете передать следующие параметры интеграции `starlight`.
 
-### `title` (обязательно)
+### `title` (обязателен)
 
-**тип:** `string`
+**тип:** `string | Record<string, string>`
 
 Задайте название для вашего сайта. Будет использоваться в метаданных и в заголовке вкладки браузера.
 
+Значение может быть строкой, а для многоязычных сайтов — объектом со значениями для каждой локали.
+При использовании объектной формы ключи должны быть тегами BCP-47 (например, `en`, `ru` или `zh-CN`):
+
+```ts
+starlight({
+	title: {
+		en: 'My delightful docs site',
+		ru: 'Моя восхитительная документация',
+	},
+});
+```
+
 ### `description`
 
 **тип:** `string`

diff --git a/docs/src/content/docs/ru/reference/frontmatter.md b/docs/src/content/docs/ru/reference/frontmatter.md
@@ -268,6 +268,21 @@ pagefind: false
 ---
 ```
 
+### `draft`
+
+**тип:** `boolean`  
+**по умолчанию:** `false`
+
+Установите, следует ли считать эту страницу черновиком и не включать её в [производственные сборки](https://docs.astro.build/ru/reference/cli-reference/#astro-build) и [группы автогенерируемых ссылок](/ru/guides/sidebar/#автогенерируемые-группы). Установите значение `true`, чтобы пометить страницу как черновик и сделать её видимой только во время разработки.
+
+```md
+---
+# src/content/docs/example.md
+# Исключить эту страницу из производственных сборок
+draft: true
+---
+```
+
 ### `sidebar`
 
 **тип:** [`SidebarConfig`](#sidebarconfig)

diff --git a/docs/src/content/docs/ru/reference/overrides.md b/docs/src/content/docs/ru/reference/overrides.md
@@ -50,6 +50,12 @@ Starlight будет передавать следующие параметры
 
 Базовый путь, по которому обслуживается язык. `undefined` для слагов корневой локали.
 
+#### `siteTitle`
+
+**тип:** `string`
+
+Название сайта для локали этой страницы.
+
 #### `slug`
 
 **тип:** `string`
@@ -218,7 +224,7 @@ entry: {
 **Стандартный компонент:** [`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-1), [`<Search />`](#search), [`<SocialIcons />`](#socialicons), [`<ThemeSelect />`](#themeselect), и [`<LanguageSelect />`](#languageselect).
 
 #### `SiteTitle`
 
@@ -332,6 +338,12 @@ entry: {
 
 Реализации должны обеспечить установку `id="_top"` для элемента `<h1>`, как в реализации по умолчанию.
 
+#### `DraftContentNotice`
+
+**Стандартный компонент:** [`DraftContentNotice.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/DraftContentNotice.astro)
+
+Уведомление, отображаемое пользователям во время разработки, когда текущая страница помечена как черновик.
+
 #### `FallbackContentNotice`
 
 **Стандартный компонент:** [`FallbackContentNotice.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/FallbackContentNotice.astro)