Использование AI для интернационализации (i18n) вебсайта

Современные AI чатботы это инструмент. Для каких-то вещей в жизни разработчика он подходит хорошо, для каких-то - не очень. Для интернационализации сайтов - хорошо.

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

У меня проект на Vue 3, но данный метод подходит как для любых фронтенд фреймворков, так и сайтов на чистом JS или PHP. Главное, нужна функция t() которая будет принимать ключ строки и выдавать перевод в соответствии с текущей локалью.

Предполагаем, что библиотечный или кастомный i18n пакет уже стоит, или каким-то другим способом функция t() уже определена.

Я использую Cursor AI IDE, который основан на VS Code и сам может вносить изменения одновременно в несколько файлов, но можно задействовать, наверняка, и других AI помощников и помощниц.

Итак, предположим уже есть сайт с зашитыми строками на английском языке. Сперва надо вытащить их в en.json. Пример будущего json файла перевода:

{
  "msg": "Hello",
  "login": {
    "signup": "Sign In",
    "subtitle": "to {name}"
  },
  "sidebar": {
    "menu": {
      "home": "Home",
      "profile": "User Profile",
      "logout": "Logout",

Первый промпт:

Ты должна помочь мне с добавлением интернационализации (i18n) в проект.
Для этого сейчас нужно создать файл с переводами для английского языка.

Вот пример структуры файла:

{
  "msg": "Hello"
}

Файл en.json уже есть, нужно дополнить его переводами для английского языка.
Все переводы нужно вытащить из кода проекта - из *.vue и *.ts файлов.
Вместо зашитых строк должны быть ключи, на которые потом нужно будет ссылаться в коде.
Ключи используются в вызове функции t(key, params) из useI18n.ts
Везде, где ты будешь менять зашитые значения на вызовы функции t(key, params), 
нужно сделать импорт функции t из useI18n.ts
Используй вложенность до второго уровня, например, ключ 'sidebar.menu.profile'
В en.json это будут вложенные объекты, например:
{
  "sidebar": {
    "menu": {
      "profile": "Profile"
    }
  }
}

Не генерируй новых файлов в качестве примера как это должно быть.
Используй текущую кодовую базу, чтобы провести в ней изменения.
Не трогай строки внутри console.log()

AI у меня обработала всего 3-4 файла сразу таким образом и достаточно хорошо. Видимо она проверяет - правильно ли она меня поняла. Поэтому промпт надо будет прогнать несколько раз. Можно просто заходить в файл и писать в том же AI потоке: Сделай i18n

Вручную надо будет поработать с параметрами для строкt().Поначалу, потом она научится вытаскивать их сама

В итоге

<h1>Hello</h1>

превратится в

<h1>{{ t("msg") }}</h1>

с добавлением этой строки с данным ключом в en.json

После того, как все зашитые строки перегнаны в en.json, второй промпт для создания переводов:

Возьми файл en.json, служащий для i18n, и переведи значения его ключей 
на испанский, немецкий, французский, арабский, вьетнамский, китайский и русский языки. 
Работай только с этими языками, не обращай внимания на переводы на другие языки.
Если необходимо, сделай изменения в файле app/composables/useI18n.ts 
(добавь новые локали).
Порядок языков должен соответствовать популярности языков в США.

Промпты удобно хранить в своих текстовых файлах и просто на них ссылаться:

Если просишь за раз перевести на большое количество языков, у меня выскакивает ошибка о превышении лимита обращений к cursor.sh. Надо переводить частями по 3-4 языка.

Переводы получаются достаточно качественные, учитывающие контекст. На порядок лучше автоматического Google Translate.

Ну и третий промпт на будущее:

Возьми файл en.json, служащий для i18n, и посмотри, какие появились у него значения его ключей, которых нет в других переводах.
Переведи эти новые значения на все остальные языки и добавь в соответствующие .json файлы.

Естественно, все промпты желательно улучшить прогоном через сам AI

Тогда, например, последний промпт превратится в следующее:

Инструкции по обновлению языковых файлов i18n:

1. Анализ файла en.json:
   - Откройте файл en.json, который служит основой для интернационализации (i18n).
   - Проанализируйте все ключи и их значения в этом файле.

2. Сравнение с другими языковыми файлами:
   - Просмотрите все остальные языковые файлы (например, ru.json, fr.json, de.json и т.д.).
   - Найдите ключи из en.json, которых нет в других языковых файлах или значения которых отличаются.

3. Перевод новых значений:
   - Для каждого нового или измененного ключа переведите его значение на все остальные языки.
   - Убедитесь, что перевод учитывает контекст и специфику каждого языка.

4. Обновление соответствующих .json файлов:
   - Добавьте новые переведенные ключи и значения в соответствующие языковые файлы.
   - Если ключ уже существует, но его значение изменилось, обновите перевод.
   - Сохраните изменения в каждом языковом файле.

5. Проверка согласованности:
   - После обновления всех файлов, проверьте, что все ключи из en.json присутствуют во всех других языковых файлах.
   - Убедитесь, что структура всех файлов идентична.

Можно подредактировать, явно указав контекст приложения и предпочтения при переводе.

Всё.

Можно в дальнейшем улучшать и автоматизировать систему, например, проверять последние коммиты на добавление новых строк и переводить их, но это уже на любителя

Интересная и полезная информация о Vue.js и фронтенде в целом на нашем Телеграм‑канале: @vuefaq