Использование 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().Поначалу, потом она научится вытаскивать их сама
В итоге
Hello
превратится в
{{ t("msg") }}
с добавлением этой строки с данным ключом в 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
