diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index b139d79c8e9..a75826cdf26 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -140,6 +140,7 @@ export default defineConfig({
ko: '컴포넌트',
ja: 'コンポーネント',
'zh-CN': '组件',
+ uk: 'Компоненти',
},
autogenerate: { directory: 'components' },
},
@@ -172,6 +173,7 @@ export default defineConfig({
ja: 'リソース',
ru: 'Ресурсы',
ko: '리소스',
+ uk: 'Ресурси',
},
autogenerate: { directory: 'resources' },
},
diff --git a/docs/src/content/docs/uk/manual-setup.mdx b/docs/src/content/docs/uk/manual-setup.mdx
new file mode 100644
index 00000000000..dca82e412e8
--- /dev/null
+++ b/docs/src/content/docs/uk/manual-setup.mdx
@@ -0,0 +1,128 @@
+---
+title: Ручне налаштування
+description: Дізнайтеся, як налаштувати Starlight вручну для додавання його в існуючий проект Astro.
+---
+
+import { Tabs, TabItem } from '@astrojs/starlight/components';
+
+Найшвидший спосіб створити новий сайт Starlight - це скористатися командою `create astro` як показано у [Вступі](/uk/getting-started/#створіть-новий-проєкт).
+Якщо ви хочете додати Starlight до існуючого проекту Astro, цей посібник пояснить як.
+
+## Налаштування Starlight
+
+Щоб слідувати цьому посібнику, вам знадобиться існуючий проєкт Astro.
+
+### Додайте інтеґрацію Starlight
+
+Starlight є [інтеґрацією Astro](https://docs.astro.build/en/guides/integrations-guide/). Додайте її до свого сайту, виконавши команду `astro add` у кореневій директорії вашого проєкту:
+
+
+
+ ```sh
+ npx astro add starlight
+ ```
+
+
+ ```sh
+ pnpm astro add starlight
+ ```
+
+
+ ```sh
+ yarn astro add starlight
+ ```
+
+
+
+Це встановить необхідні залежності та додасть Starlight до масиву integrations у вашому конфіґураційному файлі Astro.
+
+### Налаштуйте інтеґрацію
+
+Інтеґрація Starlight налаштовується у файлі `astro.config.mjs`.
+
+Додайте `title`, щоб почати:
+
+```js ins={8}
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+export default defineConfig({
+ integrations: [
+ starlight({
+ title: 'Мій чудовий сайт документації',
+ }),
+ ],
+});
+```
+
+Знайдіть усі доступні параметри в [документації з налаштування Starlight](/uk/reference/configuration/).
+
+### Налаштуйте колекції контенту
+
+Starlight побудований поверх [колекцій вмісту](https://docs.astro.build/en/guides/content-collections/) в Astro, які налаштовуються в файлі `src/content/config.ts`.
+
+Створіть або оновіть файл конфіґурації вмісту, додавши колекцію `docs`, яка використовує `docsSchema` від Starlight:
+
+```js ins={3,6}
+// src/content/config.ts
+import { defineCollection } from 'astro:content';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+ docs: defineCollection({ schema: docsSchema() }),
+};
+```
+
+### Додайте вміст
+
+Starlight тепер налаштовано, і час додати трохи вмісту!
+
+Створіть директорію `src/content/docs/` і почніть з додавання файлу `index.md`.
+Це буде домашня сторінка вашого нового сайту:
+
+```md
+---
+# src/content/docs/index.md
+title: Моя документація
+description: Дізнайтеся більше про мій проєкт на цьому сайті документації, створеному за допомогою Starlight.
+---
+
+Ласкаво просимо до мого проєкту!
+```
+
+Starlight використовує маршрутизацію на основі файлів, що означає, що кожен файл Markdown, MDX або Markdoc у `src/content/docs/` стане сторінкою на вашому сайті. Метадані Frontmatter (поля `title` і `description` в наведеному вище прикладі) можуть змінити спосіб відображення кожної сторінки.
+Перегляньте всі доступні параметри в [документації frontmatter](/uk/reference/frontmatter/).
+
+## Поради щодо існуючих сайтів
+
+Якщо у вас вже є існуючий проект Astro, ви можете використовувати Starlight для швидкого додавання розділу документації на ваш сайт.
+
+### Використання Starlight з підшляхами
+
+Щоб додати всі сторінки Starlight в підшлях, розмістіть весь свій вміст в підкаталозі `src/content/docs/`.
+
+Наприклад, якщо Starlight сторінки повинні всі починатися з `/guides/`, додайте свій вміст в `src/content/docs/guides/` каталог:
+
+import { FileTree } from '@astrojs/starlight/components';
+
+
+
+- src/
+ - content/
+ - docs/
+ - **guides/**
+ - guide.md
+ - index.md
+ - pages/
+- astro.config.mjs
+
+
+
+У майбутньому ми плануємо краще підтримувати цей випадок, щоб уникнути необхідності в додатковій вкладеній директорії в `src/content/docs/`.
+
+### Використання Starlight з SSR
+
+Щоб увімкнути SSR, дотримуйтесь посібника [“Адаптери для рендерингу на вимогу”](https://docs.astro.build/en/guides/server-side-rendering/) в документації Astro, щоб додати серверний адаптер до вашого проєкту Starlight.
+
+Сторінки документації, згенеровані Starlight, попередньо рендеряться за замовчуванням незалежно від режиму виводу вашого проєкту. Щоб вимкнути попередній рендеринг ваших сторінок Starlight, встановіть [параметр конфіґурації `prerender`](/uk/reference/configuration/#prerender) у значення `false`.