Skip to content

Commit f2d8227

Browse files
dragomanoHiDeoo
andauthored
i18n(ru): update some guides (#2035)
Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
1 parent a5e4461 commit f2d8227

File tree

4 files changed

+52
-4
lines changed

4 files changed

+52
-4
lines changed

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

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -418,6 +418,36 @@ import { Steps } from '@astrojs/starlight/components';
418418

419419
</Steps>
420420

421+
### Значки
422+
423+
import { Badge } from '@astrojs/starlight/components';
424+
425+
Используйте компонент `<Badge>` для отображения небольших фрагментов информации, таких как статус или ярлыки.
426+
427+
Передайте содержимое, которое вы хотите отобразить, в атрибут `text` компонента `<Badge>`.
428+
429+
По умолчанию значок будет использовать акцентный цвет темы вашего сайта. Чтобы использовать встроенный цвет значка, установите атрибут `variant` в одно из следующих значений: `note` (синий), `tip` (фиолетовый), `danger` (красный), `caution` (оранжевый), или `success` (зелёный).
430+
431+
Атрибут `size` (по умолчанию: `small`) управляет размером текста значка. Для отображения значка большего размера также доступны опции `medium` и `large`.
432+
433+
Для дальнейшей настройки используйте другие атрибуты `<span>`, такие как `class` или `style`, с помощью пользовательского CSS.
434+
435+
```mdx title="src/content/docs/example.mdx"
436+
import { Badge } from '@astrojs/starlight/components';
437+
438+
<Badge text="Новое" variant="tip" size="small" />
439+
<Badge text="Устарело" variant="caution" size="medium" />
440+
<Badge text="Starlight" variant="note" size="large" />
441+
<Badge text="Свой текст" variant="success" style={{ fontStyle: 'italic' }} />
442+
```
443+
444+
Вышеуказанный код сформирует следующий HTML:
445+
446+
<Badge text="Новое" variant="tip" size="small" />
447+
<Badge text="Устарело" variant="caution" size="medium" />
448+
<Badge text="Starlight" variant="note" size="large" />
449+
<Badge text="Свой текст" variant="success" style={{ fontStyle: 'italic' }} />
450+
421451
### Иконки
422452

423453
import { Icon } from '@astrojs/starlight/components';

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

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,8 @@ Starlight обеспечивает встроенную поддержку мн
6767

6868
</Steps>
6969

70+
Для более продвинутых сценариев использования i18n Starlight также поддерживает настройку интернационализации с помощью [опции `i18n` Astro](https://docs.astro.build/ru/guides/internationalization/#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-i18n-%D0%BC%D0%B0%D1%80%D1%88%D1%80%D1%83%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8).
71+
7072
### Использование корневой локали
7173

7274
Вы можете использовать «корневую» локаль для отображения языка без префикса i18n в его пути. Например, если русский является вашей корневой локалью, путь к странице на русском языке будет выглядеть как `/about` вместо `/ru/about`.
@@ -273,4 +275,17 @@ export const collections = {
273275
};
274276
```
275277

276-
Дополнительную информацию о схемах коллекции контента см. в разделе [Определение схемы коллекции](https://docs.astro.build/ru/guides/content-collections/#defining-a-collection-schema) в документации Astro.
278+
Дополнительную информацию о схемах коллекции контента см. в разделе [Определение схемы коллекции](https://docs.astro.build/ru/guides/content-collections/#%D0%BE%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D1%85%D0%B5%D0%BC%D1%8B-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B8) в документации Astro.
279+
280+
## Доступ к текущей локали
281+
282+
Вы можете использовать [`Astro.currentLocale`](https://docs.astro.build/ru/reference/api-reference/#astrocurrentlocale) для получения текущей локали в компонентах `.astro`.
283+
284+
Следующий пример считывает текущую локаль и использует её для создания ссылки на страницу о сайте на текущем языке:
285+
286+
```astro
287+
---
288+
// src/components/AboutLink.astro
289+
---
290+
<a href={`/${Astro.currentLocale}/about`}>О сайте</a>
291+
```

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

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -294,12 +294,14 @@ starlight({
294294
]}
295295
/>
296296

297-
### Варианты значков
297+
### Варианты значков и индивидуальная стилизация
298298

299-
Настройте стиль значка, используя объект со свойствами `text` и `variant`.
299+
Настройте стиль значка, используя объект со свойствами `text`, `variant` и `class`.
300300

301301
`text` представляет содержимое для отображения (например, «Новое»).
302-
Переопределите стиль `default`, который использует акцентный цвет вашего сайта, установив свойство `variant` в одно из следующих значений: `note`, `tip`, `danger`, `caution` или `success`.
302+
По умолчанию значок будет использовать акцентный цвет вашего сайта. Чтобы использовать встроенный стиль значка, установите для свойства `variant` одно из следующих значений: `note`, `tip`, `danger`, `caution` или `success`.
303+
304+
Кроме того, можно создать собственный стиль значка, задав свойству `class` имя класса CSS.
303305

304306
```js {10}
305307
starlight({

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,7 @@ title: Частично проиндексированная страница
142142
"docsearch.searchBox.resetButtonAriaLabel": "Clear the query",
143143
"docsearch.searchBox.cancelButtonText": "Cancel",
144144
"docsearch.searchBox.cancelButtonAriaLabel": "Cancel",
145+
"docsearch.searchBox.searchInputLabel": "Search",
145146

146147
"docsearch.startScreen.recentSearchesTitle": "Recent",
147148
"docsearch.startScreen.noRecentSearchesText": "No recent searches",

0 commit comments

Comments
 (0)