{$content.title}
\n\n{@const Title = $content.title}
\n\n\n\n\n\n> Якщо ваш застосунок уже існує, ви можете скористатися [Intlayer Compiler](/uk/doc/compiler) у поєднанні з [командой extract](/uk/doc/concept/cli/extract), щоб перетворити тисячі компонентів за одну секунду.\n```\n\n### (Необов'язково) Крок 6: Змініть мову вашого вмісту\n\n```svelte fileName=\"src/App.svelte\"\n\n\n{$content.markdownContent}
\n```\n\n> Ви також можете отримати доступ до даних front-matter вашого markdown за допомогою властивості `content.markdownContent.metadata.xxx`.\n\n### (Необов'язково) Крок 8: Налаштування intlayer editor / CMS\n\nЩоб налаштувати intlayer editor, дотримуйтесь [документації intlayer editor](/uk/doc/concept/editor).\n\nЩоб налаштувати intlayer CMS, дотримуйтесь [документації intlayer CMS](/uk/doc/concept/cms).\n\n### (Необов'язково) Крок 7: Додайте локалізований Routing у ваш застосунок\n\nЩоб обробляти локалізовану маршрутизацію в Svelte-застосунку, ви можете використовувати `svelte-spa-router` разом з `localeFlatMap` від Intlayer для генерації маршрутів для кожної локалі.\n\nСпочатку встановіть `svelte-spa-router`:\n\n```bash packageManager=\"npm\"\nnpm install svelte-spa-router\nnpx intlayer init\n```\n\n```bash packageManager=\"pnpm\"\npnpm add svelte-spa-router\npnpm intlayer init\n```\n\n```bash packageManager=\"yarn\"\nyarn add svelte-spa-router\nyarn intlayer init\n```\n\n```bash packageManager=\"bun\"\nbun add svelte-spa-router\n```\n\nThen, create a `Router.svelte` file to define your routes:\n\n```svelte fileName=\"src/Router.svelte\"\n\n\nЗадайте питання та отримайте підсумок документа, вказавши цю сторінку та обраного вами постачальника штучного інтелекту
Історія версій
- "Оновлення використання API useIntlayer у Solid для прямого доступу до властивостей"v8.9.004.05.2026
- "Додано команду init"v7.5.930.12.2025
- "Оновлено документацію"v5.5.1119.11.2025
- "Ініціалізовано історію"v5.5.1029.06.2025
Вміст цієї сторінки перекладено за допомогою штучного інтелекту.
Переглянути останню версію оригінального вмісту англійськоюЯкщо у вас є ідея щодо покращення цієї документації, будь ласка, долучіться, надіславши pull request на GitHub.
Посилання на документацію на GitHubСкопіювати документацію у форматі Markdown в буфер обміну
Перекладіть ваш вебсайт на Vite та Svelte за допомогою Intlayer | Інтернаціоналізація (i18n)
Зміст
Що таке Intlayer?
Intlayer, це інноваційна open-source бібліотека для інтернаціоналізації (i18n), створена для спрощення підтримки багатомовності в сучасних вебдодатках.
З Intlayer ви можете:
- Легко керувати перекладами за допомогою декларативних словників на рівні компонентів.
- Динамічно локалізувати метадані, маршрути й вміст.
- Забезпечити підтримку TypeScript за допомогою автогенерованих типів, що покращує автодоповнення та виявлення помилок.
- Скористатися розширеними можливостями, такими як динамічне визначення та перемикання локалі.
Покрокове керівництво зі встановлення Intlayer у Vite та Svelte додаток
Перегляньте Application Template на GitHub.
Крок 1: Встановлення залежностей
Встановіть необхідні пакети за допомогою npm:
Скопіюйте код у буфер обміну
npm install intlayer svelte-intlayernpm install vite-intlayer --save-devnpx intlayer initintlayer
Основний пакет, який надає інструменти для інтернаціоналізації: управління конфігурацією, переклади, оголошення контенту, транспіляцію та CLI-команди.
svelte-intlayer Пакет, який інтегрує Intlayer у Svelte-додаток. Він надає провайдери контексту та хуки для інтернаціоналізації у Svelte.
vite-intlayer Містить плагін Vite для інтеграції Intlayer з Vite bundler, а також middleware для виявлення переважної мови користувача, керування cookies та обробки перенаправлень URL.
Крок 2: Конфігурація вашого проєкту
Створіть конфігураційний файл для налаштування мов вашого застосунку:
Скопіюйте код у буфер обміну
import { Locales, type IntlayerConfig } from "intlayer";const config: IntlayerConfig = { internationalization: { locales: [ Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH, // Your other locales ], defaultLocale: Locales.ENGLISH, },};export default config;Через цей конфігураційний файл ви можете налаштувати локалізовані URL-адреси, перенаправлення в middleware, назви cookie, розташування та розширення ваших декларацій контенту, вимкнути логи Intlayer у консолі та інше. Для повного списку доступних параметрів зверніться до документації з конфігурації.
Крок 3: Інтеграція Intlayer у конфігурацію Vite
Додайте плагін intlayer до вашої конфігурації.
Скопіюйте код у буфер обміну
import { defineConfig } from "vite";import { svelte } from "@sveltejs/vite-plugin-svelte";import { intlayer } from "vite-intlayer";// Документація конфігурації: https://vitejs.dev/config/export default defineConfig({ plugins: [svelte(), intlayer()],});Плагін Vite intlayer() використовується для інтеграції Intlayer з Vite. Він забезпечує побудову файлів декларацій контенту та відстежує їх у режимі розробки. Він визначає змінні середовища Intlayer у Vite-додатку. Додатково він надаєаліаси (aliases) для оптимізації продуктивності.
Крок 4: Оголосіть свій контент
Створюйте та керуйте деклараціями контенту для зберігання перекладів:
Скопіюйте код у буфер обміну
import { t, type Dictionary } from "intlayer";
const appContent = {
key: "app",
content: {
title: t({
uk: "Привіт, світ",
en: "Hello World",
fr: "Bonjour le monde",
es: "Hola mundo",
}),
},
} satisfies Dictionary;
export default appContent;Ваші декларації контенту можуть бути визначені будь-де у вашому додатку, за умови, що вони знаходяться в директоріїcontentDir(за замовчуванням./src). І вони повинні відповідати розширенню файлу декларації контенту (за замовчуванням.content.{json,ts,tsx,js,jsx,mjs,cjs}).
Для докладнішої інформації зверніться до документації щодо декларації контенту.
Крок 5: Використання Intlayer у вашому коді
Скопіюйте код у буфер обміну
<script> import { useIntlayer } from "svelte-intlayer"; const content = useIntlayer("app");</script><div><!-- Відобразити вміст як простий контент --><h1>{$content.title}</h1><!-- Зробити вміст редагованим за допомогою редактора --><h1>{@const Title = $content.title}<Title /></h1><!-- Відобразити вміст як рядок --><div aria-label={$content.title.value}></div><div aria-label={$content.title.toString()}></div><div aria-label={String($content.title)}></div>> Якщо ваш застосунок уже існує, ви можете скористатися [Intlayer Compiler](/uk/doc/compiler) у поєднанні з [командой extract](/uk/doc/concept/cli/extract), щоб перетворити тисячі компонентів за одну секунду.(Необов'язково) Крок 6: Змініть мову вашого вмісту
Скопіюйте код у буфер обміну
<script lang="ts">import { getLocaleName } from 'intlayer';import { useLocale } from "svelte-intlayer";// Отримати інформацію про локаль та функцію setLocaleconst { locale, availableLocales, setLocale } = useLocale();// Обробка зміни локаліconst changeLocale = (event: Event) => { const target = event.target as HTMLSelectElement; const newLocale = target.value; setLocale(newLocale);};</script><div> <select value={$locale} on:change={changeLocale}> {#each availableLocales ?? [] as loc} <option value={loc}> {getLocaleName(loc)} </option> {/each} </select></div>(Необов'язково) Крок 7: Відображення Markdown
Intlayer підтримує рендеринг вмісту в Markdown безпосередньо у вашому Svelte-застосунку. За замовчуванням Markdown розглядається як звичайний текст. Щоб перетворити Markdown у багате HTML-представлення, ви можете інтегрувати @humanspeak/svelte-markdown або інший Markdown-парсер.
Щоб дізнатися, як оголосити markdown-контент за допомогою пакета intlayer, див. документацію з markdown.
Скопіюйте код у буфер обміну
<script> import { setIntlayerMarkdown } from "svelte-intlayer"; setIntlayerMarkdown((markdown) => // відобразити вміст markdown як рядок return markdown; );</script><h1>{$content.markdownContent}</h1>Ви також можете отримати доступ до даних front-matter вашого markdown за допомогою властивості content.markdownContent.metadata.xxx.
(Необов'язково) Крок 8: Налаштування intlayer editor / CMS
Щоб налаштувати intlayer editor, дотримуйтесь документації intlayer editor.
Щоб налаштувати intlayer CMS, дотримуйтесь документації intlayer CMS.
(Необов'язково) Крок 7: Додайте локалізований Routing у ваш застосунок
Щоб обробляти локалізовану маршрутизацію в Svelte-застосунку, ви можете використовувати svelte-spa-router разом з localeFlatMap від Intlayer для генерації маршрутів для кожної локалі.
Спочатку встановіть svelte-spa-router:
Скопіюйте код у буфер обміну
npm install svelte-spa-routernpx intlayer initThen, create a Router.svelte file to define your routes:
Скопіюйте код у буфер обміну
<script lang="ts">import { localeFlatMap } from "intlayer";import Router from "svelte-spa-router";import { wrap } from "svelte-spa-router/wrap";import App from "./App.svelte";const routes = Object.fromEntries( localeFlatMap(({locale, urlPrefix}) => [ [ urlPrefix || '/', wrap({ component: App as any, props: { locale, }, }), ], ]));</script><Router {routes} />Update your main.ts to mount the Router component instead of App:
Скопіюйте код у буфер обміну
import { mount } from "svelte";import Router from "./Router.svelte";const app = mount(Router, { target: document.getElementById("app")!,});export default app;Нарешті, оновіть ваш App.svelte, щоб приймати проп locale і використовувати його з useIntlayer:
Скопіюйте код у буфер обміну
<script lang="ts">import type { Locale } from 'intlayer';import { useIntlayer } from "svelte-intlayer";import Counter from './lib/Counter.svelte';import LocaleSwitcher from './lib/LocaleSwitcher.svelte';export let locale: Locale;$: content = useIntlayer('app', locale);</script><main> <div class="locale-switcher-container"> <LocaleSwitcher currentLocale={locale} /> </div> <!-- ... решта вашого додатка ... --></main>Налаштування маршрутизації на стороні сервера (необов'язково)
Паралельно ви також можете використати intlayerProxy для додавання маршрутизації на стороні сервера до вашого застосунку. Цей плагін автоматично визначатиме поточну локаль на основі URL і встановлюватиме відповідний cookie для локалі. Якщо локаль не вказана, плагін обере найвідповіднішу локаль на основі налаштувань мови браузера користувача. Якщо локаль не буде виявлена, плагін виконає перенаправлення на локаль за замовчуванням.
Зауважте, що для використанняintlayerProxyв production потрібно перемістити пакетvite-intlayerзdevDependenciesдоdependencies.
Скопіюйте код у буфер обміну
import { defineConfig } from "vite";
import { svelte } from "@sveltejs/vite-plugin-svelte";
import { intlayer, intlayerProxy } from "vite-intlayer";
// https://vitejs.dev/config/ - конфігурація Vite
export default defineConfig({
plugins: [
intlayerProxy(), // should be placed first
svelte(),
intlayer(),
],
});(Необов'язково) Крок 8: Зміна URL при зміні локалі
Щоб дозволити користувачам змінювати мову й відповідно оновлювати URL, ви можете створити компонент LocaleSwitcher. Цей компонент використовуватиме getLocalizedUrl з intlayer та push із svelte-spa-router.
Скопіюйте код у буфер обміну
<script lang="ts">import { getLocaleName, getLocalizedUrl } from "intlayer";import { useLocale } from "svelte-intlayer";import { push } from "svelte-spa-router";export let currentLocale: string | undefined = undefined;// Отримати інформацію про локальconst { locale, availableLocales } = useLocale();// Обробка зміни локаліconst changeLocale = (event: Event) => { const target = event.target as HTMLSelectElement; const newLocale = target.value; const currentUrl = window.location.pathname; const url = getLocalizedUrl( currentUrl, newLocale); push(url);};</script><div class="locale-switcher"> <select value={currentLocale ?? $locale} onchange={changeLocale}> {#each availableLocales ?? [] as loc} <option value={loc}> {getLocaleName(loc)} </option> {/each} </select></div>(Необов'язково) Крок 9: Інтернаціоналізовані посилання
Для SEO рекомендується додавати префікс локалі до ваших маршрутів (наприклад, /about, /fr/about).
Скопіюйте код у буфер обміну
<script lang="ts"> import { getLocalizedUrl } from "intlayer"; import { useLocale } from "svelte-intlayer"; export let href = ""; const { locale } = useLocale(); // Helper to prefix URL $: localizedHref = getLocalizedUrl(href, $locale);</script><a href={localizedHref}> <slot /></a>Конфігурація Git
Рекомендується ігнорувати файли, згенеровані Intlayer. Це дозволяє уникнути їх коміту до вашого Git-репозиторію.
Для цього можна додати наступні інструкції до файлу .gitignore:
Скопіюйте код у буфер обміну
# Ігнорувати файли, згенеровані Intlayer.intlayerРозширення VS Code
Щоб покращити ваш досвід розробки з Intlayer, ви можете встановити офіційне Intlayer VS Code Extension.
Встановити з VS Code Marketplace
Це розширення надає:
- Автозаповнення для ключів перекладу.
- Виявлення помилок у реальному часі для відсутніх перекладів.
- Вбудовані попередні перегляди перекладеного контенту.
- Швидкі дії для швидкого створення й оновлення перекладів.
Для детальнішої інформації про використання розширення зверніться до документації розширення Intlayer для VS Code.
(Необов'язково) Крок 1 : Витягніть вміст ваших компонентів
Якщо у вас є існуюча кодова база, перетворення тисяч файлів може зайняти багато часу.
Щоб спростити цей процес, Intlayer пропонує компілятор / екстрактор для перетворення ваших компонентів і витягування вмісту.
Щоб налаштувати його, ви можете додати розділ compiler у свій файл intlayer.config.ts:
Скопіюйте код у буфер обміну
import { type IntlayerConfig } from "intlayer";
const config: IntlayerConfig = {
// ... Інша частина вашої конфігурації
compiler: {
/**
* Вказує, чи повинен бути включений компілятор.
*/
enabled: true,
/**
* Визначає шлях до вихідних файлів
*/
output: ({ fileName, extension }) => `./${fileName}${extension}`,
/**
* Вказує, чи повинні компоненти зберігатися після перетворення. Таким чином, компілятор можна запустити лише один раз для перетворення програми, а потім видалити.
*/
saveComponents: false,
/**
* Префікс ключа словника
*/
dictionaryKeyPrefix: "",
},
};
export default config;Запустіть екстрактор для перетворення компонентів і витягування вмісту
Скопіюйте код у буфер обміну
npx intlayer extract(Опційно) Sitemap і robots.txt (генерація під час збірки)
Intlayer надає generateSitemap і getMultilingualUrls - утиліти для формування багатомовних sitemap.xml і robots.txt для краулерів та автоматичного запису в public/. Зазвичай запускають невеликий Node-скрипт перед Vite (наприклад, npm-хуки predev / prebuild).
Sitemap
Генератор sitemap враховує локалі й додає метадані для краулерів.
Підтримується простір іменxhtml:link(hreflang). Замість плоского списку URL Intlayer пов’язує всі мовні версії сторінки в обидва боки (наприклад/about,/fr/aboutабо/about?lang=frзалежно від режиму маршрутизації).
Robots.txt
Використовуйте getMultilingualUrls, щоб правила Disallow покривали всі локалізовані варіанти шляхів.
1. Файл generate-seo.mjs у корені проєкту
Скопіюйте код у буфер обміну
import fs from "fs";import path from "path";import { fileURLToPath } from "url";import { generateSitemap, getMultilingualUrls } from "intlayer";const __dirname = path.dirname(fileURLToPath(import.meta.url));const SITE_URL = (process.env.SITE_URL || "http://localhost:5173").replace( /\/$/, "");const pathList = [ { path: "/", changefreq: "daily", priority: 1.0 }, { path: "/about", changefreq: "monthly", priority: 0.7 },];const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);const getAllMultilingualUrls = (urls) => urls.flatMap((url) => Object.values(getMultilingualUrls(url)));const disallowedPaths = getAllMultilingualUrls(["/admin", "/private"]);const robotsTxt = [ "User-agent: *", "Allow: /", ...disallowedPaths.map((path) => `Disallow: ${path}`), "", `Sitemap: ${SITE_URL}/sitemap.xml`,].join("\n");fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);console.log("SEO files generated successfully.");Пакет intlayer має бути встановлений. У продакшені задайте SITE_URL у середовищі (наприклад у CI).
Для Node ESM кращеgenerate-seo.mjs. Дляgenerate-seo.jsдодайте"type": "module"уpackage.jsonабо ввімкніть ESM інакше.
2. Запуск скрипта перед Vite
Скопіюйте код у буфер обміну
{ "scripts": { "dev": "vite", "prebuild": "node generate-seo.mjs", "build": "vite build", "preview": "vite preview" }}Підлаштуйте команди для pnpm або yarn. Можна викликати скрипт із CI.
Розширені можливості
Щоб рухатися далі, ви можете реалізувати візуальний редактор або винести свій контент у зовнішню систему за допомогою CMS.