Skip to content

Commit

Permalink
i18n(ru): update translations (#2695)
Browse files Browse the repository at this point in the history
Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
  • Loading branch information
dragomano and HiDeoo authored Dec 14, 2024
1 parent 786b171 commit 2c3a4ad
Show file tree
Hide file tree
Showing 12 changed files with 66 additions and 53 deletions.
4 changes: 2 additions & 2 deletions docs/src/content/docs/ru/components/using-components.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ sidebar:
Примерами могут служить карточки-ссылки или встраиваемые ролики YouTube.
Starlight поддерживает использование компонентов в файлах [MDX](https://mdxjs.com/) и [Markdoc](https://markdoc.dev/), а также предоставляет некоторые общие компоненты для применения.

[Узнайте больше о создании компонентов в документации Astro](https://docs.astro.build/ru/core-concepts/astro-components/).
[Узнайте больше о создании компонентов в документации Astro](https://docs.astro.build/ru/basics/astro-components/).

## Использование компонента в MDX

Expand All @@ -30,7 +30,7 @@ import CustomCard from '../../components/CustomCard.astro';
<CustomCard>Компоненты могут содержать **вложенное содержимое**.</CustomCard>
```

Поскольку Starlight работает на базе Astro, вы можете использовать в своих файлах MDX любые компоненты, созданные на [поддерживаемом UI-фреймворке (React, Preact, Svelte, Vue, Solid и Alpine)](https://docs.astro.build/ru/core-concepts/framework-components/).
Поскольку Starlight работает на базе Astro, вы можете использовать в своих файлах MDX любые компоненты, созданные на [поддерживаемом UI-фреймворке (React, Preact, Svelte, Vue, Solid и Alpine)](https://docs.astro.build/ru/guides/framework-components/).
Узнайте больше об [использовании компонентов в MDX](https://docs.astro.build/ru/guides/integrations-guide/mdx/#using-components-in-mdx) в документации Astro.

## Использование компонента в Markdoc
Expand Down
2 changes: 1 addition & 1 deletion docs/src/content/docs/ru/environmental-impact.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,6 +137,6 @@ Cache-Control: public, max-age=604800, immutable
[sf]: https://www.sciencefocus.com/science/what-is-the-carbon-footprint-of-the-internet/
[bbc]: https://www.bbc.com/future/article/20200305-why-your-internet-habits-are-not-as-clean-as-you-think
[http]: https://httparchive.org/reports/state-of-the-web
[assets]: https://docs.astro.build/ru/guides/assets/
[assets]: https://docs.astro.build/ru/guides/images/
[islands]: https://docs.astro.build/ru/concepts/islands/
[wcc]: https://www.websitecarbon.com/
2 changes: 1 addition & 1 deletion docs/src/content/docs/ru/guides/authoring-content.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ title: Заголовок страницы

## Изображения

Изображения в Starlight используют [встроенную оптимизацию ресурсов Astro](https://docs.astro.build/ru/guides/assets/).
Изображения в Starlight используют [встроенную оптимизацию ресурсов Astro](https://docs.astro.build/ru/guides/images/).

Markdown и MDX поддерживают синтаксис Markdown для отображения изображений, который включает альтернативный текст для экранных читателей и вспомогательных технологий.

Expand Down
19 changes: 10 additions & 9 deletions docs/src/content/docs/ru/guides/i18n.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -189,16 +189,16 @@ import UIStringsList from '~/components/ui-strings-list.astro';

<Steps>

1. Сконфигурируйте коллекцию данных `i18n` в `src/content/config.ts`, если она ещё не настроена:
1. Сконфигурируйте коллекцию данных `i18n` в `src/content.config.ts`, если она ещё не настроена:

```diff lang="js" ins=/, (i18nSchema)/
// src/content/config.ts
import { defineCollection } from 'astro:content';
```diff lang="js" ins=/, (i18nLoader|i18nSchema)/
// src/content.config.ts
import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';

export const collections = {
docs: defineCollection({ schema: docsSchema() }),
+ i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+ i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }),
};
```

Expand Down Expand Up @@ -258,14 +258,15 @@ import UIStringsList from '~/components/ui-strings-list.astro';
В следующем примере к ключам по умолчанию добавляется новый необязательный ключ `custom.label`:

```diff lang="js"
// src/content/config.ts
// src/content.config.ts
import { defineCollection, z } from 'astro:content';
import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';

export const collections = {
docs: defineCollection({ schema: docsSchema() }),
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
i18n: defineCollection({
type: 'data',
loader: i18nLoader(),
schema: i18nSchema({
+ extend: z.object({
+ 'custom.label': z.string().optional(),
Expand Down
4 changes: 2 additions & 2 deletions docs/src/content/docs/ru/guides/overriding-components.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ import Default from '@astrojs/starlight/components/SocialIcons.astro';
При использовании встроенного компонента внутри вашего компонента:

- Передайте в него `Astro.props`. Это гарантирует, что он получит все данные, необходимые для отображения.
- Добавьте [`<slot />`](https://docs.astro.build/ru/core-concepts/astro-components/#slots) внутрь компонента по умолчанию. Это гарантирует, что если компоненту передаются какие-либо дочерние элементы, Astro знает, где их отображать.
- Добавьте [`<slot />`](https://docs.astro.build/ru/basics/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/#перенос-слотов) эти слоты.

Expand Down Expand Up @@ -157,4 +157,4 @@ const isHomepage = Astro.props.slug === '';
}
```

Узнайте больше об условной отрисовке в руководстве [Синтаксис Astro](https://docs.astro.build/ru/core-concepts/astro-syntax/#динамический-html).
Узнайте больше об условной отрисовке в руководстве [Синтаксис Astro](https://docs.astro.build/ru/basics/astro-syntax/#динамический-html).
7 changes: 3 additions & 4 deletions docs/src/content/docs/ru/guides/project-structure.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ description: Узнайте, как организовать файлы в ва

Это руководство покажет вам, как организован проект Starlight и какую роль выполняют различные файлы в вашем проекте.

Проекты Starlight, как правило, следуют той же структуре файлов и каталогов, что и другие проекты Astro. Подробнее смотрите в [документации по структуре проекта Astro](https://docs.astro.build/ru/core-concepts/project-structure/).
Проекты Starlight, как правило, следуют той же структуре файлов и каталогов, что и другие проекты Astro. Подробнее смотрите в [документации по структуре проекта Astro](https://docs.astro.build/ru/basics/project-structure/).

## Файлы и папки

- `astro.config.mjs` — Файл конфигурации Astro; включает интеграцию и конфигурацию Starlight.
- `src/content/config.ts` — Файл конфигурации коллекций контента; добавляет метаданные (frontmatter) от Starlight в ваш проект.
- `src/content.config.ts` — Файл конфигурации коллекций контента; добавляет метаданные (frontmatter) от Starlight в ваш проект.
- `src/content/docs/` — Файлы контента. Starlight преобразует каждый файл `.md`, `.mdx` или `.mdoc` в этом каталоге в страницу на вашем сайте.
- `src/content/i18n/` (по необходимости) — Данные перевода для поддержки [интернационализации](/ru/guides/i18n/).
- `src/` — Другой исходный код и файлы (компоненты, стили, изображения и т. д.) для вашего проекта.
Expand Down Expand Up @@ -39,8 +39,7 @@ import { FileTree } from '@astrojs/starlight/components';
- 01-getting-started.md
- 02-advanced.md
- index.mdx
- config.ts
- env.d.ts
- content.config.ts
- astro.config.mjs
- package.json
- tsconfig.json
Expand Down
11 changes: 6 additions & 5 deletions docs/src/content/docs/ru/guides/site-search.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -124,18 +124,19 @@ title: Частично проиндексированная страница

<Steps>

1. Расширьте определение коллекции контента Starlight `i18n` схемой DocSearch в файле `src/content/config.ts`:
1. Расширьте определение коллекции контента Starlight `i18n` схемой DocSearch в файле `src/content.config.ts`:

```js ins={4} ins=/{ extend: .+ }/
// src/content/config.ts
```js ins={5} ins=/{ extend: .+ }/
// src/content.config.ts
import { defineCollection } from 'astro:content';
import { docsLoader, i18nLoader } from '@astrojs/starlight/loaders';
import { docsSchema, i18nSchema } from '@astrojs/starlight/schema';
import { docSearchI18nSchema } from '@astrojs/starlight-docsearch/schema';

export const collections = {
docs: defineCollection({ schema: docsSchema() }),
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
i18n: defineCollection({
type: 'data',
loader: i18nLoader(),
schema: i18nSchema({ extend: docSearchI18nSchema() }),
}),
};
Expand Down
6 changes: 6 additions & 0 deletions docs/src/content/docs/ru/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,12 @@ description: Starlight помогает вам создавать красивы
template: splash
editUrl: false
lastUpdated: false
banner:
content: |
Обновляетесь до Astro 5?
<a href="https://github.com/withastro/starlight/releases/tag/%40astrojs/starlight%400.30.0">
Узнайте, как обновиться
</a>
hero:
title: Сделайте свою документацию яркой с помощью Starlight
tagline: Всё, что вам нужно, чтобы создать впечатляющий сайт с документацией. Быстро, доступно и просто в использовании.
Expand Down
30 changes: 14 additions & 16 deletions docs/src/content/docs/ru/manual-setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,7 @@ description: Узнайте, как настроить Starlight вручную,

import { Tabs, TabItem } from '@astrojs/starlight/components';

Самый быстрый способ создать новый сайт на Starlight - использовать `create astro`,
как показано во [введении](/ru/getting-started/#создание-нового-проекта).
Самый быстрый способ создать новый сайт на Starlight - использовать `create astro`, как показано во [введении](/ru/getting-started/#создание-нового-проекта).
Если вы хотите добавить Starlight к существующему проекту Astro, это руководство расскажет, как это сделать.

## Настройка Starlight
Expand All @@ -15,8 +14,7 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';

### Интеграция Starlight

Starlight является [интеграцией Astro](https://docs.astro.build/ru/guides/integrations-guide/).
Добавьте её на ваш сайт, запустив команду `astro add` в корневой директории вашего проекта:
Starlight является [интеграцией Astro](https://docs.astro.build/ru/guides/integrations-guide/). Добавьте её на ваш сайт, запустив команду `astro add` в корневой директории вашего проекта:

<Tabs syncKey="pkg">
<TabItem label="npm">
Expand Down Expand Up @@ -64,21 +62,24 @@ export default defineConfig({

### Настройка коллекций контента

Starlight создан на основе [коллекций контента](https://docs.astro.build/ru/guides/content-collections/) Astro,
которые настраиваются в файле `src/content/config.ts`.
Starlight создан на основе [коллекций контента](https://docs.astro.build/ru/guides/content-collections/) Astro, которые настраиваются в файле `src/content.config.ts`.

Создайте или обновите файл конфигурации контента, добавив коллекцию `docs`, которая использует схему `docsSchema` от Starlight:
Создайте или обновите файл конфигурации контента, добавив коллекцию `docs`, которая использует схемы `docsLoader` и `docsSchema` от Starlight:

```js ins={3,6}
// src/content/config.ts
```js ins={3-4,7}
// src/content.config.ts
import { defineCollection } from 'astro:content';
import { docsLoader } from '@astrojs/starlight/loaders';
import { docsSchema } from '@astrojs/starlight/schema';

export const collections = {
docs: defineCollection({ schema: docsSchema() }),
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
};
```

Starlight также поддерживает флаг [`legacy.collections`](https://docs.astro.build/ru/reference/legacy-flags/), при котором коллекции обрабатываются с использованием устаревшей реализации коллекций контента.
Это полезно, если у вас есть существующий проект Astro, и вы не можете в данный момент внести изменения в коллекции для использования загрузчика.

### Добавление контента

Starlight настроен, и пришло время добавить контент!
Expand All @@ -96,9 +97,7 @@ description: Узнайте больше о моем проекте на это
Добро пожаловать в мой проект!
```

Starlight использует маршрутизацию на основе файлов, что означает, что каждый файл Markdown, MDX или Markdoc в `src/content/docs/`
становится страницей на вашем сайте. Метаданные в начале файла (например, поля `title` и `description` в приведённом выше примере)
могут изменить отображение страниц.
Starlight использует маршрутизацию на основе файлов, что означает, что каждый файл Markdown, MDX или Markdoc в `src/content/docs/` становится страницей на вашем сайте. Метаданные в начале файла (например, поля `title` и `description` в приведённом выше примере) могут изменить отображение страниц.

Посмотрите все доступные параметры в [справочнике по метаданным](/ru/reference/frontmatter/).

Expand Down Expand Up @@ -127,11 +126,10 @@ import { FileTree } from '@astrojs/starlight/components';

</FileTree>

В будущем мы планируем улучшить такой вариант использования путей,
чтобы избежать необходимости в лишнем вложенном каталоге в `src/content/docs/`.
В будущем мы планируем улучшить такой вариант использования путей, чтобы избежать необходимости в лишнем вложенном каталоге в `src/content/docs/`.

### Использование Starlight с SSR

Чтобы включить SSR, следуйте руководству [Адаптеры рендеринга по требованию](https://docs.astro.build/ru/guides/server-side-rendering/) в документации Astro, для добавления серверного адаптера в ваш проект Starlight.
Чтобы включить SSR, следуйте руководству [Адаптеры рендеринга по требованию](https://docs.astro.build/ru/guides/on-demand-rendering/) в документации Astro, для добавления серверного адаптера в ваш проект Starlight.

Страницы документации, создаваемые Starlight, по умолчанию предварительно отрисовываются независимо от режима вывода вашего проекта. Для отключения предварительного рендеринга страниц установите для [параметра `prerender`](/ru/reference/configuration/#prerender) значение `false`.
4 changes: 2 additions & 2 deletions docs/src/content/docs/ru/reference/configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -461,7 +461,7 @@ Pagefind не может быть включен, если для парамет
**тип:** `boolean`
**по умолчанию:** `true`

Определите, должны ли страницы Starlight предварительно отрисовываться в статический HTML или отрисовываться по требованию с помощью [SSR-адаптера](https://docs.astro.build/ru/guides/server-side-rendering/).
Определите, должны ли страницы Starlight предварительно отрисовываться в статический HTML или отрисовываться по требованию с помощью [SSR-адаптера](https://docs.astro.build/ru/guides/on-demand-rendering/).

Страницы Starlight предварительно отрисовываются по умолчанию.
Если вы используете адаптер SSR и хотите рендерить страницы Starlight по требованию, установите `prerender: false`.
Expand Down Expand Up @@ -567,7 +567,7 @@ starlight({
**тип:** `boolean`
**по умолчанию:** `false`

Отключает внедрение стандартной [страницы 404](https://docs.astro.build/ru/core-concepts/astro-pages/#custom-404-error-page) Starlight. Чтобы использовать в своем проекте собственный маршрут `src/pages/404.astro`, установите для этого параметра значение `true`.
Отключает внедрение стандартной [страницы 404](https://docs.astro.build/ru/basics/astro-pages/#custom-404-error-page) Starlight. Чтобы использовать в своем проекте собственный маршрут `src/pages/404.astro`, установите для этого параметра значение `true`.

### `components`

Expand Down
Loading

0 comments on commit 2c3a4ad

Please sign in to comment.