Документація Intlayer

Ласкаво просимо до офіційної документації Intlayer! Тут ви знайдете все, що потрібно для інтеграції, конфігурації та опанування Intlayer для всіх ваших потреб з інтернаціоналізації (i18n), незалежно від того, працюєте ви з Next.js, React, Vite, Express або іншим JavaScript-середовищем.

Вступ

Що таке Intlayer?

Intlayer, бібліотека інтернаціоналізації (i18n), розроблена спеціально для JavaScript-розробників. Вона дозволяє оголошувати ваш контент у будь-якому місці коду. Intlayer перетворює оголошення багатомовного контенту на структуровані словники, щоб їх було легко інтегрувати у ваш код. Використовуючи TypeScript, Intlayer робить розробку більш надійною та ефективною.

Intlayer також надає необов'язковий візуальний редактор, який дозволяє легко редагувати та керувати контентом. Цей редактор особливо корисний для розробників, які віддають перевагу візуальному інтерфейсу для управління контентом, або для команд, що генерують контент без необхідності працювати з кодом.

Приклад використання

.└── Components    └── MyComponent        ├── index.content.ts        └── index.tsx

import { t, type Dictionary } from "intlayer";

const componentContent = {
  key: "component-key",
  content: {
    myTranslatedContent: t({
      uk: "Привіт, світ",
      en: "Hello World",
      es: "Hola Mundo",
      fr: "Bonjour le monde",
    }),
  },
} satisfies Dictionary;

export default componentContent;

import type { FC } from "react";
import { useIntlayer } from "react-intlayer";

export const MyComponent: FC = () => {
  const { myTranslatedContent } = useIntlayer("component-key");

  return <span>{myTranslatedContent}</span>;
};

Основні можливості

Intlayer пропонує низку можливостей, адаптованих під потреби сучасної веб-розробки. Нижче наведено ключові функції з посиланнями на докладну документацію для кожної:

• Підтримка інтернаціоналізації: Розширюйте глобальне охоплення вашого застосунку за допомогою вбудованої підтримки інтернаціоналізації.
• Візуальний редактор: Покращуйте свій робочий процес розробки за допомогою плагінів для редактора, створених для Intlayer. Перегляньте Посібник із візуального редактора.
• Гнучкість конфігурації: Налаштуйте ваше середовище за допомогою широких опцій конфігурації, детально описаних у Довіднику з конфігурації.
• Розширені інструменти CLI: Ефективно керуйте своїми проєктами за допомогою командного інтерфейсу Intlayer. Дослідіть можливості в Документації інструментів CLI.

Основні поняття

Словник

Організуйте ваш багатомовний контент поруч із кодом, щоб усе залишалося узгодженим і простим у підтримці.

• Початок роботи
  Дізнайтеся основи декларування вашого контенту в Intlayer.

• Переклад
  Дізнайтеся, як переклади генеруються, зберігаються та використовуються у вашому застосунку.

• Перелічення
  Легко керуйте повторюваними або фіксованими наборами даних для різних мов.

• Умова
  Дізнайтеся, як використовувати умовну логіку в Intlayer для створення динамічного контенту.

• Вставлення Дізнайтеся, як вставляти значення в рядок за допомогою плейсхолдерів вставки.

• Отримання за допомогою функцій
  Дізнайтеся, як динамічно отримувати контент за допомогою кастомної логіки, щоб відповідати робочому процесу вашого проєкту.

• Markdown
  Дізнайтеся, як використовувати Markdown в Intlayer для створення насиченого контенту.

• Вбудовування файлів
  Дізнайтеся, як вбудовувати зовнішні файли в Intlayer для використання їх у редакторі контенту.

• Вкладення
  Дізнайтеся, як вкладати контент в Intlayer для створення складних структур.

Середовища та інтеграції

Intlayer створено з урахуванням гнучкості, забезпечуючи безшовну інтеграцію з популярними фреймворками та інструментами збірки:

• Intlayer з Next.js 16
• Intlayer з Next.js 15
• Intlayer з Next.js 14 (App Router)
• Intlayer з Next.js Page Router
• Intlayer з React CRA
• Intlayer з Vite + React
• Intlayer з React Router v7
• Intlayer з Tanstack Start
• Intlayer з React Native та Expo
• Intlayer з Lynx та React
• Intlayer з Vite + Preact
• Intlayer з Vite + Vue
• Intlayer з Nuxt
• Intlayer з Vite + Svelte
• Intlayer з SvelteKit
• Intlayer з Express
• Intlayer з NestJS
• Intlayer з Angular

Кожен посібник з інтеграції містить найкращі практики використання можливостей Intlayer, таких як server-side rendering, dynamic routing або client-side rendering, щоб ви могли підтримувати швидкий, SEO-дружній та високо масштабований застосунок.

Внесок і відгуки

Ми цінуємо силу open-source та розробку, що керується спільнотою. Якщо ви хочете запропонувати покращення, додати новий посібник або виправити будь-які помилки в нашій документації, не соромтеся надіслати Pull Request або відкрити issue у нашому репозиторії на GitHub.

Готові перекласти ваш додаток швидше та ефективніше? Ознайомтеся з нашою документацією, щоб почати використовувати Intlayer вже сьогодні. Відчуйте надійний, оптимізований підхід до інтернаціоналізації, який зберігає ваш контент впорядкованим і підвищує продуктивність вашої команди.