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

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

Введение

Что такое Intlayer?

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

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

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

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

import { t, type Dictionary } from "intlayer";const componentContent = {  key: "component-key",  content: {    myTranslatedContent: t({      en: "Hello World",      fr: "Bonjour le monde",      es: "Hola Mundo",      ru: "Привет, мир",    }),  },} 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 с учетом гибкости, предлагая бесшовную интеграцию с популярными фреймворками и инструментами сборки:

• Intlayer с Next.js 15
• Intlayer с Next.js 14 (App Router)
• Intlayer с Next.js Page Router
• Intlayer с React CRA
• Intlayer с Vite + React
• Intlayer с Express

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

Участие и обратная связь

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

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

Удачного перевода!