Skip to content

Commit 2c3a4ad

Browse files
dragomanoHiDeoo
andauthored
i18n(ru): update translations (#2695)
Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
1 parent 786b171 commit 2c3a4ad

File tree

12 files changed

+66
-53
lines changed

12 files changed

+66
-53
lines changed

‎docs/src/content/docs/ru/components/using-components.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ sidebar:
99
Примерами могут служить карточки-ссылки или встраиваемые ролики YouTube.
1010
Starlight поддерживает использование компонентов в файлах [MDX](https://mdxjs.com/) и [Markdoc](https://markdoc.dev/), а также предоставляет некоторые общие компоненты для применения.
1111

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

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

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

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

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

‎docs/src/content/docs/ru/environmental-impact.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,6 @@ Cache-Control: public, max-age=604800, immutable
137137
[sf]: https://www.sciencefocus.com/science/what-is-the-carbon-footprint-of-the-internet/
138138
[bbc]: https://www.bbc.com/future/article/20200305-why-your-internet-habits-are-not-as-clean-as-you-think
139139
[http]: https://httparchive.org/reports/state-of-the-web
140-
[assets]: https://docs.astro.build/ru/guides/assets/
140+
[assets]: https://docs.astro.build/ru/guides/images/
141141
[islands]: https://docs.astro.build/ru/concepts/islands/
142142
[wcc]: https://www.websitecarbon.com/

‎docs/src/content/docs/ru/guides/authoring-content.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ title: Заголовок страницы
4545

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

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

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

‎docs/src/content/docs/ru/guides/i18n.mdx

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -189,16 +189,16 @@ import UIStringsList from '~/components/ui-strings-list.astro';
189189

190190
<Steps>
191191

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

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

199199
export const collections = {
200-
docs: defineCollection({ schema: docsSchema() }),
201-
+ i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
200+
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
201+
+ i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }),
202202
};
203203
```
204204

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

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

265266
export const collections = {
266-
docs: defineCollection({ schema: docsSchema() }),
267+
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
267268
i18n: defineCollection({
268-
type: 'data',
269+
loader: i18nLoader(),
269270
schema: i18nSchema({
270271
+ extend: z.object({
271272
+ 'custom.label': z.string().optional(),

‎docs/src/content/docs/ru/guides/overriding-components.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ import Default from '@astrojs/starlight/components/SocialIcons.astro';
8686
При использовании встроенного компонента внутри вашего компонента:
8787

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

9191
Если вы повторно используете компоненты [`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/#перенос-слотов) эти слоты.
9292

@@ -157,4 +157,4 @@ const isHomepage = Astro.props.slug === '';
157157
}
158158
```
159159

160-
Узнайте больше об условной отрисовке в руководстве [Синтаксис Astro](https://docs.astro.build/ru/core-concepts/astro-syntax/#динамический-html).
160+
Узнайте больше об условной отрисовке в руководстве [Синтаксис Astro](https://docs.astro.build/ru/basics/astro-syntax/#динамический-html).

‎docs/src/content/docs/ru/guides/project-structure.mdx

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ description: Узнайте, как организовать файлы в ва
55

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

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

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

1212
- `astro.config.mjs` — Файл конфигурации Astro; включает интеграцию и конфигурацию Starlight.
13-
- `src/content/config.ts` — Файл конфигурации коллекций контента; добавляет метаданные (frontmatter) от Starlight в ваш проект.
13+
- `src/content.config.ts` — Файл конфигурации коллекций контента; добавляет метаданные (frontmatter) от Starlight в ваш проект.
1414
- `src/content/docs/` — Файлы контента. Starlight преобразует каждый файл `.md`, `.mdx` или `.mdoc` в этом каталоге в страницу на вашем сайте.
1515
- `src/content/i18n/` (по необходимости) — Данные перевода для поддержки [интернационализации](/ru/guides/i18n/).
1616
- `src/` — Другой исходный код и файлы (компоненты, стили, изображения и т. д.) для вашего проекта.
@@ -39,8 +39,7 @@ import { FileTree } from '@astrojs/starlight/components';
3939
- 01-getting-started.md
4040
- 02-advanced.md
4141
- index.mdx
42-
- config.ts
43-
- env.d.ts
42+
- content.config.ts
4443
- astro.config.mjs
4544
- package.json
4645
- tsconfig.json

‎docs/src/content/docs/ru/guides/site-search.mdx

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -124,18 +124,19 @@ title: Частично проиндексированная страница
124124

125125
<Steps>
126126

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

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

135136
export const collections = {
136-
docs: defineCollection({ schema: docsSchema() }),
137+
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
137138
i18n: defineCollection({
138-
type: 'data',
139+
loader: i18nLoader(),
139140
schema: i18nSchema({ extend: docSearchI18nSchema() }),
140141
}),
141142
};

‎docs/src/content/docs/ru/index.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,12 @@ description: Starlight помогает вам создавать красивы
77
template: splash
88
editUrl: false
99
lastUpdated: false
10+
banner:
11+
content: |
12+
Обновляетесь до Astro 5?
13+
<a href="https://github.com/withastro/starlight/releases/tag/%40astrojs/starlight%400.30.0">
14+
Узнайте, как обновиться
15+
</a>
1016
hero:
1117
title: Сделайте свою документацию яркой с помощью Starlight
1218
tagline: Всё, что вам нужно, чтобы создать впечатляющий сайт с документацией. Быстро, доступно и просто в использовании.

‎docs/src/content/docs/ru/manual-setup.mdx

Lines changed: 14 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,7 @@ description: Узнайте, как настроить Starlight вручную,
55

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

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

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

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

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

2119
<Tabs syncKey="pkg">
2220
<TabItem label="npm">
@@ -64,21 +62,24 @@ export default defineConfig({
6462

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

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

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

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

7775
export const collections = {
78-
docs: defineCollection({ schema: docsSchema() }),
76+
docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
7977
};
8078
```
8179

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

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

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

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

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

128127
</FileTree>
129128

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

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

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

137135
Страницы документации, создаваемые Starlight, по умолчанию предварительно отрисовываются независимо от режима вывода вашего проекта. Для отключения предварительного рендеринга страниц установите для [параметра `prerender`](/ru/reference/configuration/#prerender) значение `false`.

‎docs/src/content/docs/ru/reference/configuration.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -461,7 +461,7 @@ Pagefind не может быть включен, если для парамет
461461
**тип:** `boolean`
462462
**по умолчанию:** `true`
463463

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

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

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

572572
### `components`
573573

0 commit comments

Comments
 (0)