Спросите свой вопрос и получите сводку документа, используя эту страницу и выбранного вами поставщика AI
История версий
- "Extract single capitalized words, add intlayer-ignore comment directives"v9.7.412.11.2026
- "Обновление опций компилятора, добавление поддержки FilePathPattern"v8.2.009.03.2026
- "Обновление опций компилятора"v8.1.725.02.2026
- "Выпуск Compiler"v7.3.127.11.2025
Содержимое этой страницы было переведено с помощью ИИ.
Смотреть последнюю версию оригинального контента на английскомЕсли у вас есть идея по улучшению этой документации, не стесняйтесь внести свой вклад, подав запрос на вытягивание на GitHub.
Ссылка на документацию GitHubКопировать Markdown документа в буфер обмена
Intlayer Compiler: Автоматизированное извлечение контента для i18n
Что такое Intlayer Compiler?
Intlayer Compiler - это мощный инструмент, разработанный для автоматизации процесса интернационализации (i18n) в ваших приложениях. Он сканирует ваш исходный код (JSX, TSX, Vue, Svelte) на предмет объявлений контента, извлекает их и автоматически генерирует необходимые файлы словарей. Это позволяет вам хранить контент вместе с компонентами, в то время как Intlayer управляет и синхронизирует ваши словари.
Почему стоит использовать Intlayer Compiler?
Автоматизация: Исключает необходимость ручного копирования содержимого в словари.
Speed: Оптимизированное извлечение контента, обеспечивающее быстроту вашего процесса сборки.
Developer Experience: Храните объявления контента в том месте, где они используются, улучшая поддерживаемость.
- Автоматизация: устраняет необходимость вручную копировать и вставлять контент в словари.
- Скорость: оптимизированное извлечение контента обеспечивает быструю сборку.
- Опыт разработчика: храните объявления контента прямо там, где они используются, что улучшает поддерживаемость.
- Живые обновления: поддержка Hot Module Replacement (HMR) для мгновенной обратной связи во время разработки.
См. блог-пост Компилятор против декларативного i18n для более глубокого сравнения.
Почему не использовать Intlayer Compiler?
Хотя компилятор предлагает отличный опыт "работает из коробки", он также вводит некоторые компромиссы, о которых вы должны знать:
- Эвристическая неоднозначность: Компилятор должен угадывать, что является пользовательским контентом, а что - логикой приложения (например,
className="active", коды состояния, ID продуктов). В сложных кодовых базах это может привести к ложным срабатываниям или пропущенным строкам, которые требуют ручных аннотаций и исключений. Только статическое извлечение: Извлечение на основе компилятора полагается на статический анализ. Строки, которые существуют только во время выполнения (коды ошибок API, поля CMS и т.д.), не могут быть обнаружены или переведены компилятором в одиночку, поэтому вам все еще нужна дополнительная стратегия i18n времени выполнения.
Извлечение только статических элементов: Извлечение на основе компилятора полагается на статический анализ. Строки, которые существуют только во время выполнения (коды ошибок API, поля CMS и т. д.), не могут быть обнаружены или переведены самим компилятором, поэтому вам все еще нужна дополнительная стратегия i18n во время выполнения.
Для более глубокого архитектурного сравнения см. блог-пост Компилятор против декларативного i18n.
В качестве альтернативы, для автоматизации процесса i18n при сохранении полного контроля над контентом, Intlayer также предоставляет команду автоматического извлечения intlayer extract (см. документацию CLI) или команду Intlayer: extract content to Dictionary из расширения Intlayer VS Code (см. документацию расширения VS Code).
Использование
Самый быстрый способ подключить компилятор, интерактивная настройка: выполнитеnpx intlayer init --interactiveи выберите Compiler. В Next.js и Vite он активируется автоматически, как только установленоcompiler.enabledи настроен путьcompiler.output.
Vite
Для приложений на базе Vite (React, Vue, Svelte и др.) самый простой способ использовать компилятор - через плагин vite-intlayer.
Установка
Копировать код в буфер обмена
Конфигурация
Обновите ваш vite.config.ts, чтобы включить плагин intlayerCompiler:
Копировать код в буфер обмена
Самостоятельный плагинintlayerCompiler()по-прежнему экспортируется для расширенных настроек. Его регистрация вместе сintlayer()безопасна, компилятор дедублирует себя и запускается только один раз.
See complete tutorial: Translate Vite and React with Intlayer
Поддержка фреймворков
Плагин Vite автоматически обнаруживает и обрабатывает различные типы файлов:
React / JSX / TSX: Обрабатывается нативно.
Vue: Requires
@intlayer/vue-compiler.- React / JSX / TSX: Обрабатывается нативно.
- Vue: Требуется
@intlayer/vue-compiler. - Svelte: Требуется
@intlayer/svelte-compiler.
Убедитесь, что установлен соответствующий пакет компилятора для вашего фреймворка:
Копировать код в буфер обмена
Next.js
В Next.js компилятор работает как загрузчик бандлера, next-intlayer/extractor-loader. withIntlayer регистрирует его для вас как в Turbopack, так и в webpack, писать babel.config.js не требуется.
Установка
Копировать код в буфер обмена
Конфигурация
Ничего настраивать не нужно. Пока ваш next.config.ts проходит через withIntlayer, установки @intlayer/babel достаточно для регистрации загрузчика:
Копировать код в буфер обмена
Загрузчик выполняется для файлов .tsx и .jsx перед next-swc-loader, поэтому он читает ваш исходный JSX. Содержимое, объявленное в компонентах, извлекается в файлы .content и собирается в .intlayer по мере компиляции файла.
Babel
Для Next.js или других приложений на основе Webpack с использованием Babel вы можете настроить компилятор с помощью плагина @intlayer/babel.
Установка
Копировать код в буфер обмена
Конфигурация
Обновите ваш файл babel.config.js (или babel.config.json), чтобы включить плагин извлечения. Мы предоставляем вспомогательную функцию getExtractPluginOptions для автоматической загрузки вашей конфигурации Intlayer.
Копировать код в буфер обмена
Эта конфигурация гарантирует, что контент, объявленный в ваших компонентах, автоматически извлекается и используется для генерации словарей во время процесса сборки.
Пользовательская конфигурация
Чтобы настроить поведение компилятора, вы можете обновить файл intlayer.config.ts в корне вашего проекта.
Копировать код в буфер обмена
Справочник по конфигурации компилятора
Следующие свойства могут быть настроены в блоке compiler вашего файла intlayer.config.ts:
enabled:
- Тип:
boolean | 'build-only' - По умолчанию:
true - Описание: Указывает, должен ли компилятор быть включен.
- Тип:
dictionaryKeyPrefix:
- Тип:
string - По умолчанию:
'' - Описание: Префикс для извлеченных ключей словаря.
- Тип:
transformPattern:
- Тип:
string | string[] - По умолчанию:
['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**'] - Описание: (Устарело: вместо этого используйте
build.traversePattern) Шаблоны для обхода кода для оптимизации.
- Тип:
excludePattern:
- Тип:
string | string[] - По умолчанию:
['**/node_modules/**'] - Описание: (Устарело: вместо этого используйте
build.traversePattern) Шаблоны для исключения из оптимизации.
- Тип:
output:
- Тип:
FilePathPattern - По умолчанию:
({ key }) => 'compiler/${key}.content.json' - Описание: Определяет путь к выходным файлам. Заменяет
outputDir. Поддерживает динамические переменные, такие как{{locale}},{{key}},{{fileName}},{{extension}},{{format}},{{dirPath}},{{componentFileName}},{{componentExtension}}, и{{componentFormat}}. Может быть задано как строка в формате'my/{{var}}/path'или как функция. - Примечание: Пути
./**/*разрешаются относительно компонента. Пути/**/*разрешаются относительноbaseDirIntlayer. - Примечание: Если язык определен в пути, словари будут генерироваться для каждого языка.
- Пример:
output: ({ locale, key }) => 'compiler/${locale}/${key}.json'
- Тип:
noMetadata:
- Тип:
boolean - По умолчанию:
false - Описание: Указывает, должны ли метаданные сохраняться в файле. Если true, компилятор не будет сохранять метаданные словарей (ключ, оболочка содержимого). Полезно для вывода JSON i18next или ICU MessageFormat для каждой локали.
- Примечание: Полезно при использовании с плагином
loadJSON. - Пример:
Если
true:json { "key": "value" }Еслиfalse:json { "key": "value", "content": { "key": "value" } }
- Тип:
saveComponents:
- Тип:
boolean - По умолчанию:
false - Описание: Указывает, должны ли компоненты сохраняться после трансформации.
- Тип:
Исключение строк из извлечения
Компилятор извлекает каждую строку, похожую на видимый пользователю текст, включая отдельные слова, такие как Save, Settings или Counter. Он не может отличить подпись от имени собственного или названия бренда, поэтому отмечайте их директивой в комментарии:
intlayer-ignore-next-line: пропускает строки следующей строки кода. Если поставить её над элементом JSX, Vue или Svelte, она также пропускает текст и атрибуты элемента.intlayer-ignore-line: пропускает строки своей собственной строки кода.intlayer-ignore-file: пропускает весь файл. Разместите её в начале файла.
Копировать код в буфер обмена
В шаблонах Vue и Svelte используйте HTML-комментарий: <!-- intlayer-ignore-next-line -->.
Правило ESLint intlayer/no-raw-text читает те же директивы, поэтому пропущенные строки тоже не помечаются.
Заполнить недостающие переводы
Intlayer предоставляет инструмент CLI, который поможет вам заполнить недостающие переводы. Вы можете использовать команду intlayer для тестирования и заполнения недостающих переводов в вашем коде.
Копировать код в буфер обмена
Копировать код в буфер обмена
Извлечение
Intlayer предоставляет инструмент CLI для извлечения контента из вашего кода. Вы можете использовать команду intlayer extract, чтобы извлечь контент из вашего кода.
Копировать код в буфер обмена
Для получения более подробной информации обратитесь к документации CLI
