From c3732a9bb5cb7907f00a3ed5e65534f48a5ff6b9 Mon Sep 17 00:00:00 2001 From: juchym Date: Tue, 2 Jan 2024 19:02:33 +0100 Subject: i18n(uk): Add Ukrainian language. (#1295) Co-authored-by: Chris Swithinbank --- .changeset/shy-ties-punch.md | 5 + .github/labeler.yml | 1 + docs/astro.config.mjs | 8 ++ docs/package.json | 2 +- docs/src/content/docs/uk/404.md | 13 ++ docs/src/content/docs/uk/getting-started.mdx | 174 +++++++++++++++++++++++++++ docs/src/content/docs/uk/index.mdx | 53 ++++++++ docs/src/content/docs/uk/showcase.mdx | 53 ++++++++ packages/starlight/translations/uk.json | 24 ++-- 9 files changed, 320 insertions(+), 13 deletions(-) create mode 100644 .changeset/shy-ties-punch.md create mode 100644 docs/src/content/docs/uk/404.md create mode 100644 docs/src/content/docs/uk/getting-started.mdx create mode 100644 docs/src/content/docs/uk/index.mdx create mode 100644 docs/src/content/docs/uk/showcase.mdx 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: Г'юстоне, у нас проблема. Ми не змогли знайти цю сторінку.
Перевірте 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, виконавши наступну команду в вашому терміналі: + + + + +```sh +npm create astro@latest -- --template starlight +``` + + + + +```sh +pnpm create astro --template starlight +``` + + + + +```sh +yarn create astro --template starlight +``` + + + + +Це створить нову [директорію проєкту](/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) дозволяє попередньо переглянути вашу роботу та автоматично оновлює браузер, щойно ви вносите зміни. + +Щоби запустити розробницький сервер, виконайте таку команду в теці вашого проєкту: + + + + +```sh +npm run dev +``` + + + + +```sh +pnpm dev +``` + + + + +```sh +yarn dev +``` + + + + +У термінал видрукується 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'; + + + +- src/ + - content/ + - docs/ + - guides/ + - faq.md + - hello-world.md + + + +#### Безпека типів у преамбулі (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, ─ виконавши в терміналі команду: + + + + +```sh +npx @astrojs/upgrade +``` + + + + +```sh +pnpm dlx @astrojs/upgrade +``` + + + + +```sh +yarn dlx @astrojs/upgrade +``` + + + + +Повний список змін до кожного релізу дивіться в [списку змін 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'; + + + + Містить: навіґацію по сайту, пошук, інтернаціоналізацію, SEO, читку + типоґрафіку, підсвічування коду, темний режим і багато іншого. + + + Пустіть усю міць і швидкість Astro в дію. Розширте можливості Starlight за допомогою ваших + улюблених інтеґрацій та бібліотек для Astro. + + + Оберіть свою улюблену мову розмітки. Starlight забезпечить + типобезпечну валідацію frontmatter-преамбули за підтримки TypeScript. + + + Starlight це цілісне й безстороннє рішення, поєднуване з + React, Vue, Svelte, Solid тощо. + + + + +Astro ─ це універсальний веб-фреймворк, наготований на швидкість. +Беріть контент хоч звідки та розгортайте його будь-де, користуючи з ваших улюблених UI-компонентів і бібліотек. + +[Дізнатися більше про Astro](https://astro.build/) + + 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 уже використовується в продакшені. Ось деякі сайти в мережі: + + + +Перегляньте всі [публічні репозиторії на GitHub, які користають зі Starlight](https://github.com/withastro/starlight/network/dependents). + +## Плаґини від спільноти + +import { CardGrid, LinkCard } from '@astrojs/starlight/components'; + +Ці інструменти, плаґини та інтеґрації, розроблені спільнотою, працюють разом зі Starlight і розширююють його функціональність. + + + + + + + + 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 -- cgit