Point I18n - VSCode Extension

Расширение для отображения переводов локализации inline прямо в коде.

🚀 Возможности

• Inline-переводы: Видите переводы прямо в коде вместо ключей
• Hover с информацией: Наведите курсор для просмотра ключа и перевода
• Быстрое редактирование: Кликните на перевод чтобы увидеть оригинальный ключ
• Синхронизация с сервером: Загрузка актуальных переводов из API
• Работа с проектами: Выбор проекта и переключение между проектами локализации
• Управление ключами: Поиск, создание и редактирование ключей локализации через sidebar
• Поиск по переводам: Поиск файлов по переведенному тексту, даже если в коде только ключ i18n
• Умный поиск: Находит все вхождения ключей с нужным переводом в указанной директории

📦 Установка

1. Установите расширение
2. Выполните команду Point I18n: Quick Login
3. Введите логин и пароль
4. Переводы загрузятся автоматически

⌨️ Горячие клавиши

• Cmd+Shift+I (macOS) - Включить/выключить inline-переводы

⚙️ Настройки

Язык переводов

{
  "i18nRemote.locale": "ru"
}

Ключ проекта

{
  "i18nRemote.projectKey": "point-frontend"
}

Путь для поиска

{
  "i18nRemote.searchPath": "src"
}

Путь поиска сохраняется автоматически при использовании функции поиска.

Базовые URL API

Расширение требует настройки базовых URL для работы с API. При первом использовании появится диалог с предложением настроить URL.

Базовый URL для API

{
  "i18nRemote.apiBaseUrl": "https://example.com"
}

Используется для:

• Авторизации
• Получения списка проектов
• Создания и обновления ключей
• Поиска ключей

Базовый URL для API локализации

{
  "i18nRemote.localizationApiBaseUrl": "https://example.com"
}

Используется для:

• Загрузки переводов (fetch locales)

Настройка через команды

Вы можете настроить URL через команды VS Code:

• Point I18n: Configure API Base URL - настройка базового URL для API
• Point I18n: Configure Localization API Base URL - настройка базового URL для API локализации

Примечание: Оба варианта URL работают одинаково (с завершающим слэшем и без): https://example.com и https://example.com/

🎨 Как использовать

До:

<template>
  <div>{{ $t('welcome-title') }}</div>
</template>

После (с расширением):

<template>
  <div>{{ $t(Добро пожаловать) }}</div>
</template>

Редактирование:

1. Кликните на перевод → увидите оригинальный ключ
2. Отредактируйте ключ
3. Кликните в другое место → вернется перевод

📝 Команды

• Point I18n: Quick Login - Авторизация и загрузка локалей
• Point I18n: Fetch locales now - Обновить переводы с сервера
• Point I18n: Toggle inline translations - Вкл/выкл inline-переводы
• Point I18n: Configure API Base URL - Настройка базового URL для API
• Point I18n: Configure Localization API Base URL - Настройка базового URL для API локализации

🔍 Поиск по переводам

Новая функция позволяет находить файлы по переведенному тексту, даже если в коде используется только ключ i18n.

Как использовать:

1. Откройте sidebar панель "Управление"
2. Найдите секцию "📁 Поиск в проекте"
3. Укажите путь поиска (например, src, src/components, app)
4. Введите текст для поиска (например, "Тип операции")
5. Результаты появятся автоматически с указанием:
   • Файла и номера строки
   • Ключа локализации
   • Переведенного текста
   • Превью строки кода
6. Кликните на результат для открытия файла на нужной строке

Особенности:

• Быстрый поиск: Параллельная обработка файлов для ускорения
• Точные результаты: Находит все вхождения ключей с нужным переводом
• Сохранение пути: Последний путь поиска сохраняется автоматически
• Умная фильтрация: Исключает ненужные директории (node_modules, dist, build и т.д.)

🎛️ Sidebar панель

Расширение добавляет sidebar панель "Управление" в Activity Bar, где можно:

• Управлять авторизацией
• Обновлять переводы
• Настраивать параметры
• Поиск по переводам: Найдите файлы, содержащие нужный переведенный текст
  • Укажите путь поиска (по умолчанию src)
  • Введите текст для поиска
  • Кликните на результат для открытия файла на нужной строке
• Поиск ключей: Поиск ключей локализации по названию
• Создание ключей: Добавление новых ключей локализации с переводами

🔧 Требования

• VSCode ^1.87.0
• Node.js для работы расширения

📄 Лицензия

Proprietary