Официальное расширение VS Code

Обзор

Intlayer — официальное расширение Visual Studio Code для Intlayer, разработанное для улучшения опыта разработчика при работе с локализованным контентом в ваших проектах.

Ссылка на расширение: https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension

Возможности

• Мгновенная навигация – Быстрый переход к нужному файлу контента при клике на ключ useIntlayer.
• Заполнение словарей – Заполнение словарей контентом из вашего проекта.

• Простой доступ к командам Intlayer – Легко собирайте, отправляйте, загружайте, заполняйте и тестируйте словари контента.

• Генератор деклараций контента – Создавайте файлы словарей контента в различных форматах (.ts, .esm, .cjs, .json).

• Тестирование словарей – Проверяйте словари на наличие отсутствующих переводов.

• Держите ваши словари в актуальном состоянии – Обновляйте словари с последним содержимым из вашего проекта.

• Вкладка Intlayer (Панель активности) – Просматривайте и ищите словари через специальную боковую вкладку с панелью инструментов и контекстными действиями (Сборка, Загрузка, Отправка, Заполнение, Обновление, Тестирование, Создание файла).

Использование

Быстрая навигация

1. Откройте проект, использующий react-intlayer.

2. Найдите вызов useIntlayer(), например:

   const content = useIntlayer("app");

3. Командный клик (⌘+Click на macOS) или Ctrl+Click (на Windows/Linux) по ключу (например, "app").
4. VS Code автоматически откроет соответствующий файл словаря, например, src/app.content.ts.

Вкладка Intlayer (Панель активности)

Используйте боковую вкладку для просмотра и управления словарями:

• Откройте иконку Intlayer на панели активности.
• В поле Поиск введите текст для фильтрации словарей и записей в реальном времени.
• В разделе Словари просматривайте окружения, словари и файлы. Используйте панель инструментов для действий: Сборка, Загрузка, Отправка, Заполнение, Обновление, Тестирование и Создание файла словаря. Щелкните правой кнопкой мыши для контекстных действий (Загрузка/Отправка для словарей, Заполнение для файлов). Текущий файл редактора автоматически подсвечивается в дереве, если применимо.

Доступ к командам

Вы можете получить доступ к командам через Палитру команд.

Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)

• Сборка словарей
• Отправка словарей
• Загрузка словарей
• Заполнение словарей
• Тестирование словарей
• Создание файла словаря

Загрузка переменных окружения

Intlayer рекомендует хранить ваши ключи API ИИ, а также идентификатор клиента Intlayer и секрет в переменных окружения.

Расширение может загружать переменные окружения из вашего рабочего пространства для выполнения команд Intlayer с правильным контекстом.

• Порядок загрузки (по приоритету): .env.<env>.local → .env.<env> → .env.local → .env
• Без разрушения: существующие значения process.env не перезаписываются.
• Область действия: файлы разрешаются из настроенной базовой директории (по умолчанию корень рабочего пространства).

Выбор активного окружения

• Палитра команд: откройте палитру и выполните команду Intlayer: Select Environment, затем выберите окружение (например, development, staging, production). Расширение попытается загрузить первый доступный файл из приведённого выше списка приоритетов и покажет уведомление, например «Загружено окружение из .env..local».
• Настройки: перейдите в Настройки → Расширения → Intlayer и установите:
  • Окружение: имя окружения, используемое для разрешения файлов .env.<env>*.
  • (Опционально) Файл Env: явный путь к файлу .env. При указании он имеет приоритет над списком, определённым автоматически.

Моно-репозитории и пользовательские директории

Если ваши файлы .env находятся за пределами корня рабочего пространства, установите Базовый каталог в Настройки → Расширения → Intlayer. Загрузчик будет искать файлы .env относительно этого каталога.

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