Я носитель испанского языка. Я живу в Соединенных Штатах, поэтому каждый день использую английский. Я пишу свои посты на английском для практики и для охвата большей аудитории.

Google Analytics показал мне кое-что важное. Более половины моих посетителей из стран, где английский не является основным языком. Это говорило мне о том, что я упускаю возможности. Поэтому я решил перевести блог с помощью ИИ.

На чем я фокусируюсь

Ясность: Я сохраняю смысл, а не дословный перевод слово в слово.
Сохранение структуры: Я не позволяю переводам изменять HTML, код или URL-адреса.
Стабильные URL-адреса: У каждого языка есть фиксированный слаг, чтобы ссылки не ломались.
Скорость: Одна команда переводит все.

Моя настройка

Формат контента: Каждый пост — это JSON-файл с полями title, date, excerpt, content, readTime, tags, categories, translatedSlugs и slug.
Фреймворк: Next.js и next-intl для маршрутизации с учетом локали.
Модель: Я вызываю API Gemini от Google из scripts/translate-es-gemini.ts. По умолчанию он использует REST и имеет резервную модель. Промпт строгий: переводить только значения, не трогать HTML или URL-адреса.
Одна команда: scripts/translate-all-languages.ts выполняет переводы для всех локалей, синхронизирует сопоставления слагов и проверяет полноту.
Переключатель языков: Он использует translatedSlugs для отправки читателей на правильный URL для каждого языка.

Мой рабочий процесс

Я пишу пост на английском языке в файле app/[locale]/blog/posts/<slug>/index.json. Поле content — это HTML. Блоки кода заключены в ограждение.
Я перевожу одной командой. Модель переводит title, excerpt, content и readTime. Метаданные, такие как date, tags и categories, остаются прежними.
Я синхронизирую слагов с помощью карты translatedSlugs в каждом файле, английском и переводах.
Я проверяю, что каждый язык существует и карта слагов полна.

Почему ИИ работает для меня

Следует инструкциям: Промпт защищает HTML, код и ссылки.
Быстро и хорошо: Быстрая модель с автоматическим резервным вариантом.
Последовательный тон: Низкая температура поддерживает стабильность стиля на разных языках.

Защитные меры

Безопасный перевод HTML: Я отправляю только значения JSON-ключей, а не теги или атрибуты.
Дисциплина слагов: translatedSlugs содержит слаг для en, es, fr, de, ru, nl, it и zh.
Проверка: Команда проверяет наличие каждого языкового файла и полноту карты слагов.
Вежливость к API: Я добавляю небольшую задержку между вызовами.

Переводы и SEO

Помощь читателям: Люди доверяют контенту на своем языке. Они остаются дольше и делятся им чаще.
URL имеют значение: Переведенный слаг может включать слова, которые люди ищут на этом языке.
Одна страница на язык: Связывайте языковые версии с помощью hreflang, чтобы избежать дублирования.
Карты сайта: Включайте все локали, чтобы поисковые системы могли их найти.
Стабильность: Переводите слагов, но сохраняйте их стабильными. Частые изменения URL могут навредить.

Команды, которые я запускаю

# Перевести один пост на все языки
npm run translate-all translate my-new-post

# Проверить наличие всех языковых файлов и карт слагов
npm run translate-all validate my-new-post

# Повторно запустить и перезаписать переводы после редактирования английского
npm run translate-all translate my-new-post --force

Вот и все. Одна для перевода, одна для проверки. Переключатель работает, потому что каждый JSON-файл содержит слаг для каждого языка.

Советы, если вы попробуете

Пишите просто. Короткие предложения хорошо переводятся.
Ограждайте блоки кода и заключайте встроенный код в <code>.
Избегайте игры слов, если вы не будете просматривать целевой текст.
Используйте семантический HTML. Заголовки и списки помогают читателям и моделям.

Часто задаваемые вопросы

Редактирую ли я переводы?

Иногда, особенно заголовки и вступления. Я хочу получить быструю отправную точку, а затем дорабатываю там, где это важно.

Конфиденциальность?

Контент отправляется в API Gemini. Я не отправляю секреты. Ключи API находятся в .env.local (GOOGLE_API_KEY или GEMINI_API_KEY).

Модели?

Я использую быструю модель Gemini и автоматически переключаюсь на резервную, если она недоступна. Вы можете переопределить ее с помощью GEMINI_MODEL.

Вывод

ИИ не заменяет ваш голос. Он устраняет рутинную работу. Держите исходный текст чистым, автоматизируйте повторяющиеся части, проверяйте и выпускайте.

Engineering

Как я перевожу этот блог с помощью ИИ