Skip to content

Commit

Permalink
i18n(ru): update some translations (#2643)
Browse files Browse the repository at this point in the history
  • Loading branch information
dragomano authored Dec 1, 2024
1 parent dc481ae commit 7be9f2d
Show file tree
Hide file tree
Showing 6 changed files with 41 additions and 3 deletions.
17 changes: 17 additions & 0 deletions docs/src/content/docs/ru/guides/overriding-components.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,23 @@ import Default from '@astrojs/starlight/components/SocialIcons.astro';
- Передайте в него `Astro.props`. Это гарантирует, что он получит все данные, необходимые для отображения.
- Добавьте [`<slot />`](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';
---
<Default {...Astro.props}>
<slot />
<slot name="right-sidebar" slot="right-sidebar" />
</Default>
```

## Использование данных страницы

При переопределении компонента Starlight ваша реализация получает стандартный объект `Astro.props`, содержащий все данные для текущей страницы.
Expand Down
2 changes: 1 addition & 1 deletion docs/src/content/docs/ru/guides/pages.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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) недоступно. Страницы, использующие компонент `<StarlightPage />`, не являются частью коллекции и не могут быть добавлены в автоматически созданную группу боковой панели.
- Свойство [`draft`](/ru/reference/frontmatter/#draft) лишь отображает [уведомление](/ru/reference/overrides/#draftcontentnotice) о том, что страница является черновиком, но не исключает её автоматически из производственных сборок.
- Свойство [`draft`](/ru/reference/frontmatter/#draft) лишь отображает [уведомление](/ru/reference/overrides/#draftcontentnotice) о том, что страница является черновиком, но не исключает её автоматически из продакшен-сборок.

##### `sidebar`

Expand Down
9 changes: 9 additions & 0 deletions docs/src/content/docs/ru/guides/site-search.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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 предоставляет только английские строки пользовательского интерфейса.
Expand Down
4 changes: 2 additions & 2 deletions docs/src/content/docs/ru/reference/frontmatter.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
```
Expand Down
2 changes: 2 additions & 0 deletions docs/src/content/docs/ru/reference/overrides.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`, а также слот по умолчанию для основного содержимого.
Expand All @@ -210,6 +211,7 @@ entry: {
#### `TwoColumnContent`

**Стандартный компонент:** [`TwoColumnContent.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/TwoColumnContent.astro)
**Именованный слот:** `right-sidebar`

Компонент макета оборачивается вокруг колонки с основным содержанием и правой боковой панели (оглавление).
Реализация по умолчанию управляет переключением между одноколоночным макетом с малой областью просмотра и двухколоночным макетом с большей областью просмотра.
Expand Down
10 changes: 10 additions & 0 deletions docs/src/content/docs/ru/resources/plugins.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -103,6 +103,16 @@ sidebar:
title="starlight-sidebar-topics-dropdown"
description="Разделение страницы с документами на несколько подстраниц и переключение между ними с помощью выпадающего меню в боковой панели."
/>
<LinkCard
href="https://github.com/trueberryless-org/starlight-cooler-credit"
title="starlight-cooler-credit"
description="Добавление красивой благодарности Starlight или Astro в нижней части оглавления."
/>
<LinkCard
href="https://github.com/trueberryless-org/starlight-contributor-list"
title="starlight-contributor-list"
description="Отображает список всех контрибьюторов вашего проекта."
/>
</CardGrid>

### Темы от сообщества
Expand Down

0 comments on commit 7be9f2d

Please sign in to comment.