i18n(ru): Primary pages were translated to russian (#852)

Co-authored-by: Loot Nurakhmetov <nurakhmetov.l@rahmetapp.kz>
Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>

.github/labeler.yml

@@ -12,6 +12,7 @@ i18n:
   - docs/src/content/docs/zh/**/*
   - docs/src/content/docs/pt-br/**/*
   - docs/src/content/docs/ko/**/*
+  - docs/src/content/docs/ru/**/*
 
 '🌟 core':
   - packages/starlight/**

docs/astro.config.mjs

@@ -12,6 +12,7 @@ export const locales = {
 	zh: { label: '简体中文', lang: 'zh' },
 	'pt-br': { label: 'Português do Brasil', lang: 'pt-BR' },
 	ko: { label: '한국어', lang: 'ko' },
+	ru: { label: 'Русский', lang: 'ru' },
 };
 
 const site = 'https://starlight.astro.build/';
@@ -66,6 +67,7 @@ export default defineConfig({
 						zh: '从这里开始',
 						'pt-BR': 'Comece Aqui',
 						ko: '여기서부터',
+						ru: 'Начать отсюда',
 					},
 					items: [
 						{
@@ -81,6 +83,7 @@ export default defineConfig({
 								zh: '开始使用',
 								'pt-BR': 'Introdução',
 								ko: '시작하기',
+								ru: 'Введение',
 							},
 						},
 						{
@@ -96,6 +99,7 @@ export default defineConfig({
 								zh: '手动配置',
 								'pt-BR': 'Instalação Manual',
 								ko: '수동으로 설정하기',
+								ru: 'Установка вручную',
 							},
 						},
 						{
@@ -111,6 +115,7 @@ export default defineConfig({
 								zh: '环境影响',
 								'pt-BR': 'Impacto Ambiental',
 								ko: '환경적 영향',
+								ru: 'Влияние на окружающую среду',
 							},
 						},
 						{
@@ -124,6 +129,7 @@ export default defineConfig({
 								// it: '',
 								id: 'Galeri',
 								ko: '쇼케이스',
+								ru: 'Примеры',
 							},
 						},
 					],
@@ -140,6 +146,7 @@ export default defineConfig({
 						zh: '指南',
 						'pt-BR': 'Guias',
 						ko: '가이드',
+						ru: 'Руководства',
 					},
 					autogenerate: { directory: 'guides' },
 				},
@@ -155,6 +162,7 @@ export default defineConfig({
 						zh: '参考',
 						'pt-BR': 'Referência',
 						ko: '참조',
+						ru: 'Справочник',
 					},
 					autogenerate: { directory: 'reference' },
 				},

docs/package.json

@@ -5,7 +5,7 @@
   "version": "0.0.1",
   "scripts": {
     "test": "start-server-and-test 'pnpm preview' http://localhost:4321 'pnpm pa11y'",
-    "pa11y": "pa11y-ci --sitemap 'http://localhost:4321/sitemap-0.xml' --sitemap-find 'https://starlight.astro.build' --sitemap-replace 'http://localhost:4321' --sitemap-exclude '/(de|zh|fr|es|pt-br|it|id|ko)/.*'",
+    "pa11y": "pa11y-ci --sitemap 'http://localhost:4321/sitemap-0.xml' --sitemap-find 'https://starlight.astro.build' --sitemap-replace 'http://localhost:4321' --sitemap-exclude '/(de|zh|fr|es|pt-br|it|id|ko|ru)/.*'",
     "dev": "astro dev",
     "start": "astro dev",
     "build": "astro build",

docs/src/content/docs/ru/getting-started.mdx

@@ -0,0 +1,139 @@
+---
+title: Введение
+description: Узнайте, как начать создание вашего следующего сайта с документацией с помощью Starlight от Astro
+---
+
+import { Tabs, TabItem } from '@astrojs/starlight/components';
+
+## Создание нового проекта
+
+Starlight — это полнофункциональная тема для документации, созданная на основе фреймворка [Astro](https://astro.build).
+
+Вы можете создать новый проект на базе 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
+```
+
+</TabItem>
+</Tabs>
+
+Это создаст новую [директорию проекта](/ru/guides/project-structure/) со всеми необходимыми файлами и настройками для вашего сайта.
+
+:::tip[Посмотрите это в действии]
+Попробуйте Starlight в вашем браузере:
+[откройте шаблон на StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics).
+:::
+
+## Создание контента с Starlight
+
+Starlight готов к созданию нового контента или к интеграции уже существующих файлов!
+
+### Форматы файлов
+
+Starlight поддерживает создание контента в форматах Markdown и MDX. (Вы можете добавить поддержку Markdoc, установив экспериментальную [интеграцию Astro Markdoc](https://docs.astro.build/ru/guides/integrations-guide/markdoc/).)
+
+### Добавить страницы
+
+Автоматически добавляйте новые страницы на ваш сайт, создавая файлы `.md` или `.mdx` в директории `src/content/docs/`.
+Добавляйте подпапки для организации ваших файлов и создания множественных сегментов пути:
+
+```
+src/content/docs/hello-world.md => ваш-сайт.com/hello-world
+src/content/docs/guides/faq.md => ваш-сайт.com/guides/faq
+```
+
+### Типобезопасные метаданные
+
+Все страницы Starlight используют настраиваемый [общий набор свойств метаданных](/ru/reference/frontmatter/) для контроля отображения страницы:
+
+```md
+---
+title: Привет, мир!
+description: Это страница на моем сайте, работающем на Starlight
+---
+```
+
+Если вы что-то забудете, Starlight сообщит вам об этом
+
+## Развертывание вашего сайта на Starlight
+
+После того как вы создали и настроили свой сайт на Starlight, вы можете развернуть его на веб-сервере или
+ платформе хостинга по вашему выбору, включая Netlify, Vercel, GitHub Pages и так далее.
+
+[Узнайте о развертывании сайта на Astro из документации Astro.](https://docs.astro.build/ru/guides/deploy/)
+
+## Обновление Starlight
+
+:::tip
+Поскольку Starlight еще в beta, будут частые обновления и улучшения.
+Не забывайте регулярно обновлять Starlight!
+:::
+
+Starlight является интеграцией Astro и обновляется так же, как любая интеграция @astrojs/*:
+
+<Tabs>
+<TabItem label="npm">
+
+```sh
+# Обновление Starlight с npm
+npm install @astrojs/starlight@latest
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+# Обновление Starlight с pnpm
+pnpm upgrade @astrojs/starlight --latest
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+# Обновление Starlight с yarn
+yarn upgrade @astrojs/starlight --latest
+```
+
+</TabItem>
+</Tabs>
+
+Вы можете увидеть полный список изменений, сделанных в каждом релизе,
+в [списке изменений Starlight](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md).
+
+## Устранение проблем с Starlight
+
+Информация о [конфигурации проекта Starlight](/ru/reference/configuration/)
+и [конфигурации метаданных отдельной страницы](/ru/reference/frontmatter/) доступна в разделе Справочник этого сайта.
+Используйте эти страницы, чтобы убедиться, что ваш сайт на Starlight настроен и работает корректно.
+
+Смотрите пополняющийся список руководств в боковой панели для помощи в добавлении контента и настройке вашего сайта на Starlight.
+
+Если вы не можете найти ответ в этой документации, пожалуйста, посетите [полную документацию Astro](https://docs.astro.build/ru/).
+Ваш вопрос может быть решен узнав как в целом работает Astro под темой Starlight.
+
+Вы также можете узнать про любые известные [проблемы Starlight на GitHub](https://github.com/withastro/starlight/issues) и получить помощь в
+[Discord Astro](https://astro.build/chat/) от нашего активного, дружелюбного сообщества!
+Задавайте вопросы на нашем форуме `#support` с тегом "starlight", или посетите наш специальный канал `#starlight`,
+чтобы обсудить текущую разработку и многое другое!