i18n(uk): Add Ukrainian language. (#1295)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>

9 files changed, 320 insertions, 13 deletions

diff --git a/.changeset/shy-ties-punch.md b/.changeset/shy-ties-punch.md
new file mode 100644
index 00000000..bda93f3f
--- /dev/null
+++ b/.changeset/shy-ties-punch.md
@@ -0,0 +1,5 @@
+---
+'@astrojs/starlight': patch
+---
+
+Improve Ukrainian UI translations
diff --git a/.github/labeler.yml b/.github/labeler.yml
index 833c0cb9..369329b0 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -17,6 +17,7 @@ i18n:
   - docs/src/content/docs/tr/**/*
   - docs/src/content/docs/hi/**/*
   - docs/src/content/docs/da/**/*
+  - docs/src/content/docs/uk/**/*
 
 '🌟 core':
   - packages/starlight/**
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index 550cf8d6..8e1f591b 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -16,6 +16,7 @@ export const locales = {
 	ru: { label: 'Русский', lang: 'ru' },
 	hi: { label: 'हिंदी', lang: 'hi' },
 	da: { label: 'Dansk', lang: 'da' },
+	uk: { label: 'Українська', lang: 'uk'},
 };
 
 /* https://vercel.com/docs/projects/environment-variables/system-environment-variables#system-environment-variables */
@@ -80,6 +81,7 @@ export default defineConfig({
 						tr: 'Buradan Başlayın',
 						ru: 'Начать отсюда',
 						hi: 'यहाँ से शुरू करे',
+						uk: 'Почніть звідси',
 					},
 					items: [
 						{
@@ -98,6 +100,7 @@ export default defineConfig({
 								tr: 'Başlarken',
 								ru: 'Введение',
 								hi: 'पहले कदम',
+								uk: 'Вступ',
 							},
 						},
 						{
@@ -116,6 +119,7 @@ export default defineConfig({
 								tr: 'Elle Kurulum',
 								ru: 'Установка вручную',
 								hi: 'मैनुअल सेटअप',
+								uk: 'Ручне встановлення',
 							},
 						},
 						{
@@ -134,6 +138,7 @@ export default defineConfig({
 								tr: 'Çevre Etkisi',
 								ru: 'Влияние на окружающую среду',
 								hi: 'पर्यावरणीय प्रभाव',
+								uk: 'Вплив на довкілля',
 							},
 						},
 						{
@@ -150,6 +155,7 @@ export default defineConfig({
 								tr: 'Vitrin',
 								ru: 'Примеры',
 								hi: 'प्रदर्शन',
+								uk: 'Вітрина',
 							},
 						},
 					],
@@ -169,6 +175,7 @@ export default defineConfig({
 						tr: 'Rehber',
 						ru: 'Руководства',
 						hi: 'गाइड',
+						uk: 'Ґайди',
 					},
 					autogenerate: { directory: 'guides' },
 				},
@@ -187,6 +194,7 @@ export default defineConfig({
 						tr: 'Referanslar',
 						ru: 'Справочник',
 						hi: 'संदर्भ',
+						uk: 'Довідник',
 					},
 					autogenerate: { directory: 'reference' },
 				},
diff --git a/docs/package.json b/docs/package.json
index f936d3f7..f8449934 100644
--- a/docs/package.json
+++ b/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-cn|fr|es|pt-br|it|id|ko|ru|tr|hi|da)/.*'",
+    "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-cn|fr|es|pt-br|it|id|ko|ru|tr|hi|da|uk)/.*'",
     "dev": "astro dev",
     "start": "astro dev",
     "build": "astro build",
diff --git a/docs/src/content/docs/uk/404.md b/docs/src/content/docs/uk/404.md
new file mode 100644
index 00000000..87acd71d
--- /dev/null
+++ b/docs/src/content/docs/uk/404.md
@@ -0,0 +1,13 @@
+---
+title: Не знайдено
+template: splash
+editUrl: false
+hero:
+  title: '404'
+  tagline: <strong>Г'юстоне, у нас проблема.</strong> Ми не змогли знайти цю сторінку.<br>Перевірте URL або спробуйте скористатися пошуком.
+  actions:
+    - text: Додому
+      icon: right-arrow
+      link: /uk/
+      variant: primary
+---
diff --git a/docs/src/content/docs/uk/getting-started.mdx b/docs/src/content/docs/uk/getting-started.mdx
new file mode 100644
index 00000000..ede37482
--- /dev/null
+++ b/docs/src/content/docs/uk/getting-started.mdx
@@ -0,0 +1,174 @@
+---
+title: Вступ
+description: Дізнайтеся, як стати до створення свого наступного документаційного сайту зі Starlight від Astro.
+---
+
+import { Tabs, TabItem } from '@astrojs/starlight/components';
+
+Starlight ─ це повнофункціональна документаційна схема, побудована на основа фреймворку [Astro](https://astro.build).
+Цей ґайд допоможе вам розпочати роботу над новим проєктом.
+Щоби додати Starlight до наявного проєкту Astro, дивіться [інструкції з ручного встановлення](/uk/manual-setup/).
+
+## Прудкий старт
+
+### Створіть новий проєкт
+
+Створіть новий проєкт Astro + Starlight, виконавши наступну команду в вашому терміналі:
+
+<Tabs>
+<TabItem label="npm">
+
+```sh
+npm create astro@latest -- --template starlight
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm create astro --template starlight
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn create astro --template starlight
+```
+
+</TabItem>
+</Tabs>
+
+Це створить нову [директорію проєкту](/uk/guides/project-structure/) з усіма необхідними файлами й конфіґурацією для вашого сайту.
+
+:::tip[Побачте це в дії]
+Випробуйте Starlight у вашому браузері:
+[відкрити шаблон на StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics).
+:::
+
+### Запустіть розробницький сервер
+
+Коли працюєте локально, [розробницький сервер Astro](https://docs.astro.build/en/reference/cli-reference/#astro-dev) дозволяє попередньо переглянути вашу роботу та автоматично оновлює браузер, щойно ви вносите зміни.
+
+Щоби запустити розробницький сервер, виконайте таку команду в теці вашого проєкту:
+
+<Tabs>
+<TabItem label="npm">
+
+```sh
+npm run dev
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm dev
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn dev
+```
+
+</TabItem>
+</Tabs>
+
+У термінал видрукується URL локального сервера.
+Відкрийте цю ланку, щоби переглянути сайт.
+
+### Додайте контент
+
+Starlight підготовлено, тепер ви можете додавати новий контент або долучати наявні файли!
+
+#### Формати файлів
+
+Starlight підтримує створення контенту у форматах Markdown і MDX без жодних додаткових налаштувань.
+Ви можете додати підтримку Markdoc, встановивши експериментальну [інтеґрацію Astro Markdoc](https://docs.astro.build/guides/integrations-guide/markdoc/).
+
+#### Додайте сторінки
+
+Додавайте нові сторінки на ваш сайт, створюючи файли `.md` та `.mdx` у теці `src/content/docs/`.
+Використовуйте підтеки, щоб орґанізовувати файли та створювати множинні сеґменти шляху.
+
+Наприклад, оттака структура файлів зґенерує сторінки за адресами `example.com/hello-world` і `example.com/guides/faq`:
+
+import FileTree from '../../../components/file-tree.astro';
+
+<FileTree>
+
+- src/
+  - content/
+    - docs/
+      - guides/
+        - faq.md
+      - hello-world.md
+
+</FileTree>
+
+#### Безпека типів у преамбулі (frontmatter)
+
+У Starlight усі сторінки поділяють спільний налаштовуваний [набір властивостей преамбули](/uk/reference/frontmatter/), якими визначається вигляд сторінки:
+
+```md
+---
+title: Привіт, світ!
+description: Це сторінка на моїм сайті, що він працює на Starlight!
+---
+```
+
+Якщо ви забудете щось важливе, Starlight сповістить вас про це.
+
+### Наступні кроки
+
+- **Конфіґурація:** Дізнайтеся про поширені параметри в ґайді [“Налаштовування Starlight”](/uk/guides/customization/).
+- **Навіґація:** Спорудить бічну панель у розділі [“Навіґація бічною панеллю”](/uk/guides/sidebar/).
+- **Компоненти:** Відкрийте вбудовані картки, вкладки та багато іншого в [“Компонентах”](/uk/guides/components/).
+- **Розгортування:** Опублікуйте власну працю за допомогою посібника [“Розгорніть свій сайт”](https://docs.astro.build/guides/deploy/) в документації Astro.
+
+## Оновлення Starlight
+
+:::tip
+Оскільки Starlight поки на стадії beta, очікуйте частих оновлень.
+Не забувайте регулярно оновлювати Starlight!
+:::
+
+Starlight є інтеґрацією Astro, отже ви можете оновити його так само, як і решту пакетів Astro, ─ виконавши в терміналі команду:
+
+<Tabs>
+<TabItem label="npm">
+
+```sh
+npx @astrojs/upgrade
+```
+
+</TabItem>
+<TabItem label="pnpm">
+
+```sh
+pnpm dlx @astrojs/upgrade
+```
+
+</TabItem>
+<TabItem label="Yarn">
+
+```sh
+yarn dlx @astrojs/upgrade
+```
+
+</TabItem>
+</Tabs>
+
+Повний список змін до кожного релізу дивіться в [списку змін Starlight](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md).
+
+## Зневадження Starlight
+
+Використовуйте довідкові сторінки [конфіґурація проєкту](/uk/reference/configuration/) та [індивідуальні налаштуванні преамбули сторінки](/uk/reference/frontmatter/), щоб упевнитися, що ваш сайт налаштований і функціонує належним чином.
+Перегляньте ґайди на бічній панелі, щоби дізнатися, як додавати контент і налаштовувати сайт Starlight.
+
+Якщо ви не можете знайти відповідь у цій документації, будь ласка, перегляньте [повну документацію Astro](https://docs.astro.build/).
+Ваше питання можна вирішити, зрозумівши, як працює Астро загалом, під капотом Starlight.
+
+Ви також можете перевірити відомі [проблеми Starlight на GitHub](https://github.com/withastro/starlight/issues), а також звернутися по допомогу на [Discord-сервері Astro](https://astro.build/chat/) до нашої активної, дружньої спільноти! Ставте запитання в гілці `#support` із теґом "starlight" або відвідайте спеціальну гілку `#starlight`, щоб обговорити поточну розробку та багато іншого!
diff --git a/docs/src/content/docs/uk/index.mdx b/docs/src/content/docs/uk/index.mdx
new file mode 100644
index 00000000..efce042f
--- /dev/null
+++ b/docs/src/content/docs/uk/index.mdx
@@ -0,0 +1,53 @@
+---
+title: Starlight 🌟 Створюйте документаційні сайти з Astro
+head:
+  - tag: title
+    content: Starlight 🌟 Створюйте документаційні сайти з Astro
+description: Starlight допомагає створювати гарні й високоефективні документаційні вебсайти за допомогою Astro.
+template: splash
+editUrl: false
+lastUpdated: false
+hero:
+  title: Осяйте вашу документацію зі Starlight
+  tagline: Усе, що треба для створення блискучого документаційного сайту. Швидко, доступно та просто в користуванні.
+  image:
+    file: ../../../assets/hero-star.webp
+  actions:
+    - text: Розпочати
+      icon: right-arrow
+      variant: primary
+      link: /uk/getting-started/
+    - text: Переглянути на GitHub
+      icon: external
+      link: https://github.com/withastro/starlight
+---
+
+import { CardGrid, Card } from '@astrojs/starlight/components';
+import AboutAstro from '../../../components/about-astro.astro';
+
+<CardGrid stagger>
+	<Card title="Документація, що кидає в захват" icon="open-book">
+		Містить: навіґацію по сайту, пошук, інтернаціоналізацію, SEO, читку
+		типоґрафіку, підсвічування коду, темний режим і багато іншого.
+	</Card>
+	<Card title="Працює на Astro" icon="rocket">
+		Пустіть усю міць і швидкість Astro в дію. Розширте можливості Starlight за допомогою ваших
+		улюблених інтеґрацій та бібліотек для Astro.
+	</Card>
+	<Card title="Markdown, Markdoc і MDX" icon="document">
+		Оберіть свою улюблену мову розмітки. Starlight забезпечить
+		типобезпечну валідацію frontmatter-преамбули за підтримки TypeScript.
+	</Card>
+	<Card title="Заживайте власні UI-компоненти" icon="puzzle">
+		Starlight це цілісне й безстороннє рішення, поєднуване з
+		React, Vue, Svelte, Solid тощо.
+	</Card>
+</CardGrid>
+
+<AboutAstro title="Подано">
+Astro ─ це універсальний веб-фреймворк, наготований на швидкість.
+Беріть контент хоч звідки та розгортайте його будь-де, користуючи з ваших улюблених UI-компонентів і бібліотек.
+
+[Дізнатися більше про Astro](https://astro.build/)
+
+</AboutAstro>
diff --git a/docs/src/content/docs/uk/showcase.mdx b/docs/src/content/docs/uk/showcase.mdx
new file mode 100644
index 00000000..76ae2068
--- /dev/null
+++ b/docs/src/content/docs/uk/showcase.mdx
@@ -0,0 +1,53 @@
+---
+title: Вітрина Starlight
+description: Відкрийте сайти, створені зі Starlight, та інструменти спільноти, які розширюють можливості Starlight!
+---
+
+:::tip[Додайте своє!]
+Створили сайт на Starlight або інструмент для Starlight?
+Відкрийте PR, щоби розмістити ланку на цій сторінці!
+:::
+
+## Сайти
+
+import ShowcaseSites from '../../../components/showcase-sites.astro';
+
+Starlight уже використовується в продакшені. Ось деякі сайти в мережі:
+
+<ShowcaseSites />
+
+Перегляньте всі [публічні репозиторії на GitHub, які користають зі Starlight](https://github.com/withastro/starlight/network/dependents).
+
+## Плаґини від спільноти
+
+import { CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+Ці інструменти, плаґини та інтеґрації, розроблені спільнотою, працюють разом зі Starlight і розширююють його функціональність.
+
+<CardGrid>
+	<LinkCard
+		href="https://www.feelback.dev/blog/new-astro-starlight-integration/"
+		title="FeelBack"
+		description="Додайте систему зворотнього зв'язку на сторінки вашої документації."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-blog"
+		title="starlight-blog"
+		description="Додайте блоґ на ваш документаційний сайт."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-links-validator"
+		title="starlight-links-validator"
+		description="Перевірте наявність зламаних ланок на сторінках Starlight."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-typedoc"
+		title="starlight-typedoc"
+		description="Ґенеруйте сторінки Starlight за допомогою TypeScript і TypeDoc."
+	/>
+	<LinkCard
+		href="https://github.com/HiDeoo/starlight-openapi"
+		title="starlight-openapi"
+		description="Створюйте сторінки документації зі специфікацій OpenAPI/Swagger."
+	/>
+</CardGrid>
diff --git a/packages/starlight/translations/uk.json b/packages/starlight/translations/uk.json
index 7a601b81..8f5d86e6 100644
--- a/packages/starlight/translations/uk.json
+++ b/packages/starlight/translations/uk.json
@@ -3,24 +3,24 @@
   "search.label": "Пошук",
   "search.shortcutLabel": "(Натисніть / для Пошуку)",
   "search.cancelLabel": "Скасувати",
-  "search.devWarning": "Пошук доступний лише у виробничих зборках. \nСпробуйте виконати збірку та переглянути сайт, щоб протестувати його локально",
-  "themeSelect.accessibleLabel": "Вибрати Тему",
+  "search.devWarning": "Пошук доступний лише у виробничих зборках. \nСпробуйте зібрати та переглянути сайт, щоби протестувати його локально",
+  "themeSelect.accessibleLabel": "Обрати тему",
   "themeSelect.dark": "Темна",
   "themeSelect.light": "Світла",
   "themeSelect.auto": "Авто",
-  "languageSelect.accessibleLabel": "Оберіть мову",
+  "languageSelect.accessibleLabel": "Обрати мову",
   "menuButton.accessibleLabel": "Меню",
   "sidebarNav.accessibleLabel": "Головне",
   "tableOfContents.onThisPage": "На цій сторінці",
   "tableOfContents.overview": "Огляд",
-  "i18n.untranslatedContent": "Цей контент ще не доступний на Вашій мові.",
+  "i18n.untranslatedContent": "Цей контент ще не доступний вашою мовою.",
   "page.editLink": "Редагувати сторінку",
   "page.lastUpdated": "Останнє оновлення:",
-  "page.previousLink": "Попередня",
-  "page.nextLink": "Наступна",
-  "404.text": "Сторінку не знайдено. Перевірте URL-адресу або спробуйте скористатися рядком пошуку.",
-  "aside.note": "Note",
-  "aside.tip": "Tip",
-  "aside.caution": "Caution",
-  "aside.danger": "Danger"
-}
+  "page.previousLink": "Назад",
+  "page.nextLink": "Далі",
+  "404.text": "Сторінку не знайдено. Перевірте URL або спробуйте скористатися пошуком.",
+  "aside.note": "Заувага",
+  "aside.tip": "Порада",
+  "aside.caution": "Обережно",
+  "aside.danger": "Небезпечно"
+}
\ No newline at end of file