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

Добро пожаловать в официальную документацию Intlayer! Здесь вы найдете все необходимое для интеграции, настройки и освоения Intlayer для всех ваших задач интернационализации (i18n), будь то работа с Next.js, React, Vite, Express или другой средой JavaScript.

Введение

Что такое Intlayer?

Intlayer — это библиотека интернационализации, разработанная специально для JavaScript-разработчиков. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявления многоязычного контента в структурированные словари для легкой интеграции в ваш код. Используя TypeScript, Intlayer делает вашу разработку более надежной и эффективной.

Intlayer также предоставляет опциональный визуальный редактор, который позволяет легко редактировать и управлять вашим контентом. Этот редактор особенно полезен для разработчиков, предпочитающих визуальный интерфейс для управления контентом, или для команд, создающих контент без необходимости беспокоиться о коде.

Пример использования

.└── Components    └── MyComponent        ├── index.content.cjs        └── index.mjs

import { t, type Dictionary } from "intlayer";const componentContent = {  key: "component-key",  content: {    myTranslatedContent: t({      en: "Hello World",      fr: "Bonjour le monde",      es: "Hola Mundo",    }),  },} 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 15
• Intlayer с Next.js 14 (App Router)
• Intlayer с Next.js Page Router
• Intlayer с React CRA
• Intlayer с Vite + React
• Intlayer с React Native и Expo
• Intlayer с Lynx и React
• Intlayer с Express

Каждое руководство по интеграции включает лучшие практики использования возможностей Intlayer, таких как рендеринг на стороне сервера, динамическая маршрутизация или рендеринг на стороне клиента, чтобы вы могли поддерживать быстрое, SEO-дружественное и высокомасштабируемое приложение.

Вклад и обратная связь

Мы ценим силу открытого исходного кода и разработки, управляемой сообществом. Если вы хотите предложить улучшения, добавить новое руководство или исправить любые ошибки в нашей документации, не стесняйтесь отправить Pull Request или открыть issue в нашем репозитории на GitHub.

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

История документации

• 5.5.10 - 2025-06-29: Инициализация истории