Update Russian translation (#1616)

Co-authored-by: Loot Nurakhmetov <[email protected]> Co-authored-by: Chris Swithinbank <[email protected]> Co-authored-by: HiDeoo <[email protected]>
withastro · Apr 1, 2024 · a86f9b7 · a86f9b7
1 parent 953c56e
commit a86f9b7
Show file tree

Hide file tree

Showing 24 changed files with 3,097 additions and 433 deletions.
diff --git a/.changeset/lemon-months-carry.md b/.changeset/lemon-months-carry.md
@@ -0,0 +1,5 @@
+---
+"@astrojs/starlight": patch
+---
+
+Updates Russian UI strings
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
@@ -82,7 +82,7 @@ export default defineConfig({
 						'pt-PT': 'Comece Aqui',
 						ko: '여기서부터',
 						tr: 'Buradan Başlayın',
-						ru: 'Начать отсюда',
+						ru: 'Первые шаги',
 						hi: 'यहाँ से शुरू करे',
 						uk: 'Почніть звідси',
 					},
@@ -195,6 +195,7 @@ export default defineConfig({
 						fr: 'Ressources',
 						'pt-BR': 'Recursos',
 						ja: 'リソース',
+						ru: 'Ресурсы',
 					},
 					autogenerate: { directory: 'resources' },
 				},

diff --git a/docs/src/content/docs/ru/environmental-impact.md b/docs/src/content/docs/ru/environmental-impact.md
@@ -8,7 +8,7 @@ description: Узнайте, как Starlight может помочь созда
 Расчет экологического воздействия веб-сайта включает в себя множество сложных факторов,
 но в данном руководстве перечислены несколько советов по снижению экологического следа вашего сайта с документацией.
 
-Хорошая новость в том, что выбор Starlight - отличное начало.
+Хорошая новость в том, что выбор Starlight — отличное начало.
 Согласно Website Carbon Calculator, этот сайт [чище, чем 99% протестированных веб-страниц][sl-carbon],
 производя 0,01 г CO₂ за каждое посещение страницы.
 
@@ -17,27 +17,27 @@ description: Узнайте, как Starlight может помочь созда
 Чем больше данных передает веб-страница, тем больше энергетических ресурсов она требует.
 В апреле 2023 года, медианная веб-страница требовала от пользователя скачать более 2 000 КБ данных, согласно [данным из HTTP Archive][http].
 
-Starlight создает страницы легкими, настолько, насколько это возможно
+Starlight создает страницы лёгкими, настолько, насколько это возможно
 Например, при первом посещении пользователь загрузит менее 50 КБ сжатых данных, что составляет всего 2,5% от медианного значения HTTP архива.
 При хорошей стратегии кэширования последующие навигации могут загружать всего 10 КБ.
 
 ### Изображения
 
-Хоть Starlight и предлагает легкие страницы по-умолчанию, изображения, которые вы добавляете на страницы документации, могут быстро увеличивать вес вашей страницы.
+Хоть Starlight и предлагает лёгкие страницы по умолчанию, изображения, которые вы добавляете на страницы документации, могут быстро увеличивать вес вашей страницы.
 Starlight использует [оптимизировацию ресурсов][assets] Astro для оптимизации локальных изображений в ваших файлах Markdown и MDX.
 
 ### UI компоненты
 
 Компоненты, на UI фреймворках, как React или Vue, могут легко добавлять большие объемы JavaScript на страницу.
 Поскольку Starlight основан на Astro, эти компоненты, по умолчанию **не загружают клиентский JavaScript** благодаря [Astro Островам][islands].
 
-### Кеширование
+### Кэширование
 
 Кэширование управляет тем, как долго браузер хранит и повторно использует данные, которые он уже загрузил.
 Хорошая стратегия кэширования гарантирует, что пользователь получает новое содержание как можно быстрее,
 когда оно меняется, но также избегает бесполезной повторной загрузки одного и того же содержания снова и снова, когда оно не изменилось.
 
-Самым распространенным способом настройки кэширования является использование [HTTP-заголовка `Cache-Control`][cache].
+Самым распространённым способом настройки кэширования является использование [HTTP-заголовка `Cache-Control`][cache].
 При использовании Starlight вы можете установить длительное время кэширования для всего, что находится в каталоге `/_astro/`.
 Этот каталог содержит CSS, JavaScript и другие ресурсы, которые можно безопасно кэшировать навсегда, что позволяет снизить избыточные загрузки:
 
@@ -60,7 +60,7 @@ Cache-Control: public, max-age=604800, immutable
 
 ## Потребление энергии
 
-То, как реализована веб-страница может влиять на потребление энергии при ее запуске на устройстве пользователя.
+То, как реализована веб-страница может влиять на потребление энергии при её запуске на устройстве пользователя.
 За счет минимального использования JavaScript, Starlight снижает объем вычислительных ресурсов, необходимых телефону,
 планшету или компьютеру пользователя для загрузки и отображения страниц.
 
@@ -111,7 +111,7 @@ Cache-Control: public, max-age=604800, immutable
 | [Read the Docs][rtd-carbon] | 0.24g                        |
 | [GitBook][gb-carbon]        | 0.71g                        |
 
-<small>Данные собраны 14 мая 2023 года. Чтобы увидеть актуальные цифры, перейдите по ссылке..</small>
+<small>Данные собраны 14 мая 2023 года. Чтобы увидеть актуальные цифры, перейдите по ссылке.</small>
 
 [sl-carbon]: https://www.websitecarbon.com/website/starlight-astro-build-getting-started/
 [vp-carbon]: https://www.websitecarbon.com/website/vitepress-dev-guide-what-is-vitepress/
@@ -136,10 +136,10 @@ Cache-Control: public, max-age=604800, immutable
 
 ### Статьи и выступления
 
-- ["Построение более экологичного веба"](https://youtu.be/EfPoOt7T5lg), выступление Мишель Баркер
-- ["Стратегии экологически устойчивый веб-разработки в организации"](https://www.smashingmagazine.com/2022/10/sustainable-web-development-strategies-organization/), статья Мишель Баркер
-- ["Экологически устойчивый веб для каждого"](https://2021.stateofthebrowser.com/speakers/tom-greenwood/), выступление Тома Гринвуда
-- ["Как веб-контент может влиять на энергопотребление"](https://webkit.org/blog/8970/how-web-content-can-affect-power-usage/), статья Бенджамина Пулена и Саймона Фрейзера.
+- [Построение более экологичного веба](https://youtu.be/EfPoOt7T5lg), выступление Мишель Баркер
+- [Стратегии устойчивого веб-развития в организации](https://www.smashingmagazine.com/2022/10/sustainable-web-development-strategies-organization/), статья Мишель Баркер
+- [Экологически устойчивый веб для каждого](https://2021.stateofthebrowser.com/speakers/tom-greenwood/), выступление Тома Гринвуда
+- [Как веб-контент может влиять на энергопотребление](https://webkit.org/blog/8970/how-web-content-can-affect-power-usage/), статья Бенджамина Пулена и Саймона Фрейзера.
 
 [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

diff --git a/docs/src/content/docs/ru/getting-started.mdx b/docs/src/content/docs/ru/getting-started.mdx
@@ -1,37 +1,38 @@
 ---
 title: Введение
-description: Узнайте, как начать создание вашего следующего сайта с документацией с помощью Starlight от Astro
+description: Узнайте, как начать создание вашего следующего сайта с документацией с помощью Starlight от Astro.
 ---
 
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 
-## Создание нового проекта
-
 Starlight — это полнофункциональная тема для документации, созданная на основе фреймворка [Astro](https://astro.build).
+Это руководство поможет вам начать работу над новым проектом.
+См. [инструкции по ручной настройке](/ru/manual-setup/), чтобы добавить Starlight в существующий проект Astro.
+
+## Быстрый старт
+
+### Создание нового проекта
 
 Вы можете создать новый проект на базе Astro + Starlight, используя следующую команду:
 
 <Tabs>
 <TabItem label="npm">
 
 ```sh
-# создать новый проект с помощью npm
 npm create astro@latest -- --template starlight
 ```
 
 </TabItem>
 <TabItem label="pnpm">
 
 ```sh
-# создать новый проект с помощью pnpm
 pnpm create astro --template starlight
 ```
 
 </TabItem>
 <TabItem label="Yarn">
 
 ```sh
-# создать новый проект с помощью yarn
 yarn create astro --template starlight
 ```
 
@@ -45,48 +46,58 @@ yarn create astro --template starlight
 [откройте шаблон на StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics).
 :::
 
-## Создание контента с Starlight
+### Запуск сервера разработки
 
-Starlight готов к созданию нового контента или к интеграции уже существующих файлов!
+При локальной работе [сервер разработки Astro](https://docs.astro.build/ru/reference/cli-reference/#astro-dev) позволяет предварительно просмотреть вашу работу и автоматически обновляет ваш браузер при внесении изменений.
 
-### Форматы файлов
+Внутри каталога вашего проекта выполните следующую команду, чтобы запустить сервер разработки:
 
-Starlight поддерживает создание контента в форматах Markdown и MDX. (Вы можете добавить поддержку Markdoc, установив экспериментальную [интеграцию Astro Markdoc](https://docs.astro.build/ru/guides/integrations-guide/markdoc/).)
+<Tabs>
+<TabItem label="npm">
 
-### Добавить страницы
+```sh
+npm run dev
+```
 
-Автоматически добавляйте новые страницы на ваш сайт, создавая файлы `.md` или `.mdx` в директории `src/content/docs/`.
-Добавляйте подпапки для организации ваших файлов и создания множественных сегментов пути:
+</TabItem>
+<TabItem label="pnpm">
 
+```sh
+pnpm dev
 ```
-src/content/docs/hello-world.md => ваш-сайт.com/hello-world
-src/content/docs/guides/faq.md => ваш-сайт.com/guides/faq
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn dev
 ```
 
-### Типобезопасные метаданные
+</TabItem>
+</Tabs>
+
+На ваш терминал будет отправлено сообщение с URL-адресом вашего локального предварительного просмотра.
+Откройте этот URL-адрес, чтобы начать просмотр вашего сайта.
 
-Все страницы Starlight используют настраиваемый [общий набор свойств метаданных](/ru/reference/frontmatter/) для контроля отображения страницы:
+### Добавление контента
 
-```md
----
-title: Привет, мир!
-description: Это страница на моем сайте, работающем на Starlight
----
-```
+Starlight готов к созданию нового контента или к интеграции уже существующих файлов!
 
-Если вы что-то забудете, Starlight сообщит вам об этом
+Добавляйте новые страницы на свой сайт, создавая файлы Markdown в каталоге `src/content/docs/`.
 
-## Развертывание вашего сайта на Starlight
+Подробнее о файловой маршрутизации и поддержке файлов MDX и Markdoc читайте в руководстве [Страницы](/ru/guides/pages/).
 
-После того как вы создали и настроили свой сайт на Starlight, вы можете развернуть его на веб-сервере или
-платформе хостинга по вашему выбору, включая Netlify, Vercel, GitHub Pages и так далее.
+### Следующие шаги
 
-[Узнайте о развертывании сайта на Astro из документации Astro.](https://docs.astro.build/ru/guides/deploy/)
+- **Настройка:** Узнайте об общих опциях в главе [Настройка Starlight](/ru/guides/customization/).
+- **Навигация.** Настройте боковую панель с помощью руководства [Навигация по боковой панели](/ru/guides/sidebar/).
+- **Компоненты.** Узнайте о встроенных карточках, вкладках и многом другом в руководстве [Компоненты](/ru/guides/components/).
+- **Развёртывание.** Опубликуйте свою работу с помощью руководства [Развёртывание вашего сайта](https://docs.astro.build/ru/guides/deploy/) в документации Astro.
 
 ## Обновление Starlight
 
 :::tip
-Поскольку Starlight еще в beta, будут частые обновления и улучшения.
+Поскольку Starlight ещё в статусе beta, будут частые обновления и улучшения.
 Не забывайте регулярно обновлять Starlight!
 :::
 
@@ -96,24 +107,21 @@ Starlight является интеграцией Astro и обновляетс
 <TabItem label="npm">
 
 ```sh
-# Обновление Starlight с npm
-npm install @astrojs/starlight@latest
+npx @astrojs/upgrade
 ```
 
 </TabItem>
 <TabItem label="pnpm">
 
 ```sh
-# Обновление Starlight с pnpm
-pnpm upgrade @astrojs/starlight --latest
+pnpm dlx @astrojs/upgrade
 ```
 
 </TabItem>
 <TabItem label="Yarn">
 
 ```sh
-# Обновление Starlight с yarn
-yarn upgrade @astrojs/starlight --latest
+yarn dlx @astrojs/upgrade
 ```
 
 </TabItem>
@@ -124,14 +132,11 @@ yarn upgrade @astrojs/starlight --latest
 
 ## Устранение проблем с Starlight
 
-Информация о [конфигурации проекта Starlight](/ru/reference/configuration/)
-и [конфигурации метаданных отдельной страницы](/ru/reference/frontmatter/) доступна в разделе Справочник этого сайта.
-Используйте эти страницы, чтобы убедиться, что ваш сайт на Starlight настроен и работает корректно.
-
-Смотрите пополняющийся список руководств в боковой панели для помощи в добавлении контента и настройке вашего сайта на Starlight.
+Используйте справочные страницы [конфигурация проекта](/ru/reference/configuration/) и [конфигурация метаданных отдельной страницы](/ru/reference/frontmatter/), чтобы убедиться, что ваш сайт Starlight настроен и работает правильно.
+См. руководства на боковой панели, чтобы получить помощь в добавлении контента и настройке вашего сайта Starlight.
 
 Если вы не можете найти ответ в этой документации, пожалуйста, посетите [полную документацию Astro](https://docs.astro.build/ru/).
-Ваш вопрос может быть решен узнав как в целом работает Astro под темой Starlight.
+На ваш вопрос можно ответить, если вы поймете, как работает Astro в целом в рамках темы Starlight.
 
 Вы также можете узнать про любые известные [проблемы Starlight на GitHub](https://github.com/withastro/starlight/issues) и получить помощь в
 [Discord Astro](https://astro.build/chat/) от нашего активного, дружелюбного сообщества!