From 7be9f2d72c80841e891b0a1bb1e7e07518db6155 Mon Sep 17 00:00:00 2001 From: Bugo Date: Sun, 1 Dec 2024 15:57:10 +0500 Subject: i18n(ru): update some translations (#2643) --- .../content/docs/ru/guides/overriding-components.mdx | 17 +++++++++++++++++ docs/src/content/docs/ru/guides/pages.mdx | 2 +- docs/src/content/docs/ru/guides/site-search.mdx | 9 +++++++++ docs/src/content/docs/ru/reference/frontmatter.md | 4 ++-- docs/src/content/docs/ru/reference/overrides.md | 2 ++ docs/src/content/docs/ru/resources/plugins.mdx | 10 ++++++++++ 6 files changed, 41 insertions(+), 3 deletions(-) diff --git a/docs/src/content/docs/ru/guides/overriding-components.mdx b/docs/src/content/docs/ru/guides/overriding-components.mdx index 7ca87e5c..e54b02f6 100644 --- a/docs/src/content/docs/ru/guides/overriding-components.mdx +++ b/docs/src/content/docs/ru/guides/overriding-components.mdx @@ -88,6 +88,23 @@ import Default from '@astrojs/starlight/components/SocialIcons.astro'; - Передайте в него `Astro.props`. Это гарантирует, что он получит все данные, необходимые для отображения. - Добавьте [``](https://docs.astro.build/ru/core-concepts/astro-components/#slots) внутрь компонента по умолчанию. Это гарантирует, что если компоненту передаются какие-либо дочерние элементы, Astro знает, где их отображать. +Если вы повторно используете компоненты [`PageFrame`](/ru/reference/overrides/#pageframe) или [`TwoColumnContent`](/ru/reference/overrides/#twocolumncontent), содержащие [именованные слоты](https://docs.astro.build/ru/basics/astro-components/#именованые-слоты), вам также необходимо [перенести](https://docs.astro.build/ru/basics/astro-components/#перенос-слотов) эти слоты. + +Ниже показан пользовательский компонент, который повторно использует компонент `TwoColumnContent`, содержащий дополнительный именованный слот `right-sidebar`, нуждающийся в переносе: + +```astro {9} +--- +// src/components/CustomContent.astro +import type { Props } from '@astrojs/starlight/props'; +import Default from '@astrojs/starlight/components/TwoColumnContent.astro'; +--- + + + + + +``` + ## Использование данных страницы При переопределении компонента Starlight ваша реализация получает стандартный объект `Astro.props`, содержащий все данные для текущей страницы. diff --git a/docs/src/content/docs/ru/guides/pages.mdx b/docs/src/content/docs/ru/guides/pages.mdx index d2b2b16a..19d35f57 100644 --- a/docs/src/content/docs/ru/guides/pages.mdx +++ b/docs/src/content/docs/ru/guides/pages.mdx @@ -105,7 +105,7 @@ import CustomComponent from './CustomComponent.astro'; - Свойство [`slug`](/ru/reference/frontmatter/#slug) не поддерживается и устанавливается автоматически на основе URL-адреса пользовательской страницы. - Свойство [`editUrl`](/ru/reference/frontmatter/#editurl) требует указания URL-адреса для отображения ссылки на редактирование. - Свойство [`sidebar`](/ru/reference/frontmatter/#sidebar) для настройки отображения страницы в [автогенерируемых группах ссылок](/ru/reference/configuration/#sidebar) недоступно. Страницы, использующие компонент ``, не являются частью коллекции и не могут быть добавлены в автоматически созданную группу боковой панели. -- Свойство [`draft`](/ru/reference/frontmatter/#draft) лишь отображает [уведомление](/ru/reference/overrides/#draftcontentnotice) о том, что страница является черновиком, но не исключает её автоматически из производственных сборок. +- Свойство [`draft`](/ru/reference/frontmatter/#draft) лишь отображает [уведомление](/ru/reference/overrides/#draftcontentnotice) о том, что страница является черновиком, но не исключает её автоматически из продакшен-сборок. ##### `sidebar` diff --git a/docs/src/content/docs/ru/guides/site-search.mdx b/docs/src/content/docs/ru/guides/site-search.mdx index ee59a477..c07e8d05 100644 --- a/docs/src/content/docs/ru/guides/site-search.mdx +++ b/docs/src/content/docs/ru/guides/site-search.mdx @@ -108,6 +108,15 @@ title: Частично проиндексированная страница С этой обновлённой конфигурацией строка поиска на вашем сайте теперь будет открывать модальное окно Algolia вместо стандартного модального окна поиска. +#### Конфигурация DocSearch + +Плагин Starlight DocSearch также поддерживает настройку компонента DocSearch с помощью следующих дополнительных опций: + +- `maxResultsPerGroup`: Ограничивает количество результатов, отображаемых для каждой группы поиска. По умолчанию `5`. +- `disableUserPersonalization`: Предотвращает сохранение недавних поисков и избранных элементов пользователя в локальном хранилище. По умолчанию `false`. +- `insights`: Включает плагин Algolia Insights и отправляет события поиска в ваш индекс DocSearch. По умолчанию `false`. +- `searchParameters`: Объект, настраивающий [параметры поиска Algolia](https://www.algolia.com/doc/api-reference/search-api-parameters/). + #### Перевод пользовательского интерфейса DocSearch По умолчанию DocSearch предоставляет только английские строки пользовательского интерфейса. diff --git a/docs/src/content/docs/ru/reference/frontmatter.md b/docs/src/content/docs/ru/reference/frontmatter.md index 983a7d13..78ce5307 100644 --- a/docs/src/content/docs/ru/reference/frontmatter.md +++ b/docs/src/content/docs/ru/reference/frontmatter.md @@ -273,12 +273,12 @@ pagefind: false **тип:** `boolean` **по умолчанию:** `false` -Установите, следует ли считать эту страницу черновиком и не включать её в [производственные сборки](https://docs.astro.build/ru/reference/cli-reference/#astro-build) и [группы автогенерируемых ссылок](/ru/guides/sidebar/#автогенерируемые-группы). Установите значение `true`, чтобы пометить страницу как черновик и сделать её видимой только во время разработки. +Установите, следует ли считать эту страницу черновиком и не включать её в [продакшен-сборки](https://docs.astro.build/ru/reference/cli-reference/#astro-build) и [группы автогенерируемых ссылок](/ru/guides/sidebar/#автогенерируемые-группы). Установите значение `true`, чтобы пометить страницу как черновик и сделать её видимой только во время разработки. ```md --- # src/content/docs/example.md -# Исключить эту страницу из производственных сборок +# Исключить эту страницу из продакшен-сборок draft: true --- ``` diff --git a/docs/src/content/docs/ru/reference/overrides.md b/docs/src/content/docs/ru/reference/overrides.md index 8fa08324..e0d7ee69 100644 --- a/docs/src/content/docs/ru/reference/overrides.md +++ b/docs/src/content/docs/ru/reference/overrides.md @@ -196,6 +196,7 @@ entry: { #### `PageFrame` **Стандартный компонент:** [`PageFrame.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/PageFrame.astro) +**Именованные слоты:** `header`, `sidebar` Компонент макета оборачивается вокруг большей части содержимого страницы. Реализация по умолчанию устанавливает макет header-sidebar-main и включает в себя именованные слоты `header` и `sidebar`, а также слот по умолчанию для основного содержимого. @@ -210,6 +211,7 @@ entry: { #### `TwoColumnContent` **Стандартный компонент:** [`TwoColumnContent.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/TwoColumnContent.astro) +**Именованный слот:** `right-sidebar` Компонент макета оборачивается вокруг колонки с основным содержанием и правой боковой панели (оглавление). Реализация по умолчанию управляет переключением между одноколоночным макетом с малой областью просмотра и двухколоночным макетом с большей областью просмотра. diff --git a/docs/src/content/docs/ru/resources/plugins.mdx b/docs/src/content/docs/ru/resources/plugins.mdx index f7057460..14dbb11c 100644 --- a/docs/src/content/docs/ru/resources/plugins.mdx +++ b/docs/src/content/docs/ru/resources/plugins.mdx @@ -103,6 +103,16 @@ sidebar: title="starlight-sidebar-topics-dropdown" description="Разделение страницы с документами на несколько подстраниц и переключение между ними с помощью выпадающего меню в боковой панели." /> + + ### Темы от сообщества -- cgit